Structure Gel API - Structure Gel API 结构凝胶接口

一个用于简化开发者创建生成结构流程的 API。

forge / neoforge 作者 ModdingLegacy 支持版本 1.16.5 - 1.21.4

Modrinth 源码地址问题反馈

下载量

3,668,335

关注数

数据来源

Modrinth

模组详细介绍

一个用于简化生成结构开发流程的 API。

Structure Gel 是一个 API 模组，旨在让开发者更轻松地创建结构，尤其是使用 jigsaw system 的结构。所有代码均为开源并附有文档。
它的一些功能包括：

📚 在这里阅读 Structure Gel API 文档

如果你想查看这个 api 的开源可运行示例，可以看看 Dungeons Plus

你可以按 Minecraft 版本查找有关如何开发和使用此 API 的详细信息。

最新文档

https://gitlab.com/modding-legacy/structure-gel-api/-/blob/1.21.4/README.md?ref_type=heads

🧪 最新功能

🛠️ 建筑工具

建筑工具是一个仅限创造模式使用的新物品，可用于执行各种大规模方块修改操作。

你可以在 Structure Items 创造模式物品栏中找到它。
手持建筑工具对空气右键可打开 GUI。打开后，你可以选择想使用的模式、撤销、重做、选择位置等等。

GUI

GUI 包含各种按钮，用于修改建筑工具的设置，以及一些方便的工具。

按下 enter、e、escape，或点击屏幕上任意非按钮区域都会关闭 GUI。
将鼠标悬停在 GUI 上的任意物品上时，右侧会显示工具提示，说明其功能和使用方法。
使用环形菜单，你可以选择想要使用的模式。
某些模式支持位置。如果支持，左上角会出现一个按钮，可根据你当前位置来选择一个位置。这在无法对方块右键，或这样做非常不方便时尤其有用。
左侧的 Undo 和 Redo 按钮顾名思义，就是用于撤销或重做你用建筑工具执行的上一个操作。最多可保存并撤销 32 次操作。
某些模式有额外设置，这些设置会显示在撤销和重做按钮下方。
中间的按钮用于选择你想使用的方块。点击后会打开一个文本框，让你输入方块状态。这也可以在游戏中完成，但有些方块例如水，实际上很难点击到。

控制

中键点击：选择你当前注视的方块状态（也可以在 GUI 中进行）。
左键点击：这是通用的“执行操作”按键，具体效果取决于你当前所在的模式。
对空气右键：打开 GUI。
对方块右键：某些模式用它来设置位置，而不使用它设置位置的模式也允许通过它来“执行操作”。
Shift + 右键：清除当前选定的位置。

模式

建筑工具模式是建筑工具可执行的不同操作。

Extend：根据你点击的方块侧面检测一个图案，并尝试在其前方放置方块以延续该图案。如果你熟悉旧版的 Builder's Wands 模组，这基本上是同样的思路。
Flood：填充你点击的 y 高度切片内的所有空气方块，直到碰到边界，然后继续向下填充。例如，这对于用水填满湖泊非常有用。
Fill：与原版 fill 指令非常相似。选择两个角点，然后左键点击，即可用当前选定的方块填充两点之间的区域。支持替换特定方块，以及只放置边框或空心盒子的选项。
Line：使用当前选定的方块，在选定位置之间放置一条方块线。
Clone：复制选定区域，并将其粘贴到你点击的位置。支持旋转、镜像，以及剪切而非复制。
Move：将选定区域朝你挥击的方向移动。
Clear：移除选定位置范围内的所有方块。
Shape：在你点击的位置放置一个形状。形状类型和会被替换的方块都可以通过 GUI 中该模式的属性进行修改。

模式属性

某些模式支持额外设置来修改其行为。一些示例包括：

Integrity：决定实际会放置多少方块。
Replace：决定模式在放置方块时会替换什么。All 替换所有方块，Air 只替换空气，Clicked 替换你点击的方块。
Rotation and Mirror：旋转或镜像克隆区域。也支持选择随机值。

🍡 Structure Gel 方块

这个方块是一个创造工具，用于轻松填充结构内部。结构生成时，gel 会被替换为空气，而所有空气在放置时都会被忽略。这样可以确保你的结构内部不会出现本不该有的自然地形。gel 方块的行为类似于结构空位（structure void），你可以穿过它，同时它本身又是可见的。

潜行时放置 gel，可以触发扩散机制。每种 gel 的扩散方式都不同，你可以将鼠标悬停在物品上查看它们的工作方式。