Skip to content
Universal Modder Guides

Universal Modder for Minecraft: the Fabric and Forge route

Java Edition / Fabric · NeoForge · Paper plugins / Single-Player & Own Servers Only

Yes — Minecraft is a documented route, not a maybe.

The agent scaffolds a Fabric or NeoForge mod, compiles it with Gradle, and tests it in a development client whose logs it can actually read. Item and block registries, Mixin patches, generated 16×16 textures — all of it is verified in the running game before you are asked to judge it.

ROUTE 1 · JAVA EDITION

Fabric or NeoForge code mods

The agent starts from the official Fabric template, registers items, blocks, entities and sounds through the registries, and ships textures (16×16 PNG), models and lang files under the mod's assets. Data like recipes and loot tables goes under the mod's data folder. Mojang's official mappings make the decompiled sources readable.

ROUTE 2 · SERVER-SIDE ONLY

Paper plugins plus resource packs

A lot can change without any client mod: a Paper or Spigot plugin plus a resource pack is how the "Black Ops 2 inside vanilla Minecraft" demo worked. If your idea lives on a server you host, this is the lightest route.

ROUTE 3 · BEDROCK

Add-ons with the Script API

Behavior packs define entities, items and blocks in JSON and script them in JavaScript or TypeScript with the official Script API. Resource packs carry the art. The agent develops in the development pack folders and reads the content log for errors.

EXTRAS

Mappings, diffs and prior art

Minecraft-specific MCP tooling hands the agent mappings, decompiled source and version diffs. Before writing anything, it searches the knowledge base for field notes from previous Minecraft sessions, so it starts from what already worked.

BUILD LOOP

What a Minecraft session actually runs

The development client is the agent's test oracle: it launches the mod, and the agent reads the log to confirm what worked before reporting back to you.

Fabric example mod · development client Gradle

# 1. Scaffold from the official template, then compile the mod

$ ./gradlew build

[GRADLE] BUILD SUCCESSFUL — mod jar ready for mods/

# 2. Produce readable sources from official mappings

$ ./gradlew genSources

# 3. Launch a dev client with your mod and verify

$ ./gradlew runClient

✓ Agent reads run/logs/latest.log to confirm the mod loaded.

SHIPPED EXAMPLE

Real Minecraft inside GTA V story mode

The project's own worked example — a Fabric mod and a ScriptHookV add-on exchanging camera, input and gameplay events, with Minecraft's colour and depth frames composited into GTA's. Recorded as a field note with every non-obvious lesson, so the next agent does not rediscover the traps.

LINK

WebSocket

Camera, input and gameplay events travel between the two games.

FRAMES

Shared memory

Minecraft's colour and depth frames and its overlay reach GTA's renderer.

STATUS

Working field note

Documented end-to-end with the gotchas: depth readback quirks, join-event timing, entity flags.

Source: examples/minecraft-gta5-passthrough ↗ and its field note in the project knowledge base.

BEFORE YOU START

Minecraft gotchas the agent watches for

Start your first Minecraft mod tonight

Follow the first-session tutorial with Minecraft as your game: install the plugin, scan, back up, get a plan, build one small slice, and see it in the running client. Code-only mods need no fal key and no paid generation.

FAQ

Minecraft compatibility questions

Does Universal Modder work with Minecraft? ▼

Yes. Minecraft Java Edition is one of the documented routes: the agent builds a Fabric or NeoForge mod, compiles it with Gradle, and verifies it in a development client with readable logs. Minecraft Bedrock Edition works through add-ons: behavior packs that use the Script API, plus resource packs. Java is the richer route, and everything stays within the single-player and own-servers boundary.

Which Minecraft loader does the agent pick? ▼

For modern Java versions the default route is Fabric: a light loader with Mixin for bytecode patches that updates fast to new game versions. NeoForge is the alternative when a mod needs its bigger API surface. For changes that only affect a server, plugins for Paper or Spigot plus a resource pack can go a long way without any client mod.

Will an AI-built Minecraft mod damage my worlds? ▼

The route keeps your worlds safe by design: the agent sets up a separate launcher profile with its own game directory, so your real saves are never the test bed. Before any session that touches saves, um backup create snapshots the folder and um backup restore can put it back. The agent also matches the exact game, loader and API version triple, because Minecraft mods are version-locked.

Can I put Minecraft inside another game? ▼

Yes, that is the mashup route. The shipped worked example runs real Minecraft inside GTA V story mode: a Fabric mod and a ScriptHookV add-on exchange camera, input and events, and Minecraft's frames are composited into GTA's. The project downloads Minecraft's assets from Mojang at first run and never redistributes them, and it never ships client hacks for public servers.