What is a Mod
A Mod is a modification to a game. In ADOFAI, Mods usually exist as UnityModManager (UMM) plugins that extend the game's behavior, visuals, and data.
What Mods Can Do
Examples from real projects in this organization:
| Mod | What it does |
|---|---|
| Iridium | Optimization Mod for ADOFAI, improves performance |
| YqlossClientHarmony | Fixes fatal decorations, effect removal, replay recording |
| Iris | Provides visual effects for the game |
| JipperKeyViewer | Key viewer |
| ADOFAI.EditorTweaks | Editor enhancements |
How Mods Work
The vast majority of ADOFAI Mods rely on two things:
- UnityModManager (UMM) — loads Mods, manages enable/disable, provides a settings UI
- Harmony — a runtime patching library that can intercept and modify game methods without touching the game's source code
What You Can Build
With these two tools, you can build a rich variety of features:
- Remove or add visual effects
- Recording and replay
- Performance optimization
- Draw in-game UI
- Extend the editor's capabilities
Red lines
Please do NOT create Mods that break the vanilla game's balance (e.g. altering hit judgement or accuracy calculation). The game's judgement system is officially off-limits, and this tutorial will not cover such practices. See Mod Development Guidelines for more.
Next Step
With your environment ready, write your first Mod → Minimal Example