ISO Bot — Isometric Game Bot Engine

Overview

Screen-reading bot engine for isometric games. First implementation: Diablo II: Resurrected.

Approach: Screen capture + computer vision + human-like input simulation. No memory injection, no hooking, no client modification.

Repository

Local: /home/openclaw/.openclaw/workspace/projects/iso-bot
Remote: git@git.cloonar.com:openclawd/iso-bot.git (pending repo creation)

Architecture

engine/           # Reusable core — game-agnostic
├── screen/       # Screenshot capture (mss), OCR, template matching
├── input/        # Mouse (bezier curves), keyboard, humanization
├── vision/       # Object detection, color analysis, UI element finding
├── state/        # State machine, event bus
├── navigation/   # Pathfinding (A*), click-to-move
└── safety/       # Session timing, break scheduling, pattern randomization

games/d2r/        # Diablo II: Resurrected implementation
├── config.py     # Screen regions, colors, timings (1920x1080)
├── game.py       # Main bot loop & orchestration
├── screens/      # State detection (menu, in-game, inventory)
├── routines/     # Farming routines (Mephisto, Pindle, Countess)
└── templates/    # UI template images for matching

ui/               # Web dashboard (FastAPI) — planned
config/           # YAML configuration

Key Design Decisions

Screen reading only — captures screenshots, analyzes pixels/templates, never touches game memory
Human-like input — Bezier mouse curves, randomized delays, micro/long breaks, fatigue simulation
Reusable engine — adding a new game = new games/<name>/ directory implementing game-specific detection
Anti-detection — session timing, route randomization, behavioral variation, configurable break schedules
Configuration-driven — YAML configs for all tunable parameters

Tech Stack

Python 3.11+
OpenCV (template matching, color detection)
pytesseract (OCR)
mss (fast screenshot capture)
pyautogui/pynput (input simulation)
FastAPI (dashboard — planned)

Development Conventions

Type hints on all functions
Docstrings on all modules, classes, public methods
black formatting
Tests in tests/
Feature branches → main

Git Workflow

cd /home/openclaw/.openclaw/workspace/projects/iso-bot
git checkout -b feature/<name>
# ... work ...
git add -A && git commit -m "descriptive message"
git checkout main && git merge feature/<name>
git push origin main

Current Status

✅ Project structure created
✅ Core engine modules with meaningful stubs
✅ D2R config (screen regions, colors, timings)
✅ D2R farming routines (Mephisto, Pindle, Countess) — stub phase
⏳ Remote git repo (needs write-access token)
⏳ Implement actual screen detection logic
⏳ Implement input simulation
⏳ Template image collection
⏳ Web dashboard
⏳ Testing

Next Steps (Priority Order)

Get remote repo set up and push
Implement engine/screen/capture.py — verified working on target machine
Implement engine/input/mouse.py — Bezier curve mouse movement
Implement engine/input/keyboard.py — human-like key presses
D2R menu detection (character select, create game)
D2R basic Mephisto run (teleport → kill → loot → exit)
Loot detection and filtering
Web dashboard for monitoring

Notes

Bot runs on a separate machine or VM from the game client
Target resolution: 1920x1080
Primary farming character: Sorceress with Teleport
The user plays D2R (Necro "Baltasar", Summoner build) — knows the game well

3.6 KiB Raw Blame History