战列舰

战舰

视频演示

战舰是一个模组，增加了一个用于将大型预制结构投放至世界的 Hexcode 法术。同名法术会召唤一艘完整的战舰，但其底层交互是通用的，可以粘贴你指定的任何预制结构。

该项目主要偏向实验性和技术性，旨在探索 Hexcode 的符文系统、交互管线以及 Hytale 的预制结构粘贴 API。

---

已实现功能

🚢 战舰符文

Hexcode 法术符文

战舰符文是一种 Hexcode 法术，可在法术落点处投放一艘完整的战舰至世界中。

在底层，该符文使用了 Hexcode 的交互处理器，并运行一个自定义的HexSpawnPrefab交互。该交互会解析其配置中指定的预制结构名称，计算出放置位置，然后将其粘贴至世界中，且朝向施法者面对的方向。

形状结构

• 正方形 作为船体基础
• 正方形 作为小结构置于第一个之上
• 正方形 小结构紧邻第二个
• 直线 作为炮管从小正方形延伸出来的水平线

如何施放

1. 进入施法模式，绘制上述形状结构以构成战舰符文。
2. 为符文指定一个目标。符文有一个目标输入插槽，预制结构会生成在该插槽接收到的位置。最简单的设置是在战舰符文前方放置一个投射物符文，并通过下一个插槽连接它，这样战舰就会在投射物落点处生成。任何能产生位置的符文都可以用相同方式工作。
3. 施放咒法。当目标位置传入时，战舰会被粘贴到该位置，并根据你面对的基本方向（根据你的视角，朝北、南、东或西）进行旋转。

配置

该交互完全由符文的配置驱动，因此同一个处理器可以生成你指定的任何预制结构：

• PrefabPath：要生成的预制结构。可接受纯名称（Battleship）或完整文件名（Battleship.prefab.json）。该值会在加载时验证，因此如果名称拼写错误或预制结构缺失，会在资源包加载时报告，而不是在施法时无声失败。
• Force：当为 true 时，方块会被直接写入并覆盖任何已有的方块，这对于放置如此大的结构来说是必要的。当为 false 时，会遵循常规的放置规则。
• Offset：一个可选的方块偏移量，在放置战舰前会沿你面对的方向应用，方便微调锚点向上或向前移动。

该法术的消耗故意设置得很低（一次性的小额即时消耗，无持续消耗），且不消耗法力，因此你可以在测试时随意生成它。

（GIF 稍后添加）