Skip to content
Universal Modder Guides

Universal Modder: Mod Any PC Game with AI Agents

v0.2.0-stable / MIT Open Source / Single-Player & Offline Games Only

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.

Autonomous Game Reconnaissance & Sandbox Lab
um scan --engine

# 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.

ENGINEERING TOUR

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.

Universal Modder asset pipeline: fal concept to 3D models and 16 AoE2 headings; fal art to cutout and a 64x26 Terraria sprite
ASSET-01: 3D concept to 16 AoE2 headings; 2D art to a 64x26 Terraria sprite 2D & 3D Asset Processing
Fal Arsenal / example project

Watch the result in a game.

Showcase from the source repository

Recorded example
Project recording
Terraria + Age of Empires II · original showcase View project ↗

Try it: 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.

  1. STEP 1

    Install the plugin

    Add universal-modder to Claude Code, Codex, Cursor or Gemini CLI with two commands.

  2. STEP 2

    Scan, then back up your saves

    um scan fingerprints the game; um backup create snapshots your saves before anything changes.

  3. STEP 3

    Build one slice, verify in-game

    Ask for a MODDING_PLAN.md, ship the smallest working slice, and screenshot the running game.

CASE STUDIES

Shipped Mod Projects

Three concrete modifications built and verified by autonomous coding agents using Universal Modder:

Terraria tModLoader

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.

Synthesized Pixel Weapons & Armor:
Terraria Tactical Nuke missile weapon sprite generated by fal.ai
Nuke
Terraria Homing Missile custom projectile sprite generated by AI
Missile
Terraria Mech Walker armor and vehicle sprite sheet frame
Mech
"Add a tactical nuke that craters tiles and make pixel sprites with fal."
Age of Empires II Genie Engine

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.

Rendered 3D Assets & Unit Icons:
Age of Empires II custom civilization Wonder landmark structure rendered from AI-generated 3D model
Wonder Landmark
Age of Empires II combat drone military unit icon synthesized for custom civ unit roster
Combat Drone
"Make a new civilization with a unique combat unit rendered from 3D."
GTA V × Minecraft WebSocket + Shared Memory

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.

UPSTREAM LINK DESIGN SCHEMATIC
Camera, input, events: WebSocket
Frames and overlay: shared memory
Game mode: GTA V story mode

Source: upstream worked example.

"Put Minecraft inside GTA V. TNT explosions should trigger vehicle damage."
CONNECTORS

How to install Universal Modder

Install the unified skills, fal MCP tools, and command-line utilities into your active coding environment:

6 Options Available
02 OPEN SETUP

Codex

Direct setup via official extension marketplace or skills CLI.

INSTALL COMMAND
codex plugin marketplace add rehan-remade/universal-modder, then codex plugin add universal-modder@universal-modder
PLAYBOOKS

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.

COST TRANSPARENCY

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.

FAQ

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.