An in-game overlay mod for A Dance of Fire and Ice (ADOFAI) that displays progress, accuracy, BPM, combo, judgement, and more. Supports both Unity Mod Manager and MelonLoader.
- Real-time Overlay — Progress, Accuracy, XAccuracy, Music/Map Time, Checkpoints, Best Record
- BPM Display — Tile BPM, Current BPM, KPS, with pseudo-BPM detection
- Combo Counter — Animated combo display with color gradients
- Judgement Display — Hit margin breakdown (Miss, Bad, Good, Perfect, etc.)
- XScore & Potential Values — Native XScore (r149+), per-player values, and predicted final Accuracy/XAccuracy/XScore
- Timing Modes — Latest hit offset, rolling average, or both; judgement-window readouts in ms
- Timing Scale — Current timing scale percentage
- Attempt Tracker — Per-map attempt count with persistent storage
- Progress Bar — Visual progress indicator
- Extended Overlay — Extended overlay with FPS, State, Death count, Start position, Timing analysis, Debug text hiding
- Co-op Support — Per-player display for multiplayer
- Tag Templates — Rewrite every readout as a free-form template over 117 tags (
{Progress:0.00},{MarginCombo(XP)}, gradient colour via{ColorRange(...)}, smoothed values via{EasedValue(...)}); game values freeze outside a level instead of flashing 0; searchable in-panel tag reference with one-click copy and ready-made examples - Custom Text Lines — Add as many extra overlay lines as you want: flow with the main column or free-position anywhere, per-line font size, alignment, style, and independent shadow/outline
- Text Effects — Global shadow (TMP Underlay) and outline with toggles, RGBA color pickers, Width/Softness sliders
- Per-Section Fonts — Independent font and font-size per overlay slot (Main, BPM, Judgement, Combo, Timing, Attempt)
- UI Patch Toggles — Independent switches for Beta watermark, level name position, auto text reposition
- Color Editor — Interactive gradient editor for all overlay colors
- XPerfect Integration — Optional enhanced perfect display via XPerfect
- Diagnostics & Font Rescan — Inspect the detected game API, loader, XPerfect, fonts, and overlay state; copy the report to the clipboard, and rescan
CustomFontswithout restarting
Install one loader variant per game folder (UMM or MelonLoader), not both. They use the same Harmony id and separate mod folders, so installing both can cause duplicate patches and split settings/statistics.
Every readout (progress, accuracy, judgement, ...) accepts a template that replaces its whole line, and any number of extra lines can be added under Custom Text Lines (stacked after the main column, or free-positioned anywhere on screen).
Syntax: {Tag} - {Tag:0.00} for decimal places - {Tag(1)} for the co-op player index - {{ / }} for literal braces. The settings panel (Text Templates) lists all 117 tags grouped by category with localized (English / 한국어 / 中文) descriptions, a search box, and click-to-copy names, plus ready-made example templates.
Example - a progress line that fades from red to green and glides between updates:
<color=#{ColorRange(Progress,0,100,FF0000,00FF00,OutExpo)}>{EasedValue(Progress,2):0.0}%</color>
Game-value tags are gated by playback state: while a level is not loaded (menu/results/transition) or the game is paused they keep their last good value instead of flashing 0; {Fps}, {Title}, {Artist} and the {Is*} booleans keep updating everywhere.
- English
- 한국어 (Korean)
- 中文 (Chinese)
- Install Unity Mod Manager (UMM)
- Download the UMM variant from Releases
- Install the mod via UMM, or extract the zip to
ADOFAI/Mods/JipperOverlayer/
- Install MelonLoader
- Download the MelonLoader variant from Releases
- Extract to
ADOFAI/Mods/JipperOverlayer-melon/ - Press F7 in-game to open settings (rebindable)
ADOFAI/Mods/JipperOverlayer/
├── Info.json
├── JipperOverlayer.dll
├── JipperOverlayer.Loader.UMM.dll
ADOFAI/Mods/JipperOverlayer-melon/
├── JipperOverlayer.dll
├── JipperOverlayer.Loader.Melon.dll
No asset files ship with the package. The default font is embedded in
JipperOverlayer.dlland self-extracts toassets/MAPLESTORY_OTF_BOLD.OTFon first run — only when that file is missing, so a font you replace yourself is never overwritten. The progress bar is built in code.
Runtime data is kept beside the loader DLL in the mod folder:
Settings.json— main settings and display orderlabels.json/colors.json— custom labels and color gradientsCustomFonts/— optional.ttf/.otffiles (use Rescan Fonts in settings)Plays.dat— local attempt/best statistics (with a.bakbackup)
The settings panel can copy a diagnostics report (detected API, loader, XPerfect, font and overlay state) to the clipboard when reporting a problem.
- A Dance of Fire and Ice (Steam version)
- One of: Unity Mod Manager 0.22.14+ or MelonLoader
- Supports game versions v136 and v141+ (the v136 path is best-effort; CI currently verifies the r148 and r150 API shapes)
- Visual Studio 2022+ with .NET Framework 4.8.1 SDK
- Steam installation of ADOFAI (for reference DLLs in
Libs/)
Note:
Libs/is.gitignored. Runcp -r "$ADOFAI/A Dance of Fire and Ice_Data/Managed/"* Libs/to populate it from your game installation (requires one-time setup).
The default font lives at
JipperOverlayer/assets/MAPLESTORY_OTF_BOLD.OTFand is embedded into the DLL at compile time — no packing step, and no Unity editor project is involved.
# Solution (core + both loaders)
msbuild -restore -p:Configuration=Release
# Or individual projects
msbuild JipperOverlayer/JipperOverlayer.csproj -restore -p:Configuration=Release
msbuild JipperOverlayer.Loader.UMM/JipperOverlayer.Loader.UMM.csproj -restore -p:Configuration=Release
msbuild JipperOverlayer.Loader.Melon/JipperOverlayer.Loader.Melon.csproj -restore -p:Configuration=ReleaseCompiled outputs:
JipperOverlayer/bin/Release/JipperOverlayer.dllJipperOverlayer.Loader.UMM/bin/Release/JipperOverlayer.Loader.UMM.dllJipperOverlayer.Loader.Melon/bin/Release/JipperOverlayer.Loader.Melon.dll
This project uses GitHub Actions for automated builds:
| Trigger | Action |
|---|---|
Push to master |
Build + package artifact |
Pull request to master |
Build verification |
Tag v*.*.* |
Build + package + GitHub Release |
Tag containing - (e.g. v1.0.0-pre1) |
Prerelease |
- MIT License — see LICENSE.