狗狗伙伴

🐕 狗狗伙伴 – 忠诚的战斗伙伴



⚠️ BETA 版本 这是测试版本，部分功能仍在开发中。

重要更新提示： 更新前请务必从 Mod 文件夹中移除所有旧版本，避免出现双重存档或服务器启动错误等问题！

📖 概述

此模组为 Hytale 添加了可驯服的狗狗，它们会跟随你、保护你，并与你并肩作战。与猫咪（和平、装饰性）不同，狗狗是主动战斗伙伴，拥有防御和攻击模式。

• 🐱 猫咪 – 和平伙伴，不参与战斗
• 🐕 狗狗 – 战斗伙伴，会战斗和保护

✅ 特性

• 3 个品种：通用犬、德国牧羊犬、柴犬（计划添加更多）
• 使用生肉或熟肉驯服，驯服成功后显示命名界面
• 操作轮盘用于控制你的狗狗（跟随、坐下、睡觉、玩耍、闲逛、战斗模式、搜索、抚摸、重命名）
• 狗哨用于召回狗狗、命令其攻击或取消攻击
• 情绪粒子效果显示狗狗的感受
• 互动提示会根据你手中持有的物品（食物、哨子、空手）变化
• 战斗模式：防御（自动保护）、攻击（协助攻击）、攻击指令（手动指定目标）
• 名称铭牌显示当前模式：[DEF]、[OFF]、[ATK]、[SIT]
• 每种行为状态都有对应的声音和动画
• 所有狗狗数据持久化保存（主人、状态、位置）
• 每位玩家可拥有的狗狗数量上限，可通过权限配置
• /dog reload 命令可即时重载配置（仅管理员）

如何获得狗狗

手动生成： 使用 NPC 生成命令来创建狗狗：

/npc spawn DogsCompanion_Wild
/npc spawn DogsCompanion_GermanShepherd_Wild
/npc spawn DogsCompanion_ShibaInu_Wild

生成蛋： 每个品种都有对应的生成蛋：

• Egg_Spawner_DogsCompanion – 通用犬
• Egg_Spawner_DogsCompanion_GermanShepherd – 德国牧羊犬
• Egg_Spawner_DogsCompanion_ShibaInu – 柴犬

注意： 自然生成计划在未来更新中添加。

如何驯服狗狗

1. 获得肉（生野味或熟野味）
2. 手持肉走向一只野生狗狗
3. 多次按下 F 键（互动键） – 需要喂食 2-5 次
4. 驯服成功后将显示品种并建议一个名字
5. 保留当前名字或输入新名字，然后确认

在创造模式下，首先需要在快速设置（TAB 键）中启用“允许 NPC 检测”。错误的物品可能会激怒野生狗狗！

狗哨

使用狗哨可以远距离指挥你的狗狗：

• 召回 – 未指向任何目标时使用，附近所有狗狗会返回
• 攻击 – 在看向敌人时使用，附近所有狗狗会攻击该敌人
• 取消 – 对正在攻击的狗狗使用，可停止其攻击

有短暂冷却时间。仅影响范围内的狗狗。

操作轮盘

对你的驯服狗狗按下 F 键可打开操作轮盘：

操作	效果
跟随	狗狗跟随你
坐下	狗狗坐下并停留原地
睡觉 / 醒来	切换睡觉状态
玩耍	玩耍情绪
闲逛 / 返回	自由漫步或返回
战斗模式	循环切换 普通 → 防御 → 攻击
搜索	狗狗在区域内搜索物品
抚摸	抚摸你的狗狗

停止（中心）取消当前行动，重命名 打开名字输入界面。

战斗系统

属性

• 每次攻击 6.0 伤害，2.5 秒冷却，约 2.5 格范围，400 毫秒前摇

战斗模式

通过操作轮盘或命令切换模式。当前模式会显示在名称铭牌上。

防御 [DEF] – 当有东西攻击你时，狗狗会自动防御（20 格半径）

攻击 [OFF] – 当你攻击某物时，狗狗会协助攻击（20 格半径）

攻击指令 [ATK] – 看向目标并使用 /dog attack 命令让你的狗狗追击它

狗狗在防御/攻击模式下击败目标后会返回跟随状态。将其设为坐下可使其不参与战斗。

忠诚防御

处于活跃状态（跟随、搜索、闲逛、玩耍、返回）的狗狗会在你的生命值低于 75% 时自动保护你——即使没有开启防御模式。这体现了狗狗保护亲近之人的本能。处于坐下、睡觉或等待状态的狗狗不会反应。

命令

所有命令都以 /dog（或 /dogs）开头。使用命令时需要看着你的狗狗。

通用命令： info – 狗狗详情 | list – 你的狗狗列表 | spawn / despawn – 生成或保存一只狗狗 | owner – 更改主人（管理员） | reload – 重载配置（管理员）

狗狗控制命令： follow | sit | sleep | wait | wander | play | name <名称> | release | attack

🔐 权限

支持 Hytale 权限系统和 LuckPerms。每位玩家默认拥有 16 只狗狗的上限。可通过 markusbordihn.dogs.limit.8 或 markusbordihn.dogs.limit.unlimited 进行调整。

⚠️ 已知限制

重要提示

• 自然生成 野生狗狗目前还不会在世界中自然生成。请使用生成命令或生成蛋。

• 品种有限 目前仅提供 3 个狗品种。计划在未来更新中添加更多品种。

🚧 计划中

• 在不同生物群系中自然生成
• 更多品种（哈士奇、金毛寻回犬、边境牧羊犬等）
• 繁殖和幼犬
• 项圈、护甲、床、玩具
• 等级系统和品种特有技能
• 多犬群体行为

🗃️ 数据存储

狗狗数据会自动保存到 worlds/default/resources/DogsCompanionData.json（包含 UUID、名称、状态、位置、战斗信息）。在移动世界时请备份此文件。

🐛 已知问题

• 野生狗狗有时会卡在手持肉类的玩家附近
• 部分动画过渡不够流畅
• 寻路功能有待改进
• 防御/攻击模式可能有轻微激活延迟

🔗 相关模组

🐱 猫咪伙伴 – 和平伙伴，具有装饰功能和趣味互动，无战斗。

👉 下载猫咪伙伴

---

享受你的新犬类伙伴吧。🐕

此模组正在积极开发中。会定期添加更新和改进。