Structure Gel API

模组

· 作者 ModdingLegacy

一个用于简化生成结构开发端 API。

5 本站下载 0 关注 更新于 2 个月前

最新 2.22.0 · 26.1.2 · NeoForge

一键开服(送7天)

undefined



一个简化生成式结构开发工作的 API。


Structure Gel 是一个旨在让开发者更容易创建结构的模组 API,特别是针对使用拼图系统(jigsaw system)的结构。所有代码均为开源并提供文档说明。
其部分功能包括:

? 在此阅读 Structure Gel API 文档

如需查看此 API 的开源工作示例,请查阅 Dungeons Plus

你可以根据 Minecraft 版本找到关于如何开发和使用该 API 的详细信息。

最新文档

? 最新功能



?️ 建造工具

建造工具是一项仅适用于创造模式的新型物品,用于执行各种大规模方块修改操作。

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

图形用户界面 (GUI)

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

  • 按下 enter、e、escape 键,或点击屏幕上非按钮的任何区域,即可关闭 GUI。
  • 将鼠标悬停在 GUI 上的任何物品上,右侧会显示提示框,解释其功能及使用方法。
  • 使用径向菜单,你可以选择想要使用的模式。
  • 某些模式支持定位。如果支持,左上角会出现一个按钮,根据你当前的位置选择坐标。这在无法右键点击方块或右键点击非常不便时非常有用。
  • 左侧的撤销和重做按钮功能如其名。它们尝试撤销或重做你最近一次使用建造工具执行的操作。最多可保存并撤销 32 个操作。
  • 某些模式具有额外设置,这些设置将显示在撤销和重做按钮下方。
  • 中间的按钮用于选择你想要使用的方块。点击它会弹出一个文本框供你输入方块状态(block state)。这在游戏中也可以完成,但对于水等难以点击的方块来说,这种方式更为方便。

控制方式

  • 中键:选中你当前注视的方块状态(也可在 GUI 中完成)。
  • 左键:这是通用“执行操作”按键,具体取决于你所处的模式。
  • 右键点击空气:打开 GUI。
  • 右键点击方块:某些模式使用此操作来设置位置,不支持设置位置的模式也允许通过此操作“执行操作”。
  • Shift + 右键点击:清除当前选定的位置。

模式

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

  • 延伸(Extend):根据你点击的方块侧面检测图案,并尝试在该方向前方放置方块以延续该图案。如果你熟悉旧版的 Builder's Wands 模组,它的理念基本相同。
    Building Tool Extend



  • 填充(Flood):填充你点击所在的 Y 轴切片内的所有空气方块,直到遇到边界,然后继续向下填充。例如,这对于用水平面填满湖泊非常有用。

  • 填充区域(Fill):与原版 /fill 命令非常相似。选择两个对角点,然后左键点击以用当前选中的方块填充该区域。支持替换特定方块以及仅放置框架或空心立方体等选项。

  • 直线(Line):在选定的位置之间使用当前选中的方块放置一条直线。

  • 克隆(Clone):复制选定区域并将其粘贴到你点击的位置。支持旋转、镜像以及裁剪而非复制。
    Building Tool Clone



  • 移动(Move):将你朝攻击方向移动选定区域。

  • 清除(Clear):移除选定位置内的所有方块。

  • 形状:在你点击的位置放置一个形状。可以通过图形界面中的模式属性来更改形状以及要替换的方块。


Building Tool Shape

模式属性

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

  • 完整性(Integrity):决定实际放置多少方块。
  • 替换(Replace):决定该模式在放置方块时替换什么。All 替换所有方块,Air 仅替换空气,Clicked 替换你点击的那个方块。
  • 旋转与镜像(Rotation and Mirror):旋转或镜像克隆的区域。还可以选择随机值。

? 结构凝胶方块

这是一种创造模式工具,用于轻松填充结构的内部。当你的结构生成时,凝胶会被替换为空气,而在放置过程中所有的空气都会被忽略。这确保了你的结构不会在不应该出现的地方包含自然地形。凝胶方块的行为类似于结构虚空(structure voids),你可以穿过它,但它实际上是可见的。

当你潜行放置凝胶时,可以触发扩散机制。每种凝胶的扩散方式不同,你可以将鼠标悬停在物品上查看其工作原理。

? 认识这些凝胶!

? 红色凝胶

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

Spoiler
Red Gel

? 蓝色凝胶

蓝色凝胶的功能与红色凝胶类似,但它不会向能看到天空的位置扩散。

Spoiler
Blue Gel

? 绿色凝胶

绿色凝胶的扩散方式与红色凝胶相同,并增加了对角线扩散的能力。这使得它能够穿过由藤蔓或其他复杂建筑形成的角落。请小心不要让它泄漏到建筑外部。

Spoiler
Green Gel

? 青色凝胶

青色凝胶结合了绿色和蓝色凝胶的特性,既能对角线扩散,又能避开天空。

Spoiler
Cyan Gel

? 橙色凝胶

橙色凝胶的行为与红色凝胶相同,但其扩散距离取决于你在放置时手持的数量,使其非常适合在开阔区域进行建造。

Spoiler
Orange Gel

? 黄色凝胶

黄色凝胶仅在你放置时所面对平面的方向上扩散,非常适合用来封堵墙壁、窗户或其他凝胶可能会穿过的孔洞。

Spoiler
Yellow Gel



移除凝胶

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

Spoiler
Removing Gel



示例

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

Spoiler
House Example

此方块的代码设计使得你可以轻松地扩展它,并通过 `blocks.IStructureGel` 中的方法挂钩其行为,如果你需要尚未实现的行为的话。

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



? 翻译 Structure Gel API - 帮助打破语言障碍!

所有翻译者都将在此处署名。感谢每一位帮助使此模组易于访问的人!
旗帜 语言 翻译者
德语 Deutsch A1403, Barion
葡萄牙语(巴西) Português (Brasil) gabisaoo, simsgameboh
荷兰语(荷兰) Nederlands (Nederland) faas.mr
西班牙语(西班牙) Español (España) Minaderm , guillermojuegostablet, juggernogk
乌克兰语(Ukrayins'ka) Українська (Ukrayins'ka) Queez
土耳其语(Türkiye) Türkçe (Türkiye) asimemir58, demirgokler406
希伯来语('Ivriyþ) עברית ('Ivriyþ) pecan1245
西班牙语(阿根廷) Español (Argentina) patriciofagetti
意大利语(Italia) Italiano (Italia) antonioauciello226
立陶宛语 Lietuvių WaryRGMCA


? 支持:如果您对我们的模组有任何疑问或问题,请阅读常见问题解答!您也可以在问题追踪器上提交一个问题,或者加入我们的 Discord 服务器,我们将为您提供帮助!


你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源