Desktop Tool
Fantasia EXP Tracker
v0.1.41
A real-time screen-OCR overlay for MapleStory Fantasia that reads your EXP bar, character level, and minimap name directly from the game window, and automatically logs per-map sessions with EXP/hr stats to a CSV file.
- Auto-detects the game (or Magpie-scaled) window on startup
- Recognises EXP and level digits via pixel-perfect template matching
- Fuzzy-matches minimap text against the full MapleStory map list
- Tracks a session per map, with rolling EXP/hr and time-to-level estimates
- Logs completed map sessions to
exp_sessions.csv
Installation
1
Extract the zip and run
FantasiaExpTracker.exe. No Python install required.
2
(Optional) Install Tesseract OCR to enable map name detection and per-map session logging.
Download from the UB Mannheim build:
github.com/UB-Mannheim/tesseract/wiki
github.com/UB-Mannheim/tesseract/wiki
3
Accept the default install path —
C:\Program Files\Tesseract-OCR\ —
and the tracker will find it automatically.
Installed Tesseract somewhere else? Set
"tesseract_path" in
exp_tracker_config.json to the full path of tesseract.exe.
The config file is created on first run.
First-Run Setup
Launch Fantasia (and Magpie, if you use it to upscale the window) and log into a character.
Launch the tracker. It will auto-detect the game window and capture a HUD sample automatically. The settings gear will pulse red/gold and Rebuild Templates will be highlighted in blue to let you know templates need to be built.
Open the settings menu and click Rebuild Templates. The builder walks you through two steps — EXP templates, then Level templates — and closes itself when done.
Press Start. The tracker will begin reading EXP and level in real time.
(Optional) Open the settings menu and click Set Map, then drag a box over the map-name text on your minimap. Required for per-map session logging — map position varies by resolution so it must be set manually. Requires Tesseract to be installed.
Completed map sessions (30 seconds or longer by default) are appended to
exp_sessions.csv in the application folder. Map session logging requires Tesseract and a map region to be configured.
Changelog
v0.1.4
- Improved accuracy of exp/hour calculation when there are long gaps between exp (such as killing bosses)
- v0.1.41: Added session time to UI
v0.1.3
- Auto-detection & reliability — Regions now automatically follow the game window when you move or resize it. OCR pauses when the game is minimized or another app is in the foreground, preventing bogus readings.
- First-run experience — Missing templates are auto-captured at startup when the game is visible. The settings gear pulses red/gold and the Rebuild Templates menu entry is highlighted in blue when templates need to be built. The missing-templates popup now tailors its instructions based on whether a HUD sample was captured.
- Template builder — Building EXP and Level templates is now a single two-phase action (Step 1 of 2, Step 2 of 2). Clearer prompts, auto-captured HUD samples, auto-close on final step, and distinct error messages for each failure case.
- Settings menu — SETUP renamed to SET MAP and now opens the map-region picker directly. Region overrides moved under ⚙ → Reset Regions.
- Map database — Expanded from 1876 to 2140 entries, adding Zipangu 2095/2100/2102 arcs, Taipei 101, and other missing maps.
v0.1.2
- Resolved rebuild templates locking up
v0.1.1
- Resolved dependencies incorrectly packaged with the .exe
v0.1.0 — Initial release
- Real-time EXP bar and level OCR via pixel-perfect template matching
- Minimap name detection with fuzzy matching against full map list
- Per-map session tracking with rolling EXP/hr and time-to-level estimates
- Auto-detection of Fantasia and Magpie-scaled game windows
- Session logging to
exp_sessions.csv - Dark and Maple UI themes