Structure Gel API

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

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

📚 在此阅读 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 中该模式的属性进行更改。

模式属性

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

• 完整度：决定实际会放置多少个方块。
• 替换：决定该模式在放置方块时会替换什么。全部会替换一切，空气仅替换空气，点击的方块则替换你点击的方块。
• 旋转与镜像：旋转或镜像克隆的区域。也允许选择一个随机值。

🍡 结构凝胶方块

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

在潜行时放置凝胶，你可以触发蔓延机制。每种凝胶的蔓延方式不同，你可以通过将鼠标悬停在物品上来了解它们的工作方式。

🍮 来认识凝胶吧！

🟥 红色凝胶

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

🟦 蓝色凝胶

蓝色凝胶的功能与红色类似，但它不会蔓延到能看到天空的位置。

🟩 绿色凝胶

绿色凝胶的蔓延方式与红色凝胶相同，但额外还会沿对角线蔓延。这使它能够穿过由藤蔓或其他复杂建筑形成的角落。注意不要让它泄漏到你的建筑之外。

🟦 青色凝胶

青色凝胶是绿色和蓝色凝胶的结合，既能沿对角线蔓延，又能避开天空。

🟧 橙色凝胶

橙色凝胶的行为与红色凝胶相同，但它蔓延的距离取决于你放置时手持的数量，这使得它非常适合在开阔区域建造。

🟨 黄色凝胶

黄色凝胶只会沿着你放置时面朝的方向平面蔓延，非常适合封住墙壁、窗户或其他凝胶原本会穿过的孔洞。

移除凝胶

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

示例

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

这个方块的代码设计方式使得你可以轻松地扩展它，并通过 blocks.IStructureGel 中的方法接入其行为，以防你需要尚未实现的行为。

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

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

所有翻译者都在此致谢。感谢 OneSkyApp，你可以轻松地进行翻译！

undefined

德语翻译由：A1403、Barion 提供
巴西葡萄牙语翻译由：gabisaoo、simsgameboh 提供
荷兰语（荷兰）翻译由：faas.mr 提供
西班牙语（西班牙）翻译由：Minaderm、guillermojuegostablet、juggernogk 提供
乌克兰语翻译由：Queez 提供
土耳其语（土耳其）翻译由：asimemir58、demirgokler406 提供
希伯来语翻译由：pecan1245 提供
西班牙语（阿根廷）翻译由：patriciofagetti 提供
意大利语（意大利）翻译由：antonioauciello226 提供
立陶宛语翻译由：WaryRGMCA 提供

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