sonpiaz/4x-game-agent

LLM-powered AI agent framework for 4X mobile strategy games (Rise of Kingdoms, Evony, Lords Mobile, etc.). 5-layer hybrid architecture: OCR → FSM → World Model → Workflows → LLM Vision. 99% cheaper than pure LLM approach.

39
/ 100
Emerging

Integrates with Android emulators (ADB) and uses PaddleOCR for screen reading, with optional Claude API integration for strategic decision-making every 30 minutes. The framework employs a self-improving workflow system that learns UI positions via template matching and avoids repeated failures through reflection logging. Designed as a pluggable multi-game platform with YAML-driven configuration, enabling rapid adaptation to new 4X strategy titles through coordinate mapping and FSM state definitions rather than code rewrites.

No Package No Dependents
Maintenance 13 / 25
Adoption 2 / 25
Maturity 9 / 25
Community 15 / 25

How are scores calculated?

Stars

2

Forks

4

Language

Python

License

MIT

Last pushed

Mar 15, 2026

Commits (30d)

0

Get this data via API

curl "https://pt-edge.onrender.com/api/v1/quality/agents/sonpiaz/4x-game-agent"

Open to everyone — 100 requests/day, no key needed. Get a free key for 1,000/day.