Hearts of Iron IV

•

Enables AI agents to inspect game state and play Hearts of Iron IV using live memory reads, save parsing, and player command queue injection.

hoi4-mcp bridges external AI agents with Hearts of Iron IV (v1.19.3.0), enabling automated observation and gameplay without relying on console cheats or altered memory values. It provides an advanced multi-layered interface that executes real-time, non-invasive memory reads and injects commands directly into the game's native command queue via special user APCs. Agents can inspect dynamic game metrics, parse full binary save files offline to evaluate country semantics and focus trees, and execute verified in-game actions like setting speeds, selecting national focuses, and managing interfaces while strictly enforcing single-player safety guardrails.

주요 기능

01Native command injection via QueueUserAPC2 targeting the game's actual command queue
02Real-time memory state inspection using ReadProcessMemory without pausing the game
03Complete offline HOI4 binary save parsing with token decoding and national focus tree analysis
04Specialized micro-VM payload execution with VEH crash shield protection
05Integrated single-player safety covenant enforcing read-only modes and multiplayer lockouts
060 GitHub stars

사용 사례

01Automating gameplay sessions and national focus path testing for balance analysis
02Developing and evaluating autonomous AI agents on complex grand strategy gaming benchmarks
03Extracting deep, tick-by-tick world and country telemetry for data analytics and research