1253 lines
58 KiB
HTML
1253 lines
58 KiB
HTML
|
<html>
|
|||
|
|
<head>
|
|||
|
|
<meta http-equiv="Content-Language" content="en-us">
|
|||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|||
|
|
</head>
|
|||
|
|
|
|||
|
|
<body>
|
|||
|
|
|
|||
|
|
<p><font face="Courier New" size="2">StepMania X.X<br>
|
|||
|
|
©2001-2003, StepMania team, All rights reserved.<br>
|
|||
|
|
<a href="http://www.stepmania.com">http://www.stepmania.com</a></font></p>
|
|||
|
|
<p>
|
|||
|
|
<hr>
|
|||
|
|
<font face="Courier New" size="2"><a name="Table of Contents">Table of Contents</a></font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
<a href="#About StepMania">About StepMania</a><br>
|
|||
|
|
<a href="#Minimum Requirements">Minimum Requirements</a><br>
|
|||
|
|
<a href="#DirectX">DirectX</a> <br>
|
|||
|
|
<a href="#Installation">Installation</a> <br>
|
|||
|
|
<a href="#Controls">Controls</a><br>
|
|||
|
|
<a href="#How StepMania Loads Songs">How StepMania Loads Songs</a><br>
|
|||
|
|
<a href="#Connecting Dance Pads">Connecting Dance Pads</a> <br>
|
|||
|
|
<a href="#Compatibility Issues">Compatibility Issues</a><br>
|
|||
|
|
<a href="#FAQ / Troubleshooting">FAQ / Troubleshooting</a><br>
|
|||
|
|
<a href="#StepMania Packages - .smzip">StepMania Packages - .smzip</a><br>
|
|||
|
|
<a href="#Questions, Bugs, Suggestions, and Help">Questions, Bugs, Suggestions,
|
|||
|
|
and Help</a> <br>
|
|||
|
|
<a href="#The StepMania editor">The StepMania Editor</a><br>
|
|||
|
|
<a href="#The .SM file format">The .SM File Format</a><br>
|
|||
|
|
<a href="#Backgrounds">Backgrounds</a><br>
|
|||
|
|
<a href="#BGAnimations Format">BGAnimations Format</a><br>
|
|||
|
|
<a href="#The .CRS File Format">The .CRS File Format</a><br>
|
|||
|
|
<a href="#Extra Stages">Extra Stages</a><br>
|
|||
|
|
<a href="#Creating an Announcer">Creating an Announcer</a><br>
|
|||
|
|
<a href="#Creating a Note Skin">Creating a Note Skin</a><br>
|
|||
|
|
<a href="#Creating a Theme">Creating a Theme</a><br>
|
|||
|
|
<a href="#Actor Commands">Actor Commands</a><br>
|
|||
|
|
<a href="#ScreenSelect">ScreenSelect</a><br>
|
|||
|
|
<a href="#How StepMania Loads Textures">How StepMania Loads Textures</a><br>
|
|||
|
|
<a href="#Building StepMania from CVS source">Building StepMania from CVS Source</a><br>
|
|||
|
|
<a href="#Thanks">Thanks</a><br>
|
|||
|
|
<br>
|
|||
|
|
See the file <a href="NEWS">NEWS</a> for version history.<br>
|
|||
|
|
See the file <a href="COPYING.txt">COPYING.txt</a> for license information.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="About StepMania"><hr>About StepMania</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
StepMania is capable of playing many game types. Currently, it supports games
|
|||
|
|
similar to Dance Dance Revolution, Pump It Up, EZ 2 Dancer, and Para Para
|
|||
|
|
Paradise. In the future, it will support games similar to BeatMania, Guitar
|
|||
|
|
Freaks, DrumMania, and more.<br>
|
|||
|
|
<br>
|
|||
|
|
The games played by StepMania are rhythm games. Notes scroll up from the bottom
|
|||
|
|
of the screen, and the player must hit the corresponding button on the
|
|||
|
|
controller in time to the. All games can be played using the keyboard, but the
|
|||
|
|
real fun comes when using specially designed controllers, like a dance pad or
|
|||
|
|
hand sensors.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Minimum Requirements"><hr>Minimum Requirements</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
* Windows 98, Windows ME, Windows 2000, or Windows XP<br>
|
|||
|
|
* Pentium II, Pentium III, Celeron, Athlon, or compatible processor, 266MHz
|
|||
|
|
minimum (400 MHz recommended)<br>
|
|||
|
|
* 64 MB of RAM<br>
|
|||
|
|
* Video card that supports High Color (16-bit color) and has 16MB video RAM<br>
|
|||
|
|
* Video card with OpenGL drivers<br>
|
|||
|
|
* DirectX 8.1 compatible sound card with drivers<br>
|
|||
|
|
* DivX 5 video codec for movie visualizations (www.divx.com)<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="DirectX"><hr>DirectX</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
DirectX 8.0 is required before installing StepMania. If DirectX 8.0 is not
|
|||
|
|
installed on your computer, the StepMania installer will display a warning and
|
|||
|
|
abort the installation.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Installation"><hr>Installation</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
To install StepMania, download the file stepmania300.exe to a known location on
|
|||
|
|
your hard drive, then double-click the file icon to begin the installation. The
|
|||
|
|
installer may prompt you to remove an older version of the program if one is
|
|||
|
|
present. The default installation directory is 'C:\Program Files\StepMania'.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Controls"><hr>Controls</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
Use the "Config Key/Joy" option from the Title Menu to configure your keyboard,
|
|||
|
|
dance pad, or other game controller. This menu allows you to map up to 2
|
|||
|
|
keyboard/joystick buttons to each function in the game. The third column is the
|
|||
|
|
default key mapping, and cannot be changed. However, you can override a
|
|||
|
|
default keyboard key by simply assigning it to another function. The mappings
|
|||
|
|
for player 1 are on the left half of the screen, and the mapping for player 2
|
|||
|
|
are on right half.<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
The following is a list of special keys:<br>
|
|||
|
|
<br>
|
|||
|
|
Any time:<br>
|
|||
|
|
* F1 = insert coin for player 1<br>
|
|||
|
|
* F2 = insert coin for player 2<br>
|
|||
|
|
* Alt-Enter or F4 = toggle fullscreen<br>
|
|||
|
|
* F5 = take screenshot (saves to program directory as "screenNNNN.bmp")<br>
|
|||
|
|
* Hold Tab = increase game speed 4x (useful for moving through menus quickly)<br>
|
|||
|
|
* Hold Tilde (~) = decrease game speed to 1/4x<br>
|
|||
|
|
<br>
|
|||
|
|
In menus:<br>
|
|||
|
|
* Arrow keys navigate menus<br>
|
|||
|
|
* Enter = Start<br>
|
|||
|
|
* Escape = Back<br>
|
|||
|
|
<br>
|
|||
|
|
In any attract screen:<br>
|
|||
|
|
* Left or Right = next attract screen<br>
|
|||
|
|
* F3 = toggle CoinMode<br>
|
|||
|
|
<br>
|
|||
|
|
In title menu:<br>
|
|||
|
|
* Escape = return to attract sequence<br>
|
|||
|
|
<br>
|
|||
|
|
In gameplay:<br>
|
|||
|
|
* F6 = toggle AutoSync mode<br>
|
|||
|
|
* F7 = toggle assist tick<br>
|
|||
|
|
* F8 = toggle AutoPlay<br>
|
|||
|
|
* F9 = decrease offset<br>
|
|||
|
|
* F10 = increase offset<br>
|
|||
|
|
* F11 = decrease BPM of current segment<br>
|
|||
|
|
* F12 = increase BPM of current segment<br>
|
|||
|
|
* Hold Escape = abort playing<br>
|
|||
|
|
<br>
|
|||
|
|
In editor:<br>
|
|||
|
|
* Escape = menu<br>
|
|||
|
|
* Up/Down = prev/next line<br>
|
|||
|
|
* Left/Right = change snap<br>
|
|||
|
|
* 1 through 0 = add/remove note<br>
|
|||
|
|
* Enter - Set selection begin marker<br>
|
|||
|
|
* Space - Set selection end marker<br>
|
|||
|
|
* P - Play back current selection (if no selection, play whole song)<br>
|
|||
|
|
* R - Record over current selection (if no selection, record whole song)<br>
|
|||
|
|
<br>
|
|||
|
|
In the music select screen:<br>
|
|||
|
|
* F9 = Toggle title translations<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="How StepMania Loads Songs"><hr>How StepMania Loads Songs</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
All files for a specific song (data file, music file, banner, background) must
|
|||
|
|
reside in a single folder. This folder must have the following path:<br>
|
|||
|
|
<br>
|
|||
|
|
Songs/<group folder>/<song folder>/<br>
|
|||
|
|
<br>
|
|||
|
|
For example, the song B4U may consist of the following files:<br>
|
|||
|
|
<br>
|
|||
|
|
Songs/Dance Dance Revolution 4th Mix/B4U/b4u.dwi<br>
|
|||
|
|
Songs/Dance Dance Revolution 4th Mix/B4U/b4u.mp3<br>
|
|||
|
|
Songs/Dance Dance Revolution 4th
|
|||
|
|
Mix/B4U/b4u-banner.png<br>
|
|||
|
|
Songs/Dance Dance Revolution 4th Mix/B4U/b4u.png<br>
|
|||
|
|
Songs/Dance Dance Revolution 4th
|
|||
|
|
Mix/B4U/b4u-movie.avi<br>
|
|||
|
|
<br>
|
|||
|
|
StepMania supports the SM, DWI, BMS, and KSF song file formats. If the song file
|
|||
|
|
format is BMS or KSF, simply put all the KSF or BMS files into the song folder.<br>
|
|||
|
|
<br>
|
|||
|
|
If a song file does not specify a valid banner file, StepMania first looks for a
|
|||
|
|
graphic in the song folder that contains the word "banner". If that search
|
|||
|
|
fails, StepMania will guess which image is most appropriate.<br>
|
|||
|
|
<br>
|
|||
|
|
If a song file does not specify a valid background file, StepMania first looks
|
|||
|
|
for a graphic in the song folder that contains the words "bg" or "background".
|
|||
|
|
If that search fails, StepMania will guess which image is most appropriate.<br>
|
|||
|
|
<br>
|
|||
|
|
If a song file does not specify a valid CDTitle file, StepMania will look for a
|
|||
|
|
graphic in the song folder that contains the words "cdtitle". If that search
|
|||
|
|
fails, StepMania will guess which image is most appropriate.<br>
|
|||
|
|
<br>
|
|||
|
|
If there is exactly one movie in the song folder, StepMania will insert a
|
|||
|
|
background change to that movie at beat 0.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Connecting Dance Pads"><hr>Connecting Dance Pads</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
There are several devices that allow you to connect PlayStation dance pads to
|
|||
|
|
your PC.<br>
|
|||
|
|
<br>
|
|||
|
|
* Not recommended: generic PlayStation->USB converter <br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
* Highly Recommended: specific brands of PlayStation->USB adaptor<br>
|
|||
|
|
<br>
|
|||
|
|
There is just one brand of PlayStation->USB adaptor that functions perfectly
|
|||
|
|
with StepMania. These adaptors are available for purchase 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.<br>
|
|||
|
|
<br>
|
|||
|
|
* Semi-Recommended: PlayStation->Parallel adaptor<br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
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
|
|||
|
|
is NTPad XP 1.x or PSXPAD. For the latest versions of these drivers, visit
|
|||
|
|
<a href="http://www.aldostools.com/dpad.html">Aldo's Tools</a>.<br>
|
|||
|
|
<br>
|
|||
|
|
StepMania now natively supports USB Pump It Up pads.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Compatibility Issues"><hr>Compatibility Issues</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
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:<br>
|
|||
|
|
<br>
|
|||
|
|
* <a name="Voodoo3">Voodoo 3</a><br>
|
|||
|
|
Blah<br>
|
|||
|
|
<br>
|
|||
|
|
* nVidia Geforce cards<br>
|
|||
|
|
Symptom: Extremely low framerates.<br>
|
|||
|
|
Fix: Ensure "Enable conformant OpenGL texture clamp behavior" is NOT CHECKED
|
|||
|
|
in advanced display settings.<br>
|
|||
|
|
<br>
|
|||
|
|
* S3 Savage family cards (e.g. Diamond Stealth)<br>
|
|||
|
|
Symptom: The right edge of some graphics appears "cut off".<br>
|
|||
|
|
Explanation: Drivers do not properly handle textures >= 512x512, resulting in
|
|||
|
|
cropped textures. Turn the texture detail option to 256 to force textures to a
|
|||
|
|
smaller size.<br>
|
|||
|
|
<br>
|
|||
|
|
* SiS cards <br>
|
|||
|
|
Symptom: Garbled fonts.<br>
|
|||
|
|
Explanation: Drivers have errors in handling texture coordinates. Only known
|
|||
|
|
solution is to upgrade drivers.<br>
|
|||
|
|
<br>
|
|||
|
|
* Any card older than two years<br>
|
|||
|
|
Symptom: Various graphical glitches.<br>
|
|||
|
|
Explanation: These problems are most often caused by buggy video card drivers
|
|||
|
|
bugs. Please upgrade to the latest drivers, which will hopefully fix the errors.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="FAQ / Troubleshooting"><hr>FAQ / Troubleshooting</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
* The error "Cannot find Dinput8.dll" appears when launching the game.<br>
|
|||
|
|
<br>
|
|||
|
|
You need to download DirectX 8.1. http://www.microsoft.com/directx<br>
|
|||
|
|
<br>
|
|||
|
|
* I’m looking to purchase a video card. What works well with StepMania?<br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
* How can I improve performance with my existing video card<br>
|
|||
|
|
<br>
|
|||
|
|
1. Install the latest drivers for your video card.<br>
|
|||
|
|
2. Press F5 in the game to toggle between high detail and low detail modes.<br>
|
|||
|
|
3. Tweak the Display Resolution and Texture Resolution setting in the
|
|||
|
|
Options->Graphic Options screen.<br>
|
|||
|
|
<br>
|
|||
|
|
* Will you tell me when the next version will be released?<br>
|
|||
|
|
<br>
|
|||
|
|
Nope, Sorry. It's gotten me in trouble before.<br>
|
|||
|
|
<br>
|
|||
|
|
* Why won't you tell me? I promise I won't tell anyone else.<br>
|
|||
|
|
<br>
|
|||
|
|
The reasons I won't tell is because: a) I don't know yet, and b) I don't want to
|
|||
|
|
make anyone angry if it takes longer than expected (it usually does).<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="StepMania Packages - .smzip"><hr>StepMania Packages - .smzip</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
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 application (e.g. WinZip, WinRAR).<br>
|
|||
|
|
<br>
|
|||
|
|
The StepMania Package Exporter (smpackage.exe) can create packages of your song,
|
|||
|
|
announcers, themes, or other add-ons. Simply launch the Package Exporter (Start
|
|||
|
|
Menu->Programs->StepMania->Package Exporter), click the items you would like to
|
|||
|
|
make into a package, then click the one of the Export buttons. "Export as One"
|
|||
|
|
will take all of the selected items and make one package that contains them all.
|
|||
|
|
"Export Individual" will create one separate package for each selected item in
|
|||
|
|
the list.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Questions, Bugs, Suggestions, and Help"><hr>Questions, Bugs, Suggestions,
|
|||
|
|
and Help</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
If you have a question about or problem with StepMania, please first ask your
|
|||
|
|
question a StepMania message board. For a list of StepMania message boards, see
|
|||
|
|
the <a href="http://www.stepmania.com">web site</a>.<br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
* In a bug report, please specify your video card brand and model, and your OS
|
|||
|
|
version (Win98, WinXP, etc).<br>
|
|||
|
|
* PLEASE, PLEASE enter your e-mail address on the bug reports. In many cases, we
|
|||
|
|
need more information from the bug reporter.<br>
|
|||
|
|
<br>
|
|||
|
|
Please use
|
|||
|
|
<a href="http://sourceforge.net/tracker/?atid=421369&group_id=37892&func=browse">
|
|||
|
|
SourceForge's feature request system</a> to enter new feature requests. Also,
|
|||
|
|
please discuss feature ideas on the
|
|||
|
|
<a href="http://www.ddrmaniax.net/ddrmaniax/boards/index.php?act=SF&f=17">
|
|||
|
|
StepMania message board</a> or the
|
|||
|
|
<a href="mailto:[email protected]">StepMania developers list</a>. <br>
|
|||
|
|
<br>
|
|||
|
|
If you would like to help with development of StepMania, please send an email to
|
|||
|
|
the <a href="mailto:[email protected]">StepMania developers list</a>
|
|||
|
|
or to <a href="mailto:[email protected]">Chris</a>.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="The StepMania editor"><hr>The StepMania editor</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
The StepMania editor allows you to edit, record, synchronize, and play back note
|
|||
|
|
patterns. When you choose 'Save', your song will be saved in both the .SM format
|
|||
|
|
and the DWI format for use in Dance With Intensity. If you save a song that was
|
|||
|
|
originally in the BMS or KSF format, the old files will be appended with ".old",
|
|||
|
|
and a new .SM file will be written with your new song data.<br>
|
|||
|
|
<br>
|
|||
|
|
Following are a few basic commands that you will find useful in learning to use
|
|||
|
|
the editor:<br>
|
|||
|
|
<br>
|
|||
|
|
* Escape = menu<br>
|
|||
|
|
* Up/Down = prev/next line<br>
|
|||
|
|
* Left/Right = change snap<br>
|
|||
|
|
* 1 through 0 = add/remove note<br>
|
|||
|
|
* Enter - Set selection begin marker<br>
|
|||
|
|
* Space - Set selection end marker<br>
|
|||
|
|
* P - Play back current selection (if no selection, play whole song)<br>
|
|||
|
|
* R - Record over current selection (if no selection, record whole song)<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="The .SM file format"><hr>The .SM file format</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
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 syntax
|
|||
|
|
of a .SM is similar to .DWI and .KSF except that some tags are different.<br>
|
|||
|
|
<br>
|
|||
|
|
Note that StepMania can load images in PNG, GIF, PJG, and BMP formats, and
|
|||
|
|
can load sounds in OGG, MP3, and WAV formats.<br>
|
|||
|
|
<br>
|
|||
|
|
Any text field in an SM file can contain UTF-8 characters.<br>
|
|||
|
|
<br>
|
|||
|
|
#TITLE:...; - The "main title" of the song.<br>
|
|||
|
|
#SUBTITLE:...; - This text will appear underneath the main title of the song on
|
|||
|
|
the Select Music screen. e.g. "~Dirty Mix~" or "(remix)".<br>
|
|||
|
|
#ARTIST:...; - The artist of the song.<br>
|
|||
|
|
#TITLETRANSLIT:...; - Transliteration of song's main title for sorting<br>
|
|||
|
|
#SUBTITLETRANSLIT:...; - Transliteration of song's sub title for sorting<br>
|
|||
|
|
#ARTISTTRANSLIT:...; - Transliteration of the artist of the song<br>
|
|||
|
|
#CREDIT:...; - Give yourself some credit here for creating a wonderful song.<br>
|
|||
|
|
#BANNER:...; - The file name of the banner image. e.g. "b4u-banner.png". This
|
|||
|
|
image must reside in the song folder.<br>
|
|||
|
|
#BACKGROUND:...; - The file name of the background image. e.g. "b4u-bg.png".
|
|||
|
|
This image must reside in the song folder.<br>
|
|||
|
|
#CDTITLE:...; - The file name of the spinning CD logo. e.g. "b4u-cdtitle.png".
|
|||
|
|
This image must reside in the song folder.<br>
|
|||
|
|
#MUSIC:...; - The file name of the music file. e.g. "b4u.mp3". This image must
|
|||
|
|
reside in the song folder.<br>
|
|||
|
|
#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".<br>
|
|||
|
|
#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".<br>
|
|||
|
|
#SAMPLELENGTH:...; - The time in seconds let the sample music play after
|
|||
|
|
starting. This is specified as a floating point value. e.g. "16.00". Note that
|
|||
|
|
in the last 1 second of playing the music will fade out.<br>
|
|||
|
|
#SELECTABLE:...; - If "NO", the song can not be selected manually and can only
|
|||
|
|
be played as part of a course. If "ROULETTE", the song can can also be selected
|
|||
|
|
via roulette. The default value is "YES".<br>
|
|||
|
|
#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".<br>
|
|||
|
|
#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".<br>
|
|||
|
|
#BGCHANGE:...; - A value of the format "beat=bg name". Indicates that at 'beat',
|
|||
|
|
the background should begin playing a new background named 'bg name'. 'beat' is
|
|||
|
|
a fractional value value and 'bg name' is a string. Different bg changes are
|
|||
|
|
separated by commas. e.g. "60=falling,80=flower". When StepMania looks for
|
|||
|
|
a backgound, it searches in this order:<br>
|
|||
|
|
</font>
|
|||
|
|
<ol>
|
|||
|
|
<li><font face="Courier New" size="2">Looks for a movie with file name = "bg name" in the song folder. You must
|
|||
|
|
include the file extension in "bg name". e.g. "60=falling.avi,80=flower.mpg".</font></li>
|
|||
|
|
<li><font face="Courier New" size="2">Looks for a BGAnimation folder with the name "bg name" in the song folder.</font></li>
|
|||
|
|
<li><font face="Courier New" size="2">Looks for a movie with file name "bg name" in the RandomMovies folder. You
|
|||
|
|
must include the file extension in "bg name". e.g. "60=falling.avi,80=flower.mpg".</font></li>
|
|||
|
|
<li><font face="Courier New" size="2">Looks for a BGAnimation with file name "bg name" in the BGAnimations folder.</font></li>
|
|||
|
|
<li><font face="Courier New" size="2">Looks for a Visualization with the file name "bg name" in the Visualizations
|
|||
|
|
folder. For example, suppose you have a song B4U and special B4U-specific
|
|||
|
|
BGAnimations called "robot" and "electric". First, move the robot and electric
|
|||
|
|
BGAnimation folders into the B4U song folder (e.g. Songs\4th Mix\B4U\robot and
|
|||
|
|
Songs\4th Mix\B4U\electric). Then, using the editor, insert a new background
|
|||
|
|
change at each point in the song where you to switch to a new BGAnimation. When
|
|||
|
|
prompted for the name of the background change, you could type either "robot" or
|
|||
|
|
"electric".</font></li>
|
|||
|
|
</ol>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
Each pattern of notes has the same basic format:<br>
|
|||
|
|
<br>
|
|||
|
|
#NOTES:<NotesType>:<Description>:<DifficultyClass>:<DifficultyMeter>:<RadarValues>:<NoteData>;<br>
|
|||
|
|
<br>
|
|||
|
|
NotesType: Must be one of the currently supported types in StepMania:
|
|||
|
|
"dance-single", "dance-double", "dance-couple", "dance-solo", "pump-single",
|
|||
|
|
"pump-double", "pump-couple", "ez2-single", "ez2-double", "ez2-real", "para-single"<br>
|
|||
|
|
<br>
|
|||
|
|
Description: This will be displayed on the gameplay screen. This can be any
|
|||
|
|
text, but is most commonly:<br>
|
|||
|
|
"Beginner", "Basic", "Another", "Trick", "Standard", "SSR", "Maniac", "Heavy", "Challenge",
|
|||
|
|
"SManaic"<br>
|
|||
|
|
<br>
|
|||
|
|
DifficultyClass: This value must be "beginner", "easy", "medium", "hard", or "challenge". These values
|
|||
|
|
correspond the levels of difficulty on the Select Difficulty screen.<br>
|
|||
|
|
<br>
|
|||
|
|
DifficultyMeter: The difficulty of these notes as a bar rating. The value must
|
|||
|
|
be an integer between 1 and 10.<br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
NoteData: This value requires a longer explanation.<br>
|
|||
|
|
<br>
|
|||
|
|
Each note is represented by a character:<br>
|
|||
|
|
<br>
|
|||
|
|
0 = no note here<br>
|
|||
|
|
1 = a regular "tap note"<br>
|
|||
|
|
2 = beginning of a "hold note"<br>
|
|||
|
|
3 = end of a "hold note"<br>
|
|||
|
|
a-z,A-z = tap notes reserved for game types that have sounds associated with
|
|||
|
|
notes<br>
|
|||
|
|
<br>
|
|||
|
|
Notes that are hit at the same time are grouped into rows. For example, if the
|
|||
|
|
NotesType is "dance-single", the row "1001" would specify that both the Left and
|
|||
|
|
Right and Down panels should be hit at the same time.<br>
|
|||
|
|
<br>
|
|||
|
|
The number of notes per row (also called the number of 'columns') depends on the
|
|||
|
|
"NotesType.<br>
|
|||
|
|
<br>
|
|||
|
|
dance-single = 4 notes/row (Left,Down,Up,Right)<br>
|
|||
|
|
dance-double = 8 notes/row<br>
|
|||
|
|
dance-couple = 8 notes/row<br>
|
|||
|
|
dance-solo = 6 notes/row<br>
|
|||
|
|
pump-single = 5 notes/row<br>
|
|||
|
|
pump-double = 10 notes/row<br>
|
|||
|
|
pump-couple = 10 notes/row<br>
|
|||
|
|
ez2-single = 5 notes/row<br>
|
|||
|
|
ez2-double = 10 notes/row<br>
|
|||
|
|
ez2-real = 7 notes/row<br>
|
|||
|
|
para-single = 5 notes/row<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
Note rows are grouped into measures. The number of note rows you specify 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
|
|||
|
|
(1/12th) note. Measures are separated by a comma.<br>
|
|||
|
|
<br>
|
|||
|
|
Example:<br>
|
|||
|
|
<br>
|
|||
|
|
// measure 1<br>
|
|||
|
|
2010<br>
|
|||
|
|
0000<br>
|
|||
|
|
0100<br>
|
|||
|
|
0000<br>
|
|||
|
|
: // measure 2<br>
|
|||
|
|
0001<br>
|
|||
|
|
0100<br>
|
|||
|
|
0001<br>
|
|||
|
|
0000<br>
|
|||
|
|
3010<br>
|
|||
|
|
0000<br>
|
|||
|
|
0000<br>
|
|||
|
|
0000<br>
|
|||
|
|
;<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Backgrounds"><hr>Backgrounds</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
StepMania supports three different modes of backgrounds. The default background
|
|||
|
|
mode can be set in the Graphic Options menu.<br>
|
|||
|
|
<br>
|
|||
|
|
BGAnimations - Sprite animations similar to DDR 1st-5th Mix. There must be
|
|||
|
|
BGAnimation folders present in the BGAnimations directory, or else no background
|
|||
|
|
will be played. See the section called "BGAnimations Format" in this document
|
|||
|
|
for more information on the BGAnimations format. BGAnimations will perform
|
|||
|
|
better than the other background modes on slower computers.<br>
|
|||
|
|
<br>
|
|||
|
|
Random Movies - The background will cycle randomly over any avi or mpg files in
|
|||
|
|
the "RandomMovies" folder in the StepMania program directory.<br>
|
|||
|
|
<br>
|
|||
|
|
Visualizations - A random avi or mpg file will be chosen from the
|
|||
|
|
"Visualizations" folder in the StepMania program directory. This movie file will
|
|||
|
|
be played and blended over top of the song's background graphic.<br>
|
|||
|
|
<br>
|
|||
|
|
Many video AVIs will require the DivX codec for playback. If you haven't yet
|
|||
|
|
downloaded DivX, you can get it from www.divx.com. Playing movies as the
|
|||
|
|
background is very processor intensive, and may cause choppiness on slower
|
|||
|
|
computers.<br>
|
|||
|
|
<br>
|
|||
|
|
Sample animations, visualizations, and random movies can be found at
|
|||
|
|
<a href="http://www.stepmania.com">www.stepmania.com</a>.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="BGAnimations Format"><hr>BGAnimations Format</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
The BGAnimations folder in the StepMania program directory may contain several
|
|||
|
|
BGAnimation folders.<br>
|
|||
|
|
<br>
|
|||
|
|
\BGAnimations\<anim folder>\<layer files><br>
|
|||
|
|
<br>
|
|||
|
|
<anim folder> is the name of the animation.<br>
|
|||
|
|
<br>
|
|||
|
|
<layer files> are one or more graphics files that will be used as layers in the
|
|||
|
|
animation. Each sprite represents exactly one layer. Multiple layers can be
|
|||
|
|
specified by having multiple <layer files>. Layer files can be PNG, AVI, or MPEG
|
|||
|
|
files.<br>
|
|||
|
|
<br>
|
|||
|
|
For example, a BGAnimation named "flower" may include the files:<br>
|
|||
|
|
<br>
|
|||
|
|
BGAnimations\flower\1 TileScrollUp.png<br>
|
|||
|
|
BGAnimations\flower\2 StartOnRandomFrame ParticlesFloatDown 1x2.png<br>
|
|||
|
|
BGAnimations\flower\3 TileScrollLeft CycleColor 2x2.png<br>
|
|||
|
|
<br>
|
|||
|
|
The layers of a BGAnimation are drawn from bottom in the order in which the
|
|||
|
|
layer graphics files appear alphanumerically. A layer file name will often begin
|
|||
|
|
with a number to control the order in which they are drawn.<br>
|
|||
|
|
<br>
|
|||
|
|
Different "effects" are specified for each layer by adding tokens to the file
|
|||
|
|
name. Here are an explanation of the currently supported tokens:<br>
|
|||
|
|
<br>
|
|||
|
|
UseSongBg - Use the song's background file instead of this graphics file. Since
|
|||
|
|
this graphics file is merely a placeholder, you might want to make this graphic
|
|||
|
|
a 1x1 graphic to save disk space.<br>
|
|||
|
|
<br>
|
|||
|
|
Add - use additive blending instead of normal blending.<br>
|
|||
|
|
<br>
|
|||
|
|
CycleColor - cycle the color of the layer over the colors of the rainbow<br>
|
|||
|
|
<br>
|
|||
|
|
CycleAlpha - cycle the alpha channel of the layer over type<br>
|
|||
|
|
<br>
|
|||
|
|
StartOnRandomFrame - Start the animation on a random frame. This is mainly
|
|||
|
|
useful for Tile or Particle effects. <br>
|
|||
|
|
<br>
|
|||
|
|
DontAnimate - Stay on the first frame of this animation. This is only useful for
|
|||
|
|
layers with multiple frames.<br>
|
|||
|
|
<br>
|
|||
|
|
(stretch effects) - These scretch the graphic across the extire screen.<br>
|
|||
|
|
ScretchScrollLeft,<br>
|
|||
|
|
StretchScrollRight,<br>
|
|||
|
|
StretchScrollUp,<br>
|
|||
|
|
StretchScrollDown,<br>
|
|||
|
|
- Scroll the layer in a direction<br>
|
|||
|
|
<br>
|
|||
|
|
StretchWater,<br>
|
|||
|
|
StretchBubble,<br>
|
|||
|
|
StretchTwist,<br>
|
|||
|
|
StretchSpin,<br>
|
|||
|
|
- Deform the background sprite with an effect. Only stretch spin is currently
|
|||
|
|
implemented.<br>
|
|||
|
|
<br>
|
|||
|
|
(particle effects) - Use the graphic to make individual particles on the screen.<br>
|
|||
|
|
ParticlesSpiralOut,<br>
|
|||
|
|
ParticlesSpiralIn,<br>
|
|||
|
|
- Spiral particles away from/toward the center of the screen.<br>
|
|||
|
|
<br>
|
|||
|
|
ParticlesFloatUp,<br>
|
|||
|
|
ParticlesFloatDown,<br>
|
|||
|
|
ParticlesFloatLeft,<br>
|
|||
|
|
ParticlesFloatRight,<br>
|
|||
|
|
- Scroll the particles across the screen.<br>
|
|||
|
|
ParticlesBounce,<br>
|
|||
|
|
- Particles start traveling in random directions and bounce when they hit the
|
|||
|
|
edge of the screen.<br>
|
|||
|
|
<br>
|
|||
|
|
(tile effects) - Tile the graphics across the screen, forming a grid of
|
|||
|
|
graphics.<br>
|
|||
|
|
TileStill,<br>
|
|||
|
|
TileScrollLeft,<br>
|
|||
|
|
TileScrollRight,<br>
|
|||
|
|
TileScrollUp,<br>
|
|||
|
|
TileScrollDown,<br>
|
|||
|
|
- Scroll the tiles<br>
|
|||
|
|
<br>
|
|||
|
|
TileFlipX,<br>
|
|||
|
|
TileFlipY,<br>
|
|||
|
|
- Flip the tiles along the X or Y axis.<br>
|
|||
|
|
<br>
|
|||
|
|
TilePulse,<br>
|
|||
|
|
- Tiles zoom in and out.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="The .CRS File Format"><hr>The .CRS File Format</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
CRS files define the courses used in the Nonstop, Oni, and Endless modes. All CRS
|
|||
|
|
files must reside in the "Courses" folder in the StepMania program folder.
|
|||
|
|
These rules determine which of the three modes a course will appear in:<br>
|
|||
|
|
<br>
|
|||
|
|
Nonstop: Will appear if there is no #LIVES tag and #REPEAT is OFF.<br>
|
|||
|
|
Oni (Challenge): Will appear if there is a #LIVES tag and #REPEAT is OFF.<br>
|
|||
|
|
Endless: Will appear if #REPEAT is ON.<br>
|
|||
|
|
<br>
|
|||
|
|
#COURSE:...; - name of the course<br>
|
|||
|
|
#LIVES:<0..10>; - An integer between 0 and 10. This line is optional.<br>
|
|||
|
|
#REPEAT:<YES|NO>; - start over after last stage?<br>
|
|||
|
|
#SONG: - can use any one of the following formats:<br>
|
|||
|
|
<br>
|
|||
|
|
A fixed song:<br>
|
|||
|
|
#SONG:<group folder>/<song
|
|||
|
|
folder>:<difficulty>:<modifiers>;<br>
|
|||
|
|
example: #SONG:DDRMAX/MAX300:BASIC;<br>
|
|||
|
|
example:
|
|||
|
|
#SONG:DDR4th/B4U:MANIAC:sudden,shuffle,reverse;<br>
|
|||
|
|
A random song:<br>
|
|||
|
|
#SONG:*:(<difficulty>|<meter
|
|||
|
|
range>):<modifiers>;<br>
|
|||
|
|
example: #SONG:*:MANIAC;<br>
|
|||
|
|
example: #SONG:*:8..10:1.5x,reverse;<br>
|
|||
|
|
A random song within a group:<br>
|
|||
|
|
#SONG:<group
|
|||
|
|
folder>/*:(<difficulty>|<meter range>):<modifiers>;<br>
|
|||
|
|
example: #SONG:DDRMAX/*:3..6;<br>
|
|||
|
|
example:
|
|||
|
|
#SONG:DDR3rd/*:MANIAC:1.5x,reverse;<br>
|
|||
|
|
A players best song:<br>
|
|||
|
|
#SONG:PlayersBest:<number>:<modifiers>;<br>
|
|||
|
|
example: #PlayersBest1:TRICK;<br>
|
|||
|
|
example:
|
|||
|
|
#PlayersBest4:MANIAC:1.5x,reverse;<br>
|
|||
|
|
A players worst song:<br>
|
|||
|
|
#SONG:PlayersWorst:<number>:<modifiers>;<br>
|
|||
|
|
example: #PlayersWorst4:MANIAC;<br>
|
|||
|
|
example:
|
|||
|
|
#PlayersWorst1:TRICK:1.5x,reverse,drunk;<br>
|
|||
|
|
<br>
|
|||
|
|
Descriptions:<br>
|
|||
|
|
group folder - The name of the folder that contains the song folder. (e.g.
|
|||
|
|
"DDR4th")<br>
|
|||
|
|
song folder - the name of the folder that contains files for the song. (e.g.
|
|||
|
|
"B4U")<br>
|
|||
|
|
difficulty - Can be one of the following: BEGINNER, BASIC, TRICK, MANIAC,
|
|||
|
|
CHALLENGE.<br>
|
|||
|
|
meter range - A value in the format "x..y" where x is the lowest meter allowed
|
|||
|
|
and y is the highest meter allowed. For example, the string "7..9" would
|
|||
|
|
choose only from songs with a foot meter of 7, 8, or 9.<br>
|
|||
|
|
modifiers - A comma separated series of modifier strings. This value may
|
|||
|
|
be left blank. Any string you see on the Player Options screen is a
|
|||
|
|
modifier string. Some examples are:<br>
|
|||
|
|
0.5x, 0.75x, 1.5x, 2.0x, 3.0x, 4.0x, 5.0x, 8.0x<br>
|
|||
|
|
boost, wave, drunk, dizzy, space, mini<br>
|
|||
|
|
hidden, sudden, stealth, blink<br>
|
|||
|
|
mirror, left, right, shuffle, supershuffle<br>
|
|||
|
|
little<br>
|
|||
|
|
reverse<br>
|
|||
|
|
note, flat, plain<br>
|
|||
|
|
noholds<br>
|
|||
|
|
nofreeze<br>
|
|||
|
|
dark<br>
|
|||
|
|
0.7xmusic, 0.8xmusic, 0.9xmusic, 1.0xmusic, 1.1xmusic, <br>
|
|||
|
|
1.2xmusic, 1.3xmusic, 1.4xmusic, 1.5xmusic<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Extra Stages"><hr>Extra Stages</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
You can manually specify extra stages for each song group by creating .CRS files
|
|||
|
|
called "extra1.crs" and "extra2.crs" and placing them in the song group folder
|
|||
|
|
(e.g. Songs\MAX2\extra1.crs). When it comes time to play an extra stage the
|
|||
|
|
first song in the .crs file will be used. Don't forget to specify modifiers -
|
|||
|
|
see the "CRS File Format" section of this document for more information. If a
|
|||
|
|
CRS file is not found or is invalid, appropriate song, notes, and modifiers will be chosen.<br>
|
|||
|
|
<br>
|
|||
|
|
Don't forget: extra stage CRS files belong in the song group folder (e.g.
|
|||
|
|
"Songs/DDRMAX/"), not in "Courses".<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Creating an Announcer"><hr>Creating an Announcer</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
Announcers folders must reside in the "Announcers" folder inside the StepMania
|
|||
|
|
program directory (e.g. "Announcers\DDRMAX\"). An announcer folder contains
|
|||
|
|
several more folders - one for each announcer "trigger". Add as many .WAV, .MP3,
|
|||
|
|
or .OGG sounds as you want to the trigger folder. When StepMania wants to play a
|
|||
|
|
sound for that trigger, it will play a random sound file from your trigger
|
|||
|
|
folder.<br>
|
|||
|
|
<br>
|
|||
|
|
Sound files in a trigger folder can have any name you want. It's recommended
|
|||
|
|
that you name the sound files according to what is being said (e.g. "everybodys
|
|||
|
|
waiting for you.mp3"). If there are 0 sound files in a trigger folder, or the
|
|||
|
|
trigger folder is missing, then no sound will be played for that trigger.<br>
|
|||
|
|
<br>
|
|||
|
|
For a complete list of announcer trigger names, see the example announcer packs
|
|||
|
|
that are available at <a href="http://www.stepmania.com">www.stepmania.com</a>.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Creating a Note Skin"><hr>Creating a Note Skin</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
Note skins allow you to customize the way notes appear. Note skins must reside
|
|||
|
|
in the folder "NoteSkins\<Game Name>\<Note Skin Name>". Note skins are specific
|
|||
|
|
to a particular game (dance, pump, etc). In the note skin folder, you must
|
|||
|
|
implement the folling files for each note:<br>
|
|||
|
|
<br>
|
|||
|
|
<NoteName> receptor (3x1).png<br>
|
|||
|
|
<NoteName> tap note (NxN).png<br>
|
|||
|
|
<NoteName> tap explosion bright.png<br>
|
|||
|
|
<NoteName> tap explosion bright.png<br>
|
|||
|
|
<NoteName> hold explosion.png<br>
|
|||
|
|
<NoteName> down hold topcap active.png.png<br>
|
|||
|
|
<NoteName> down hold topcap inactive.png.png<br>
|
|||
|
|
<NoteName> down hold head active.png.png<br>
|
|||
|
|
<NoteName> down hold head inactive.png.png<br>
|
|||
|
|
<NoteName> down hold body active.png.png<br>
|
|||
|
|
<NoteName> down hold body inactive.png.png<br>
|
|||
|
|
<NoteName> down hold tail active.png.png<br>
|
|||
|
|
<NoteName> down hold tail inactive.png.png<br>
|
|||
|
|
<NoteName> down hold bottomcap active.png.png<br>
|
|||
|
|
<NoteName> down hold bottomcap inactive.png.png<br>
|
|||
|
|
<NoteName> tap.colors<br>
|
|||
|
|
<br>
|
|||
|
|
"<NoteName>" must be the name of the note (e.g. "left", "upright", "snare").
|
|||
|
|
Look at the example note skins included with StepMania for a complete list for
|
|||
|
|
each game.<br>
|
|||
|
|
<br>
|
|||
|
|
Most of the note skin elements can use any number of frames. For example, the
|
|||
|
|
element "tap exposion bright" could have 4 frames (2x2), 2 frames (1x2), or just
|
|||
|
|
a single frame. The exception to this rule is "receptor", which must have 3 frames.<br>
|
|||
|
|
<br>
|
|||
|
|
For more information on about textures with multiple frames, see the section
|
|||
|
|
"How StepMania Loads Textures" in this document.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Creating a Theme"><hr>Creating a Theme</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
All themes must reside in the Themes folder below the StepMania program
|
|||
|
|
directory. Inside a theme folder, you will all or only a few of the items below:<br>
|
|||
|
|
<br>
|
|||
|
|
Themes\<ThemeName>\BGAnimations\<br>
|
|||
|
|
Themes\<ThemeName>\Fonts\<br>
|
|||
|
|
Themes\<ThemeName>\Graphics\<br>
|
|||
|
|
Themes\<ThemeName>\Numbers\<br>
|
|||
|
|
Themes\<ThemeName>\Sounds\<br>
|
|||
|
|
Themes\<ThemeName>\metrics.ini<br>
|
|||
|
|
<br>
|
|||
|
|
The 5 possible folders in a theme hold "theme elements". A theme element is
|
|||
|
|
simply a little piece of the theme that can be changed. Each of the 5 folders
|
|||
|
|
contains different types of information as explained below:<br>
|
|||
|
|
<br>
|
|||
|
|
BGAnimations: This folder contains BGAnimation elements for the different
|
|||
|
|
screens. Since all backgrounds for all the menus in the game are generated using
|
|||
|
|
BGAnimations, any screen in the game can have an animating background. Also,
|
|||
|
|
BGAnimations can contain movie layers. For more information about BGAnimations,
|
|||
|
|
see the section "BGAnimations Format" in this document.<br>
|
|||
|
|
<br>
|
|||
|
|
Fonts: This folder contains graphics and font width data used by the font
|
|||
|
|
system. Font graphics and width files are generated using the program "Bitmap
|
|||
|
|
Font Builder", which is <a href="http://www.lmnopc.com/bitmapfontbuilder/">
|
|||
|
|
available at their site</a>. To export a font for use in StepMania:<br>
|
|||
|
|
- In Bitmap Font Builder, choose Character Set->Full ASCII. StepMania can only
|
|||
|
|
load 16x16 character sheets.<br>
|
|||
|
|
- In Bitmap Font Builder, click File->Save 32bit TGA. Save the file some place
|
|||
|
|
that is easy to access.<br>
|
|||
|
|
- Open Photoshop and load the TGA file. Click the chanel "Alpha 1", then load
|
|||
|
|
this channel as a selection.<br>
|
|||
|
|
- Click back to the Layers tab and create a new layer.<br>
|
|||
|
|
- Choose Edit->Fill, and fill the selection with white.<br>
|
|||
|
|
- Delete the layer named "Background". You should now see a mostly transparent
|
|||
|
|
background with faint hints of white text.<br>
|
|||
|
|
- Click File->Save For Web. Choose the Format "PNG-24" and Save.<br>
|
|||
|
|
- Rename the PNG file you just saved to "<YourFontName> 16x16.png". (the "16x16"
|
|||
|
|
means that the graphic contains 16 * 16 frames worth of characters.<br>
|
|||
|
|
- Back in Bitmap Font Builder, click File->Save Font Widths (INI Format). Save
|
|||
|
|
this in the same directory where you saved the PNG. Rename the exported INI file
|
|||
|
|
to "<YourFontName> 16x16.ini" where the first part of the file name matches the
|
|||
|
|
PNG you exported.<br>
|
|||
|
|
- Done! The PNG and the INI file are your new font. Move them into your theme's
|
|||
|
|
Fonts folder.<br>
|
|||
|
|
<br>
|
|||
|
|
StepMania will also look for the following optional lines in a font INI file:<br>
|
|||
|
|
CapitalsOnly=<0|1>: If 1, then StepMania will use the capital letter frames in
|
|||
|
|
place of the lower case letter frames. If not specified, StepMania will use 0
|
|||
|
|
for this value.<br>
|
|||
|
|
DrawExtraPixelsLeft=<0..32>: If letters of your font are being chopped off on
|
|||
|
|
the left size, try increasing this value. If not specified, StepMania will use 0
|
|||
|
|
for this value.<br>
|
|||
|
|
DrawExtraPixelsRight=<0..32>: If letters of your font are being chopped off on
|
|||
|
|
the right size, try increasing this value. If not specified, StepMania will use
|
|||
|
|
0 for this value.<br>
|
|||
|
|
AddToAllWidths=<0..32>: The value in this line will be added to the width of
|
|||
|
|
every character in the font. Increase this value to increase character spacing
|
|||
|
|
in your font. This feature is also useful if you wish to add a border to the
|
|||
|
|
characters of your font. If not specified, StepMania will use 0 for this value.
|
|||
|
|
ScaleAllWidthsBy=<0.0...2.0>: The width of every character in the font be
|
|||
|
|
multipled by this value. If not specified, StepMania will use 1 for this value.<br>
|
|||
|
|
LineSpacing=<0..64>: This controls the spacing in pixels between lines of text.
|
|||
|
|
This value is only used in text items that have multiple lines. If not
|
|||
|
|
specified, StepMania will use the height of the frames in your texture (which is
|
|||
|
|
32 pixels for 512x512 graphics).<br>
|
|||
|
|
Top=<0..63>: This indicates the top of a typical capital letter, from the top of
|
|||
|
|
the frame. If not specified, this will be derived from LineSpacing.<br>
|
|||
|
|
Baseline=<0..63>: This indicates the baseline of the font, from the top of the
|
|||
|
|
frame. If not specified, the baseline is derived from LineSpacing.<br>
|
|||
|
|
<br>
|
|||
|
|
Graphics: This folder contains graphics used in all of the screens. These
|
|||
|
|
graphics are the meat and potatoes of a theme. These graphics can be of any
|
|||
|
|
dimension. For example, your theme could have a "title menu logo dance.png"
|
|||
|
|
graphic that is 640x480 - which would take up the whole screen!<br>
|
|||
|
|
<br>
|
|||
|
|
Numbers: This folder contains graphics used to render numbers. Every graphic in
|
|||
|
|
this folder must be 5 frames by 3 frames (5x3) and follow the standard layout
|
|||
|
|
(see the Numbers graphics in the theme named "default" for examples).<br>
|
|||
|
|
<br>
|
|||
|
|
Sounds: This folder contains sounds. Sounds may be in OGG, MP3, or WAV format.<br>
|
|||
|
|
<br>
|
|||
|
|
metrics.ini: A metric is simply values that can alter the appearance of the
|
|||
|
|
game. metrics.ini is a large list of values that will allow you to alter things
|
|||
|
|
like the position of elements in the menus, and the order of menu screens. There
|
|||
|
|
is no documentation or explaination of these values other than the value name.
|
|||
|
|
Because the theme "default" implements all possible theme elements and metrics,
|
|||
|
|
the metrics file "Themes\default\metrics.ini" contains a complete list of all
|
|||
|
|
possible metrics. DO NOT EDIT the file "Themes\default\metrics.ini". Instead,
|
|||
|
|
create a blank file "metrics.ini" in your theme folder, and override only those
|
|||
|
|
values you want to customize for your theme using default's metrics.ini to see
|
|||
|
|
what values are possible.<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
When StepMania looks to load a theme element from one of these folders, it will
|
|||
|
|
first look in the folder of the currently selected theme. If the element is not
|
|||
|
|
found in this folder, StepMania then look for the theme element in the theme
|
|||
|
|
folder called "default". The theme "default" is a base theme and guaranteed that
|
|||
|
|
a theme is usable even if it is missing elements. <br>
|
|||
|
|
<br>
|
|||
|
|
This "fallback" system has other advantages too. User-created themes can
|
|||
|
|
override as many or as few theme elements as the author pleases. For example,
|
|||
|
|
you could create a theme called "MySuperTheme" which does nothing more than
|
|||
|
|
override the title menu logo. Here's how you would create this theme:<br>
|
|||
|
|
<br>
|
|||
|
|
- Create a new folder in "Themes" called "MySuperTheme"<br>
|
|||
|
|
- Open the MyStepMania folder. Create a folder inside called "Graphics".<br>
|
|||
|
|
- Copy the file "Themes\default\Graphics\title menu logo dance.png" into your
|
|||
|
|
Graphics folder "Themes\MySuperTheme\Graphics". <br>
|
|||
|
|
- Edit your new title menu graphic to be whatever you want.<br>
|
|||
|
|
- Start StepMania, go to Appearance Options, and change your theme to "MySuperTheme".<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2"><a name="Actor Commands"><hr>Actor Commands</a> (<a href="#Table of Contents">top</a>)</font>
|
|||
|
|
<hr>
|
|||
|
|
<p>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
In the old paradigm, you would define the position of an Actor with two
|
|||
|
|
different metrics - one for the X position, and one for the Y. For example:<br>
|
|||
|
|
ObjectX=100<br>
|
|||
|
|
ObjectY=220<br>
|
|||
|
|
<br>
|
|||
|
|
This system is being replaced by more powerful "commands strings". A command
|
|||
|
|
string can set positions, colors, effects, and also script animations over time.
|
|||
|
|
Positioning an Actor with command string would look like this:<br>
|
|||
|
|
ObjectOnCommand=x,100;y,220<br>
|
|||
|
|
<br>
|
|||
|
|
A command string contains one or more commands separated by semicolons. This
|
|||
|
|
command string contains two commands: "x,100" and "y,220". A command is made up
|
|||
|
|
of a command name and a list of parameters. The command name and any parameters
|
|||
|
|
are separated by commas. In the example above, both the commands "x" and "y"
|
|||
|
|
both take exactly one parameter. Other commands like "diffuse" take 4 parameters
|
|||
|
|
(R, G, B, and A). For example, the command "diffuse,1,0,1,1" would turn an
|
|||
|
|
Actor's color to opaque purple.<br>
|
|||
|
|
<br>
|
|||
|
|
Typically, the metrics file will have two commands per Actor - the "OnCommand"
|
|||
|
|
(which is where you command an Actor to tween onto the screen), and the "OffCommand"
|
|||
|
|
(for tweening the Actor off the screen).<br>
|
|||
|
|
<br>
|
|||
|
|
Below is a list of actor commands and their C++ equivalents. I'll
|
|||
|
|
have an explanation of animations and more examples in the full documentation.<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
sleep BeginTweening( fParam(0), TWEEN_LINEAR );<br>
|
|||
|
|
linear BeginTweening( fParam(0), TWEEN_LINEAR );<br>
|
|||
|
|
accelerate BeginTweening( fParam(0), TWEEN_ACCELERATE );<br>
|
|||
|
|
decelerate BeginTweening( fParam(0), TWEEN_DECELERATE );<br>
|
|||
|
|
bouncebegin BeginTweening( fParam(0), TWEEN_BOUNCE_BEGIN );<br>
|
|||
|
|
bounceend BeginTweening( fParam(0), TWEEN_BOUNCE_END );<br>
|
|||
|
|
spring BeginTweening( fParam(0), TWEEN_SPRING );<br>
|
|||
|
|
stoptweening { StopTweening(); BeginTweening( 0.0001f, TWEEN_LINEAR ); }<br>
|
|||
|
|
x SetX( fParam(0) );<br>
|
|||
|
|
y SetY( fParam(0) );<br>
|
|||
|
|
xoffset SetX( GetX()+fParam(0) );<br>
|
|||
|
|
yoffset SetY( GetY()+fParam(0) );<br>
|
|||
|
|
zoom SetZoom( fParam(0) );<br>
|
|||
|
|
zoomx SetZoomY( fParam(0) );<br>
|
|||
|
|
zoomy SetZoomY( fParam(0) );<br>
|
|||
|
|
diffuse SetDiffuse( RageColor(fParam(0),fParam(1),fParam(2),fParam(3)) );<br>
|
|||
|
|
glow SetGlow( RageColor(fParam(0),fParam(1),fParam(2),fParam(3)) );<br>
|
|||
|
|
rotationx SetRotationX( fParam(0) );<br>
|
|||
|
|
rotationy SetRotationY( fParam(0) );<br>
|
|||
|
|
rotationz SetRotationZ( fParam(0) );<br>
|
|||
|
|
shadowlength SetShadowLength( fParam(0) );<br>
|
|||
|
|
horizalign SetHorizAlign( sParam(0) );<br>
|
|||
|
|
vertalign SetVertAlign( sParam(0) );<br>
|
|||
|
|
diffuseblink SetEffectDiffuseBlink();<br>
|
|||
|
|
diffuseshift SetEffectDiffuseShift();<br>
|
|||
|
|
glowblink SetEffectGlowBlink();<br>
|
|||
|
|
glowshift SetEffectGlowShift();<br>
|
|||
|
|
wag SetEffectWag();<br>
|
|||
|
|
bounce SetEffectBounce();<br>
|
|||
|
|
bob SetEffectBob();<br>
|
|||
|
|
spin SetEffectSpin();<br>
|
|||
|
|
vibrate SetEffectVibrate();<br>
|
|||
|
|
stopeffect SetEffectNone();<br>
|
|||
|
|
effectcolor1 SetEffectColor1( RageColor(fParam(0),fParam(1),fParam(2),fParam(3))
|
|||
|
|
);<br>
|
|||
|
|
effectcolor2 SetEffectColor2( RageColor(fParam(0),fParam(1),fParam(2),fParam(3))
|
|||
|
|
);<br>
|
|||
|
|
effectperiod SetEffectPeriod( fParam(0) );<br>
|
|||
|
|
effectmagnitude SetEffectMagnitude( RageVector3(fParam(0),fParam(1),fParam(2))
|
|||
|
|
);<br>
|
|||
|
|
additiveblend EnableAdditiveBlend( iParam(0)!=0 );<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
</font></p>
|
|||
|
|
<font face="Courier New" size="2"><a name="ScreenSelect"><hr>ScreenSelect</a> (<a href="#Table of Contents">top</a>)</font>
|
|||
|
|
<hr>
|
|||
|
|
<p>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
ScreenSelect is a type of screen that presents the user with a list of choices.
|
|||
|
|
The choices shown on these screens can be Styles, Difficulties, PlayModes, or
|
|||
|
|
any combination thereof. Each ScreenSelect screen has two metrics that define
|
|||
|
|
what choices are shown (examples below). Currently, there are only two different
|
|||
|
|
screens that support the ScreenSelect framework.<br>
|
|||
|
|
- ScreenSelectMaxType1<br>
|
|||
|
|
- ScreenSelectMaxType2<br>
|
|||
|
|
- (more will be converted over in the next couple days)<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
// Example 1: Show all Styles for the current game type the DDR MAX Select Style
|
|||
|
|
template<br>
|
|||
|
|
<br>
|
|||
|
|
[ScreenSelectMaxType1]<br>
|
|||
|
|
ChoicesType=0 // 0=styles, 1=difficulties, 2=modes, 3=games<br>
|
|||
|
|
Choices=<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
// Example 2: Show specific Difficulty and PlayMode choices using a DDR MAX
|
|||
|
|
Select Difficulty template<br>
|
|||
|
|
<br>
|
|||
|
|
[ScreenSelectMaxType2]<br>
|
|||
|
|
ChoicesType=1 // 0=styles, 1=difficulties, 2=modes, 3=games<br>
|
|||
|
|
Choices=Beginner,Easy,Medium,Hard,Nonstop,Oni,Endless<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
// Example 3: Show specific Style-PlayMode-Difficulty combinations using a DDR
|
|||
|
|
MAX Select Style template<br>
|
|||
|
|
<br>
|
|||
|
|
ChoicesType=2 // 0=styles, 1=difficulties, 2=modes, 3=games<br>
|
|||
|
|
Choices=versus-arcade-medium,couple-arcade-medium,double-arcade-medium,single-arcade-medium,single-battle-medium,double-battle-medium,couple-battle-medium,versus-battle-medium<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
</font></p>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="How StepMania Loads Textures"><hr>How StepMania Loads Textures</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
* What are textures?<br>
|
|||
|
|
<br>
|
|||
|
|
"Texture" is simply another name for graphics file. The name "texture" is more
|
|||
|
|
common when taking about 3D graphics. This document uses "texture" and "graphic"
|
|||
|
|
interchangeably.<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
* How to you specify that a texture has multiple frames (for animation)?<br>
|
|||
|
|
<br>
|
|||
|
|
Simply add the string "(NxN)". Immediately before the "." that separates the
|
|||
|
|
main file name and the extension. For example, suppose there is a file called
|
|||
|
|
"title menu logo.png" that you would like to turn into an animation. Now, you
|
|||
|
|
create an graphic file with 9 frames of animation - 3 frames wide and 3 frames
|
|||
|
|
high. Name this file, "title menu logo 3x3.png", and StepMania will play the
|
|||
|
|
graphic as an animation with frames in the order left-to-right, top-to-bottom,
|
|||
|
|
with 0.20 seconds separating each frame.<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
* What are .sprite files?<br>
|
|||
|
|
<br>
|
|||
|
|
.sprite files are a way to have even more precise control over how your graphics
|
|||
|
|
animate. Each sprite has multiple "states". For each state, you may specify: 1)
|
|||
|
|
What frame of the graphic to show, and 2) how long to show this state before
|
|||
|
|
moving to the next state.<br>
|
|||
|
|
<br>
|
|||
|
|
Let's look at an example .sprite file:<br>
|
|||
|
|
<br>
|
|||
|
|
[Sprite]<br>
|
|||
|
|
Texture=dancer p1 1x3.png<br>
|
|||
|
|
Frame0000=0<br>
|
|||
|
|
Delay0000=0.05<br>
|
|||
|
|
Frame0001=1<br>
|
|||
|
|
Delay0001=0.05<br>
|
|||
|
|
Frame0002=2<br>
|
|||
|
|
Delay0002=0.05<br>
|
|||
|
|
<br>
|
|||
|
|
Texture is the name of the texture file to use. This must reside in the same
|
|||
|
|
directory as the .sprite file. If your texture has multiple frames, be sure to
|
|||
|
|
specify the dimensions in the file name using the convention described above.<br>
|
|||
|
|
<br>
|
|||
|
|
FrameNNNN is the index of the frame number to use for the first state of the
|
|||
|
|
animation. Frame may range between 0 and (total number of frames - 1).
|
|||
|
|
Frame indicies move left-to-right, top-to-bottom over the frames in an image.<br>
|
|||
|
|
<br>
|
|||
|
|
DelayNNNN is the time in seconds to show the state.<br>
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
* My graphics show ugly banding or look washed out. What can I do?<br>
|
|||
|
|
<br>
|
|||
|
|
Change your PNG images to use "palette mode" instead of "RGB mode".
|
|||
|
|
Paletted images have three advantages:<br>
|
|||
|
|
- StepMania can load paletted images with higher color precision than RGB
|
|||
|
|
images.<br>
|
|||
|
|
- paletted images use much less texture memory than RGB images.<br>
|
|||
|
|
- paletted images often have a smaller file size than an equivalent RGB mode
|
|||
|
|
image.<br>
|
|||
|
|
<br>
|
|||
|
|
However, paletted PNGs have a couple limitations:<br>
|
|||
|
|
- they support you to only "on/off" alpha.<br>
|
|||
|
|
- they support a maximum of 256 colors. This can make smooth gradients
|
|||
|
|
look ugly. <br>
|
|||
|
|
<br>
|
|||
|
|
Alternatively, inserting "dither" into filenames will instruct StepMania
|
|||
|
|
to dither the image when loading.
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
* Why do the graphics look so blurry?<br>
|
|||
|
|
<br>
|
|||
|
|
Some 3D graphics cards (the Voodoo3 in particular) do not support textures
|
|||
|
|
greater in size than 256x256. If a texture is larger than the card's maximum
|
|||
|
|
texture size, the image will scaled down internally resulting in output that
|
|||
|
|
looks blurry.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Building StepMania from CVS source"><hr>Building StepMania from CVS source</a>
|
|||
|
|
(<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
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 compile
|
|||
|
|
the source into a working executable. If you do not have a basic understanding
|
|||
|
|
of how to build a program using Visual C++, then you probably should not attempt
|
|||
|
|
to build StepMania.<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 1: Install and configure Visual C++<br>
|
|||
|
|
<br>
|
|||
|
|
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.<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 2: Install the Direct X 8.1 SDK<br>
|
|||
|
|
<br>
|
|||
|
|
The DirectX 8.1 SDK is a
|
|||
|
|
<a href="http://msdn.microsoft.com/downloads/?url=/downloads/sample.asp?url=/MSDN-FILES/027/001/771/msdncompositedoc.xml&frame=true">
|
|||
|
|
free download</a> from Microsoft. 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.<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 3: Create a SourceForge account<br>
|
|||
|
|
<br>
|
|||
|
|
In order to commit changes to CVS, you'll have to have a SourceForge account.
|
|||
|
|
<a href="http://sourceforge.net/account/register.php">Create an account</a> with
|
|||
|
|
SourceForge, then <a href="mailto:[email protected]">e-mail Chris</a>
|
|||
|
|
with your username so he can add you to the project.<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 4: Install WinCVS<br>
|
|||
|
|
<br>
|
|||
|
|
A CVS client is required to "checkout" the course from the CVS server. Download
|
|||
|
|
latest stable version (1.2) of WinCVS <a href="http://www.cvsgui.org">here</a>
|
|||
|
|
or <a href="http://sourceforge.net/project/showfiles.php?group_id=10072">here</a>.<br>
|
|||
|
|
<br>
|
|||
|
|
IMPORTANT: Now, open and close WinCVS once. This will cause WinCVS to create
|
|||
|
|
registry entries, which is required for the next step...<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 5: Use SourceForge Setup to install SSH and configure WinCVS<br>
|
|||
|
|
<br>
|
|||
|
|
A small utility called SourceForge Setup will greatly simplify the steps needed
|
|||
|
|
to configure SSH and WinCVS. Download SourceForge Setup
|
|||
|
|
<a href="http://sfsetup.sourceforge.net/">here</a>. Use the following settings
|
|||
|
|
when prompted by SF Setup:<br>
|
|||
|
|
<br>
|
|||
|
|
- Unpack SSH directory: c:\ssh<br>
|
|||
|
|
- SSH install direcotory: c:\ssh<br>
|
|||
|
|
- Your home directory: c:\ssh<br>
|
|||
|
|
- Your SourceForge user name: -yourusername-<br>
|
|||
|
|
- Name of the project: stepmania<br>
|
|||
|
|
- The directory where you will be keeping checked out project sources: c:\stepmania<br>
|
|||
|
|
<br>
|
|||
|
|
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:<br>
|
|||
|
|
<br>
|
|||
|
|
rem SourceForge setup stuff<br>
|
|||
|
|
SET PATH=%PATH%;c:\ssh<br>
|
|||
|
|
SET HOME=c:\ssh<br>
|
|||
|
|
<br>
|
|||
|
|
IMPORTANT: You must restart after running SF Setup so that the new environment
|
|||
|
|
variables take effect.<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 6: Enable SSH access to the cvs machine<br>
|
|||
|
|
<br>
|
|||
|
|
Before you can use your account, you must run the following (substituting your
|
|||
|
|
username and projectname as appropriate) before attempting to use CVS from a new
|
|||
|
|
user account. Open a command prompt, and type:<br>
|
|||
|
|
<br>
|
|||
|
|
ssh -l username cvs.stepmania.sourceforge.net<br>
|
|||
|
|
<br>
|
|||
|
|
Enter your password, and you'll get a message about how you're not supposed to
|
|||
|
|
be there and the connection will drop. What they don't tell you is that this
|
|||
|
|
creates your home directory and is required for things to start working.<br>
|
|||
|
|
<br>
|
|||
|
|
* Step 7: "Checkout" the source code<br>
|
|||
|
|
<br>
|
|||
|
|
- Open up WinCVS again. <br>
|
|||
|
|
- In the right pane, you should see the folder "stepmania".<br>
|
|||
|
|
- Right click on that folder and choose "Checkout module...". For the module
|
|||
|
|
name enter "stepmania". <br>
|
|||
|
|
- Click OK. <br>
|
|||
|
|
- If a "chose your home directory" window appears, select "c:\stepmania".<br>
|
|||
|
|
- A minimized console window should appear. Unminimize it, type in your
|
|||
|
|
SourceForge password, and press Enter.<br>
|
|||
|
|
- The source code should begin downloading. This can take a long time depending
|
|||
|
|
on your connection speed.<br>
|
|||
|
|
<br>
|
|||
|
|
* Optional: Create the SSH keypair for painless access to CVS server via SSH.
|
|||
|
|
<br>
|
|||
|
|
<br>
|
|||
|
|
Open a command prompt and enter this to create a new key pair: <br>
|
|||
|
|
<br>
|
|||
|
|
ssh-keygen -C <comment> -f identity <br>
|
|||
|
|
<br>
|
|||
|
|
<comment> is an identifier placed in the public key. I used my email address.
|
|||
|
|
Just press enter when it asks you for a passphrase. You don't want a passphrase.
|
|||
|
|
BTW, without the -C option the program will fail and you won't get a new key
|
|||
|
|
pair. I couldn't use any other ssh-keygen utility except for this one. Any other
|
|||
|
|
(SecureCRT, or the linux server) and ssh.exe wouldn't read it. <br>
|
|||
|
|
<br>
|
|||
|
|
Next, on your user account page at SourceForge, you should find a box to enter
|
|||
|
|
your SSH public key. Copy the entire contents of the identity.pub file (located
|
|||
|
|
in your .ssh directory) into the text entry box on the page -- be sure not to
|
|||
|
|
add any line breaks or it will not work. After a 6 hour wait, you should be able
|
|||
|
|
to use CVS with SSH without using your password.<br>
|
|||
|
|
<br>
|
|||
|
|
(Meanwhile...)<br>
|
|||
|
|
Copy the file "identity" (no extension) to c:\ssh\.ssh\<br>
|
|||
|
|
<br>
|
|||
|
|
Create a new file called ssh.bat in your ssh directory (c:\ssh\) with
|
|||
|
|
notepad and dump these contents into it: <br>
|
|||
|
|
<br>
|
|||
|
|
@echo off <br>
|
|||
|
|
rem echo %0 %1 %2 %3 %4 %5 %6 %7 %8 %9 > debug.txt <br>
|
|||
|
|
ssh.exe -C -l %3 -i c:\ssh\.ssh\identity %1 %4 <br>
|
|||
|
|
<br>
|
|||
|
|
Open WinCVS. In Admin->Preferences...->Ports tab, check 'Check for an alternate RSH name'
|
|||
|
|
and put "ssh.bat" into the editbox. <br>
|
|||
|
|
<br>
|
|||
|
|
* All done! Congrats.<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<a name="Thanks"><hr>Thanks</a> (<a href="#Table of Contents">top</a>)</font><hr>
|
|||
|
|
<font face="Courier New" size="2">
|
|||
|
|
<br>
|
|||
|
|
redcrusher for help on ez2 graphics<br>
|
|||
|
|
Dj Slash & Tony Thai for the caution graphic<br>
|
|||
|
|
Kyle "KeeL" Ward for his awesome menu music (www.ampcast.com/keel)<br>
|
|||
|
|
<br>
|
|||
|
|
</font>
|
|||
|
|
<hr>
|
|||
|
|
<font face="Courier New" size="2">End of document </font>
|
|||
|
|
<hr>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
</body>
|
|||
|
|
|
|||
|
|
</html>
|