HEY GUYS THIS FILE IS VERY OUTDATED LIKE THREE YEARS There isn't really much pertinent info in it anyways. bemani and Music Game Simulator File Types Written by AJ 187 (AJ187 \at\ AJWorld /dot/ net) version 0.12 [1/1/2003] ------------------ Table of Contents ------------------ 1. Introduction and Updates 2. Introduction to Formats 2a. Dance Dance Revolution 2aa. BeMusic Script (BMS) 2ab. Dazzle Dazzle Realization (D2R) 2aba. Dazzle Dazzle Realization Solo (SLO) 2ac. Dance Paranoia (DPR) 2ad. [unknown name] (MSD) 2ae. Dance With Intensity (DWI) 2af. PyDDR (STEP) 2ag. Stepmania (SM) 2b. beatmania and Variants 2ba. BeMusic Script (BMS) 2c. Pop'n Music 2ca. BeMusic Script (BMS) 2cb. Pop'n Music Script (PMS) 2d. Pump it Up 2da. Kick it Up Stepfiles (KSF) 2db. Stepmania (SM) 2e. EZ2Dancer 2ea. Stepmania (SM) 2f. ParaPara Paradise 2fa. Stepmania (SM) 2g. Guitar Freaks and drummania 2ga. [unknown name] (GDA) 2h. KeyboardMania 2ha. Virtual Orchestra Script (VOS) 2hb. Pop'n Music Script (PMS) 3. Writing Simfiles 2a. BMS 2aa. beatmania using BMS 2ab. Dance Dance Revolution using BMS [soon] 2ac. Pop'n Music using BMS [soon] 2b. D2R 2ba. SOL 2c. DPR 2d. MSD 2e. DWI 2f. SM 2fa. Dance Dance Revolution using SM 2fb. Pump it Up using SM 2fc. EZ2Dancer using SM 2fd. ParaPara Paradise using SM 2g. PMS 2ga. Pop'n Music using PMS 2gb. Keyboardmania using PMS [soon] 2h. KSF 2i. GDA 2j. VOS 4. Conversions Between Types 5. Other Formats Related to Simulators 5a. Lyrics 5aa. Dance With Intensity (LRC) 5ab. Dazzle Dazzle Realization (KSH) 5ac. PyDDR (internally into STEP file) 5b. Nonstop, Oni Courses, and Extra Stages 5ba. Dance With Intensity (CRS) 5bb. Stepmania (CRS) 6. Contacts and Other Crap --------------------------- 1. Introduction and Updates --------------------------- /Introduction/ Music game simulators have been out for a while now, and many of them adopt at least one format, maybe even more. (That's all I have for now, actually... I'm not good with introductions.) I'd also like to say that my info is not 100% accurate in some places, espically the names of the formats. /Updates/ version "hey this is dead why are people still linking to it lol" [8/31/2007] Seriously you guys this file sucks and doesn't even explain DWI or SM, the de facto formats for the most part. :D version 0.12 [1/1/2003] Simwolf released Dance With Intensity 2.30.00, making the following changes necessary: -Multiple Colours for lyrics [section 5.aa] -Course Definitions [section 5.ba] I've also started work on the Writing Simfiles section [section 3]. version 0.11 [12/28/02] -Added another section to Keyboardmania thanks to AJMix from the DDRManiaX forums. -Added Rythm-It's homepage thanks to Happy Hardcore from the DDRManiaX forums. -Added Dance Paranoia's webpage (most likely never coming back) -Fixed a spelling error with Simwolf's name. Shows that I should proofread the whole thing. =D version 0.1 [12/27/2002] -Everything that's there, just missing sections 3 and 4. -------------------------- 2. Introduction to Formats -------------------------- As there are many music game simulators, there are many different formats to match. In this section, we break down each format used for each simulation, and which simulators support what formats. 2a. Dance Dance Revolution -------------------------- There are at least 7 known formats for Dance Dance Revolution simulators. 2aa. BeMusic Script (BMS) ------------------------- Simulators Supporting BMS for Dance Dance Revolution: -Delight Delight Reduplication by Nickle - http://hey.to/nickle -Dance With Intensity by Simwolf (see note) - http://dwi.ddruk.com -Stepmania by Stepmania Team - http://www.stepmania.com [Note: Dance With Intensity does not natively support the BMS format, but on the homepage is a convertor written by Simwolf that can convert BMS files to DWI files] 2ab. Dazzle Dazzle Realization (D2R/SUL) ------------------------------------ Simulators Supporting D2R/SUL for Dance Dance Revolution: -Dazzle Dazzle Realization by ? - Homepage Unknown The SUL version was for version 1.xx of Dazzle Dazzle Realization. 2aba. Dazzle Dazzle Realization Solo (SLO) ------------------------------------------ Simulators Supporting SLO for Dance Dance Revolution: -Dazzle Dazzle Realization by ? - Homepage Unknown D2R for DDR Solo mode. 2ac. Dance Paranoia (DPR) ------------------------- Simulators Supporting DPR for Dance Dance Revolution: -Dance Paranoia by ? - http://www.linkclub.or.jp/~digix/danpara/ (down and probably dead) The only piece of information I found was that this simulator supports DDR Solo. 2ad. [unknown name] (MSD) ----------------------- Simulators Supporting MSD for Dance Dance Revolution: -Diet Diet Revolution by ? - Homepage Unknown -Dance With Intensity by Simwolf (see note) - http://dwi.ddruk.com [Note: Dance With Intensity's format was based off the MSD format, so all one needs to do is rename the extension to DWI and change the gap] 2ae. Dance With Intensity (DWI) ------------------------------- Simulators Supporting DWI for Dance Dance Revolution: -Dance With Intensity by Simwolf - http://dwi.ddruk.com -Stepmania by Stepmania Team - http://www.stepmania.com -PyDDR by P2E/tgz (see note) - http://clickass.org/~tgz/pyddr/ -CPD (Cross Platform Dance) by CPD Team - http://cpd.sourceforge.net/ [Note: PyDDR does not natively support DWI files. However, it comes with a DWI2STEP converter.] (taken from the DWI homepage, History of DWI section) "DDRMAX was due out late that year, and I had heard about these new 'freeze arrows'. Intrigued, I tried to find out what I could about them, and implemented them into the game. I didn't have much to go on, so the initial behaviour was different than how DDR did it. However, it did make my program the first to support freeze arrows, before DDRMAX was even in wide release. Because of this, and additions to the MSD format to allow for speed-changes and pauses, djDH and I decided it was best to change the extension." - Simwolf 2af. PyDDR (STEP) ----------------- Simulators Supporting STEP for Dance Dance Revolution: -PyDDR by P2E/tgz - http://clickass.org/~tgz/pyddr/ (taken from the PyDDR FAQ page) "there are a few features I want to implement in STEP files that aren't available using the DWI format. Plus, there have been things from time to time that I still don't understand about the formats, so I just invented something I could decipher. Use the included DWI2STEP converter to play DWI files." 2ag. Stepmania (SM) ------------------- Simulators Supporting SM for Dance Dance Revolution: -Stepmania by Stepmania Team - http://www.stepmania.com (taken from the Stepmania readme) "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." 2b. beatmania and Variants -------------------------- Throughout all these years, there has remained a single standard for simfiles of beatmania and its clones. 2ba. BeMusic Script (BMS) ------------------------- Simulators Supporting BMS for beatmania and Variants: -Lunatic Rave by lavalse, cyclia, et al. - http://lunatic-rave.com/ -BM98 by ? - Homepage Unknown -Delight Delight Reduplication by Nickle - http://hey.to/nickle/ -MixWaver by LOA - http://hello.to/mixwaver -bemaniaDX by pop'n the breakdown PROJECT -Rhythm-It by ? - http://nothing.sh/~manbow/dee_news/rdm/ and TONS more... The BMS format was originally created for BM98, when the only thing around was 5key + scratch. Now, the format has expanded to 7keys + scratch, and is also used for pop'n music simfiles. I have no idea if it supports beatmania III yet (5keys + bass pedal and scratch), but I assume one can use the 7key format (and leave a column open)... Also of note is BME, Be-Music Script Extended. This adds things like long notes and addressing WAVs from 00-ZZ (as opposed to 00-FF in base 16). 2c. Pop'n Music --------------- Pop'n simulators support two kinds of files; BMS and PMS. 2ca. BeMusic Script (BMS) ------------------------- Simulators Supporting BMS for Pop'n Music: -Feeling Pomu by ? (see note) - http://www.geocities.co.jp/HeartLand-Keyaki/9320/ Maybe more... [Note: Bemanistyle ( http://www.bemanistyle.com ) is the only American site supporting Feeling Pomu. They also have a guide to setting it up, written by reo and djp. They also have Pop'n Music BMS files.] 2cb. Pop'N Music Script (PMS) ----------------------------- Simulators Supporting PMS for Pop'n Music: -Feeling Pomu by ? (see note) - http://www.geocities.co.jp/HeartLand-Keyaki/9320/ Maybe more... [Note: Bemanistyle ( http://www.bemanistyle.com ) is the only American site supporting Feeling Pomu. They also have a guide to setting it up, written by reo and djp. They also have Pop'n Music BMS files.] God, what an awful extension name. 2d. Pump it Up -------------- 2da. Kick It Up Stepfiles (KSF) ------------------------------- Simulators Supporting KSF for Pump it Up: -Kick It Up by mahalo, the nogada worker, and Amigo~* - http://hello.to/kickitup/ -Direct Move by DIRECT MOVE - http://"DIRECT MOVE" in google, probably should add "pump" to that query as well. (Hey, be lucky I'm actually updating this document with a small amount of information :D) -Stepmania by Stepmania Team - http://www.stepmania.com 2db. Stepmania (SM) ------------------- Simulators Suporting SM for Pump it Up: -Stepmania by Stepmania Team - http://www.stepmania.com 2e. EZ2Dancer ------------- Only Stepmania supports this game (to my knowledge). 2ea. Stepmania (SM) ------------------- Simulators Supporting SM for EZ2Dancer: -Stepmania by Stepmania Team - http://www.stepmania.com 2f. ParaPara Paradise --------------------- 2fa. Stepmania (SM) ------------------- Simulators Supporting SM for ParaPara Paradise: -Stepmania by Stepmania Team - http://www.stepmania.com 2g. Guitar Freaks and drummania ------------------------------- Same story with Guitar Freaks and drummania as with beatmania. 2ga. [unknown name] (GDA) ------------------------- Simulators Supporting GDA for Guitar Freaks and drummania: -BandJAM by bandjam-net/BandJAM Team - http://www.bandjam.net -SessionStream by ? - Homepage Unknown Maybe more... 2h. KeyboardMania ----------------- 2ha. Virtual Orchestra Script (VOS) ----------------------------------- Simulators Supporting VOS for KeyboardMania: -Virtual Orchestra by ? - Homepage Unknown Maybe more... 2hb. Pop'n Music Script (PMS) ----------------------------- Simulators Supporting PMS for KeyboardMania -Doremimania by ? - Homepage Unmknown ------------------- 3. Writing Simfiles ------------------- Coming soon... 3a. BeMusic Script (BMS) ----------------------- BMS is one of the hardest formats to write songs in (manually). However, it gives the format an advantage, as you can write many types of simfiles with it. There are a couple ways of writing BMS files... It all depends if you like doing things the easy way or the hard way. [Programs] Programs specifically made for BMS editing/creating are available. -BMS Creator (Site in Japanese, English download available) - http://www2.plala.or.jp/ns/SoftWareLibrary/BMSCreator/index_alpha.html http://tixlab.com/ is the official site of BMS Creator. -BM Maker (Site and program are in Japanese) - http://market.agr.tottori-u.ac.jp/ken/soft.html#BMMaker (possibly more?) 3aa. beatmania Simfiles ----------------------- To be written later. 3ab. Dance Dance Revolution Simfiles ------------------------------------ To be written later. 3ac. Pop'n Music Simfiles ------------------------- To be written later. 3b. Dazzle Dazzle Realization (D2R) ----------------------------------- If you take a look inside, you'll find that a D2R file looks pretty simple. [Programs] There's programs for making/editing D2R files, too. -[forgot the name] (Site in Japanese, Program mostly in English) - http://paramax.hypermart.net/editor.html If I ever get a hex editor on this computer, I'll hack it for a complete English version. [Editing Files Manually] ~Tags The following tags can be placed in the header of the file. Each tag is separated by a line break (enter). TITLE=whatever The title of the song. ARTIST=whoever The artist of the song MUSIC=whatever.mp3 The music file of the song. SHORTCUT=whatevers.mp3 The preview music of the song. You don't have to add an 's' at the end of your filename, but it's suggested. TEMPO10=number The tempo multiplied by 10, so if you're converting the BPM for another simfile format, divide the number there by 10. START=number Not sure what this does yet. I think it's an equivalent to a gap. DELAYTIME=number Not sure on this either. It could also be the gap. TITLEBMP=whatever_tl.bmp The title bitmap. Equivalent to the song banner. STITLEBMP=whatever_li.bmp Now this is interesting. This is a custom select picture for song selection. CDBMP=whatever_cd.bmp A CD picture of the song, like DDR 3rd Mix. BGBMP=whatever_bg.bmp Background Picture. KASHIFILE=whatever.ksh The lyrics to the song [see section 5ab for info on writing lyrics] GENREBMP=whatever.bmp Similar to the CDTitle feature of DWI/SM. ~Steps The steps in a D2R file are a fairly simple concept to grasp... ~Tags LEVEL=number (1-10) Foot level of the song. PLAYER=number (1 or 2) Steps for whichever player. MODE=(BASIC, ANOTHER, or MANIAC) Whichever difficulty the steps are for. MUSICSTART as soon as this is placed, the lines after are read as steps. ~Steps Themselves The step format looks very logical... 4P:LDUR: Yup, that's the basic format. Now, if you want to do doubles... 8P:LDUR:LDUR: Each 4P or 8P line is one full bar (i.e. no offbeats), and I'll explain in the conversion section later how this works. If you want to put offbeats in the song, use this: 4p:LDUR: Notice the lowercase 'p'. There's also 'holds', which don't seem to work in the sim I'm using (Dazzle Dazzle Realization Solo)... I'm guessing that these would be freeze arrows of some sort. ---------------------------- 4. Conversions Between Types ---------------------------- Coming soon... In the meantime, StepMania provides an automatic conversion for the following types: DWI -> SM SM -> DWI BMS -> SM KSF -> SM -------------------------------------- 5. Other Formats Related to Simulators -------------------------------------- Sometimes, addons are created to further the simulator to make it more like the real thing. Two things added were lyrics and courses (Oni, Nonstop, Extra Stage). 5a. Lyrics ---------- Lyrics have actually been around for a while, and are in three simulators. 5aa. Dance With Intensity (LRC) ------------------------------- Dance With Intensity Versions 2.20.x and above support LRC files containing lyrics for the song being played. -Writing LRC Files (This text mainly comes from the DWI readme) Filename: The filename should be [name of dwi].LRC (i.e. paranoia.dwi and paranoia.lrc) Supported Tags: 2 [COLOUR] (or [COLOR], both are supported) Description: Changes the colour of the lyric text. Format: [COLOUR]0x######;, where ###### is a color given in Hexidecimal. It uses the same format as HTML colors. With DWI 2.30.00, multiple colours are allowed. [COLOUR]0xFFFF00,0xFF00FF; To call them, one can use {cX}, where X is 0-9. Take note that the first colour is defined as {c0}. [MM:SS.ss]...; Description: Sets a time where a lyric should be shown. Format: [MM:SS.ss]Lyrics, where MM is minutes, SS is seconds, and ss is milliseconds. Line breaks are added with the pipe (|) character. 5ab. Dazzle Dazzle Realization (KSH) ------------------------------------ I do not completely understand the Dazzle Dazzle Realization lyric format right now, and I only have one thing on it. All I know is that the top line has the title and artist in the format TITLE / ARTIST. 5ac. PyDDR (internally into STEP file) -------------------------------------- There are two ways to make lyrics for STEP files: 1. Using the bundled lyrictag.py (the easy way) 2. Inserting the lyrics into the STEP file manually (useful if the song already has a LRC for DWI) Since I don't have PyDDR on my machine, I can't tell you how lyrictag.py works... However, I can tell you how to manually insert the lyrics into the STEP file. (This comes almost directly from the mini-HOWTO stepfile.txt, available on the PyDDR site, as well as in the distribution of PyDDR) if you already have all the times written down for the lyrics in your song (you masochist!), most useful will be the 'atsec' and 'waits' commands, followed by these two commands: lyric Displays whatever is after 'lyric' at the current command time. trans Stands for 'trans'lated - displays whatever is after 'trans' at the current time. You can use this to display background singing, any echoes, or even the English translation of a line in romanji. remember to end the lyrics section with 'end'. 5b. Nonstop, Oni Courses, and Extra Stages ------------------------------------------ Dance With Intensity 1.70 was the first simulator to support custom nonstop courses, using a built-in editor. Now, DWI and Stepmania can use external course files for nonstop courses, oni courses, and extra stages. However, each simulator uses a different format, for reasons I cannot understand. 5ba. Dance With Intensity (CRS) ------------------------------- DWI's Course format is as follows: -Header #COURSE:...; The course name. (i.e. #COURSE:PARANOiA BROS.;) #DISPLAYCOURSE:...; Allows you to use symbols in your course name. (i.e. #DISPLAYCOURSE:{.\Chars\kidou.png};) #REPEAT:(YES/NO); (optional) Allows you to make a repeating course if set to YES. #COMBO:PERFECT; (optional) Affects the combo counter. If this option is in the CRS file, only Perfects will count towards the combo. #COMBOMODE:(1/2); (optional) Tells how much a jump should be for the combo counter. 1 makes jumps worth 1 (like in pre-DDRMAX) towards the combo. #LIVES:x; (optional) How many lives you can have in a course. Keep in mind that official Konami courses allow 4 lives. If this tag is not in the file, the course will not have a battery meter. x is 1-10. -Adding Songs #SONG:...; There's a few ways a song can be added to a course. -Random Song #SONG:*:a..b; a is the minimum foot difficulty, and b is the maximum foot difficulty. -Specific Song #SONG:Mix Directory\Song Title or Directory*:Difficulty; Directory is the directory the song is in, and the song title is from the song selection screen. Difficulty is a difficulty defined in the DWI file. *Directory supported only on DWI 2.30.00 and above. -Modifiers (optional) #SONG:Directory\Song Title:Difficulty:modifier; modifier is one or more of the following (separated by commas): [speed mods] 0.5x, 0.75x, 1.5x, 2.0x, 3.0x, 4.0x, 5.0x, 8.0x [boost] BOOST [appear] HIDDEN, SUDDEN, STEALTH [turn] LEFT, MIRROR, RIGHT, SHUFFLE [other] LITTLE, FLAT, SOLO [dark] DARK [scroll] REVERSE [freeze] NOFREEZE [power] POWER-DROP, DEATH If a random modifier (or a number of random modifiers) are desired, add xRANDOM at the end, where x is 1 through 7. (i.e. #SONG:DDRMAX\MAX 300:MANIAC:1.5x,REVERSE,1RANDOM;) -Awards (optional) #SONG:Directory\Song Title:Difficulty:AWARDx; x is the number of lives awarded at the end of a song. -Notes for Extra Stage Extra Stages must have the filename as bonus-1.crs or bonus-2.crs, and must reside in the main DWI directory, as opposed to Oni and Nonstop courses (which must be in the Courses directory). 5bb. Stepmania (CRS) -------------------- The Stepmania CRS format has one difference from the DWI course format, and it's a small one at that. Just replace song title with song directory. Extra Stages are also different. -Stepmania Modifiers [speed mods] 0.5x, 0.75x, 1.5x, 2.0x, 3.0x, 4.0x, 5.0x, 8.0x [boost + others] boost, wave, drunk, dizzy, space, mini [appear] hidden, sudden, stealth, blink [turn] mirror, left, right, shuffle, supershuffle [little] little [scroll] reverse [color] note, flat, plain [holds] noholds [freeze] nofreeze [dark] dark [power] norecover, suddendeath, power-drop, death [music] 0.7xmusic, 0.8xmusic, 0.9xmusic, 1.0xmusic, 1.1xmusic, 1.2xmusic, 1.3xmusic, 1.4xmusic, 1.5xmusic -Notes for Extra Stage Extra Stages must have the filename as extra1.crs or extra2.crs, and must reside in the group directory (i.e. songs\ddrmax\) -------------------------- 6. Contacts and Other Crap -------------------------- This document was written to while listening to the following songs: NAOKI underground - l'amour et la liberte Orange Lounge - Mobo*Moga Akira Yamaoka - 250bpm /Contacts/ E-Mail: AJ187 \a_t\ AJWorld /d0t/ net AIM: AJ95 (serious comments and questions only, thanks) DDRFreak Forums: AJ 187 Bemanistyle: AJ 187 DDRUK: AJ187 Nickname on #DDRManiaX: AJ187 Personal Website: http://www.ajworld.net /Coming Soon/ -completion of chapters 3 and 4 -Links to places to get simfiles? -Verification and addition of information /Thanks/ -Konami and Andamiro, as well as any other companies who make music simulation games -All music game simulator writers -Bemanistyle, DDRManiaX, DDRUK, DDRei, DDRFreak, Aaron in Japan -#DDRManiaX on GameArcadia