MiOW2IP — Minecraft Automation Bot GUI

MiOW2IP is an Electron-based launcher and monitor for Minecraft automation bots. The app manages four bot types—fishing, boating, mining, and flooring—each spawned as a forked Node.js process whose stdout/stderr streams directly to the GUI. The UI is built in React 19 with Tailwind CSS, React Router for navigation, and React Icons; it presents real-time console output, bot state tracking, and control buttons on dedicated pages for each bot.

The architecture splits across three layers: Electron main process (Node.js) orchestrates bot lifecycle, manages IPC channels, and handles system integrations; a preload script securely bridges the React renderer to main via contextBridge; React components subscribe to bot events and emit control signals. Global hotkeys (Ctrl+F2 for fishing, Ctrl+F3 for boating, etc.) toggle bots and navigate the app. Bots use environment variables for tuning and interact with the Minecraft window via a native C++ addon (win_api_loader) that wraps DirectX DXGI screen capture, grayscale + contrast preprocessing, template matching, and mouse/keyboard injection.

A utility layer adds recording, replay, and OCR operations: npm run record captures raw RGBA frames decoupled from diff/templating, npm run replay consumes a manifest to re-run detection offline, and npm run ocr processes diffs through Ollama vision. Bots declare intent via stdout markers (INTENT:LOSE_FOCUS), which trigger focus management to prevent accidental input. All bots listen on stdin for graceful SHUTDOWN commands and clean up resources (keys, hotkeys) on exit.