How jhazewindus/auto-maplev2 works
Auto Maple is a desktop bot that automates MapleStory play. The user loads a class-specific command book and a map routine; the bot interprets routine components, tracks the player from captured game frames, navigates between points, and issues simulated inputs. Separate capabilities include rune solving and a GUI for monitoring, editing routines, changing settings, and loading resources. The README documents these features, while several implementation links—especially capture and rune-inference internals—are not shown in the excerpts, so those relationships are omitted or marked unverified.
Main entry points: bot.py Bot Interpreter · components.py Routine Components · main.py Application Entry · gui GUI Tabs
Components 21
Bot Runtime
- Application Entry
main.py - Bot Interpreter
src/modules/bot.py - Frame Capture
src/modules/capture.py - Keyboard Listener
src/modules/listener.py - Notifier
src/modules/notifier.py
Play Logic
- Vision Detection
src/detection/detection.py - Routine Compiler
src/routine/routine.py - Routine Components
src/routine/components.py - Minimap Layout
src/routine/layout.py - Command Books
src/command_book/command_book.py
Desktop Interface
- GUI Host
src/modules/gui.py - GUI Tabs
src/gui - Routine Editor
src/gui/edit/main.py - Resource Menus
src/gui/menu - Settings Panel
src/gui/settings/main.py - Routine Viewer
src/gui/view/main.py
Shared Services
- Simulated Inputs
src/common/vkeys.py - Shared Runtime State
src/common/config.py - Runtime Settings
src/common/settings.py
Other components
- Player
- MapleStory
Connections 32
- Player → Application Entry: starts app
- Application Entry → Bot Interpreter: starts
main.py - Application Entry → Frame Capture: starts
main.py - Application Entry → Keyboard Listener: starts
main.py - Application Entry → Notifier: starts
main.py - Application Entry → GUI Host: starts
main.py - GUI Host → GUI Tabs: creates
src/modules/gui.py - GUI Tabs → Resource Menus: creates
src/gui/menu/main.py - GUI Tabs → Routine Viewer: creates
src/gui/view/main.py - GUI Tabs → Routine Editor: creates
src/gui/edit/main.py - GUI Tabs → Settings Panel: creates
src/gui/settings/main.py - Bot Interpreter → Routine Compiler: loads
src/modules/bot.py - Bot Interpreter → Command Books: loads
src/modules/bot.py - Bot Interpreter → Vision Detection: uses
src/modules/bot.py - Routine Compiler → Routine Components: builds
README.md - Routine Compiler → Minimap Layout: uses
src/routine/routine.py - Bot Interpreter → Routine Components: executes
src/modules/bot.py - Routine Components → Simulated Inputs: simulates keys
src/routine/components.py - Bot Interpreter → Simulated Inputs: presses keys
src/modules/bot.py - Routine Components → Minimap Layout: plans movement
src/routine/components.py - Frame Capture → Vision Detection: supplies frames
- Vision Detection → Bot Interpreter: reports position
src/modules/bot.py - Bot Interpreter → MapleStory: controls
README.md - MapleStory → Frame Capture: provides frames
- Bot Interpreter → Shared Runtime State: updates state
src/modules/bot.py - Routine Components → Runtime Settings: reads settings
src/routine/components.py - Routine Editor → Routine Components: edits components
src/gui/edit/main.py - Resource Menus → Command Books: loads resources
- Resource Menus → Routine Compiler: loads routines
- Settings Panel → Shared Runtime State: edits bindings
src/gui/settings/main.py - Routine Viewer → Routine Components: displays routine
src/gui/view/main.py - Notifier → Routine Components: observes events
src/modules/notifier.py