82 lines
3.5 KiB
Markdown
82 lines
3.5 KiB
Markdown
# Rizu
|
|
A Tachi score hook for maimai DX.
|
|
|
|
Tested versions:
|
|
- BUDDiES
|
|
|
|
## Installation
|
|
First, get the [config file](https://kamai.tachi.ac/client-file-flow/CIaa7b4d91041688189231cfc696c0754120b1790b) and
|
|
place it in the same folder as the game executable (Sinmai.exe), then follow **only** one of three methods:
|
|
- [BepInEx (fast)](#bepinex-fast)
|
|
- [BepInEx](#bepinex)
|
|
- [Hard-patching using MonoMod](#hard-patching-using-monomod)
|
|
|
|
### BepInEx (fast)
|
|
- Update [segatools](https://gitea.tendokyu.moe/Dniel97/segatools/releases/latest).
|
|
- Download [Rizu-BepInEx-v0.1.2.zip](https://gitea.tendokyu.moe/beerpsi/Rizu/releases/download/v0.1.2/Rizu-BepInEx-v0.1.2.zip).
|
|
- Extract the zip into the base game folder (containing `Sinmai.exe`).
|
|
- Edit `segatools.ini`, adding this entry:
|
|
```ini
|
|
[unity]
|
|
targetAssembly=BepInEx\core\BepInEx.Preloader.dll
|
|
```
|
|
|
|
> **Warning**
|
|
>
|
|
> If you have MelonLoader installed (for YuanCon ADX HID input or other mods):
|
|
> - Grab [MLLoader-UnityMono-BepInEx5-v0.5.7.zip](https://github.com/BepInEx/BepInEx.MelonLoader.Loader/releases/download/v2.1.0/MLLoader-UnityMono-BepInEx5-v0.5.7.zip) and extract this zip into the base game folder, overwriting any conflicts. This allow BepInEx to also load MelonLoader mods.
|
|
> - Delete `version.dll`, which is used to load MelonLoader, from the game folder.
|
|
|
|
### BepInEx
|
|
#### Installing BepInEx
|
|
- Update [segatools](https://gitea.tendokyu.moe/Dniel97/segatools/releases/latest).
|
|
- Download [BepInEx 5](https://github.com/BepInEx/BepInEx/releases/tag/v5.4.23.1).
|
|
- Extract the `BepInEx` folder from the archive into the base game folder, ignoring other files.
|
|
- Edit `segatools.ini`, adding this entry:
|
|
```ini
|
|
[unity]
|
|
targetAssembly=BepInEx\core\BepInEx.Preloader.dll
|
|
```
|
|
|
|
#### Installing the score hook
|
|
- Download [Rizu-v0.1.2.zip](https://gitea.tendokyu.moe/beerpsi/Rizu/releases/download/v0.1.2/Rizu-v0.1.2.zip).
|
|
- Extract it into the base game folder.
|
|
|
|
In the end, your game directory should look like this:
|
|
```
|
|
└───BepInEx
|
|
└───plugins
|
|
└───Rizu
|
|
├───Rizu.dll
|
|
└───Rizu.Core.dll
|
|
├───Sinmai_Data
|
|
├───Rizu.cfg
|
|
├───Sinmai.exe
|
|
└───segatools.ini
|
|
```
|
|
|
|
> **Warning**
|
|
>
|
|
> If you have MelonLoader installed (for YuanCon ADX HID input or other mods):
|
|
> - Grab [MLLoader-UnityMono-BepInEx5-v0.5.7.zip](https://github.com/BepInEx/BepInEx.MelonLoader.Loader/releases/download/v2.1.0/MLLoader-UnityMono-BepInEx5-v0.5.7.zip) and extract this zip into the base game folder, overwriting any conflicts. This allow BepInEx to also load MelonLoader mods.
|
|
> - Delete `version.dll`, which is used to load MelonLoader, from the game folder.
|
|
|
|
### Hard-patching using MonoMod
|
|
- Download [MonoMod](https://github.com/MonoMod/MonoMod/releases/latest).
|
|
- Download `Assembly-CSharp.Rizu.mm.dll` from [releases](https://gitea.tendokyu.moe/beerpsi/Rizu/releases/latest)
|
|
and place it in `Sinmai_Data/Managed`.
|
|
- Run `MonoMod.exe path\to\Sinmai_Data\Managed\Assembly-CSharp.dll` in a command prompt.
|
|
- Rename `MONOMODDED_Assembly-CSharp.dll` to `Assembly-CSharp.dll`, optionally backing up the original file.
|
|
|
|
## Development
|
|
Copy these files from `Sinmai_Data/Managed` into `External`:
|
|
- `Assembly-CSharp.dll`
|
|
- `UnityEngine.dll`
|
|
- `UnityEngine.CoreModule.dll`
|
|
- `UnityEngine.JSONSerializeModule.dll`
|
|
- `UnityEngine.UnityWebRequestModule.dll`
|
|
|
|
You will also need to download [MonoMod](https://github.com/MonoMod/MonoMod/releases/latest). and extract to `External`.
|
|
|
|
After that, the project can be restored and built normally.
|