格莱梅拉守卫

🦅 GlymeraGuard 🦅

放置一个鸟笼，守卫鸟便会自动巡逻区域并攻击敌对NPC。

当前版本仅兼容 Hytale 稳定版 5！ 不要错过我的其他精彩项目——请查看 GlymeraCraft 的个人主页 Discord：https://discord.gg/s5NRFWfxgy

GlymeraGuard 是什么？

GlymeraGuard 为你的 Hytale 服务器添加了自动守卫鸟系统。玩家放置四种特殊鸟笼方块之一后，守卫鸟会自动生成并开始在笼子上方巡逻。当敌对 NPC 进入守卫半径时，鸟会利用自然飞行 AI 追击它们，并在足够接近时造成伤害。打破笼子会立即清除所有鸟。

每种笼子会生成不同鸟种，拥有独特的属性。鸟对玩家伤害免疫，但可被敌对 NPC 击杀。当笼子的所有鸟死亡后，新的一批会自动重新生成。卡在地形中的鸟会在 3 秒后被自动向上推起。

每个玩家最多可同时放置 3 个笼子（可配置）。此限制适用于所有鸟种的总和。

---

如何获取鸟笼

鸟笼可通过两种方式获得：

• 合成配方：每种笼子由特洛克笼子与特定的羽毛类型合成。所有配方可在插件配置中启用或禁用。

笼子	材料1	材料2
Cage_Vulture	Deco_Trork_Cage	Ingredient_Feathers_Light
Cage_Hawk	Deco_Trork_Cage	Ingredient_Feathers_Dark
Cage_Archaeopteryx	Deco_Trork_Cage	Ingredient_Feathers_Red
Cage_Pterodactyl	Deco_Trork_Cage	Ingredient_Feathers_Blue

• 命令：使用 /give Cage_Vulture、/give Cage_Hawk、/give Cage_Archaeopteryx 或 /give Cage_Pterodactyl 直接获取。

---

工作原理 - 逐步说明

1. 玩家通过合成或 /give 命令获得鸟笼。
2. 玩家将笼子放置在地面上。
3. 几秒钟内，笼子扫描器检测到新笼子，并自动在其上方生成守卫鸟。
4. 鸟开始在笼子上方以自然飞行高度（距离地面 15-35 个方块）盘旋巡逻。
5. 当敌对 NPC 进入守卫半径（默认：笼子周围 20 个方块）时，鸟使用 AI 驱动的飞行追击它们。
6. 当鸟足够接近（2 个方块内）时，它会攻击敌对 NPC，并附带撞击音效和粒子效果。
7. 当敌对 NPC 死亡或离开该区域后，鸟返回巡逻模式。
8. 破坏笼子会立即清除其所有鸟。

---

鸟种类型

笼子物品	鸟种	生命值	速度	特性
Cage_Vulture	秃鹫	500 HP	快速 (15)	高翻滚角度，急转弯
Cage_Hawk	鹰	400 HP	极速 (18)	非常灵活，最大转弯速度
Cage_Archaeopteryx	始祖鸟	600 HP	适中 (14)	坦克型，巡逻圈大
Cage_Pterodactyl	翼龙	700 HP	慢速 (12)	最肉，最大飞行高度高

所有鸟：

• 在自然高度（距离地面 15-35 个方块）飞行
• 对玩家伤害免疫，但可被敌对 NPC 击杀
• 使用 LockedTarget AI 自动追击敌对目标
• 在攻击范围内每 2 秒造成一次可配置伤害（默认 20）
• 如果卡在地形中超过 3 秒，会被自动向上推起

---

功能特性

• 完全自动化 - 放置笼子，鸟出现。破坏笼子，鸟消失。操作无需任何命令。
• 可合成笼子 - 每个笼子可由特洛克笼子和一种特定羽毛合成。配方可在配置中开关。
• 4 种鸟种 - 每种笼子生成不同的鸟，拥有独特属性（生命值、速度、敏捷度）。
• 自然飞行行为 - 鸟以真实高度盘旋巡逻，并使用 Hytale 原生 AI 飞行系统追击敌对目标。
• 可配置守卫半径 - 鸟会检测并攻击笼子周围可配置半径（默认 20 个方块）内的敌对 NPC。
• 每玩家笼子上限 - 每个玩家最多可拥有 3 个活跃笼子（可配置）。此限制统计所有笼子类型的总和。
• 鸟重生 - 当笼子的所有鸟被击杀后，新的一批会自动生成。
• 防卡死系统 - 3 秒内任何方向移动少于 1 个方块的鸟，会被向上推 5 个方块。
• 玩家安全 - 鸟无法被玩家伤害。只有敌对 NPC 能伤害它们。
• 攻击特效 - 每次鸟的攻击都带有撞击音效和粒子效果，附近所有玩家可见。
• 可选中立目标 - 可配置为也攻击中立 NPC（默认禁用）。
• 区块感知 - 鸟仅在其区块被加载时运作。玩家离开并返回时不会生成重复鸟。
• 防重复机制 - 三层防重复保护：区块加载检查、预生成清理、定期重复实体移除。
• 干净重启 - 服务器重启时会清理旧鸟实体。玩家回到笼子时，新鸟会生成。

---

命令

本插件无操作命令。一切通过放置和破坏鸟笼来控制。

通过命令获取笼子物品，请使用：

• /give Cage_Vulture
• /give Cage_Hawk
• /give Cage_Archaeopteryx
• /give Cage_Pterodactyl

---

配置

配置文件在首次启动时自动创建于 plugins/GlymeraGuard/config.json。所有值均可更改，在服务器重启后生效。

参数	默认值	描述
maxCagesPerPlayer	3	每个玩家可同时拥有的最大鸟笼数量。统计所有笼子类型的总和。
birdsPerCage	3	每个笼子生成的守卫鸟数量。
guardRadius	20	笼子周围检测并攻击敌对 NPC 的半径（单位：方块）。
attackNeutral	false	若为 true，鸟也会攻击中立 NPC（而不仅仅是敌对 NPC）。
combatTickMs	1000	战斗更新的间隔时间（毫秒）（包括目标分配、伤害检查、卡死检测）。
cageScanTickMs	5000	笼子检测扫描的间隔时间（毫秒）（检测新放置或移除的笼子）。
attackDamage	20.0	每次鸟攻击造成的伤害。
attackIntervalMs	2000	每只鸟两次攻击之间的最小时间间隔（毫秒）。
attackRange	2.0	鸟可以对其目标造成伤害的距离（单位：方块）。

---

安装

1. 停止你的 Hytale 服务器。
2. 将 GlymeraGuard.jar 复制到服务器的 mods/ 文件夹中。
3. 启动你的服务器。
4. 检查服务器日志以确认启动消息。

无需额外的依赖或资源包——所有内容都包含在单个 JAR 文件中。

---

已知限制

• 鸟基于笼子位置攻击 - 守卫半径以笼子为中心测量，而非鸟的位置。鸟可能追击半径外的敌对 NPC，但不会检测半径外的新敌对 NPC。
• 无鸟持久化 - 单只鸟的生命值和位置不会被保存。服务器重启后，新鸟会以满血状态生成。
• 多块笼子检测 - 相互距离 2 个方块内的笼子被视为一个笼子，以防止因多块家具碰撞箱导致的重复检测。

---

支持

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

由 GlymeraCraft 开发

GlymeraGuard 团队