MimcBot
Electron GUI for automating Minecraft tasks—fishing, boating, mining—with real-time console streaming and native Windows API bindings.
A desktop application that automates repetitive Minecraft tasks through an intuitive React interface. Runs bot scripts as child processes with live console output, integrates native Windows APIs for game window manipulation and template matching, and provides global hotkeys for hands-free control.
- Electron 38
- React 19
- TypeScript
- Vite
- Tailwind CSS 4
- React Router 7
- React Icons
- C++17 (node-gyp)
- Windows API
- GDI+
MimcBot is an Electron desktop app built to automate Minecraft gameplay tasks: fishing, boating, mining, and flooring. It spins up bot processes scripted in Node.js, streams their output to the UI in real-time, and communicates via IPC between the main Electron process and the renderer (React).
The fishing bot uses template matching—grayscale pixel detection on captured game frames—to detect bobber splashes and automate cast-and-reel cycles. A custom C++ addon built with node-gyp and Windows API calls handles window capture, template scanning, mouse/keyboard input, and game window positioning. The bot logic runs as a separate process so I can interrupt and start it from the UI or via global hotkeys (Ctrl+F2 for fishing, Ctrl+F3 for boating, etc.).
The interface is a modern dark-themed React app with a sidebar navigator, per-bot console output, status overlays that render on top of the Minecraft window, and a custom title bar. I hand-built the loading screen, overlay positioning logic, and focus management so the app can gracefully yield control to the game when needed. The app bundles successfully with electron-builder into a Windows NSIS installer.
- Multi-bot orchestration: Four independent bot scripts (fishing, boating, mining, flooring) managed from one control panel with graceful shutdown and cleanup.
- Real-time console streaming: Bot stdout/stderr piped to the React UI as they execute; parsed for state changes and performance metrics.
- Native Windows API bindings: C++ addon built with node-gyp exposes window capture, pixel template matching, mouse/keyboard input, and game window repositioning.
- Global hotkey system: Ctrl+F-key combos navigate to bot pages and toggle bots without focus loss, routed through IPC from main process to renderer.
- Graceful process management: Bots listen on stdin for SHUTDOWN signals and clean up resources before exit; 2-second timeout before force-kill.