Modscraper Modscraper Minecraft
Diegesis logo

Diegesis

Mod

Library for in-world block interfaces: the camera moves to the block and players work with its 3D parts directly, without a GUI.

Type

Mod

Modrinth Downloads

17,557

Modrinth ID

pyljrXOa

Last Updated

Nov 18, 2026

Description

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.

Soup cooked and stirred by hand in a station built with Diegesis

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 ✅ Embeddium and Oculus ✅ Oculus: scenes, liquids and particles draw as usual, with or without a shader pack

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

Create Aeronautics ✅ 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

Hoarfrost: Snow & Blizzards Petrichor: Rain & Storms Rustling Leaves Turbo for Distant Horizons Pocky Shaders HexTale Mekanism Advanced Generators Inventory Backups Hands-On Delight

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

Enjoying my mods? Buy me a coffee on Ko-fi

Compatibility

Mod Loaders

Fabric Forge Neoforge

Game Versions

1.20.1 1.21.1

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

As an Amazon Associate I earn from qualifying purchases.

Similar Mods

External Resources