格莱梅拉飞行坐骑

🦅 GlymeraFlyMount 🦅

将你驯服的坐骑升级为飞行变体，在 Hytale 的天空中翱翔！

---

GlymeraFlyMount 是什么？

GlymeraFlyMount 为你的 Hytale 服务器添加了飞行坐骑。玩家可以通过用铁锭击打已驯服的动物，将其升级为飞行变体。一旦升级，骑乘坐骑即可自动飞行——坐骑会悬浮在空中，每次跳跃都会升高，当玩家按住 Shift 或 Ctrl 键时会下降。

飞行系统的原理是在坐骑下方放置一个隐形的 3x3 屏障方块平台，该平台会实时跟随坐骑移动。这样可以使坐骑保持在空中，而无需修改 Hytale 的运动物理机制。当玩家想要下降时，平台会被移除，重力会自然接管。

目前支持的坐骑类型有马、骆驼和公羊。每种都有已驯服变体和飞行变体。升级会消耗玩家快捷栏中的一个铁锭，并将已驯服的动物替换为其飞行对应物，位置完全相同。

所有飞行状态都是实时管理的——当玩家下坐骑时，屏障平台会立即被清理，坐骑会正常降落。

如何获得飞行坐骑

飞行坐骑无法在野外找到。你需要升级已有的已驯服坐骑。以下是完整流程：

第 1 步：驯服一只动物

首先，使用 Hytale 的正常驯服机制驯服一匹马、骆驼或公羊。该动物必须完全驯服，并在游戏中显示为“Tamed_Horse”、“Tamed_Camel”或“Tamed_Ram”。

第 2 步：获得一个铁锭

获取一个铁锭（Ingredient_Bar_Iron）。这是升级材料。每次升级需要一个铁锭。

第 3 步：用铁锭击打已驯服的坐骑

将铁锭放在活跃的快捷栏槽位中，然后击打（左键单击）已驯服的动物。插件会拦截这次击打，取消对动物的任何伤害，消耗你快捷栏中的一个铁锭，并在完全相同的位置和旋转角度将已驯服的动物替换为其飞行变体。

你将看到消息：“坐骑已升级为飞行坐骑！骑上它并按空格键飞行！”

升级是永久的。已驯服的动物会被移除，并在其位置生成一个新的飞行变体。可用的升级如下：

• 已驯服的马 → 已驯服的飞行马
• 已驯服的骆驼 → 已驯服的飞行骆驼
• 已驯服的公羊 → 已驯服的飞行公羊

如何飞行

一旦你拥有飞行坐骑，只需骑乘（右键单击）它，飞行就会自动激活。无需任何命令——插件检测到你正在骑乘飞行坐骑变体，并立即启用飞行。

升高（空格键 / 跳跃）

每次你在骑乘时按下 空格键（跳跃），坐骑都会升高。每次跳跃都会使你向上移动。持续按空格键可以爬得更高。坐骑下方会放置一个隐形的 3x3 屏障方块平台以保持其空中状态。这个平台会随着你飞行而移动，因此你也可以在空中向前、向后和侧向移动。

最大飞行高度为 300 个方块。

下降（Shift 或 Ctrl）

在骑乘时按住 Shift（蹲下）或 Ctrl（冲刺）可以下降。只要按住任一键，坐骑下方的屏障平台就会被移除，重力会接管——坐骑和骑手会缓慢下降。松开 Shift/Ctrl 即可停止下降并悬浮在当前高度。

最小飞行高度为地面以上2个方块。

悬浮

当你没有按下空格键、Shift 或 Ctrl 时，坐骑会悬浮在当前位置。屏障平台会使坐骑稳定地停留在空中。你仍然可以在悬浮时水平移动。

着陆

要着陆，请按住 Shift 或 Ctrl，直到坐骑到达地面。或者，随时下坐骑——屏障平台会立即被清理。请注意，在高海拔下坐骑可能会导致掉落伤害！

下坐骑

当你从飞行坐骑上下时，插件会立即检测到你不再骑乘，并移除所有屏障方块。坐骑会正常落到地面。

/fly 命令

/fly

手动开启或关闭飞行模式。这是一个备用命令，以防你在骑乘时需要禁用飞行。在正常情况下，当你骑乘和下坐骑飞行变体时，飞行会自动激活和停用。

开启时：“飞行开启！空格键=上升，Ctrl/Shift=下降，/fly=关闭” 关闭时：“飞行关闭”

技术细节

• 飞行基于放置在坐骑脚下方 1 个方块处的隐形 3x3 屏障方块平台。该平台每 50 毫秒（20 次/秒）跟随坐骑移动。
• 插件使用 Hytale 的 ECS（实体组件系统）来拦截用于升级机制的伤害事件。在 DamageModule 的 FilterDamageGroup 中捕获对已驯服坐骑的铁锭击打。
• 飞行检测使用 originalRoleIndex（坐骑被骑乘改变之前的原始角色）来识别飞行坐骑变体。这比检查角色名称更可靠，因为当玩家骑乘 NPC 时角色名称会改变。
• 平台放置使用坐骑 Y 坐标（而非玩家 Y 坐标）以避免视觉抖动，特别是对于骆驼等较大的坐骑。
• 屏障方块被静默放置——不会产生粒子或音效（NO_SEND_PARTICLES、NO_SEND_AUDIO、NO_DROP_ITEMS）。
• 只有空气方块会被替换为屏障。平台永远不会覆盖现有方块。
• 当下降时，平台在每个游戏刻都会被完全移除，允许自然重力将坐骑拉下。
• 当玩家下坐骑或禁用飞行时，所有屏障方块会立即被清理。
• 升级会在原始已驯服坐骑的精确位置和旋转角度生成飞行变体，因此过渡是无缝的。
• 每次升级会从玩家活跃的快捷栏槽位消耗一个铁锭。

安装

1. 停止你的 Hytale 服务器。
2. 将 GlymeraFlyMount.jar 复制到服务器的 mods/ 文件夹中。
3. 同时将附带的 资源包 也复制到服务器的 mods/ 文件夹中。该资源包包含飞行坐骑角色定义（Tamed_Flying_Horse、Tamed_Flying_Camel、Tamed_Flying_Ram），是插件运行所必需的。
4. 启动你的服务器。
5. 检查服务器日志中是否包含：“[GlymeraFlyMount] GlymeraFlyMount v2.3.0 started!”
6. 日志还会显示解析出的飞行坐骑类型及其索引，确认资源包已正确加载。

重要提示： JAR 文件和资源包都必须放置在 mods/ 文件夹中。仅放置 JAR 文件将无法工作——资源包定义了插件引用的飞行坐骑角色。如果没有资源包，服务器日志将显示类似“Flying mount role not found in registry”的警告。

服务器日志输出

示例日志消息：

[GlymeraFlyMount] Setup complete. Upgradeable types: [Tamed_Horse, Tamed_Camel, Tamed_Ram]
[GlymeraFlyMount] Flying mount role resolved: Tamed_Flying_Horse -> index 47
[GlymeraFlyMount] Flying mount role resolved: Tamed_Flying_Camel -> index 48
[GlymeraFlyMount] Flying mount role resolved: Tamed_Flying_Ram -> index 49
[GlymeraFlyMount] GlymeraFlyMount v2.3.0 started!
[GlymeraFlyMount] Upgraded Tamed_Horse -> Tamed_Flying_Horse by PlayerName
[GlymeraFlyMount] Auto-flight ON for PlayerName (originalRoleIndex=47)

支持

遇到问题或有疑问？在此处留言或访问我们的 Discord！

---

由 GlymeraCraft 开发