DuskCraft

DuskCraft

Minecraft inside The Legend of Zelda: Twilight Princess (Dusklight port), in the style of SkyCraft / ValCraft: both games run at the same time and talk through shared memory. Minecraft runs hidden and simulates the player; Dusklight renders everything.

Status: IPC v2 foundation in progress; passthrough still incomplete.

• Snapshots and SPSC input ring are tested across C++, Java and Python.
• Native and Fabric builds pass on Windows.
• Fabric consumes input events from the protocol; capturing them on the Dusklight side and validating in the runtime is still pending.
• Streamed collision and export/render of blocks, avatar, entities and HUD are not integrated yet.

What is here

Testing the bridge

bash tools/run_tests.sh
python tools/fake_dusklight.py run
Building the mod (Windows)
Requires git, CMake 3.26+, Visual Studio Build Tools (C++) and internet (CMake downloads the Dusklight SDK
and a link-stub).

bash
cmake -S dusklight-mod -B build -DDUSKLIGHT_VERSION=
cmake --build build --config RelWithDebInfo --target tpcraft
copy build\mods\tpcraft.dusk %APPDATA%\TwilitRealm\Dusklight\mods
Note: mods with game depend on the Dusklight version. The CMake default is v2.0.3;
change it to the version you have installed.

Next phases
Wire a Dusklight-supported input producer into the ring already consumed by Fabric.

Implement TP->Minecraft collision by regions; the current heightfield does not represent walls or objects.

Export block sections, avatar, entities, particles and overlay from Fabric to the Dusklight renderer.

Calibrate coordinates per stage/room, scale and orientation in the real runtime.

Integrate interactions, combat, loot and persistence; test each subsystem in-game.

Notes
The TPCraft v2 protocol is its own; it is not binary-compatible with SkyCraft/ValCraft.

No Nintendo or Mojang assets are included. You need your own copy of the games.