MegaBonkPlus
MegaBonkPlus is a BepInEx mod for Megabonk that adds a powerful web dashboard to control, analyze, and modify the game in real-time.
Monitor your character, spawn items, teleport across the map, and manage your inventory—all from a modern web interface running in your browser.
✨ Features
- Web Dashboard: A full-featured frontend application (HTML/CSS/JS) served by a local server.
- Live Game Stats: Track your character's stats (gold, level, etc.) in real-time.
- Inventory Management: Add, remove, or equip weapons and tomes.
- Action System: Execute a wide variety of in-game actions:
- Gameplay: Add gold/levels, kill all enemies, absorb all XP, auto-restart runs.
- Teleportation: Teleport to specific coordinates or to the nearest object of interest.
- Item Spawner: Spawn any in-game item.
- Interactive Minimap: A live minimap in the web dashboard showing your position, enemies, and key objects.
- Hotkey Manager: Configure in-game hotkeys for your favorite actions directly from the web UI.
🚀 Installation
Ensure BepInExPack_IL2CPP (Version 6) is installed for your game.
- Compile this project or download the latest release.
- Place both
MegaBonkPlusMod.dll and its required dependency BonkersLib.dll into your BepInEx/plugins folder.
- Start the game once to allow the mod to generate its configuration files.
🎮 Usage
- Start your game with the mod installed.
- The mod will automatically start a local web server in the background.
- Open your preferred web browser (e.g., Chrome, Firefox).
- Navigate to the following address: http://localhost:8080
- The web dashboard should load and connect to your game.
Note: The port 8080 is the default. This can be changed in the mod's configuration file.
🛠️ Technical Overview
This mod consists of the following components:
- Infrastructure: Starts an
HttpServer (using HttpListener) to handle web requests.
- Controllers: Defines API endpoints (e.g.,
/api/action/..., /api/gamestate) to receive requests from the frontend.
- Actions: Contains the specific logic for all executable cheats/actions (e.g.,
GoldAction, TeleportAction).
- GameLogic: Contains "Trackers" that poll the game state (player position, enemies, etc.) and provide this data to the frontend.
- Frontend: Contains all the static web files (
index.html, js/app.js, css/...) that are served by the HttpServer.
❗ Dependencies
- BonkersLib: This mod relies on
BonkersLib.dll, which provides the core API for interacting with the game.
🤝 Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
📄 License
MIT LICENSE
