# Modding (Unity) - two-torial.xyz
Arcade Games Troubleshooting Guide
Author: two-torial Team

Skip to content

# Modding (Unity)

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!

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

- Download the BepInEx 5 stable release (`BepInEx_win_x64_5.x.y.z.zip`).

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:

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

## Installing Mods

BepInEx plugins

Place them in `BepInEx\plugins`.

Melonloader mods and plugins

- Download `MLLoader-UnityMono-BepInEx5` of the latest BepInEx.MelonLoader.Loader.
- Extract it into `App\package`.
- Place mods in `MLLoader\Mods`.

MonoMod patches

These patches always follow the naming pattern: `Assembly-CSharp.Name.mm.dll`.

- Extract BepInEx.MonoMod.Loader into `App\package`.
- Place patches in `BepInEx\monomod`.

## Available Mods

- mu3-mods open source BepInEx mods for O.N.G.E.K.I., includes many fixes and QOL changes that can be added selectively.
- AquaMai open source MelonLoader mod for maimai, includes fixes, QOL, and cheats that can be configured from a toml or gui.
- worldlinkd open source MelonLoader mod for maimai, which adds cross-network online c2c similar to online matching in CHUNITHM.

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.

May 30, 2025