Diegesis

Diegesis

A library for interfaces that live on the block itself.

Using a block flies the camera to it. The player then works with real 3D objects on that block: moves items, pulls levers, turns knobs, pours liquids. Everyone standing nearby sees it happen.

Diegesis adds nothing to the game on its own. Install it when a mod asks for it, such as Hands-On Delight.

The cooking pot of Hands-On Delight, built with Diegesis.

🎮 For players

Put it in the mods folder next to the mod that needs it. Minecraft 1.20.1 on Forge, 1.21.1 on NeoForge, and both on Fabric (with Fabric API).

🛠️ For modders

An interface is two things. A station in Java says which blocks it opens on, what state it keeps and what the rules are. A scene in JSON says what is drawn where and what can be touched. Models come straight from Blockbench, and scenes reload with F3+T while the game runs.

• 🎥 Camera and scenes: a camera rig per scene, nodes that nest, move, turn, scale, fade and glow.
• 📦 Items on the block: clicks work as in a vanilla menu, including shift-click, splitting and dragging a stack across slots. The inventory can be a drawer or laid out in the world.
• ✋ Carried objects: held by a grip point, with weight and lean, a shadow of their own shape and triggers on touch.
• 💧 Liquids and pouring: tanks hold real volumes and mixtures that rock and ripple. The server paces and checks every pour.
• 🎛️ Ready controls: lever, rocker switch, push button, knob and slider, one line of JSON each.
• ✨ Particles, light and sound: emitters, boiling surfaces, glowing nodes that light what is near.
• 🪑 Seats and multiblocks: a station can span several blocks and seat several players, each with their own view.
• 🌐 Client-only or server: client stations work on any server. Server stations check every action, so items cannot be duplicated, and share one state between players.

📚 Guides, a cookbook and a JSON schema for scene files are on GitHub.

Compatibility

✅ Embeddium and ✅ Oculus: scenes, liquids and particles draw as usual, with or without a shader pack

✅ Blur (Forge), ✅ ReBlured and ✅ Blur+: stations stay sharp, other screens keep their blur

✅ Create Aeronautics on 1.21.1: stations on its flying ships open there and stay with the ship as it flies and turns

More mods by Pocky

Made by Pocky. Source on GitHub under the MIT license.