Leahnaya/two-torial
1
0
Fork 0
mirror of https://github.com/two-torial/two-torial.git synced 2026-03-24 02:24:07 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity
f5ff28bc41
two-torial/docs/extras/unity.md
Keeboy99 82a3477848 Bunch of Stuff
2025-04-13 11:10:59 +12:00

2.4 KiB
Raw Blame History

Modding Unity-based games

!!! danger "Before proceeding" This guide applies to games made in the Unity engine, such as maimai DX, O.N.G.E.K.I. and Card Maker.

**It is highly recommended to use an unpatched Assembly DLL as your base!**

!!! info "Patches have historically been hardcoded into the unprotected Assembly-CSharp.dll" The modern approach is to use BepInEx to load custom patches without tampering with Assembly-CSharp.
BepInEx can be used to load all mods, including those made for MelonLoader and MonoMod

Installing BepInEx

!!! tip "" - Download the BepInEx 5 stable release (BepInEx_win_x64_5.x.y.z.zip). !!! warning "Some maimai DX mods are only compatible with BepInEx 5.4.22"

- Extract the `BepInEx` folder to the `App\package` folder (ignore other files such as `.doorstop_version`)

- Modify `segatools.ini` with the following:

```ini
[unity]
enable=1
targetAssembly=BepInEx\core\BepInEx.Preloader.dll
```

Installing mods

!!! tip "BepInEx plugins" Place them in BepInEx\plugins.

!!! tip "Melonloader mods and plugins" - Download MLLoader-UnityMono-BepInEx5 of the latest BepInEx.MelonLoader.Loader. - Extract it into App\package. - Place mods in MLLoader\Mods.

!!! tip "MonoMod patches" !!! info "" These patches always follow the naming pattern: Assembly-CSharp.Name.mm.dll.

- Extract [BepInEx.MonoMod.Loader](https://github.com/BepInEx/BepInEx.MonoMod.Loader/releases/latest) into `App\package`.
- Place patches in `BepInEx\monomod`.

Available mods

!!! tip ""

- [mu3-mods](https://gitea.tendokyu.moe/akanyan/mu3-mods/wiki) open source BepInEx mods for O.N.G.E.K.I., includes many fixes and QOL changes that can be added selectively. 
- [AquaMai](https://github.com/MewoLab/AquaMai) open source MelonLoader mod for maimai, includes fixes, QOL, and cheats that can be configured from a toml or [gui](https://github.com/MewoLab/MaiChartManager).
- [worldlinkd](https://github.com/MewoLab/worldlinkd) open source MelonLoader mod for maimai, which adds cross-network online c2c similar to online matching in CHUNITHM.

!!! warning "AquaMai & worldlinkd" These mods may not work with the MelonLoader compatiblity layer for BepInEx, and as such it's recommended to follow their respective guides.