Skip to content

About

JipperOverlayer ADOFAI overlay mod

Resources

Stars

19 stars

Watchers

1 watching

Forks

Repository files navigation

JipperOverlayer

C# Visual Studio 2022 Downloads Build

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.

Features

  • 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 CustomFonts without 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.

Tag Templates & Custom Text

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.

Settings UI Languages

Settings UI Languages

  • English
  • 한국어 (Korean)
  • 中文 (Chinese)

Installation

Unity Mod Manager

  1. Install Unity Mod Manager (UMM)
  2. Download the UMM variant from Releases
  3. Install the mod via UMM, or extract the zip to ADOFAI/Mods/JipperOverlayer/

MelonLoader

  1. Install MelonLoader
  2. Download the MelonLoader variant from Releases
  3. Extract to ADOFAI/Mods/JipperOverlayer-melon/
  4. Press F7 in-game to open settings (rebindable)

Manual Installation

UMM variant

ADOFAI/Mods/JipperOverlayer/
├── Info.json
├── JipperOverlayer.dll
├── JipperOverlayer.Loader.UMM.dll

MelonLoader variant

ADOFAI/Mods/JipperOverlayer-melon/
├── JipperOverlayer.dll
├── JipperOverlayer.Loader.Melon.dll

No asset files ship with the package. The default font is embedded in JipperOverlayer.dll and self-extracts to assets/MAPLESTORY_OTF_BOLD.OTF on first run — only when that file is missing, so a font you replace yourself is never overwritten. The progress bar is built in code.

Local data

Runtime data is kept beside the loader DLL in the mod folder:

  • Settings.json — main settings and display order
  • labels.json / colors.json — custom labels and color gradients
  • CustomFonts/ — optional .ttf / .otf files (use Rescan Fonts in settings)
  • Plays.dat — local attempt/best statistics (with a .bak backup)

The settings panel can copy a diagnostics report (detected API, loader, XPerfect, font and overlay state) to the clipboard when reporting a problem.

Requirements

  • 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)

Build from Source

Prerequisites

  • Visual Studio 2022+ with .NET Framework 4.8.1 SDK
  • Steam installation of ADOFAI (for reference DLLs in Libs/)

Note: Libs/ is .gitignored. Run cp -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.OTF and is embedded into the DLL at compile time — no packing step, and no Unity editor project is involved.

Build

# 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=Release

Compiled outputs:

  • JipperOverlayer/bin/Release/JipperOverlayer.dll
  • JipperOverlayer.Loader.UMM/bin/Release/JipperOverlayer.Loader.UMM.dll
  • JipperOverlayer.Loader.Melon/bin/Release/JipperOverlayer.Loader.Melon.dll

CI/CD

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

License

About

JipperOverlayer ADOFAI overlay mod

Resources

Stars

19 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages