Universal Modder: Mod Any PC Game with AI Agents
Reverse engineer, write code slices, and synthesize assets in your PC games.
An open-source toolkit that gives Claude Code, Codex, Cursor, and Gemini real hooks into game binaries. The agent fingerprints your installed engine, isolates your save directory, decompiles classes, generates art with fal.ai, and verifies the mod in a running game window.
# 1. Fingerprint installed executable & check anti-cheat boundary
$ um scan "/SteamLibrary/steamapps/common/SlayTheSpire"
[RECON] Found desktop-1.0.jar · Runtime: Java LibGDX · Loader: ModTheSpire
[SCAN] anti-cheat: none found (single-player offline client)
# 2. Automated save isolation before touching any binaries
$ um backup create "...\Documents\SlayTheSpire" --name before-first-mod
[BACKUP] Snapshot written to ~/.universal-modder/backups/before-first-mod/20261005-140812.zip (17 files, 3.2 MB)
# 3. Compile vertical slice with fal.ai sprite synthesis
[SLICE] Registered relic: VoidPrism.java | Generated 32x32 transparent PNG via fal
✓ Window launched for automated verification.
ANTI-CHEAT SHIELD
Refuses Online Games
Agent safety rules refuse injection if EAC, BattlEye, VAC, or Vanguard are present.
SAVE INTEGRITY
Snapshot Sandboxes
Runs automated save snapshots (um backup) before code execution.
COMPATIBILITY
12 Engine Playbooks
Pre-built playbooks for Unity, Unreal, .NET, Godot, Source 1/2, Genie, C++.
LICENSING
MIT Permissive
100% free toolkit. No proprietary SDKs, no telemetry, no tracking.
Your first mod: what to type and what happens
Every mod follows an identical, verifiable cycle. The agent never guesses APIs or touches your production files blind.
Watch the result in a game.
Showcase from the source repository
Start with the thing you wish was in the game.
“A missile launcher that follows enemies.
A tactical nuke that leaves a crater.”
For this example, the modding route is already documented.
.NET / XNAC# · ModItemThe example includes a separate save-directory option. Test destructive mods in a spare world.
public override void SetDefaults() {
Item.width = 64; Item.height = 26;
Item.damage = 60;
Item.shoot = ModContent.ProjectileType<HomingMissile>();
} click the four steps above, or hit “Replay the build”. In Build you can zoom into the shipped sprite.
Artwork, sprite, code and recording: Universal Modder / Rehan & contributors.
A useful first session
Read the full first-session tutorial-
STEP 1
Install the plugin
Add universal-modder to Claude Code, Codex, Cursor or Gemini CLI with two commands.
-
STEP 2
Scan, then back up your saves
um scan fingerprints the game; um backup create snapshots your saves before anything changes.
-
STEP 3
Build one slice, verify in-game
Ask for a MODDING_PLAN.md, ship the smallest working slice, and screenshot the running game.
Shipped Mod Projects
Three concrete modifications built and verified by autonomous coding agents using Universal Modder:
Tactical Nuke & Homing Missiles
Autonomous agent reverse-engineered weapon projectiles, hooked explosion physics to crater world tiles, and generated 16x16 pixel sprites using fal.ai.
Custom Civilization & 3D Units
Coordinated text-to-3D GLB generation with headless Blender scripts to render 16-direction isometric sprite frames loaded into AoE2 Genie unit slots.
Cross-Game Event & Frame Bridge
Real Minecraft is composited into GTA V story mode. WebSocket carries camera, input, and gameplay events; shared memory carries Minecraft's colour and depth frames and its overlay.
Source: upstream worked example.
How to install Universal Modder
Install the unified skills, fal MCP tools, and command-line utilities into your active coding environment:
Gemini CLI
Direct setup via official extension marketplace or skills CLI.
VS Code
Direct setup via official extension marketplace or skills CLI.
Plain skills
Direct setup via official extension marketplace or skills CLI.
Which games and engines are supported
Pre-configured reverse-engineering and modding routes tested on commercial, classic, and indie titles:
Unity
BepInEx, Cpp2IL, Harmony, IL2CPP.
Unreal Engine
UE4SS, live Lua, C++ hooks.
.NET / XNA
Terraria (tModLoader), SMAPI.
Source 1 & 2
Valve VPK, console CFG scripts.
Godot
PCK unpacking, GDScript injection.
Bethesda
Skyrim, Fallout, Starfield ESM/ESP.
Minecraft
Fabric and NeoForge code mods.
Indie & Custom
Genie (AoE2), GameMaker, RPG Maker.
How much does Universal Modder actually cost?
The short answer: the tool is free, your AI assistant's plan is the main cost, and generated art is optional.
Is Universal Modder itself free?
Yes. The um CLI, agent skills, game playbooks and the knowledge base are free under the MIT license. No proprietary SDKs, no telemetry, no tracking.
What do I pay my AI coding assistant?
Your own plan. Claude Code runs on a Claude Pro subscription (US$20/month) or API credits; Codex, Cursor and Gemini CLI use their existing plans. The assistant subscription is the main cost of a session.
Do I pay to generate art or 3D models?
Only if you want generated assets. Sprites, models and sound run on fal.ai's pay-per-use API balance — and your first mod can skip fal entirely, because code-only mods run without an API key.
Frequently Asked Questions
Direct answers to common questions about using AI agents for PC game modification:
Can I get banned from my games for using Universal Modder? ▼
Universal Modder is strictly restricted to legally owned single-player PC games, local mod sandboxes, and servers you host. Its project rules refuse to interact with or inject into multiplayer games protected by anti-cheat systems (such as Easy Anti-Cheat, BattlEye, Valve Anti-Cheat, or Vanguard). Always respect these boundaries and do not tamper with protected online clients.
Do I need to be a programmer or know reverse engineering? ▼
No. You describe your idea in natural language (for example, "Add a grappling hook with double the range and a custom sound effect"). The AI agent coordinates the underlying tools: decompiling or reading classes, finding hook locations, writing mod loader code, and formatting game-compatible assets.
Will Universal Modder touch or corrupt my existing save files? ▼
No. The agent's safety rules require it to run an automated save snapshot (um backup) before testing any code. It also launches games with dedicated sandbox save directories wherever supported, helping isolate your original characters and worlds from modified files.
Which operating systems are supported? ▼
Windows 10 and Windows 11 provide the most comprehensive support, as the majority of moddable PC games and window automation tools run natively on Windows. However, AI coding agents and CLI workflows can also be operated from macOS or Linux, with game execution handled via WSL or native ports.
How do I start modding my first game right now? ▼
Start by picking an AI coding assistant in the agent selection section above. If you use Claude Code, check out our step-by-step Claude Code Installation Guide to set up the marketplace plugin in under five minutes.