GModCraft Sandbox Bridge

Status: prototype source, untested in the real games.

A Minecraft: Java Edition (Fabric) prototype that talks to a companion Garry's Mod addon. Minecraft is the primary game. Garry's Mod is the companion game and supplies the real spawned prop/entity gameplay through the player's own installation. The bridge uses files inside the player's GMod garrysmod/data/ folder so the GMod game files are never copied into this project.

First playable slice

1. Start Minecraft with this mod.
2. Set GMODCRAFT_GMOD_ROOT to the installed Garry's Mod folder.
3. Start Garry's Mod with the included addon.
4. In Minecraft, run:
   • /gmodcraft status
   • /gmodcraft spawn models/props_junk/wood_crate001a.mdl
5. The command writes a one-shot bridge file into the player's GMod data folder. The running GMod addon consumes it and spawns the real GMod physics prop.
6. GMod writes an event record back to the same data folder for the Minecraft side to verify.

This is intentionally a small vertical slice. A Minecraft-side visual proxy/tool interaction comes next after testing the bridge against the actual installed versions.

What is and is not shipped

• Ships: our Java/Lua code, JSON sheets, build instructions, and bridge logic.
• Does not ship: Minecraft, Garry's Mod, or their copyrighted models/textures/sounds.
• The Minecraft mod reads the companion folder through GMODCRAFT_GMOD_ROOT.

Current blocker

The current execution environment has neither game installation mounted nor external package-network access, so no real-game launch, build, or screenshot test has been claimed.