Back to mods
Diegesis project artwork

Modrinth · Minecraft mod

Diegesis

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Diegesis release matches 1.20.1 Forge?

Updated 2 days ago
beta file 1.0.0-beta.13-forge
Game version 1.20.1
Loader Forge

Diegesis 1.0.0-beta.13-forge targets 1.20.1 with Forge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Diegesis required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does Diegesis 1.0.0-beta.13-forge need?

1.0.0-beta.13-forge on 1.20.1 Forge. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Diegesis without breaking your instance.

Built for Diegesis 1.0.0-beta.13-forge on 1.20.1 Forge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.0-beta.13-forge. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.0-beta.13-forge. It opens that exact file at the source.

About this project

What does Diegesis add?

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

Project description from Modrinth.

Pick your setup

Diegesis by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

4 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Diegesis versions and loaders

6 of 24 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.