Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

kostaman0077/MapleStory-HUD-Skills

Repository files navigation

Skill Tracker Overlay

A high-performance, customizable overlay for tracking skill cooldowns in any game.

Status Platform

Skill Tracker is a lightweight desktop application that monitors specific regions of your screen (your game's skill bar) and creates a floating overlay. This overlay shows you exactly when your skills are ready, even if you're focused on the action in the center of the screen.


🚀 Key Features

  • Real-Time Tracking: Instantly detects when a skill is on cooldown (darkened) or ready (bright).
  • Dynamic Overlay:
    • Drag & Drop: Move the overlay anywhere on your screen.
    • Scalable: Resize the icons to fit your setup ideally.
    • Always on Top: Stays visible over your game window (borderless windowed mode recommended).
  • Easy Configuration:
    • Visual Setup: Simply draw a box around your skill icons to add them.
    • Live Updates: Changes in settings appear immediately on the overlay.
  • Performance: Optimized for minimal impact on your game's FPS.
image image

Animation


📥 Installation

Option A: Standalone Executable (Recommended)

  1. Navigate to the dist/SkillTracker folder.
  2. Run SkillTracker.exe.
  3. No Python installation required.

Option B: Run from Source (For Developers)

  1. Install Python 3.10+.
  2. Install dependencies:
    pip install -r requirements.txt
  3. Run the app:
    python main.py

🎮 User Guide

1. First Run & Setup

When you first launch the application, you'll see an overlay (likely empty or with default slots) and possibly the Settings window.

To open Settings:

  1. Find the overlay on your screen.
  2. Right-Click on the overlay.
  3. Select Settings.

2. Adding Skills

  1. Open the Settings window.
  2. Click "Add New".
  3. Your screen will freeze slightly, and you'll see a crosshair.
  4. Click and Drag to draw a box around a single skill icon in your game.
  5. Release the mouse. The skill is now tracked!
  6. Repeat for as many skills as you want.

3. Customizing the Overlay

  • Move: Simply Left-Click and Drag the overlay window to position it where you want. The position is saved automatically.
  • Resize: In the Settings window, drag the Overlay Scale slider. The icons will grow or shrink in real-time.

4. Managing Skills

  • Edit: Select a skill in the list and click "Edit Selected" to re-draw its detection region.
  • Remove: Select a skill and click "Remove" to delete it.
  • Clear All: Removes all configured skills to start fresh.

🔧 Troubleshooting

  • Overlay is Black/Invisible:
    • Ensure your game is running in Windowed or Borderless Windowed mode. Fullscreen exclusive mode may hide desktop overlays.
  • Skills not detecting correctly:
    • Open config.json and adjust "brightness_threshold" (default is 100). Lower it if skills are detected as "cooldown" too often.
    • Ensure nothing is blocking the game UI (chat windows, notifications).

📦 Building from Source

If you want to modify the code and build your own executable:

  1. Make your changes.
  2. Run the build script:
    python build_exe.py
  3. The new executable will be in dist/SkillTracker/.

About

A real-time, computer-vision-powered skill tracker for MapleStory. Features dynamic OCR for cooldown detection, orientation switching, and a customizable, transparent overlay for high-level bossing optimization.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle によって変換されたページ (->オリジナル) /