Magic Garden Bot

An advanced browser extension for automating and enhancing gameplay in Magic Garden. This bot injects a powerful utility sidebar directly into the game, offering automation features, real-time data visualization, and smart decision-making assistance.

✨ Key Features

🤖 Automation

Auto Plant: Automatically replants crops in empty tiles.
Auto Harvest: Harvests crops when they are ready.
Smart Harvest: Uses advanced decision logic (Bellman Equation) to wait for optimal crop mutations (e.g., waiting for specific weather conditions to maximize value) before harvesting.
Auto Sell: Automatically sells harvested resources to free up inventory space.
Auto Feed Pets: Keeps your equipped pets fed with the cheapest compatible food from your inventory.

🖥️ User Interface

The bot features a clean, dark-themed UI that blends into the game.

Control Panel: A sidebar for toggling specific automation features on/off.
Overlays: Draggable, floating windows for deeper insight:
- Garden Overlay: Visual representation of plot status.
- Inventory Overlay: Filterable view of your items.
- Shop Overlay: Quick view of shop contents.
- Players Overlay: See other players in the vicinity.
- Pets Overlay: Manage your pets, view hunger levels, and toggle auto-feed per pet.
- Model/Decision Overlay: Visualizes the decision boundary for "Smart Harvest," showing potential value vs. current value.

🛠️ Visualizers & Logs

Log Viewer: Searchable log of bot actions and network traffic.
Network Filtering: specific filters to inspect socket message traffic.

🚀 Installation

Clone or download this repository.
Open Chrome (or a Chromium-based browser) and navigate to chrome://extensions.
Enable Developer Mode (toggle in the top right).
Click Load unpacked.
Select the extension folder from this project.
Navigate to Magic Garden (the bot will load automatically).

🎮 Usage

Controls

Toggle UI: Press Insert or Backquote (`) to show/hide the sidebar.
Sidebar: Click the arrow icons to expand/collapse sections.
Overlays: Windows are draggable. Close them with the X button.

Configuration

Automation settings are adjustable in the sidebar. "Smart Harvest" can be toggled to prioritize long-term value over immediate harvesting.

🏗️ Development

Project Structure

extension/manifest.json: Extension configuration.
extension/content_loader.js: Entry point that injects the bot.
extension/modules/: Core logic modules.
- main.js: Central loop and event orchestration.
- decision.js: Logic for Smart Harvest valuations.
- ui/: UI components and style definitions.
  - ui_manager.js: Manages the sidebar and overlays.
  - overlays/: Individual overlay implementations (Pets, Inventory, etc.).

Permissions

The extension requires:

activeTab & scripting: To inject the bot into the game page.
Host permissions for magicgarden.gg.

3.1 KiB Raw Blame History