A live Minecraft 1.8.9 client (LWJGL3, JDK 25) exposed to an LLM over MCP. The model can observe, act on, hot-swap, and debug the running JVM. Every tool call goes through a 7-layer NT-style privilege kernel.
Site: https://dwgx.github.io/MCPClient/
This is a research project. It is not affiliated with Mojang or Microsoft. Minecraft is a trademark of Mojang.
Original work in this repository is licensed under
Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
(CC BY-NC-ND 4.0). The legal code is in LICENSE.
In plain terms, for the original work:
- You may copy and share it verbatim, for non-commercial purposes, with attribution.
- You may not use it commercially.
- You may not distribute modified versions, including open-source forks or "I rewrote it and published it" derivatives.
- Other uses (commercial, derivatives, dual-license, exception): open a GitHub issue or contact @dwgx.
This license does not cover:
- Vanilla Minecraft 1.8.9 sources, mappings, and assets under
client/(Mojang). You need a lawful copy of the game. - Third-party libraries pulled by Maven (LWJGL, qml4j, Skija, MCP SDK, and so on). Those keep their own licenses.
| Layer | Module | Role |
|---|---|---|
| Platform | lwjgl2-shim/ |
LWJGL2 to LWJGL3 ABI shim |
| Spine | core/ |
MCP server, 7-layer kernel, capability packs, JVMTI |
| Spine | board/ |
Client feature framework (PCB). No hard dependency on core |
| Spine | client/ |
Minecraft 1.8.9 vanilla mapping |
| Aux | pg/ dwm/ |
Detachable. dwm is qml4j painted into a real GuiScreen. GL / ImGui / Skiko backends were removed |
Requires JDK 25. Fat agent jar:
./mvnw -q -pl core -am package -DskipTestsCore tests:
./mvnw -pl core testWindows, game + MCP:
scripts\run-mcp.bat
scripts\run-mcp-overlay.batrun-mcp-overlay.bat arms the KI-11 DWM overlay (Right Shift). UI substrate is Maven Central qml4j (dwm/pom.xml). Live map: dwm/README.md.
Tracked design notes live under docs/. Start at docs/README.md.
The agency path (one command to an in-game action) is docs/agency/command-to-action.md.