Diegesis

Diegesis

一个让交互界面直接呈现在方块上的前置库。

使用方块时，镜头会飞到方块前。接着，玩家就能操作方块上的真实 3D 物件：移动物品、拉动拉杆、转动旋钮、倾倒液体。附近的所有玩家都能看到这一切。

Diegesis 本身不会为游戏添加任何内容。只有在其他模组需要时才安装它，例如 Hands-On Delight。

使用 Diegesis 制作的 Hands-On Delight 烹饪锅。

🎮 玩家须知

将它与需要此模组的模组一起放进 mods 文件夹。支持 Minecraft 1.20.1 的 Forge、1.21.1 的 NeoForge，以及这两个版本的 Fabric（需搭配 Fabric API）。

🛠️ 模组开发者须知

交互界面由两部分组成：用 Java 编写的 工作站，用于指定可开启它的方块、保存的状态和交互规则；用 JSON 编写的 场景，用于指定绘制内容的位置和可交互对象。模型可直接从 Blockbench导入，游戏运行时按 F3+T 即可重新加载场景。

• 🎥 镜头与场景：每个场景都能设置独立的镜头；节点可以嵌套，并可移动、旋转、缩放、淡入淡出和发光。
• 📦 方块上的物品：点击操作与原版菜单一致，包括 Shift 点击、拆分物品和拖动一组物品穿过多个槽位。物品栏既可以做成抽屉，也可以直接布置在场景中。
• ✋ 手持物件：物件可通过握持点拿起，并模拟重量和倾斜；它们有符合自身形状的阴影，也能设置触碰触发器。
• 💧 液体与倾倒：储液罐可容纳真实容量的液体和混合物，还会晃动、泛起涟漪。服务器会控制每次倾倒的速度并进行验证。
• 🎛️ 现成控件：拉杆、拨动开关、按钮、旋钮和滑块，每种只需一行 JSON。
• ✨ 粒子、光照与音效：发射器、沸腾表面，以及能照亮附近区域的发光节点。
• 🪑 座位与多方块结构：一个工作站可以跨越多个方块，并供多名玩家乘坐，每位玩家都有自己的视角。
• 🌐 仅客户端或服务器端：客户端工作站可在任何服务器上运行。服务器端工作站会验证每项操作，防止物品复制，并让所有玩家共享同一状态。

场景文件的指南、示例手册和 JSON Schema 均可在 GitHub查看。

兼容性

✅ Embeddium 和 ✅ Oculus：场景、液体和粒子均可正常渲染，无论是否使用光影包

✅ Blur (Forge)、 ✅ ReBlured 和 ✅ Blur+：工作站界面保持清晰，其他界面仍会应用模糊效果

Pocky 制作的更多模组

由 Pocky 制作。源码发布于 GitHub，采用 MIT 许可证。