Structure Gel API

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

---

Structure Gel 是一个 API 模组，旨在让开发者更容易创建结构，尤其是使用拼图（jigsaw）系统的结构。所有代码均为开源且带有文档。其部分功能包括：

📚 在此阅读 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

🧪 最新功能

🛠️ 建筑工具

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

• 可以在“结构物品”创造模式标签页中找到它。
• 在空中右键点击建筑工具以打开 GUI。打开后，您可以选择要使用的模式、撤销、重做、选择您的位置等。

GUI

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

• 按下 enter、e、escape 键，或点击屏幕上不是按钮的任意位置，将关闭 GUI。
• 悬停在 GUI 上的任何项目上，右侧将显示一个工具提示，解释其功能及使用方法。
• 使用径向菜单，您可以选择要使用的模式。
• 某些模式支持位置。如果支持，左上角会出现一个按钮，用于根据您当前的位置选择位置。这在无法右键点击方块或极为不便时非常有用。
• 左侧的“撤销”和“重做”按钮正是如其名。它们会尝试撤销或重做您使用建筑工具执行的最后一次操作。最多可保存 32 个操作并可撤销。
• 某些模式具有附加设置，这些设置将显示在“撤销”和“重做”按钮下方。
• 中间的按钮用于选择您要使用的方块。点击它时，会打开一个文本框供您输入方块状态。这在游戏内也可以完成，但像水这样的方块很难点击。

控制

• 鼠标中键：选择您正在查看的当前方块状态（也可以在 GUI 中完成）。
• 鼠标左键：这是“执行操作”的通用按键，具体取决于您所处的模式。
• 右键点击空气：打开 GUI。
• 右键点击方块：某些模式使用此操作来设置位置，但那些不需要位置的模式也允许使用此操作来“执行操作”。
• Shift + 右键点击：清除当前选择的位置。

模式

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

• 扩展：根据您点击的方块侧面检测图案，并尝试在该图案前方放置方块以延续该图案。如果您熟悉旧的 Builder's Wands 模组，这本质上与其思路相同。

• 填充：填充您点击的 Y 轴水平切片内的所有空气方块，直到碰到边界，然后继续向下填充。例如，这对于用填满一个湖泊非常有用。

• 实心填充：与游戏原版的 fill 命令非常相似。选择两个角点，然后左键点击以使用当前选中的方块填充之间的区域。具有替换特定方块以及仅放置框架或空心盒子的选项。

• 线条：使用当前选中的方块在选定位置之间放置一条方块线。

• 克隆：复制选定的区域并将其粘贴到您点击的位置。允许旋转、镜像和剪切（而非复制）。

• 移动：将选定的区域向您点击的方向移动。

• 清除：移除选定位置内的所有方块。

• 形状：在您点击的位置放置一个形状。形状以及将替换哪些方块可以通过 GUI 中该模式的属性进行更改。

模式属性

某些模式支持附加设置以修改其行为。一些示例如下：

• 完整性：决定实际会放置多少个方块。
• 替换：决定模式在放置方块时替换什么。全部替换所有方块，空气仅替换空气，已点击替换您点击的方块。
• 旋转和镜像：旋转或镜像克隆的区域。也允许选择随机值。

🍡 Structure Gel 方块

此方块是一个创造工具，用于轻松填充结构内部。当您的结构生成时，凝胶会被替换为空气，而在放置时所有空气都会被忽略。这确保了您的结构不会在不应该有自然地形的地方出现自然地形。凝胶方块的行为类似于结构空位，您可以穿过它，但它是可见的。

在潜行时放置凝胶，可以触发扩展机制。每种凝胶的扩展方式不同，您可以通过悬停在物品上了解它们的工作方式。

🍮 认识各种凝胶！

🟥 红色凝胶

红色凝胶使用默认的扩展机制，沿基本方向扩展，仅替换空气。

查看动画

🟦 蓝色凝胶

蓝色凝胶的功能与红色凝胶类似，区别在于它不会扩展到可以看到天空的位置。

查看动画

🟩 绿色凝胶

绿色凝胶的扩展方式与红色凝胶相同，但增加了对角扩展的能力。这使得它可以通过藤蔓或其他复杂建筑产生的角落。小心不要让它泄漏到您的建筑之外。

查看动画

🟦 青色凝胶

青色凝胶结合了绿色和蓝色凝胶的功能，既能对角扩展，又能避开天空。

查看动画

🟧 橙色凝胶

橙色凝胶的行为与红色凝胶相同，但其扩展距离取决于您放置时手中持有的数量，这使得它在开放区域建造时非常方便。

查看动画

🟨 黄色凝胶

黄色凝胶只会沿着您放置时面向的平面扩展，这使其非常适合密封墙壁、窗户或其他凝胶可能会穿过的孔洞。

查看动画

---

移除凝胶

可以使用火药右键点击凝胶来移除它。这样做会触发连锁反应，移除所有相连的同类型凝胶。

查看动画

---

示例

以下是一个如何在建筑中使用它的示例。如果将此结构加载到游戏中，内部的凝胶将被替换为空气，而外部的空气则不会被放置。

查看动画

此方块的代码被设计成这样：如果需要尚未实现的功能，您可以轻松地扩展它，并通过 blocks.IStructureGel 中的方法挂钩其行为。

这是一个核心模组，会修改一些内部类。如果您在使用此模组时遇到崩溃，且崩溃仅在与另一个模组混合时发生，这可能是原因。请在报告前进行测试。

---

🌐 翻译 Structure Gel API - 帮助打破语言障碍！

所有翻译者的名单都记在这里。感谢 OneSkyApp，您可以轻松进行翻译！

• 🇩🇪 德语翻译： A1403, Barion
• 🇧🇷 葡萄牙语（巴西）翻译： gabisaoo, simsgameboh
• 🇳🇱 荷兰语（荷兰）翻译： faas.mr
• 🇪🇸 西班牙语（西班牙）翻译： Minaderm, guillermojuegostablet, juggernogk
• 🇺🇦 乌克兰语翻译： Queez
• 🇹🇷 土耳其语（土耳其）翻译： asimemir58, demirgokler406
• 🇮🇱 希伯来语翻译： pecan1245
• 🇦🇷 西班牙语（阿根廷）翻译： patriciofagetti
• 🇮🇹 意大利语（意大利）翻译： antonioauciello226
• 🇱🇹 立陶宛语翻译： WaryRGMCA

---

🤚 支持：如果您对我们的模组有任何疑问或问题，请阅读 FAQ！您也可以在问题跟踪器上提交问题，或加入我们的 Discord 服务器，我们可以在那里为您提供帮助！