README.en.md

maidata-rs

简体中文

Parses the maidata.txt format of the simai application, popular in the maimai mapping community.

Currently very much WIP, expect a lot of breakages. Don't use in production.

Supported maidata.txt features

General format features:

• basic metadata fields
• comments ||xxx\n
• escape sequences \＆ \＋ \％ \￥
• active message fields

Map definition instructions:

• BPM spec (float)
• beat divisor spec {4}
  • normal spec {4}
  • absolute duration spec {#0.25}
• end mark E
• TAP B,
  • simplified BOTH/EACH TAP form (16 38 etc.; 123 and such are also allowed)
  • BREAK modifier Bb,
  • star-shape modifier B$, Bb$, B$b, B$$,
• HOLD Bh[length],
  • normal duration spec [x:y]
  • absolute duration spec [#float]
• SLIDE FxE[length],
  • all track shapes - ^ < > v p q s z pp qq V w
  • multiple tracks sharing one start 1-3[4:1]*-4[4:1]
  • absolute duration specs
    • [#1.5]
    • [160#2]
    • [3##1.5]
• BOTH/EACH note/note,
  • arbitrary number of concurrent notes allowed (3simai)

maimai DX (3simai) features are largely currently not implemented.