Diegesis
一个用于在方块本身显示界面的库。
使用方块时,摄像机将飞向该方块。玩家随后在该方块上与真实的 3D 对象进行交互:移动物品、拉动拉杆、旋转旋钮、倾倒液体。附近的所有玩家都能看到这些操作的发生。
Diegesis 本身不会为游戏添加任何内容。当某个模组要求安装它时再安装它,例如 Hands-On Delight。

由 Diegesis 构建的 Hands-On Delight 的烹饪锅。
🎮 给玩家
将其放入需要它的模组旁边的 mods 文件夹中。支持 Forge 上的 Minecraft 1.20.1,NeoForge 上的 1.21.1,以及 Fabric 上的两者(需搭配 Fabric API)。
🛠️ 给模组开发者
一个界面包含两件事。Java 中的工作站(station)指定它在哪些方块上打开、保持何种状态以及规则是什么。JSON 中的场景(scene)指定绘制内容和可交互元素。模型直接来自 Blockbench,场景在游戏运行时按 F3+T 即可重载。
- 🎥 摄像机与场景:每个场景一套摄像机 rig,节点可嵌套、移动、旋转、缩放、淡入淡出并发光。
- 📦 方块上的物品:点击操作如同原版菜单,包括 Shift 点击、拆分以及在槽位间拖拽堆叠物品。库存可以是一个抽屉,也可以平铺在世界中。
- ✋ 手持物体:通过握持点固定,具有重量和倾斜度,拥有独立的形状阴影,并在接触时触发事件。
- 💧 液体与倾倒:储罐容纳真实的体积和混合物,会晃动和泛起涟漪。服务器会对每一次倾倒进行速率控制和检查。
- 🎛️ 现成控件:拉杆、摇杆开关、按钮、旋钮和滑块,每种只需一行 JSON。
- ✨ 粒子、光源与声音:发射器、沸腾表面、能照亮周围区域的发光节点。
- 🪑 座位与多块结构:工作站可以跨越多个方块并容纳多名玩家,每人拥有各自的视角。
- 🌐 仅客户端或服务器端:客户端工作站可在任何服务器上运行。服务器端工作站会检查每项操作,防止物品复制,并在玩家间共享单一状态。
📚 指南、食谱以及场景文件的 JSON 架构位于 GitHub。
有关 API 或你正在构建的工作站的问题,可以前往我们的 Discord 服务器 Pocky's Kitchen。
兼容性
✅ Embeddium 和
✅ Oculus:无论是否安装光影包,场景、液体和粒子都能正常渲染
✅ Blur (Forge),
✅ ReBlured 和
✅ Blur+:工作站保持清晰,其他屏幕保留模糊效果
✅ Create Aeronautics 在 1.21.1 版本上:其飞行飞船上的工作站会在飞船上打开,并随飞船飞行和转向而跟随
Pocky 的其他模组
由 Pocky 制作。源代码托管于 GitHub,采用 MIT 许可证。
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.
Questions about the API or a station you are building can go to Pocky's Kitchen, our Discord server.
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.
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Diegesis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 槽位选项
idle_highlight:当光标位于其他位置时,该槽位的方块会微弱显示。 NodeView.setTooltipItem:自行绘制物品的节点会像槽位一样显示其工具提示,并接管配方查看器的按键操作。DiegesisClient.items(buffers):用于节点绘制器绘制物品的缓冲区,包含深度信息和附魔光泽效果。- 菜单站与相邻站点的联动:移动键和屏幕边缘可以延伸至旁边的工作台旁的熔炉。
- 界面选项
carry_count_facing:决定手中堆叠物品数量的朝向。
更改
- 在
upright槽位上,光标下方的方块现在位于物品平面内、处于物品后方,不再平贴在底部。 - 手中堆叠物品的数量已调整为面向摄像机(
"carry_count_facing": "up"可保留旧版外观)。
修复
- 场景中的附魔物品再次显示附魔光泽。
- 绘制在顶部的堆叠数量不再被前方方块遮挡裁剪。
- 多区块站点的静止场景仅在主方块处绘制一次,不再在每个其他方块处重复绘制。
- 作为方块渲染的模型从其所处的世界方块获取光照,因此多区块场景按方块逐个着色。
- 多区块的场景会一直保留直到所有方块回归,且其自身方块永远不会从摄像机视野中清除:避免摄像机进出时出现空洞。
- 搅拌浅层液体时,其波纹不再像被盖子压住一样变平。
- 游戏启动时不再因 AsyncParticles 而崩溃,且其 GPU 粒子会在站点前方渐显。
- 诸如 Open Parties and Claims 等领地模组以及出生点保护功能,会使无法使用该方块的玩家无法打开站点。
- 在使用 Iris 或 Oculus 光影包时,站点处不再有手部残留碎片显示。
新增
StationView.setPlacingReachable:放置的物品保持在视野内但无法触及,位于烤箱关闭的玻璃门后方。
修复
- 位于工作站旁的方块不再在摄像机仅掠过其角落时消失:
clear_view现在仅排除真正阻挡视线的方块。 - 游戏启动时不再因 AsyncParticles 而崩溃,且工作站前方的粒子效果会随其 GPU 粒子一同淡出。
- Open Parties and Claims 等领地插件以及出生点保护功能可确保工作站对可能无法使用该方块的玩家保持关闭状态。
- 在使用 Iris 光影包时,工作站处不再有手部残影残留于视野中。
- 位于正上方或正下方(例如冰箱的冷冻室)的工作站,现可通过屏幕顶部或底部边缘、光标或 W/S 键进行交互,不再从左侧边缘触发。
- 位于库存抽屉侧边的相邻方块可通过对应按键访问,此时光标应悬停在库存区域上方。
- 无明确放置位置即进入
placing状态的物品(如 Shift+点击、漏斗投放),会先出现在行中间的可视位置。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧