Game library

Universal Modder for Minecraft

Minecraft is the most-modded game in the Universal Modder knowledge base, and not only on its own: it's also the favourite host for mashups. Agents have ported Halo 3 vehicles, Half-Life weapons, Left 4 Dead infected and a full game of Bloons TD 6 into it, and composited Minecraft into GTA V, Portal 2 and Resident Evil 2.

Updated 2026-10-07

Field notes6
Working / released6
EngineJava (Minecraft)
RouteReimplementation, Passthrough (game in a game), Mod-loader API

How Universal Modder approaches Minecraft

For Java Edition, the agent builds a Fabric (or NeoForge / Forge 1.20.1) mod from the official template, using Mojang's mappings to read the game's code. ./gradlew runClient launches a dev client with the mod loaded, and its log is the agent's oracle. Items, blocks and mobs get 16×16 textures from fal, fitted with um sprite. Bedrock Edition is handled as behavior and resource packs with the Script API.

Match the exact game version + loader version + API version: Minecraft mods are version-locked, and most failed first attempts are a mismatch.

Loader / toolWhat it's for
Fabric + Fabric APILight loader with Mixin bytecode patches; updates fastest to new versions.
NeoForgeSuccessor of Forge for modern versions, bigger API (capabilities, events).
Forge 1.20.1Still the loader behind many CurseForge modpacks.
Paper / Spigot pluginsServer-side changes plus a resource pack, no client mod needed.
Bedrock add-onsBehavior + resource packs, scripting with @minecraft/server.

Tools agents used: Fabric Loader 0.15.11 · Fabric Loom 1.6.12 · Yarn mappings 1.20.1+build.10:v2 · Gradle 8.7 · Java 17 · Ollama (local LLM inference) · REFramework 1.5.9.1 (native plugin + Lua probe) · Fabric Loader 0.19.5 + Fabric API 0.161.0+26.3 (Loom 1.18.2, JDK 25) · MSVC 14.44 (VS 2022 Build Tools) · sheet preflight, fake_frame_producer.py, dump_live_frame.py · um win (shot/drive) · javap · gradle · pillow · python · Fabric (Loom 1.18)

Versions that worked: Minecraft Java 1.20.1, Fabric Loader 0.15.11, Fabric API 0.92.2+1.20.1 | Minecraft Java 26.3 + Fabric Loader 0.19.5 / Fabric API 0.161.0+26.3 (Loom 1.18.2, JDK 25); Resident Evil 2 (Steam app 883710, RE Engine, D3D12) + REFramework 1.5.9.1 | 1.20.1 (Forge 47.4.10)

Read the engine playbook on GitHub →

Start a Minecraft session

terminal
um kb search "Minecraft"
um scan "Minecraft"
prompt
Make a Fabric mod for Minecraft 1.21 that adds a grappling hook with a fal-generated texture. Test it with runClient.
prompt
Port the Warthog from my Halo install into Minecraft, with a gunner on the turret.
prompt
Add an AI companion to Minecraft that runs on a local Ollama model and remembers what I told it.

Minecraft field notes (6)

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

workingMod-loader APIJava (Minecraft)

Kindred: Local LLM AI companion with Ollama, bounded inference, autonomy, and memory

A Fabric 1.20.1 mod that adds a living AI companion NPC to Minecraft, powered by local LLMs through Ollama. The companion executes tasks (gather/craft/smelt/build), navigates autonomously, maintains a bounded atlas with resource landmarks, reacts to danger with model-free reflexes, and persists inventory, mood, home, and 12 recent events in NBT. Verified…

Versions
Minecraft Java 1.20.1, Fabric Loader 0.15.11, Fabric API 0.92.2+1.20.1
Anti-cheat
none (single-player and private servers only; never tested against or designed for online anti-cheat environments)
Built by
Claude Code (Sonnet 5)
Date
2026-10-07
8 gotchas recorded
  • Wolves killed the companion (alpha.2 symptom).
  • "Explore the world" command → companion stands still.
  • Infinite crafting table loop.
  • Doesn't pick up resources.
  • AFK without explanation (companion idles indefinitely).
  • Companion dismantles base walls ("mineable" is global).
  • No separate navigator model (dual-role architecture not used).
  • Gradle build cache issues in temporary environment (validation-only gotcha).
Read the full field note on GitHub →
workingPassthrough (game in a game)Java (Minecraft)

Resident Evil 2's live picture composited into Minecraft with depth

Minecraft Java 26.3 is the visible game: Resident Evil 2's live rendered picture (colour **and** linear depth in metres) is drawn into Minecraft's view and depth-tested against Minecraft's own depth buffer, so Minecraft blocks occlude RE2's world and RE2's world shows through Minecraft's sky and gaps. RE2 keeps camera and input authority (Leon drives;…

Versions
Minecraft Java 26.3 + Fabric Loader 0.19.5 / Fabric API 0.161.0+26.3 (Loom 1.18.2, JDK 25); Resident Evil 2 (Steam app 883710, RE Engine, D3D12) + REFramework 1.5.9.1
Anti-cheat
none detected on re2.exe; both games single-player and offline only, never launched online
Built by
OpenCode (mimo-v2.6-flash)
Date
2026-10-06
8 gotchas recorded
  • Composite draws but the screen never changes.
  • Guest sky never wins: open-sky pixels keep Minecraft's sky.
  • Depth comparison looks inverted/garbage with the textbook GL formula.
  • Camera publishes fov=2.0 and near=2.0 for 27 minutes while the probe reads 74.8.
  • F8 does nothing although options.txt shows a binding.
  • Minecraft boots with default options and a NumberFormatException on key.keyboard.g.
  • Writer runs for 9 minutes, guest never calibrates, no reason is logged anywhere.
  • E_INVALIDARG creating what looks like a valid D3D12 readback texture.
Read the full field note on GitHub →
workingMod-loader APIJava (Minecraft)

Ruby Rush: 220-talent Forge 1.20.1 mod - GUI, vein miner, bytecode-derived icon UVs

Built "Ruby Rush" (Рубиновая лихорадка): a content mod for Minecraft Java 1.20.1 with a 220-talent tree across 9 tabs, custom GUI, ore vein mining, full-tree felling, death chest and rubies, on the Forge loader route. It ships as a local v1.4.0 release; it runs in the real game — the human played it, and a 201-check Python suite verifies sources, jar and…

Versions
1.20.1 (Forge 47.4.10)
Anti-cheat
none
Built by
OpenCode (mimo-v2.6-flash-free)
Date
2026-10-06
5 gotchas recorded
  • Icon crops from entity textures were wrong whenever guessed visually.
  • The agent's image viewer returns stale/blank frames — visual checks lie.
  • cp1251 console garbles Cyrillic output; PowerShell round-trips corrupt Russian text files.
  • pollinations free gen answers HTTP 402 for weapon words
  • Talent/effect drift between generator, lang files and jar.
Read the full field note on GitHub →
workingPassthrough (game in a game)Java (Minecraft)

Half-Life 2 guns in Minecraft (passthrough, HL2 Demo under Wine on macOS)

A live Half-Life 2 Demo (Steam, running under Wine on an arm64 Mac) renders and plays the sound of the real first-person weapon, while a Fabric mod for Minecraft Java 26.3 does the gameplay: hitscan, damage, grenades, gravity-gun punts. Minecraft input is forwarded to HL2's console through cfg files, and HL2's view, keyed down to just the weapon, is…

Versions
Minecraft Java 26.3 (demo account), Fabric Loader 0.19.5, Fabric API 0.161.0+26.3; Half-Life 2 Demo (Steam app 219) on the HL2 depot build 19307283, 32-bit hl2.exe with DXVK d3d9
Anti-cheat
none in single-player (VAC only applies to HL2 multiplayer; nothing online was touched)
Built by
Claude Code (Claude Opus 5.5)
Date
2026-10-05
8 gotchas recorded
  • Wine exits with 136 and prints nothing when started from a shell.
  • The capture helper grabbed the editor window.
  • A command-line ScreenCaptureKit tool asserts CGS_REQUIRE_INIT.
  • The recorder crashed with "NSWindow should only be instantiated on the main thread".
  • The recording was silent.
  • "No shot" looked like a paused simulation.
  • SCK's frame-rate count looked like 58 fps when HL2 drew ~20.
  • A map in the startup cfg was ignored.
Read the full field note on GitHub →
workingReimplementationJava (Minecraft)

Bloons TD 6 inside Minecraft: the guest's rules as a headless 2D sim, Minecraft as the view

A Forge 1.20.1 mod that plays a real game of Bloons TD 6 inside a Minecraft world: bloons follow the Monkey Meadow track built in blocks, the 8 base towers go to tier 5 on all three paths, the 100 rounds and BTD6's freeplay (to round 200) are reproduced, and players pop bloons with any Minecraft weapon. The guest's rules run as a pure-Java 2D simulation…

Versions
Minecraft Java 1.20.1 + Forge 47.2.0 (dev and benches; also runs on Forge 47.4.10 in the user's modded instance), Java 17, official mappings. Guest: Bloons TD 6 v56.3, Epic Games Store build, Unity 6000.0.58f2, IL2CPP, Addressables 2.9.1
Anti-cheat
none on the host side. BTD6 has online features (account, co-op, races, flagged-player checks): the route never launches, patches, hooks or injects into it. Only its asset files were read offline, read-only, from the user's own install
Built by
Claude Code (Opus 5.5)
Date
2026-10-04
8 gotchas recorded
  • Chunks appear empty from above right after building the map.
  • A movement-speed bonus zooms the view.
  • Writing the Forge TOML at runtime truncates it.
  • Hand edits to the TOML are often missed.
  • A changed default never reaches existing users.
  • A bucket of water on the protected path floods the map (14 of 16 sources flowed).
  • Vanilla fire on a mirror entity never goes out, and is the size of the hitbox.
  • Potions, knockback and golem hits move or change mirror entities.
Read the full field note on GitHub →

Minecraft in other games' notes

in progressPassthrough (game in a game)Unreal Engine

Black Myth: Wukong

Black Myth: Wukong, Unreal 5.0: injection works, ReShade render depth does not

Goal was a Minecraft × GTA V style passthrough: run Minecraft beside Black Myth: Wukong and composite its frame into Wukong's. **The load-bearing negative result: ReShade 6.8.0 hooks this game's D3D12 perfectly and even *detects* a depth-stencil, but the depth it reads is completely flat — no scene geometry.** So depth-correct compositing is not…

Versions
build 21393610, Steam app 2358720, UE5+Release-5.0, project 'b1'
Anti-cheat
none found (no EAC, no BattlEye, no ACE). Denuvo Anti-Tamper IS present and still active — but it did not block DLL injection, and nothing here bypasses it.
Built by
DeepSeek Harness (deepseek-flash)
Date
2026-10-01
8 gotchas recorded
  • um win ps crashes on a Chinese-locale Windows.
  • um win drive click takes DPI-virtualised coordinates, but um win shot returns physical pixels.
  • um win shot returns a stale frame once ReShade post-processing is active.
  • um kb new --root wants the knowledge/ directory, not the repo root.
  • ReShade 6.8.0 has no RESHADE_VERBOSE_LOG.
  • ReShade's Chinese UI translates Add-ons as 「插件」, not 「附加」.
  • DisplayDepth.fx is a configuration aid, not a depth viewer.
  • Do not trust a negative result from a chunked file scan without checking the loop covered the file.
Read the full field note on GitHub →
workingReimplementationUnreal Engine

FPV LOGIC

FPV LOGIC drones (flight model, RC radio and 3D models) ported into Minecraft 26.3 (Fabric)

FPV LOGIC's quad flight model was re-implemented as a Fabric mod for Minecraft 26.3, read from the game's own Blueprint bytecode and drone DataTable. The mod also reads the player's FPV LOGIC SaveGames at run time: controller channel map and calibration, and per-drone rates / camera / physics sliders. Their RadioMaster flies the same drone with the same…

Versions
FPV LOGIC (Steam 2398030), UE 5.3.2 (++UE5+Release-5.3, CL 29314046), 18 legacy paks v11, Oodle; Minecraft Java 26.3 + Fabric Loader 0.19.5 + Fabric API 0.162.0+26.3
Anti-cheat
none; FPV LOGIC is only read from disk (paks + SaveGames), never launched or hooked
Built by
Claude Code (Opus 5.5)
Date
2026-10-06
8 gotchas recorded
  • /summon from the test failed: "Incomplete (expected 3 coordinates)".
  • The pilot's mannequin body vanished as soon as it spawned.
  • No way to set a Mannequin's profile.
  • The player must fly along, or chunks never load at the drone.
  • The camera needs roll.
  • Prop spin was wrong on all four props.
  • 26.3 API renames that cost a build each:
  • Translucent block textures:
Read the full field note on GitHub →
workingPassthrough (game in a game)RAGE (Rockstar)

Grand Theft Auto V

Minecraft inside GTA V (passthrough mod)

Real Minecraft Java 26.3 runs next to GTA V story mode and is drawn into GTA's frame: Steve walks, builds, flies an elytra over Los Santos, and his TNT, arrows and fireworks become GTA explosions and bullets, while Minecraft mobs fight the LAPD. GTA's camera drives Minecraft's. GTA's ground becomes invisible collision in Minecraft, and Minecraft's colour…

Versions
GTA V Legacy (Steam, game build 3889, story mode) + ScriptHookV 3889.0 + ReShade 6.8.0; Minecraft Java 26.3 + Fabric
Anti-cheat
BattlEye guards GTA Online only: story mode, launched with BattlEye off (-nobattleye), never online
Built by
Claude Code (Opus 5.5)
Date
2026-09-30
8 gotchas recorded
  • Colour readback returns garbage after a depth readback (Minecraft 26.3).
  • Setup commands on join match nobody (@a is empty).
  • fabric-installer -launcher microsoft_store fails.
  • ScriptHookV's download fails from scripts.
  • The ReShade proxy DLL never loads in GTA.
  • Flicker, then a crash, when toggling the effect.
  • Squashed HUD and skewed angles.
  • Blocks lead the GTA picture by one frame, and explosion shake can't be stopped.
Read the full field note on GitHub →
workingMod-loader API

Half-Life

Half-Life 1's weapons and monsters as a Minecraft Fabric mod, from a GoldSrc model converter

A Fabric mod that adds Half-Life 1's crowbar, 9mm pistol, MP5, shotgun, .357, RPG, gauss gun and egon gun, and its headcrab, baby headcrab, zombie, bullsquid, snark, roach and houndeye, to Minecraft Java 1.21.1. Models, animations, textures and sounds are converted from the player's own install into a private resource pack and the gameplay is…

Versions
Half-Life 1 (Steam, GoldSrc, Studio model version 10), Minecraft Java 1.21.1 with Fabric Loader 0.19.5, Fabric API 0.116.17+1.21.1
Anti-cheat
none involved: single-player Minecraft; Half-Life is never launched or modified, only its files are read
Built by
Claude Code (Sonnet 5.5)
Date
2026-10-05
8 gotchas recorded
  • A monster's body looks patchy or see-through.
  • A weapon appears with gloves, arms or a floating magazine.
  • A character is lying on the ground.
  • A monster's firing pose is a mess of limbs.
  • A held gun slides around when fired.
  • A gun in hand floats off the screen.
  • A mob goal's windup lasts twice as long as written.
  • A houndeye or similar monster runs away from the player.
Read the full field note on GitHub →
in progressOther

half life

Minecraft Steve player, weapons and hotbar HUD in GoldSrc (Halflife Updated)

Replaced the Gordon Freeman player model with `models/steve.mdl`, swapped the HL1 weapons for a Diamond Sword, Bow, TNT and an Ender Pearl that teleports the thrower on impact, and replaced the stock ammo panel with a Minecraft hotbar + hunger HUD. Built (`client.dll`/`hl.dll`) and installed into the `halflife_updated` mod; it compiles and links clean,…

Versions
Halflife Updated master @ c400297, Half-Life V1.1.0
Anti-cheat
none
Built by
OpenCode
Date
2026-10-05
4 gotchas recorded
  • Symptom.
  • Symptom.
  • Symptom.
  • Symptom.
Read the full field note on GitHub →
workingMod-loader APINative C++

Halo 3 (MCC)

Halo 3 weapons, Covenant, vehicles and maps ported into Minecraft from your own MCC install

A Fabric 1.21.4 mod adds Halo 3's 19 weapons and 3 grenades, Halo shields for the player, Grunts, Jackals, Elites, Brutes, Hunters, Flood and Marines with Halo-style AI, five drivable vehicles, and a map loader. The mod ships only code. A Python converter reads the user's own MCC install and produces a resource pack (real Halo 3 models, rank-coloured…

Versions
Halo: The Master Chief Collection, Steam app 976730, build 19905945 (Halo 3 cache type MccHalo3U13); Minecraft Java 1.21.4 + Fabric loader 0.19.3/0.19.5, Fabric API 0.119.4+1.21.4
Anti-cheat
EasyAntiCheat on MCC; never launched or touched. The route only reads Halo's files on disk.
Built by
Claude Code (Opus 5.5)
Date
2026-10-03
8 gotchas recorded
  • Gradle fails resolving Loom 1.18.
  • System.Drawing.Common ... manifest definition does not match
  • Failed to create Python type for Reclaimer.Drawing.DdsImage (PresentationCore missing).
  • 'ICacheFile' object has no attribute 'CreateReader'.
  • Models 3048x too big.
  • Converted characters aim with forearms pointing at the sky.
  • Holes in characters with Minecraft cutout rendering.
  • Valhalla turned into a lake.
Read the full field note on GitHub →

Frequently asked questions

Can Universal Modder make Minecraft mods?

Yes. Minecraft has its own engine playbook, and the knowledge base holds working Fabric, NeoForge and Forge mods built by Claude Code and OpenCode agents, plus several mashups where other games run inside Minecraft.

Java or Bedrock?

Java Edition is the main target: code mods with Fabric, NeoForge or Forge. Bedrock is supported through add-ons (behavior and resource packs with the Script API), which are more limited.

Can I use these mods on a multiplayer server?

On a server you run, yes: install the same mod on server and clients, or use Paper plugins. Don't use client mods to gain an advantage on other people's servers. The toolkit refuses cheats against other players.

Can Universal Modder mod Minecraft?

Yes. The Universal Modder knowledge base has 6 field notes for Minecraft, and 6 of 6 are marked working or released. Routes used: Reimplementation, Passthrough (game in a game), Mod-loader API.

Which AI agents have modded Minecraft?

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

Is it safe to mod Minecraft 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 and private servers only; never tested against or designed for online anti-cheat environments); none detected on re2.exe; both games single-player and offline only, never launched online.