Be-Music Source

BMS

Filename extension	.bms
Developed by	Urao Yane, NBK
Type of format	Music
Container for	Pattern data
Extended from	text files
Extended to	BME, BML, PMS

BMS is a file format for rhythm action games, devised by Urao Yane in 1998.
The format was originally developed as a format specific for a simulator of the game Beatmania by KONAMI, and currently the term BMS is widely used to describe the whole Beatmania simulating game system.

There are several theories about what the acronym BMS stands for, as the expansion was unknown. The acronym has been confirmed by Urao Yane to be Be-Music Source in the official BMS format specification.

Gameplay

Similar to the Beatmania and Beatmania IIDX series, the purpose of the game is to hit keys as notes fall from the top of the screen to the judge line.
When the player hits the notes with the proper timing, a gauge will fill up. When the player misses a note, the gauge will drain.
In addition to the normal notes, there are also long notes where the player needs to keep holding the key until the note ends and mine notes that will explode and drain the gauge if the player is pressing the key when they hit the judge line.
To clear the game, the player's gauge must be filled to a specified level at the end of the song.

BMS songs

Most BMS songs are original songs made especially for the game, because the BMS format requires the sounds that compose the music to be separated into small pieces, thus making it hard to use preexisting songs to be made into a BMS.
Currently most BMS songs are distributed in BMS events, where usually several artists publish their songs and compete for scores. The largest BMS event is the BMS of Fighters (BOF) held by AOiRO_MANBOW where more than 100 songs are presented each year.

Basic Format

The .bms file describes how notes are arranged and how the game responds when the player takes a specific action. It is a plain text file with 'directive' lines starting with the # character.
Each directive line is formatted in the form below.

#[definition_setter] [definer]

The space between the definition setter and the definer is required.

A .bms file is generally composed of a header field and the main data field.
Below is a simple example of what an actual .bms file will look like when it is opened by a notepad.

∗---------------------- HEADER FIELD
#PLAYER 1
#GENRE Sample
#TITLE Sample
#ARTIST Sample
#BPM 120
#PLAYLEVEL 5
#TOTAL 100
#RANK 2
#bmp00 miss.bmp
#bmp01 1.bmp
#wav01 1.wav
∗---------------------- MAIN DATA FIELD
#00111:01010101
#00211:0101010001010100

Commonly used header field components

Commands existing from the original BM98 used in the original .bms extensions.

#PLAYER Defines play style. 1 for Single Play, 2 for Couple Play, and 3 for Double Play.
Modern BMS simulators do not depend on #PLAYER anymore, but define play style by the extension of the file itself and the directive lines used in the main data field.

#GENRE
　　Defines the genre.

#TITLE
　　Defines the title.

#ARTIST
　　Defines the artist.

#BPM
　　Defines the BPM.

#PLAYLEVEL
　　Defines difficulty level displayed for the song.

#RANK
　　Defines how strict timing to hit the notes is.
　　0 for very hard, 1 for hard, 2 for normal, and 3 for easy unless it is otherwise set by the simulator.

#WAVxx/#OGGxx
　　Defines the music file that will played when the number xx appears in the played channels and the sound channels of the main data field.
　　WAV00 sets the sound played when a mine note is activated.
　　Most commonly used music file types for BMS are .wav and .ogg

#BMPxx
　　Defines the picture/movie file that will be displayed when the number xx appears in the graphic channels of the main data field.

#TOTAL
　　Defines how much the gauge will increase when the notes are hit appropriately.

Commands later developed that have became popular.

#SUBTITLE
　　Defines the subtitle.

#DIFFICULTY
　　Defines difficulty of a song by color.
　　1=green, 2=blue, 3=yellow, 4=red, and 5=purple
　　Generally as the songs get harder, a higher number is assigned.

#STAGEFILE
　　Defines picture displayed when the song is chosen to be played.

#BANNER
　　Defines banner displayed when choosing the song to play.

#LNOBJ
　　Notes defined to be this will act as an ending for long notes when they appear in the played channels of the main data field.

#STOPxx
　　Defines period of the sequence stopping when the number xx appears in the stop channel of the main data field.

#BPMxx
　　Defines what the BPM will change to when the number xx appears in the BPM channel of the main data field.

Main data field components

Main field data will be written in the form of #XXXYY:ZZZZZZ.
XXX defines the number of the measure, YY defines the channel, and the ZZ defines the components of the measure using 2digits 36 base.
The colon separating the definer and components is required.

Expansion of BMS format

As the original .bms format became outdated by the transfer of the KONAMI Beatmania series to the Beatmania IIDX series, other formats that adopted changes in the Beatmania series were developed.
Famous expansions include Be-Music Extend format (.bme) that allowed 7 lines and 1 scratch to be played, and the Be-Music Long note format (.bml) that allowed usage of long notes that required players to keep pushing until the end of the note.

Separate from the development of the file types, simulators have also been developed by fans.

The original simulator BM98 by Urao Yane supported only 256 music files and picture files to be played, and only supported 5 lanes plus one scratch per playside.
Delight Delight Replicant allowed the .bme format to be played, most significantly allowing the 7 line format similar to the KONAMI Beatmania IIDX series to be played.
nazoBMplay allowed the number of sound and picture/movie files to increase by making the format 36 base instead of 16 base and with a patch allowed to play .ogg file type sounds.
Currently the most widely used BMS player is Lunatic Rave 2 by lavalse that has its own online ranking website.
Other simulators after Lunatic Rave 2 with higher performances and wider freedoms of expansion exist but no other simulator was able to replace the position of Lunatic Rave 2 as the most used simulator, mostly due to compatibility to older formats and lack of an online ranking system.

See also

• Beatmania
• Stepmania

External links

• A specification of original BMS format by Urao Yane
• BMS command memo
• Be-Music Scripting Museum (Korean)

Games dedicated for BMS format

• BM98 Kikuchan Version Drink Edition (Japanese)
• nazobmplay (Japanese)
• rhythm-it (Korean)
• LunaticRave 2 (Japanese)
• raindrop
• Bemuse