How aynamuk/maplestoryautolevelup-cn works
This is a Windows computer-vision auto-leveling tool for MapleStory’s remade Chinese client. Its main workflow is to capture the game window, locate the player on the minimap, detect nearby monsters, follow configured routes, and issue keyboard commands through the Interception driver. The UI manages settings and launches route/template tools; the runtime also supports health/mana monitoring with automatic potions, stuck alerts, and home-route recovery. Core engine wiring is documented and partly sampled; links to unsampled feature modules are limited to documented responsibilities.
Main entry points: MapleStoryAutoLevelUp.py Bot engine · AutoBotController.py Bot controller · ui.py Control window · hunting.py Hunting state
Components 20
Interface and setup
- Application entry
src/main.py - Control window
src/ui/ui.py - Bot controller
src/ui/AutoBotController.py - Route recorder
tools/routeRecorder.py
Capture and perception
- Window capture
src/input/GameWindowCapturor.py - Vision utilities
src/utils/common.py - Bar reading
src/utils/bars.py - Monster templates
src/utils/mob_library.py
Automation runtime
- Bot engine
src/engine/MapleStoryAutoLevelUp.py - State machine
src/engine/FiniteStateMachine.py - Hunting state
src/states/hunting.py - State base
src/states/base_state.py - Home-route logic
src/utils/home_route.py - Potion policy
src/utils/potions.py - Stuck alerts
src/utils/stuck_alert.py
Input and state
- Keyboard control
src/input/KeyBoardController.py - Interception adapter
src/input/InterceptionController.py - Hotkey listener
src/input/KeyBoardListener.py
Other components
- User
- Game client
Connections 26
- User → Control window: configures and starts
- Application entry → Control window: creates
- Application entry → Bot controller: creates
- Control window → Bot controller: commands
- Bot controller → Bot engine: configures and starts
- Bot controller → Interception adapter: checks availability
- Control window → Route recorder: launches tools
- Route recorder → Window capture: captures game window
- Bot engine → Window capture: obtains frames
- Window capture → Game client: captures window
- Bot engine → Vision utilities: uses image helpers
- Bot engine → Monster templates: uses monster templates
- Bot engine → Bar reading: reads health and mana
- Bot engine → Home-route logic: uses route recovery
- Bot engine → Potion policy: checks potion policy
- Bot engine → Stuck alerts: handles stuck alerts
- Bot engine → State machine: runs state machine
- State machine → Hunting state: dispatches state
- Hunting state → Bot engine: updates route and combat commands
- Hunting state → Keyboard control: sets commands
- Bot engine → Keyboard control: controls
- Keyboard control → Interception adapter: sends key events
- Interception adapter → Game client: delivers simulated input
- Bot engine → Hotkey listener: uses hotkeys
- Hotkey listener → Bot controller: signals hotkeys
- State base → Hunting state: provides state base