游戏库

用 Universal Modder 改 Minecraft(我的世界)

Minecraft 是 Universal Modder 知识库里被改得最多的游戏,而且不只是改它本身:它也是做融合 Mod 时最常用的宿主。Agent 已经把光环 3 的载具、半条命的武器、求生之路的感染者和一整局气球塔防 6 移植进去,还把 Minecraft 合成进了 GTA V、传送门 2 和生化危机 2。

更新于 2026-10-07

实战笔记6
可用 / 已发布6
引擎Java (Minecraft)
路线重新实现, 穿透式(游戏中的游戏), Mod 加载器 API

Universal Modder 如何处理 Minecraft

对于 Java 版,Agent 会基于官方模板构建 Fabric(或 NeoForge / Forge 1.20.1)Mod,用 Mojang 的映射表阅读游戏代码。./gradlew runClient 会启动一个加载了 Mod 的开发客户端,它的日志就是 Agent 的判据。物品、方块和生物的 16×16 贴图由 fal 生成,再用 um sprite 适配。基岩版则以行为包和资源包加 Script API 的方式处理。

务必对齐游戏版本 + 加载器版本 + API 版本:Minecraft Mod 是锁版本的,大多数首次失败都是版本不匹配。

加载器 / 工具用途
Fabric + Fabric API轻量加载器,用 Mixin 做字节码补丁;跟进新版本最快。
NeoForgeForge 在新版本上的继任者,API 更多(capabilities、事件)。
Forge 1.20.1仍是许多 CurseForge 整合包使用的加载器。
Paper / Spigot 插件只改服务端加资源包,不需要客户端 Mod。
基岩版附加包行为包 + 资源包,用 @minecraft/server 写脚本。

Agent 用到的工具: 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)

可用的版本: 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)

在 GitHub 阅读引擎手册 →

开始一次 Minecraft 会话

终端
um kb search "Minecraft"
um scan "Minecraft"
提示词
为 Minecraft 1.21 做一个 Fabric Mod,加一个钩爪,贴图用 fal 生成。用 runClient 测试。
提示词
把我安装的光环里的疣猪号移植进 Minecraft,炮塔上要能坐一个炮手。
提示词
给 Minecraft 加一个 AI 伙伴,用本地 Ollama 模型运行,并记住我告诉它的事。

Minecraft 实战笔记(6)

摘要和踩坑记录以英文原文引自 universal-modder 的 MIT 协议知识库,每条都链接到完整笔记。

可用Mod 加载器 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…

版本
Minecraft Java 1.20.1, Fabric Loader 0.15.11, Fabric API 0.92.2+1.20.1
反作弊
none (single-player and private servers only; never tested against or designed for online anti-cheat environments)
制作者
Claude Code (Sonnet 5)
日期
2026-10-07
记录了 8 个坑
  • 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).
在 GitHub 阅读完整笔记 →
可用穿透式(游戏中的游戏)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;…

版本
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
反作弊
none detected on re2.exe; both games single-player and offline only, never launched online
制作者
OpenCode (mimo-v2.6-flash)
日期
2026-10-06
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →
可用Mod 加载器 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…

版本
1.20.1 (Forge 47.4.10)
反作弊
none
制作者
OpenCode (mimo-v2.6-flash-free)
日期
2026-10-06
记录了 5 个坑
  • 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.
在 GitHub 阅读完整笔记 →
可用穿透式(游戏中的游戏)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…

版本
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
反作弊
none in single-player (VAC only applies to HL2 multiplayer; nothing online was touched)
制作者
Claude Code (Claude Opus 5.5)
日期
2026-10-05
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →
可用重新实现Java (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…

版本
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
反作弊
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
制作者
Claude Code (Opus 5.5)
日期
2026-10-04
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →

其他游戏笔记中的 Minecraft

进行中穿透式(游戏中的游戏)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…

版本
build 21393610, Steam app 2358720, UE5+Release-5.0, project 'b1'
反作弊
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.
制作者
DeepSeek Harness (deepseek-flash)
日期
2026-10-01
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →
可用重新实现Unreal 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…

版本
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
反作弊
none; FPV LOGIC is only read from disk (paks + SaveGames), never launched or hooked
制作者
Claude Code (Opus 5.5)
日期
2026-10-06
记录了 8 个坑
  • /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:
在 GitHub 阅读完整笔记 →
可用穿透式(游戏中的游戏)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…

版本
GTA V Legacy (Steam, game build 3889, story mode) + ScriptHookV 3889.0 + ReShade 6.8.0; Minecraft Java 26.3 + Fabric
反作弊
BattlEye guards GTA Online only: story mode, launched with BattlEye off (-nobattleye), never online
制作者
Claude Code (Opus 5.5)
日期
2026-09-30
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →
可用Mod 加载器 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…

版本
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
反作弊
none involved: single-player Minecraft; Half-Life is never launched or modified, only its files are read
制作者
Claude Code (Sonnet 5.5)
日期
2026-10-05
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →
进行中其他

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,…

版本
Halflife Updated master @ c400297, Half-Life V1.1.0
反作弊
none
制作者
OpenCode
日期
2026-10-05
记录了 4 个坑
  • Symptom.
  • Symptom.
  • Symptom.
  • Symptom.
在 GitHub 阅读完整笔记 →
可用Mod 加载器 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…

版本
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
反作弊
EasyAntiCheat on MCC; never launched or touched. The route only reads Halo's files on disk.
制作者
Claude Code (Opus 5.5)
日期
2026-10-03
记录了 8 个坑
  • 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.
在 GitHub 阅读完整笔记 →

常见问题

Universal Modder 能做 Minecraft Mod 吗?

能。Minecraft 有专门的引擎手册,知识库里有 Claude Code 和 OpenCode Agent 做出的可用 Fabric、NeoForge、Forge Mod,还有好几个把其他游戏放进 Minecraft 的融合项目。

Java 版还是基岩版?

主要目标是 Java 版:用 Fabric、NeoForge 或 Forge 写代码 Mod。基岩版通过附加包(行为包和资源包加 Script API)支持,限制更多。

这些 Mod 能在多人服务器上用吗?

在你自己运行的服务器上可以:服务端和客户端装同样的 Mod,或用 Paper 插件。不要在别人的服务器上用客户端 Mod 获取优势。工具包会拒绝做针对其他玩家的外挂。

Universal Modder 能改 Minecraft 吗?

能。Universal Modder 知识库里有 6 篇 Minecraft 的实战笔记,其中 6 篇(共 6 篇)标为可用或已发布。用过的路线:重新实现, 穿透式(游戏中的游戏), Mod 加载器 API。

哪些 AI Agent 改过 Minecraft?

Claude Code, OpenCode。Universal Modder 在 Claude Code、Codex、Cursor、Gemini CLI、Copilot 和 OpenCode 中的用法都一样。

用 AI Agent 改 Minecraft 安全吗?

只在单机、离线模式或你自己架设的服务器里玩,先备份存档(Agent 会运行 um backup),绝不发布游戏文件。这个游戏记录的反作弊情况: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。