Files
itgmania212121/stepmania/README-FIRST.TXT
T
2002-08-02 09:31:06 +00:00

1059 lines
49 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
 ____ __
/\ _`\ /\ \__ /'\_/`\ __
\ \,\L\_\ \ ,_\ __ _____ /\ \ __ ___ /\_\ __
 \/_\__ \\ \ \/ /'__`\/\ '__`\ \ \__\ \ /'__`\ /' _ `\/\ \ /'__`\
/\ \L\ \ \ \_/\ __/\ \ \L\ \ \ \_/\ \/\ \L\.\_/\ \/\ \ \ \/\ \L\.\_
\ `\____\ \__\ \____\\ \ ,__/\ \_\\ \_\ \__/.\_\ \_\ \_\ \_\ \__/.\_\
\/_____/\/__/\/____/ \ \ \/ \/_/ \/_/\/__/\/_/\/_/\/_/\/_/\/__/\/_/
\ \_\
\/_/
__ __
 /'__`\ /'__`\
/\_\L\ \ /\ \/\ \
\/_/_\_<_ \ \ \ \ \
/\ \L\ \__\ \ \_\ \
\ \____/\_\\ \____/
\/___/\/_/ \/___/
(c)2001-2002, StepMania team
http://www.stepmania.com
************************************************************
Table of Contents
************************************************************
1. About StepMania
2. Minimum Requirements
3. DirectX
4. Installation
5. Controls
6. How StepMania Loads Songs
7. Connecting Dance Pads
8. Compatibility Issues
9. FAQ / Troubleshooting
10. StepMania Packages - .smzip
11. Questions, Bugs, Suggestions, and Help
12. The StepMania Editor
13. The .SM File Format
14. Background Animations
15. The .CRS File Format
16. Improving Image Quality with Texture Hints
17. Creating a StepMania announcer pack
18. Creating a StepMania theme pack
19. Building StepMania from CVS Source
20. Version History
21. Thanks
************************************************************
1. About StepMania
************************************************************
StepMania game system is capable of playing many game types. Currently, it
supports games Dance Dance Revolution and Pump It Up, with future support for EZ
2 Dancer, BeatMania, Guitar Freaks, DrumMania, Para Para Paradise and more.
************************************************************
2. Minimum Requirements
************************************************************
* Windows 98, Windows ME, Windows 2000, or Windows XP
* Pentium II, Pentium III, Celeron, Athlon, or compatible processor, 266MHz
minimum (400 MHz highly recommended)
* 64 MB of RAM
* Video card that supports High Color (16-bit color) and has 16MB video RAM
* DirectX 8.1 compatible video card with drivers
* DirectX 8.1 compatible sound card with drivers
* DivX 5 video codec (for movie visualizations)
************************************************************
3. DirectX
************************************************************
DirectX 8.1 is required before installing StepMania. If DirectX 8.1 is not
installed on your computer, the StepMania installer will display a warning
and abort the installation.
************************************************************
4. Installation
************************************************************
To install StepMania, download the file stepmania3.exe to a known location
on your hard drive, then double-click the file icon to begin the installation.
The installer automatically remove an older version of the program if one is
present. The default installation directory is 'C:\Program Files\StepMania'.
************************************************************
5. Controls
************************************************************
Use the "Config Key/Joy" option from the Title Menu to configure your
keyboad or dance pad.
Any time:
* F4 = toggle fullscreen
* F5 = toggle detail
* Tab = increase game speed 4x
* LShift = decrease game speed to 1/4x
In menus:
* Arrow keys navigate menus
* Enter = Start, Escape = Back
In gameplay:
* F8 = toggle AutoPlay
* F9 = decrease offset
* F10 = increase offset
* F11 = decrease BPM of current segment
* F12 = increase BPM of current segment
* Hold Escape = abort playing
************************************************************
6. How StepMania Loads Songs
************************************************************
All song files for a specific song (data file, music file, banner, background)
must reside in a single folder. This folder must have the following path:
Songs/<group folder>/<song folder>/
For example, the song B4U may consist of the following files:
Songs/Dance Dance Revolution 4th Mix/B4U/b4u.dwi
Songs/Dance Dance Revolution 4th Mix/B4U/b4u.mp3
Songs/Dance Dance Revolution 4th Mix/B4U/b4u-banner.png
Songs/Dance Dance Revolution 4th Mix/B4U/b4u.png
Songs/Dance Dance Revolution 4th Mix/B4U/b4u-movie.avi
StepMania supports the SM, DWI, and BMS song file formats.
If a song file does not specify a valid banner file, StepMania first looks
for a graphic in the song folder that contains the letters "banner". If that
search fails, StepMania will guess which image is most appropriate.
If a song file does not specify a valid background file, StepMania first looks
for a graphic in the song folder that contains the letters "bg" or "background".
If that search fails, StepMania will guess which image is most appropriate.
If a song file does not specify a valid CDTitle file, StepMania will look
for a graphic in the song folder that contains the letters "cdtitle". If that
search fails, StepMania will guess which image is most appropriate.
Also, for compatibility with DWI, if can reading CDTitles from the .\CDTitles
folder. Song makers are not encouraged to not use this feature and instead
should put the CDTitle graphic in the song folder. Having a separate CDTitles
folder breaks the principle that all files needed to play a song should reside
in the song folder.
If a song file does not specify a valid movie background file, StepMania will
look for a movie in the song folder that contains the letters "movie". If
that search fails, StepMania will use the first movie in the song folder.
************************************************************
7. Connecting Dance Pads
************************************************************
There are several devices that allow you to connect PlayStation dance pads to
your PC.
* Not recommended: generic PlayStation->USB converter
Using a generic PlayStation->USB converter is not recommended to play any
dancing game on the PC. The vast majority of these converters are not capable
of registering simultaneous presses of Left+Right or Up+Down. This
restriction will cause the player to miss many notes where two buttons must
be hit simultaneously.
* Highly Recommended: Special PlayStation->USB adaptor
There is just one brand of PlayStation->USB adaptor that functions perfectly
with StepMania. These adaptors are available for purchase at the StepMania
web site (www.stepmania.com) and through some importers (www.liksang.com).
The adaptor is made by “Boom”, and it small and black with a detachable USB
cable. These adaptors cost about $15 and allow you to attach one dance pad
per adaptor. The primary advantage of these adaptors is that they do not
require special drivers and require no configuring.
* Semi-Recommended: PlayStation->Parallel adaptor
PlayStation->Parallel converters do not have the simultaneous button problem
that USB converters do. The disadvantage of these adaptors is that home-made
drivers are required to use these devices. These drivers are often finicky
and incompatible with some sound cards. PlayStation->Parallel adaptors can
be purchased from the StepMania web site or any importer.
For Windows 98 and Windows Me users, the recommended driver is "DirectPad Pro
5.0 for Win9x". For Windows 2000 and Windows XP, the recommended drivers are
NTPad XP 1.x. Both of these drivers can be downloaded from Aldos web site:
http://www.aldostools.com/dpad.html
************************************************************
8. Compatibility Issues
************************************************************
Some video card/driver combinations have visual errors when running StepMania.
If you experience any visual errors, please visit your video card manufacturer's
web site and download the latest Direct3D 8.1 drivers. Below is a list of known
issues that are thought to be video card driver bugs:
* S3 Savage family cards (e.g. Diamond Stealth)
Symptom: The right edge of some graphics appears "cut off".
Explanation: Drivers do not properly handle textures > 512x512, resulting in
cropped textures. Please use the Low texture detail option to force texture to
be 512x512 or smaller.
* SiS cards
Symptom: Garbled fonts.
Explanation: Drivers have errors in handling texture coordinates. Only known
solution is to upgrade drivers.
* Any card older than two years
Symptom: Various graphical glitches.
Explanation: These problems are most often video card driver bugs. Please
upgrade to the latest drivers, which will hopefully fix the errors.
************************************************************
9. FAQ / Troubleshooting
************************************************************
* The error "Cannot find Dinput8.dll" appears when launching the game.
You need to download DirectX 8.1. http://www.microsoft.com/directx
* StepMania reports "Direct3DCreate failed".
You need to download DirectX 8.1. http://www.microsoft.com/directx
* StepMania reports "Direct3DCreateDevice failed".
This error means that your video card or drivers do not support Direct3D 8.
Download the latest drivers for your video card. If your video card is older
than 2 or 3 years, Direct3D 8 drivers may not be available. Sorry.
* Music rates of over 100% do not work on my computer. Why?
Some very old sound cards do not support sound playback rates that are greater
than the original sample rate. This problem is likely to be corrected by newer
sound card drivers.
* Im looking to purchase a video card. What works well with StepMania?
Just about any video card manufactured in the last year will run StepMania
flawlessly at 60 frames per second. I recommend any card with an nVidia
GeForce chip or an ATI Radeon chip.
* How can I improve performance with my existing video card
1. Install the latest drivers for your video card.
2. Press F5 in the game to toggle between high detail and low detail modes.
3. Tweak the Display Resolution and Texture Resolution setting in the GameOptions
screen.
* Chris, will you tell me when the next version will be released?
I'd rather not going to say. Sorry. It's gotten me in trouble before.
* Why won't you tell me? I promise I won't tell anyone else.
The reason I won't tell is because I don't know yet and I don't want to make
anyone angry if it takes longer than I expect (it usually does).
************************************************************
10. StepMania Packages - .smzip
************************************************************
The StepMania package format was created to make the distribution of songs and
other add-ons very easy.  StepMania package files have the extension '.smzip'
and can be installed by double-clicking the .smzip file.
A StepMania package is 'installed' by extracting all files in the package to the
StepMania program directory. This allows songs, courses, themes, and
visualizations to all be installed by the Package Manager.
The file format of an .smzip file is actually the PK-Zip standard.  This means
you can rename any .smzip file to have the extension '.zip', and then open the
file in any compression package (e.g. WinZip).
The StepMania Package Manager (smpackage.exe) can also create song packages
for you. Simply launch the Package Manager
(Start Menu->Programs->StepMania->Package Manager), click the song you want to
create a package for, click the Export button, and a .smzip package will be
placed on your desktop.
************************************************************
11. Questions, Bugs, Suggestions, and Help
************************************************************
If you have a question or problem about StepMania, please try asking your
question to the StepMania message board. A link is available from the StepMania
web site - http://www.stepmania.com.
If you have found a bug, please file a bug report into the SourceForge bug
tracking system (http://sourceforge.net/tracker/?group_id=37892&atid=421366).  
This will allow the developers to track and fix bugs much more efficiently.  
* In a bug report, please specify your video card brand and model, and your OS
version.
* PLEASE, PLEASE enter your e-mail address on the bug reports. In many cases,
we need more information from the bug reporter.
Please use SourceForge's feature request system to enter new feature requests
(http://sourceforge.net/tracker/?atid=421369&group_id=37892&func=browse). Also,
please discuss feature ideas on the StepMania message board or the StepMania
developers list ([email protected]).  
If you would like to help with development of StepMania, please send an email
to the StepMania developers list ([email protected]) or to Chris
([email protected]).
************************************************************
12. The StepMania editor
************************************************************
The StepMania editor allows you to edit, record, synchronize, and play back
note patterns. Current, it support saving only in the .SM format. If you save
a song that was originally in DWI or BMS format, the old DWI and BMS files will
be renamed to have ".old" appended to avoid conflicts when the song is next
loaded. All of the commands are listed along the left side of the screen.
************************************************************
13. The .SM file format
************************************************************
The .SM song file format was created to be one file format that supports all
game types that StepMania can play (dance, pump, beat, guitar, etc). The .SM
file syntax is identical to DWI except for some different tags and meanings.
These are a list of all supported tags.
All images can be in png, gif, jpg, or bmp format. All sounds can be in ogg,
mp3, or wav format.
#TITLE:...; - The "main title" of the song.
#SUBTITLE:...; - This text will appear underneath the main title of the song
on the Select Music screen. e.g. "-Dirty Mix-", "(remix)".
#ARTIST:...; - The artist of the song.
#CREDIT:...; - Give yourself some credit here for creating a wonderful song.
#BPM:...; - BPM of the music
#BANNER:...; - The file name of the banner image. e.g. "b4u-banner.png".
This image must reside in the song folder.
#BACKGROUND:...; - The file name of the background image. e.g. "b4u-bg.png".
This image must reside in the song folder.
#CDTITLE:...; - The file name of the spinning CD logo. e.g. "b4u-cdtitle.png".
This image must reside in the song folder.
#MOVIEBACKGROUND:...; - The file name of the a background movie. e.g. "b4u-movie.avi".
This movie must reside in the song folder.
#MUSIC:...; - The file name of the music file. e.g. "b4u.mp3". This image
must reside in the song folder.
#MUSICBYTES:...; - The size in bytes of the music file that this song was last
synchronized with. A "Song may be out of synch" warning will be displayed if
the value of this tag does not match the actual size of the music file.
#OFFSET:...; - The time in seconds at which beat 0 occurs in the music. This
is specified as a floating point value. e.g. "2.34".
#SAMPLESTART:...; - The time in seconds to start the music sample that plays
on the Select Music screen. This is specified as a floating point value. e.g.
"32.34".
#SAMPLELENGTH:...; - The time in seconds let the sample music play after
starting. This is specified as a floating point value. e.g. "32.34". Note
that in the last 1 second of playing the music will fade out.
#BPMS:...; - A value of the format "beat=bpm". Indicates that at 'beat', the
speed of the arrows will change to "bpm". Both of these values are specified
as floating point values. You must specifiy a BPM value for beat 0. Multiple
BPMs can be given by separating them with commas. e.g. "0=160,120=80".
#STOPS:...; - A value of the format "beat=sec". Indicates that at 'beat',
the motion of the arrows should stop for "sec" seconds. Both of these values
are specified as floating point values. Multiple stops can be given by
separating them with commas. e.g. "60=2.23,80=1.12".
#ANIMATIONS:...; - A value of the format "beat=anim name". Indicates that at 'beat',
the background animation should change to the animation names 'anim name'. 'beat'
is a floating point value and 'anim name' is a string. Different animation change
are separated by commas. e.g. "60=falling,80=flower".
Each pattern of steps for different modes have the same basic format:
#NOTES:<NotesType>:<Description>:<DifficultyClass>:<DifficultyMeter>:<RadarValues>:<NoteData>;
NotesType: Must be one of the currently supported types in StepMania:
"dance-single", "dance-double", "dance-couple", "dance-solo", "pump-single",
"pump-double".
Description: This will be displayed on the gameplay screen. This can be any
text, but is most commonly "Basic", "Another", "Trick", "Standard", "SSR",
"Maniac", "Heavy", or "Challenge".
DifficultyClass: This value must be "easy", "medium", or "hard". These values
correspond the levels of difficulty on the Select Difficulty screen.
DifficultyMeter: The difficulty of these notes as a bar rating. The value must
be an integer between 1 and 10.
RadarValues: The values that will be displayed on the Groove Radar as floats
between 0.00 and 1.00. The 5 values must be separated by commas, and are
specified in the order: "stream,voltage,air,freeze,chaos". For MAX300, these
values are "0.95,0.98,0.22,0.12,0.13". These values will automatically be
written when you save the song in the StepMania editor, but you may edit the
.SM file afterward to tweak them.
NoteData: This value requires a longer explanation. The format is pretty
similar to that used in KSF files.
Each note is represented by a character:
1 = a regular "tap note"
2 = beginning of a "hold note"
3 = end of a "hold note"
a-z,A-z = reserved for game types that have sounds associated with notes
Notes are grouped into rows. The number of notes in a row depends on the
NotesType field.
dance-single = 4 notes/row
dance-double = 8 notes/row
dance-couple = 8 notes/row
dance-solo = 6 notes/row
pump-single = 5 notes/row
pump-double = 10 notes/row
For example, a note row for a dance-single pattern may look like "1001" (press
Left and Right simultaneously. A note row for a dance-double pattern may look
like "10010000" (press Left and Right simultaneously on the left pad).
Note rows are grouped into measures. The number of note rows in a measure will
determine the time value of each note. For example, if there are 4 note rows
in a measure, each note will be treated as a quarter note. If there are 8 notes
rows in a measure, each note will be treated as a eighth note. If there are 12
notes rows in a measure, each note will be treated as a triplet note. Measures
are separated by a comma.
Example:
// measure 1
2010
0000
0100
0000
: // measure 2
0001
0100
0001
0000
3010
0000
0000
0000
;
************************************************************
14. Background Animations
************************************************************
\BGAnimations\<anim folder>\<layer files>
The BGAnimations folder should contain several folders for individual background animations. Currently, these background animations cycle in order of their folder names, changing every 4 measures of the song.
In an animation folder, each sprite represents one layer. Multiple layers can be specified by having multiple sprites. Layers are drawn from back to front in order of their file name. Different "layer effects" are specified by adding tokens to the file name. Here are an explanation of the currently supported tokens:
usesongbg - Use the song's background file instead of this graphics file. Since this graphics file will not be used, you might want to make this graphic a 1x1 graphic to save space.
add - use additive blending instead of normal blending.
cyclecolor - cycle the color of the layer over the colors of the rainbow
cyclealpha - cycle the alpha channel of the layer over type
startonrandomframe - Start the animation on a random frame. This is mainly useful for Tile or Particle effects.
dontanimate - Stay on the first frame of this animation. This is only useful for layers with multiple frames.
(stretch effects) - These scretch the graphic across the extire screen.
scretchscrollleft,
stretchscrollright,
stretchscrollup,
stretchscrolldown,
- Scroll the layer in a direction
stretchwater,
stretchbubble,
stretchtwist,
stretchspin,
- Deform the background sprite with an effect. Only stretch spin is currently implemented.
(particle effects) - Use the graphic to make individual particles on the screen.
particlesspiralout,
particlesspiralin,
- Spiral particles away from/toward the center of the screen.
particlesfloatup,
particlesfloatdown,
particlesfloatleft,
particlesfloatright,
- Scroll the particles across the screen.
particlesbounce,
- Particles start traveling in random directions and bounce when they hit the edge of the screen.
(tile effects) - Tile the graphics across the screen, forming a grid of graphics.
tilestill,
tilescrollleft,
tilescrollright,
tilescrollup,
tilescrolldown,
- Scroll the tiles
tileflipx,
tileflipy,
- Flip the tiles along the X or Y axis.
tilepulse,
- Tiles zoom in and out.
************************************************************
15. The .CRS File Format
************************************************************
Place holder...
Header section...
#COURSE:...; - name of the course
#LIVES:<0..10>; - An integer between 0 and 10. This line is optional.
#REPEAT:<YES|NO>; - start over after last stage?
#SONG:<group folder>\<song folder>:<description>[:modifiers]; -
group folder - The name of the folder that contains the song folder.
song folder - the name of the folder that contains files for the song
description - BASIC, TRICK, SSR, MANIAC, HEAVY, etc.
modifiers - One or more of:
0.5x, 0.75x, 1.5x, 2.0x, 3.0x, 4.0x, 5.0x, 8.0x
boost, wave, drunk, dizzy, space, mini
hidden, sudden, stealth
mirror, left, right, shuffle
little
reverse
note, flat, plain
noholds
nofreeze
dark
norecover, suddendeath, power-drop, death
0.7xmusic, 0.8xmusic, 0.9xmusic, 1.0xmusic, 1.1xmusic,
1.2xmusic, 1.3xmusic, 1.4xmusic, 1.5xmusic
************************************************************
16. Improving Image Quality with Texture Hints
************************************************************
All are textures loaded by StepMania are 16-bits. The default the texture
format is 4444 (4 bits for R,G,B, 4 bits for alpha), which can cause some
banding artifacts or a washed-out look. You can change the texture format by
adding "hints" to the file name. Hints:
"no alpha" - This will force a 5650 texture format (5 bits for R, 6 for G, 5
for B, 0 for alpha). 5650 textures cannot have transparency, but have much
better color fidelity.
"1 alpha" - This will force a 5551 texture format. If your graphic has only
"on or off" alpha (like a GIF file), use this hint for better color fidelity.
"dither" - This will dither an image upon load. Dithering will reduce banding,
but can cause transparency artifacts.
Hints can be placed anywhere in the file name, but are usually placed at the
end of a file name in parenthesis. For example:
caution (dither, no alpha).png
Arrows Left 1x4 (1 alpha).png
************************************************************
17. Creating a StepMania announcer pack
************************************************************
************************************************************
18. Creating a StepMania theme pack
************************************************************
************************************************************
19. Building StepMania from CVS source
************************************************************
CVS is the repository that manages the StepMania source code. Our CVS server is
graciously provided by SourceForge. You can get the absolute-latest bleeding
edge updates to StepMania by taking the source from CVS. Below are instructions
on how to configure your computer to download source code from CVS and complile
the source into a working executable.
* Step 1: Install and configure Visual C++
The StepMania source can currently be built with Microsoft Visual C++ 6.0 or
Visual C++ .Net. Installing Visual C++ or Visual Studio with all the default
options is sufficient.
* Step 2: Install the Direct X 8.1 SDK
The DirectX 8.1 SDK is a free (but large) download from Microsoft (link here).
Install it using all the default settings. The SDK installer will configure
Visual C++ with the correct paths needed to find the DirectX 8.1 libraries and
headers.
* Step 3: Install WinCVS
A CVS client is required to "checkout" the course from the CVS server. Download
version 1.2 of WinCVS here - http://www.cvsgui.org.
IMPORTANT: Now, open and close WinCVS once. This will cause WinCVS to create
registry entries, which is required for the next step...
* Step 4: Use SourceForge Setup to install SSH and configure WinCVS
A small utility called SourceForge Setup will greatly simplify the steps needed
to configure SSH and WinCVS. Download SourceForge Setup here - link here. Use
the following settings when prompted by SF Setup:
- Unpack SSH directory: c:\ssh
- SSH install direcotory: c:\ssh
- Your home directory: c:\ssh
- Your SourceForge user name: -yourusername-
- Name of the project: stepmania
- The directory where you will be keeping checked out project sources:
c:\stepmania
IMPORTANT: If you are using Windows 2000 or Windows XP SourceForge Setup will
not correctly write changes to the c:\autoexec.bat file. Verify that the
following lines are present after you run SF Setup:
rem SourceForge setup stuff
SET PATH=%PATH%;c:\ssh
SET HOME=c:\ssh
IMPORTANT: You must restart after running SF Setup so that the new environment
variables take effect.
* DONE! Enjoy staying on the bleeding edge of StepMania releases! 
************************************************************
20. Version History
************************************************************
------------------------CVS after 3.00 beta 5----------------
OPTIMIZATION: Much faster song loading.
BUG FIX: New hashing algorithm prevents multiple songs from hashing to the same
cache file.
BUG FIX: "Select Group" screen now only displays songs and groups available in
the current style (instead of all songs).
BUG FIX: Opening a "(NEW)" sequence in Edit/Record/Synch mode with a style
over 4 panels (such as dance-solo or ez2-single) now works.
BUG FIX: Oni life meter finished.
NEW FEATURE: Theme support. See readme for more info.
BUG FIX: Stop times now read correctly again in BMSs.
BUG FIX: #SOLO steps in DWIs now read correctly.
OPTIMIZATION: Startup time greatly reduced thanks to hiding the log window and
SM parsing optimizations
CHANGE: Display resolution and max texture size sliders re-enabled
NEW FEATURE: Refresh rate slider
NEW FEATURE: 0.5x, 0.75x scroll speed
NEW FEATURE: Song rates up to 1.5X
NEW FEATURE: Effect Mini
CHANGE: Now hold L&R while pressing start to change sort on Select Music
CHANGE: Combo display now draws behind notes
BUG FIX: Stage counter reset after fail (thanks Andy)
BUG FIX: Roulette chooses from only last preferred group
BUG FIX: Fail End of Song setting doesn't get stuck at end of song.
CHANGE: Back button must now be held for 1/2 a second to prevent accidental presses.
BUG FIX: No more slowdown when song background showing song background (I think).
BUG FIX: Fixed clipping problems related to scroll speed
BUG FIX: Hold notes no longer jitter at certain scroll speeds
NEW FEATURE: During gameplay: F8 = toggle AutoPlay
NEW FEATURE: During gameplay: F9 = decrease offset, F10 = increase offset,
NEW FEATURE: During gameplay: F11 = decrease BPM of current segment, F12 =
increase BPM of current segment.
NEW FEATURE: After changing Offset or BPM during gameplay, I prompt will appear
at the end of the stage or course asking if you want to save changes.
Chosing cancel will revert to the pre-modified values.
CHANGE: Life meters graphics are now part of the theme system
CHANGE: New Song Option: Choose Oni life battery or normal life meter
BUG FIX: Life Bar no-recover and sudden death options now work.
BUG FIX: Select Difficulty arrow no longer messed up on early input
BUG FIX: Fixed scoring inaccuracies in Oni
NEW FEATURE: Endless, next to Oni Nonstop
BUG FIX: Inaccurate earned Chaos radar values fixed
BUG FIX: Score multiplier now based on note number and not current combo size.
This change causes higher, but MAX2-accurate scores.
NEW FEATURE: KSF file reading. Just drop the KSF folders into a group folder.
NEW FEATURE: Pump It Up support
NEW FEATURE: Life Difficulty option - this option determines how much the life
meter changes when steps are judged. This option corresponds to Difficulty in
DDR Arcade machines.
CHANGE: Old difficulty option renamed to Judge Difficulty.
NEW FEATURE: MenuInput option. Setting this option to "USE ONLY DEDICATED MENU
BUTTONS" will allow the menus to be controlled only by the buttons mapped to
MenuLeft, MenuRight, etc. This is useful if you have a controller with
buttons that can be dedicated to controlling the menus (like a DDR arcade
cabinet). Also, using only dedicated menu buttons will allow you to enter
codes at the Select Music screen using the dance panels.
NEW FEATURE: Random background movies. Put a bunch of movies in RandomMovies and
change the BackgroundMode setting in Game Options to "RANDOM MOVIES".
CHANGE: Made folders for DWI-style CDTitles and DWI-style Music.
BUG FIX: Fixed more HoldNote drawing ugliness.
BUG FIX: Hidden and Sudden now work with Reverse.
BUG FIX: Group names are now correct when using the SongFolders option
BUG FIX: No longer crashes in Select Group with > 15 groups
NEW FEATURE: PlayerOptions and SongOptions displays on the Select Music screen.
BUG FIX: Extra stage actually works! Props to Bruno for all of his help with this.
You can manually specify extra stage 1 and 2 by creating a .CRS files in the
group folder called extra1.crs and extra2.crs. These courses must contain
exactly one valid song. Don't forget to specify modifiers - see the CRS File
Format section in the readme for more information. If a CRS file is not found
or is invalid, the program will choose approprite Song/Notes/Options.
BUG FIX: Browsing past a song that don't have notes for some Difficulties will not
change your preferred difficulty.
BUG FIX: TurnMirror, TurnLeft, and TurnShuffle now work. TurnRight does the same
thing is as TurnLeft temporarily.
NEW FEATURE: Demonstration plays after sitting idle at title screen.
------------------------Version 3.00 beta 4------------------
BUG FIX: Fixed crash entering Config Joy/Key (duh!)
BUG FIX: Smarter bannner/backgroung/cdtitle discovery
NEW FEATURE: Supports reading CDTitles from the .\CDTitles folder (compatible
with DWI). Song makers are not encouraged to use this feature and instead should
put the CDTitle graphic in the song folder. Having a separate CDTitles folder
breaks the principle that all files needed to play a song should reside in the
song folder.
BUG FIX: Fixed "D3DCreateTextureFromFile" error. This happend a lot on a Voodoo3
and Win98.
BUG FIX: Fixed "Divide by 0"/"Access Violoation" when loading a song - I think.
OPTIMIZATION: Faster loading at "Nth Stage" screen.
------------------------Version 3.00 beta 3------------------
BUG FIX: Fixed crash BemaniRuler's "Connected"
BUG FIX: #BPMCHANGE in DWI files now read fractional values (BemaniRuler's Naturally)
BUG FIX: Dizzy works correctly again
BUG FIX: Subtitle extraction now works for "Dub-I-Dub" and "SP-Trip Machine"
BUG FIX: No longer crashes on Titles starting with '('
BUG FIX: Earlier scrolling for songs that have early notes (BMR's A)
BUG FIX: Inserted blank time for songs that have note right at end of song (AM-3P)
OPTIMIZATION: Faster loading of gameplay screen
BUG FIX: Sample music no longer studders on Select Music screen
BUG FIX: "Shaky" artifacts no longer appear while holding a hold note
CHANGE: Re-added support for movie visualizations (by popular demand).
NEW FEATURE: Movie backgrounds. Either specify with the "#MOVIEBACKGROUND" tag,
or the first movie file in the song directory will be used. Works with
BemaniRuler's background movies. Background movie will not play will not play
if BackgroundMode is set to "OFF".
NEW FEATURE: Song-specific animations. Place all animations in a folder called
"BGAnimations" within the song folder. See "13. The .SM file format" and
"14. Background Animations" in README-FIRST.txt for details.
CHANGE: Appearance Options now available from Title Menu. Here you can choose
the announcer and note skin.
------------------------Version 3.00 beta 2------------------
BUG FIX: Fixed crash when loading MAX2 files from ddrei.com
CHANGE: "JudgeWindow" option name changed to "Difficulty"
CHANGE: Initial difficulty made easier
BUG FIX: Song loading now smarter about how it picks banners, backgrounds,
and CDTitles. See readme "6. How StepMania Loads Songs" for details.
BUG FIX: #BPMS in SM files now read fractional values
NEW FEATURE: Background brightness (Game Options)
BUG FIX: BemaniRuler songs (like Pulse) now loaded correctly
BUG FIX: Stationary arrows don't press unless note is a hit
BUG FIX: Size of combo text capped to a reasonable level
BUG FIX: Song background now stretched correctly when used in a background animation
OPTIMIZATION: Reduced lag while starting music sample (Select Music screen)
NEW FEATURE: Menu Timer - accessable from Game Options
BUG FIX: Changes saved in editor now show up immediately (instead of after restart)
------------------------Version 3.00 beta 1------------------
NEW FEATURE: Roulette
NEW FEATURE: AutoPlay (selectable from Game Options screen)
NEW FEATURE: Read Delight BMS 0.5 (hold notes, freezes, and new BPM changes supported)
NEW FEATURE: Editor - edit, record, playback, and synchronize from one screen
NEW FEATURE: Oni Nonstop Challenge (not finished)
NEW FEATURE: "Judge Window" option to adjust difficulty of step judging
NEW FEATURE: Song data cache for faster loading.
NEW FEATURE: Groove Radar
NEW FEATURE: Dark Mode (selectable from Player Options screen)
NEW FEATURE (partially complete): Nonstop Challenge (Oni)
NEW FEATURE (partially complete): Pump It Up support
NEW FEATURE (partially complete): Background Animations (defaut animations go in
BGAnimations dir)
------------------------Version 2.90-------------------------
CHANGE: Ogg Vorbis music support re-enabled
NEW FEATURE: Note Skins (selectable from Player Options screen)
------------------------Version 2.50-------------------------
NEW FEATURE: New multi game compatible .sm file format.
CHANGE: "Graphic Detail" presets
BUG FIX: Installer DirectX check now works
NEW FEATURE: Aracde and Free Play game modes
------------------------Version 1.90-------------------------
OPTIMIZATION: Major speedup to BitmapText loading
CHANGE: Menus changes to accomodate MAX-style menus
CHANGE: Now compiles in Visual C++.Net
OPTIMIZATION: Max texture size and texture color options are now supported.
BUG FIX: Scaled sprite alignment (no more transparent strip along the edge of
"danger" static)
NEW FEATURE: Repeating input
NEW FEATURE: Select Group menu
NEW FEATURE: Edit / Record / Playback
NEW FEATURE: Support for DWI solo notes in DWI reader
------------------------Version 1.65-------------------------
BUG FIX: Statistics now save and load correctly
BUG FIX: Better framerate during gameplay
------------------------Version 1.64-------------------------
NEW FEATURE: Group banners on Select Music screen. Just put a banner in the group
folder.
BUG FIX: Hacked around a Savage texture loading bug.
CHANGE: Added "hold NEXT for options" after choosing a song. Most people don't know
about this feature!
CHANGE: Faster song loading
CHANGE: more accurate synching at song rates other than 100%
CHANGE: Assist tick calibrated automatically by detecting sound card play latency
CHANGE: Lowered wait time between menus
CHANGE: Improved loading time of sounds
BUG FIX: Improved quality of sounds while dancing
BUG FIX: Fixed DWI parsing error that often caused the last note to not appear
NEW FEATURE: More resolution presets in GameOptions menu
------------------------Version 1.63-------------------------
NEW FEATURE: Effects "drunk", "dizzy", "space"
CHANGE: Song sort by group now has collapsible sections
BUG FIX: Prefs, songs, and default mappings now load if StepMania.ini doesn't exist
BUG FIX: Pad 2 can now be used to navigate the title screen
BUG FIX: Crash if change sort while a section item was selected
BUG FIX: BPM changes to 0 when section is selected
BUG FIX: Pixel/Texel alignment bug causing a strip of color along right and bottom
edges moving between menus.
BUG FIX: Graphical glitches on Results screen
BUG FIX: Hold Steps now look better when Scroll Speed is > 1
BUG FIX: Wrong Ghost Arrow graphic being used
BUG FIX: Boost/Scroll Speed interaction is now like MAX
BUG FIX: DWI's with newlines before semicolon are no longer corrupt when saving
using Synchronize
BUG FIX: #516498 - Installing Stepmania Deletes records
BUG FIX: #517003 - Joystick mappings not flushed
BUG FIX: Multiple NEXT presses not allowed on Caution screen
NEW FEATURE: Skip Caution toggle
NEW FEATURE: Announcer toggle
BUG FIX: Arrows no longer jump back to time = 0 on fail or cleared
BUG FIX: #523621 - Turning on effects in Double (1.62)
BUG FIX: #521941 - Using pad to select songs acts weird
------------------------Version 1.62-------------------------
CHANGE: Can now press NEXT to skip Caution screen.
BUG FIX: Crash at "No music" prompt.
NEW FEATURE: Synchronize while dancing with '+', '-', "PgUp", "pgDn"
BUG FIX: DWI parsing no longer crashes on line with only a space
------------------------Version 1.61-------------------------
BUG FIX: Players' Best crowns not displaying.
BUG FIX: #506751 - "Assist" Ticks off-beat
BUG FIX: Crash switching sort
NEW FEATURE: Synchronize mode! Can write BMS and DWI formats.
------------------------Version 1.60-------------------------
BUG FIX: Inefficient use of memory in Select Music screen
OPTIMIZATION: No noticable loading time in Select Music
CHANGE: New grade graphics (thanks Parasyte!)
BUG FIX: 511184 - Battle mode not working
BUG FIX: 510557 - Result *** overlays result letter
BUG FIX: 510556 - Sound stops at Options Screen
BUG FIX: NG percentage is "-1%" if no Hold Steps
BUG FIX: #507861 - Multiple Enter on Song Wheel
BUG FIX: #507391 - Song Options menu fade errors
BUG FIX: #506820 - Select Style Versus Images
BUG FIX: #506746 - Difficulty Mix-Ups in Song Select
BUG FIX: #506597 - Empty Sort Crash
BUG FIX: #511543/#511186 - Visualizations not shown correctly
------------------------Version 1.59-------------------------
NEW FEATURE: More texture loading hints (DITHER, NO_MIP_MAPS) for increased
quality and faster loading time.
BUG FIX: #506274 Crash changing song after sorting.
BUG FIX: #506343 TextureColor=32 Auto-Reset
CHANGE: SMLauncher integrated with the main StepMania executable. Now the
pretty error screen will appear automatically.
NEW FEATURE: Added Low-Medium-High detail prompt to installer.
NEW FEATURE: Song sort order is now rememebered.
OPTIMIZATION: Instantaneous Song Sort Order switch.
OPTIMIZATION: Instantaneous Song Group expand/collapse.
CHANGE: Song Sort groups that begin with a number now appear under the "NUM"
group.
BUG FIX: "Player's Best" is now sorted by num times played decending
BUG FIX: #506835 - PREV from Song Select Fade Glitch
BUG FIX: #506827 - Song Selected Graphic Errors
------------------------Version 1.58-------------------------
NEW FEATURE: SMLauncher generates friendly error messages.
CHAGNE: Removed "NG" from Results screen.
BUG FIX: Statistics are now working, honest!
BUG FIX: 511544 - Grade Results Sometimes pops up NO DATA
OPTIMIZATION: Improved animation of and optimized drawing of rolling score display.
OPTIMIZATION: Toned down motion blur effect in "Failed" for increased performance.
BUG FIX: Fixed matrix stack bug that caused some shadows not to draw
OPTIMIZATION: Major optimization of BitmapText. Now about 2x faster.
NEW FEATURE: F4-F8: Toggle Fullscreen, Change Resolution, Change Display Color,
Change Texture Color, Toggle Statistics
NEW FEATURE: Remebers last selected Steps
NEW FEATURE: Stage number saved to .ini file.
BUG FIX: Default key buttons don't work if .ini file not present on startup
CHANGE: Hold Arrows are now drawn last to first, like in DDR MAX.
NEW FEATURE: Hold Arrows allow you to not hold the button for a second without
NG'ing them.
CHANGE: Regular Arrows on the same line as a Hold Arrow now appear green.
NEW FEATURE: Hold Arrows now turn gray player doesn't hold the button.
BUG FIX: #510980 Danger is a static box, not text
------------------------Version 1.57-------------------------
NEW FEATURE: smzip package installer and manager
CHANGE: Installer now uninstalls previous version.
BUG FIX: Package Manager now converts all non-HTTP-friendly characters to '_' when
exporting.
CHANGE: Much better texture loading algorithm. Texture quality and loading time of
non-power of 2 texture improved greatly.
CHANGE: New 5th Mix theme graphics. Thanks thingmabobr!
BUG FIX: #507170 Speed Problem (Got rid of "pauses" caused by buffered writing to
log)
BUG FIX: #506309 Installer doesn't overwrite files
BUG FIX: #511187 old banners are shown diagonal
------------------------Version 1.56-------------------------
BUG FIX: 506314 Fixed "Hall of mirrors" on nVidia cards (actually, just a work
around for a driver bug)
CHANGE: Couple and Solo now appear in Select Style
CHANGE: New Title Menu options (but you can choose them yet :-)
BUG FIX: Fixed jibberish at the top of Arial Bold font by shifting all letters
up one pixel
BUG FIX: 505896 Menu Problems [unreadable/illegible font?]
BUG FIX: Ugly textures with Voodoo3
BUG FIX: Ignore Joystick D-pad now works again.
BUG FIX: Installer-created icon "Open Songs Folder" now fixed for OSes that had
problems.
BUG FIX: BMS parse crash fixed.
BUG FIX: Player2 couldn't press up to select different steps
BUG FIX: Player2's side in StepsSelector no longer has multiple bouncing difficulty
icons
BUG FIX: 507380 Multiple FAILED with Esc presses
BUG FIX: 507860 - Esc in No Fail Mode = lock up
CHANGE: Improved response time to user input when change sort in SelectMusic
BUG FIX: Announcer no longer makes dancing comments while FAILED is showing.
OPTIMIZATION: Added texture alpha hints - significantly improved texture quality
for 16-bit textures.
------------------------Version 1.55-------------------------
BUG FIX: "4nd Stage" is now "4th Stage"
BUG FIX: 496315 ragescreen.cpp error for 16bit-only cards
BUG FIX: 500342 - wave volume changes to 100% on startup
BUG FIX: Fixed "visualization movie files go here" trying to be loaded as a texture
BUG FIX: Mini banner now tweens on and off screen
BUG FIX: MusicWheel now tweens off screen and Music comment plays
BUG FIX: Stage count not incremented until song is passed
CHANGE: Added longer delay before song start
CHANGE: Assist tick now louder and timing improved
CHANGE: cleaned up debug messages
OPTIMIZATION: Improved texture loading time
CHANGE: Maximize button no longer toggles fullscreen.
CHANGE: MusicWheel response to user input is improved
OPTIMIZATION: Preview in SelectMusic now uses banner instead of background for faster
loading
NEW FEATURE: Change resolution, display color depth, texture color depth, and toggle
texture filtering
NEW FEATURE: Check at startup time that all required theme elements are present
NEW FEATURE: installer
NEW FEATURE: motion blur "Failed" effect
NEW FEATURE: MusicWheel remembers previously selected song.
BUG FIX: Back from Result screen no longer leads to black screen
CHANGE: All documentation is now in "Docs" folder
CHANGE: New "Danger" animation
------------------------Version 1.50-------------------------
Bug fix: No longer crashes on foreign chars in BMS files. Please report all songs that
still cause a crash.
Change: Added sepatate background movie property to Song. Now status backgrounds will
display in SelectMusic if the Song has a movie background.
Change: Asset directory structure has completely changed in preparation for theme support.
Optimization: BitmapText is now ~80% faster.
New Feature: 5th Mix style SelectMusic and auto-generated text banners. Loads 100x faster
than the previous SelectSong screen.
Change: Error messages in Release builds no longer show source file line and number.
Bug Fix: Fade transition now fades all the way to black (doesn't leave a "hazy" screen).
Bug Fix: Multiple joysticks now work again.
-------------------------Version 0.97-------------------------
Bug fix: Songs with same title no longer change positions while scrolling.
Bug fix: Wrong group name for DWI files in the Songs folder.
Bug fix: Fixed a problem that caused the music to become out of sync if many sound
effect are played. This was causing the song to become out of sync near the end.
Note that this change makes the music much more accurate, and some BMS files may
be out of sync if they appeared in sync before.
Bug fix: Dancing waits 2 seconds before starting music playback. This allows some
slower systems to catch up.
Bug fix: Little now works correctly. It is accessible from the PlayerOptions menu.
Optimization: Lower priority for movie decoding, which is a major speed boost on
slower computers.
Change: Freeze arrow scoring now matches DDR MAX. The start of a freeze arrow is judged
as other steps are (perfect, great, good, etc).  Missing the start of a freeze will
should break your combo, but NG'ing the freeze arrow will not.
New feature: Basic song statistics tracking. Times played, top score, top combo, and
top grade are shown on SelectSong screen.
New feature: Assist tick, accessible from the SongOptions menu.
New feature: Music Rate, accessible from the SongOptions menu. You can speed up or
slow down the rate of music playback. Great for practicing hard step patterns.
New feature: Freeze arrow scores are now shown on the Results screen.
Change: Arrow ghost now appear different depending on the combo length (roughly matches
DDR MAX).
Change: Added some animation to the Results screen.
Change: Revamped input mapping to allow assignment and clearing of specific slots.
-------------------------Version 0.96b-------------------------
Change: Removed background movies showing in SelectSong (this was causing crashes).
Bug fix: No longer crashes when loading Max300 from DWI support directory.
Bug fix: Timing is now correct for freeze in Max300.
Bug fix: Freeze arrows now are correct in Mirror/Left/Right/Shuffle.
-------------------------Version 0.96-------------------------
Merry Christmas!
Changed the song directory structure to be backward compatible with 0.90 and 0.91.
-------------------------Version 0.95-------------------------
Bug fix: Sounds files with commas now load
Bug fix: Freezes in Telephone Operator are now correct
Bug fix: Nonsense help messages fixed
Bug fix: D3D init failure now opens browser to correct troubleshooting page
Optimization: Drawing of freeze arrows is much more efficient
Optimization: In SelectSong, only one preview graphic is drawn. This saves fill rate
and leaves room for group/sort/BPM text.
Change: DWI files now use the DWI directory structure. StepMania also automatically
crop and rotate the song banner. BMS files still reside in the Songs folder.
Change: Now hold Next to get to PlayerOptions and SongOptions menus (Previously, you
would hold Next to bypass these menus).
New feautre: FPS counter. Can toggle from GameOptions.
New feature: Disable joystick d-pad (for DirectPad Pro and NTPad).
New Feature: Song background movies
New Feature: random visualization movies
New feature: song groups by folder
New feature: song sorting by Title, BPM, and Artist
New: Caution screen to hide texture load time
New: Logo appears between screens as a keepalive indicator
-------------------------Version 0.91-------------------------
Bug fix: Good and Boo arrows not being drawn.
-------------------------Version 0.90-------------------------
-------------------------Version 0.50-------------------------
************************************************************
21. Thanks
************************************************************
Thanks to:
Dj Slash & Tony Thai for the caution graphic
Kyle "KeeL" Ward for his awesome menu music (www.ampcast.com/keel)
************************************************************
End of document
************************************************************