叙事世界

叙事世界

面向世界内方块界面的库:摄像机移动到方块处,玩家直接与其3D部件交互,无需图形界面。

基础库

Diegesis

一个用于“界面就活在方块上”的库。

对着方块交互时镜头会飞向它。随后玩家直接和该方块上的真实 3D 物件打交道:移动物品、拉下操纵杆、转动旋钮、倾倒液体。附近的每个玩家都能看到这一切发生。

Diegesis 本身不会给游戏添加任何内容。当有模组需要它时再安装,例如 Hands-On Delight。

用 Diegesis 搭建的站点中徒手搅拌并熬煮的汤

Hands-On Delight 的烹饪锅,由 Diegesis 构建。


🎮 面向玩家

把它和需要它的模组一起放进 mods 文件夹。Minecraft 1.20.1 用 Forge,1.21.1 用 NeoForge,两者也都支持 Fabric(需 Fabric API)。

🛠️ 面向模组开发者

一个界面由两部分构成。Java 中的站点(station)声明它在哪些方块上打开、保存什么状态、遵循什么规则。JSON 中的场景(scene)声明在何处绘制什么、哪些部分可以交互。模型直接来自 Blockbench,场景可在游戏运行时用 F3+T 重新加载。

  • 🎥 镜头与场景:每个场景一套镜头装置,节点可嵌套、移动、旋转、缩放、淡出和发光。
  • 📦 方块上的物品:点击行为与原版菜单一致,包括 shift 点击、拆分以及将整组物品拖到不同槽位。物品栏可以是抽屉,也可以铺陈在世界中。
  • ✋ 手持物件:由抓握点持有,带重量与倾斜,具有自身形状的阴影,以及触碰时的触发器。
  • 💧 液体与倾倒:储罐容纳真实体积与混合物,会摇晃和泛起涟漪。服务器会为每次倾倒设定节奏并校验。
  • 🎛️ 现成控件:操纵杆、摇板开关、按压按钮、旋钮和滑块,每个只需一行 JSON。
  • ✨ 粒子、光照与声音:发射器、沸腾表面、会照亮附近物体的发光节点。
  • 🪑 座位与多方块:一个站点可以横跨多个方块并容纳多名玩家,每人拥有自己的视角。
  • 🌐 仅客户端或服务器:客户端站点可在任何服务器上工作。服务器站点会校验每个操作,因此物品无法复制,并在玩家之间共享同一份状态。

📚 指南、食谱以及场景文件的 JSON schema 都在 GitHub 上。

兼容性

Embeddium ✅ Embeddium 与 Oculus ✅ Oculus:无论是否使用光影包,场景、液体和粒子都正常绘制

Blur ✅ Blur (Forge)、ReBlured ✅ ReBlured 与 Blur+ ✅ Blur+:站点界面保持清晰,其他界面保留模糊效果

Create Aeronautics ✅ Create Aeronautics(1.21.1):其飞行飞船上的站点可在船上打开,并随飞船飞行和转向而保持在船上


Pocky 的更多模组

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

由 Pocky 制作。源代码在 GitHub 上,采用 MIT 许可证。