How walpth/charge-grinder works
Charge Grinder is a desktop automation bot for Limbus Company: the user configures teams and priorities, starts a run, and the bot reads the displayed game, chooses actions, and sends mouse/keyboard input. The documented run spans team selection, floor-pack and route choices, events and battles, then shop gift fusion; Luxcavation is a separate grind mode. The graph also shows the GUI/configuration layer and platform input/capture backends. README capabilities inform the domain branches; sampled excerpts are partial, so uncertain internal call links are omitted.
Main entry points: move.py Mirror Dungeon · Bot.py Bot orchestrator · utils.py Image and action utilities · App.py Application UI
Components 25
Desktop UI
- Application UI
App.py - UI run controls
source_app/run.py - Settings manager
source_app/settings_manager.py
Run control
- Bot orchestrator
Bot.py - Mirror Dungeon
source/move.py - Luxcavation
source/lux.py
Game decisions
- Team selection
source/teams.py - Floor packs
source/pack.py - Route movement
source/move.py - Events
source/event.py - Battle handling
source/battle.py - Gift shop
source/shop.py
Desktop interaction
- Screen capture
source/grab.py - Image and action utilities
source/utils/utils.py - OS backends
source/utils/os_windows_backend.py - X11 backend
source/utils/os_x11_backend.py - Wayland backend
source/utils/os_wayland_backend.py - Mouse movement
source/utils/movement/builder.py - Input bridge
source/utils/bridge/bridge.py - Input profiles
source/utils/profiles.py
Reporting and state
- Run statistics
stats.py - Discord reporting
source/utils/discord_webhook.py
Other components
- User
- Game window
- Discord webhook service
Connections 30
- User → Application UI: configures and starts
- Application UI → Settings manager: reads and saves
- Application UI → UI run controls: starts run
- UI run controls → Bot orchestrator: dispatches
- Bot orchestrator → Mirror Dungeon: runs dungeon
- Bot orchestrator → Luxcavation: runs grind
- Mirror Dungeon → Team selection: selects team
- Mirror Dungeon → Floor packs: selects packs
- Mirror Dungeon → Route movement: chooses next node
- Mirror Dungeon → Events: handles event
- Mirror Dungeon → Battle handling: handles encounter
- Mirror Dungeon → Gift shop: manages gifts
- Team selection → Game window: reads and selects
- Floor packs → Game window: reads and selects
- Route movement → Game window: reads and moves
- Events → Game window: reads and acts
- Battle handling → Game window: reads and acts
- Gift shop → Game window: reads and buys
- Luxcavation → Game window: reads and acts
- Bot orchestrator → Screen capture: captures screen
- Screen capture → Image and action utilities: provides images
- Image and action utilities → OS backends: uses platform input
- Image and action utilities → X11 backend: uses platform input
- Image and action utilities → Wayland backend: uses platform input
- Image and action utilities → Mouse movement: builds pointer motion
- Mouse movement → Input profiles: uses profiles
- Image and action utilities → Input bridge: sends input
- Bot orchestrator → Run statistics: records run metrics
- Bot orchestrator → Discord reporting: emits run events
- Discord reporting → Discord webhook service: sends notifications