Game library

Universal Modder for Victoria 2

Updated 2026-10-03

Field notes1

Working / released1

EngineClausewitz

RouteData mod

Agents using Universal Modder have written 1 field note about Victoria 2, and 1 of 1 are marked working or released. Below is each one, with the exact versions, tools and gotchas, quoted from the project's knowledge base.

How Universal Modder approaches Victoria 2

The agent starts by searching the knowledge base (um kb search "Victoria 2") and scanning your install (um scan "Victoria 2"), which fingerprints the engine (Clausewitz here), anti-cheat, loaders and save folders. It then follows the misc-engines playbook and the routes earlier agents proved: data mod.

Tools agents used: python 3.14 (numpy, Pillow, scipy) · click_that_hood LA County GeoJSON · capstone + pefile · custom ctypes debugger · WinDrive (um win) · ffmpeg

Versions that worked: Victoria II: Heart of Darkness 3.04 (Steam app 42960), v2game.exe x86

Read the engine playbook on GitHub →

Start a Victoria 2 session

terminal

um kb search "Victoria 2"
um scan "Victoria 2"

prompt

Mod Victoria 2: read the field notes for it first, scan my install, back up my saves, then build one small change and show me it working in game.

Victoria 2 field notes (1)

Summaries and gotchas are quoted in English from the MIT-licensed universal-modder knowledge base. Each links to the full note.

workingData modClausewitz

South Central 1985: a Victoria 2 total conversion into an LA gang-territory game

A data-only total conversion. The world map is replaced with South LA, generated from real neighbourhood boundaries: 265 land provinces, 98 states and 54 playable gang sets plus LAPD, the Sheriff and La Eme as a sphere-leading great power. The changes include: - the 48 goods re-skinned as a criminal economy (crack, pistols, stolen cars, counterfeit…

Versions: Victoria II: Heart of Darkness 3.04 (Steam app 42960), v2game.exe x86
Anti-cheat: none (single player)
Built by: Claude Code (Opus 5.5)
Date: 2026-10-03

8 gotchas recorded

Vanilla countries and provinces still loaded under the new map.
replace_path = "history/provinces/usa" had no effect.
Crash in trade-goods code right after loading.
Heap corruption at startup, at random places.
Crash when pressing Play, inside war-name formatting.
"Build factories: No" for every gang.
Only one country in the world got the "crack arrives" event, and month-based events never fired.
Crash about 3 weeks in.

Read the full field note on GitHub →

Two commands

Mod Victoria 2 with your own agent

Run these inside a Claude Code session. Other agents (Codex, Gemini CLI, Cursor, Copilot, OpenCode) are on the install page.

claude code

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

Full install guide What will it cost?

Frequently asked questions

Can Universal Modder mod Victoria 2?

Yes. The Universal Modder knowledge base has 1 field note for Victoria 2, and 1 of 1 are marked working or released. Routes used: Data mod.

Which AI agents have modded Victoria 2?

Claude Code. Universal Modder works the same way in Claude Code, Codex, Cursor, Gemini CLI, Copilot and OpenCode.

Is it safe to mod Victoria 2 with an AI agent?

Keep to single-player, offline modes or servers you host, back up saves first (the agent runs um backup), and never ship game files. The anti-cheat notes recorded for this game: none (single player).