sinmai-mods/README.md

69 lines
2.9 KiB
Markdown
Raw Permalink Normal View History

2024-05-22 17:31:19 +02:00
## sinmai-mods
2024-06-01 14:30:03 +02:00
Miscellaneous mods for maimai DX. Mods are MonoMod unless specified otherwise.
2024-05-22 17:31:19 +02:00
### CachedDataManager
Speeds up game reboots by caching loaded data. Cache is stored in the `dataCache` folder
and should be deleted if any issues arise.
### FixLocaleIssues
Attempts to fix charts not loading on some system locales.
Adds `CultureInfo.InvariantCulture` to all instances of `float.Parse` and `float.TryParse`
so charts will still load on locales where the comma is the decimal separator.
2024-05-24 16:47:45 +02:00
### LooseDBTables
Enables loading tables from loose `.json` files in `Sinmai_Data/StreamingAssets/DB`.
Useful for string edits (a.k.a. english patch).
Tables are automatically generated if `Sinmai_Data/StreamingAssets/DB` doesn't exist.
2024-05-27 05:59:40 +02:00
### MoreChartFormats
Loads charts written in various known formats:
- [simai](https://w.atwiki.jp/simai) (powered by a custom fork of [SimaiSharp](https://github.com/reflektone-games/SimaiSharp))
- srt/szt/sct/sdt (maimai classic chart format)
To use, edit Music.xml to point the chart file path to your chart file:
```xml
<Notes>
<file>
<path>{filename}.sdt</path>
</file>
<!-- snip -->
</Notes>
```
The chart loader used depends on the file extension:
- simai chart files must end with `.simai`
- srt chart files must end with `.srt`
- szt/sct/sdt files can use `.szt`/`.sct`/`.sdt` interchangeably, since they only
differ by two ending columns. [details](https://listed.to/@donmai/18173/the-four-chart-formats-of-maimai-classic)
#### Simai caveats
- **`maidata.txt` is not supported. If you have one, paste the content of each
`inote_x` into their own `.simai` file.**
- Both `?` and `!` will create a slide without a star note, but both of them will
make the slide fade in (`!` makes the slide suddenly appear in standard simai).
- `$` cannot be used to create a tapless slide (maiPad PLUS syntax).
- `$$` is ignored, as star notes only spin when there's an associated slide.
- `[BPM#a:b]` is not supported for specifying hold time.
- `` ` `` (fake EACH) makes taps 1/384 measures apart.
#### SXT caveats
- Encrypted chart files (`.srb`/`.szb`/`.scb`/`.sdb`) are not supported. Decrypt
2024-05-27 06:03:42 +02:00
them before loading into the game.
- Since this chart format does not contain timing data, the song's BPM is retrieved
by loading the `Music.xml` associated with the chart, **and it is assumed that the
chart and `Music.xml` is in the same folder**. The SXT loader will not work if the
2024-06-01 14:30:03 +02:00
chart file is somehow in a different folder from `Music.xml`.
### UnlockFrameRate
Change the target FPS. Also comes with an FPS counter.
Unlike other mods in this collection, this is a **BepInEx** mod. You will need to
install BepInEx and drop this into `BepInEx/plugins` to enable the mod.
The configuration file for changing the FPS is at `BepInEx/config/io.github.beerpsi.sinmai.framerate.cfg`
and is already documented.