VO: Better Dogs

🐕 Better Dogs

“让狼成为值得信赖的伙伴：更聪明、更安全、更鲜活。”

每位 Minecraft 玩家都懂这种痛：花上几个小时寻找并驯服一只狼，结果五分钟后，它就跳进两格深的熔岩坑，或是走下致命的悬崖。Better Dogs 从根本上重做原版狼的 AI，让它们成为聪明、耐打且能力出众的伙伴。借助高性能的事件驱动型 AI 调度器，所有机制运行时几乎不会增加游戏刻开销。

本模组属于 Vanilla Outsider Collection——一系列现代模组，旨在打磨并提升原版 Minecraft 体验。

[!注意]

每个版本对应一个 JAR：我会为每个 Minecraft 版本单独构建一个 JAR（例如 MC 1.20.1、MC 1.21.1、MC 1.21.11、MC 26.1.2、MC 26.2、MC 26.3）。请下载与你安装的 Minecraft 版本完全匹配的构建版本。

前置依赖说明：

– 现代版本（MC 26.x+）：需要 Fabric API 和 Dasik Library >=1.9.0。

– 旧版与过渡版本（MC 1.20.1、MC 1.21.x）：独立构建，仅需要 Fabric API。

---

✨ 功能

🧠 个性智能系统

驯服后，每只狼都会永久获得三种独特个性之一，并拥有专属属性、特质和巡逻粒子效果：

• 💢 攻击型（先锋）：主动在主人前方最多 10 格处侦察，并攻击最多 20 格外的敌对生物（速度 +15%、伤害 -15%、生命值 -10 点、低生命值时有 10% 概率逃跑）。巡逻时会散发红色尘埃（0xFF3333）。
• ❤️ 和平型（哨兵）：紧跟在主人 6 格范围内（生命值 +20 点、速度 -10%、伤害 +15%、击退抗性 +50%、低生命值时有 100% 概率逃跑）。巡逻时会散发绿色/青绿色尘埃（0x00FF88）。附近有怪物时，会通过低吼和警戒姿态提醒你。
• ✨ 普通型（均衡伙伴）：会可靠地跟随在主人 10 格范围内（属性均衡，低生命值时有 50% 概率逃跑）。巡逻时会散发金色尘埃（0xFFD700）。

---

🛡️ 驯服狼守卫模式

手持骨头对已驯服的狼按住 Shift 并右键点击（潜行 + 右键点击），即可将它固定在当前位置并进入守卫模式（消耗 1 根骨头）。

• 保持姿势：坐下的狼会在守卫位置保持坐姿，像哨兵一样驻守，不会改变姿势。
• 个性化巡逻方式：
• 好斗型：沿多边形周界主动巡逻，范围最远可达守卫位置周围 12 格。
• 普通型：进行径向巡逻（默认关闭巡逻，范围为 0）。
• 和平型：在 3 格范围内进行紧凑的环形巡逻。
• 看门犬警报与威胁指示：敌对生物接近和平型守卫时，狗会站起、定住并直视最近的怪物，同时发出指向性的红色粒子，并根据其独特的音效变体发出低吼。

  

---

📄 狼的所有权转让（领养）

安全、顺畅地将已驯服伙伴的所有权转让给其他玩家：

1. 发起领养：手持纸对已驯服的狼按住 Shift 并右键点击。狼会坐下、解除敌意，并留下闪烁的玫瑰粉色粒子轨迹。
2. 领取：非主人玩家可空手右键点击待领养的狼，将它认领为自己的新伙伴。
3. 安全保护：狼受到任何伤害，或原主人普通右键点击它，都会立即取消领养状态。

---

🦯 选择并骑乘指令系统

命令已驯服的狼乘坐载具、坐骑、船、矿车或模组添加的椅子，并准确呈现坐姿：

🎬 视频教程：选择并骑乘指令系统
点击下方缩略图或按钮，在 YouTube 上观看功能展示

• 选择目标：手持普通木棍、烈焰棒或微风棒，对已驯服的狼按住 Shift 并右键，即可选中它（会播放提示音并生成一圈金色粒子）。
• 指定乘坐目标：右键点击任意载具（船、矿车、马、骆驼、驴、骡、骷髅马，或模组添加的椅子/楼梯），即可让狼进入座位。
• 自然的坐姿：狼乘坐载具时会保持自然挺直的坐姿，不会悬浮或姿势僵硬地站着。

---

📏 动态体型与属性缩放

每只狼的体型都会根据遗传因素连续变化（70% 至 145%），并使用 Minecraft 原生的 Attributes.SCALE：

• 体型与属性关联：体型会按比例影响生命值上限和攻击伤害。
• 独特音效变体抽选：体型、遗传和性格会确定性地共同决定独特的音效变体（经典、大型、可爱、Puglin、愤怒、暴躁、悲伤），并为每种变体设置单独的音高偏移。

---

🤝 高级社交 AI 与族群遗传

• 多只幼崽的窝：繁殖一次可生下 1 至 4 只幼崽，每只都会独立生成性格特征、突变和体型系数。
• 成年犬纠正行为：性情强势的成年犬会温和地管教调皮的幼犬，避免陷入混乱的死亡循环。
• 食物偏好：每只狗都有独特的饮食习性——热衷于觅食的“清道夫”会积极捡食地上的食物，而挑食的族系则会拒绝地上的残食。
• 社交关系与亲和力：同伴之间会随时间建立相互亲和力，从而避免意外内斗并抑制血仇式报复。

---

🐕 无害的族群嬉戏打闹 AI 系统

同一族群中的已驯服犬只现在可以自然地进行非致命嬉戏打闹，并形成社交等级关系：

• 🤼 嬉戏式打闹回合：同属一位主人、同属一个族群的狗会发起温和的打闹，包括嬉戏绕圈、动态扑跃和摇尾巴。打闹完全不会致命，也绝不会导致死亡。
• 🐺 成年犬等级纠正轻咬：平静的成年族群成员会轻轻咬一下，对过于活跃、反复扑跃的同伴进行管教（扑跃 3–5 次后触发；幼犬受到 0 点伤害并听到温和的低吼，成年犬受到 0.5 颗心的伤害）。这会立即让场面平静下来、停止警报，并抑制报复性冲突。
• ⏱️ 嬉戏超时惩罚：受到管教的狗会进入 10 分钟的惩罚期（betterdogs:bd_play_penalty_minutes），垂下尾巴，并在被抚摸时发出轻柔的顺从呜咽声。
• 🍖 安抚零食：给受管教的狗喂食安抚零食（骨头、熟肉或生肉）可以舒缓情绪，每喂一份可缩短 10% 的惩罚时间。
• 👥 族群围观：6 格范围内的族群成员会停下来围观打闹，并兴奋地摇尾巴。

---

🛡️ 智能生存 AI

• 悬崖安全：狼会识别致命坠落（>3 格）和悬崖边缘，并停止危险的追逐。
• 规避危险：智能绕开熔岩、火焰、溺水危险和岩浆块。
• 狼群碰撞推挤保护：狼在悬崖或危险区域附近与同伴碰撞时，会立即停止移动，避免把同伴推入险境。
• 火灾求生 AI：着火的狼会在紧急情况下停止坐姿，并冲向 16 格内最近的水域灭火。
• 苦力怕爆炸闪避：驯服的狗会察觉正在膨胀的苦力怕，并迅速向四周逃离。
• 按比例呜咽：低血量呜咽会在生命值低于最大生命值的 < 50% max HP 时触发（避免健康但体型较小的狗不停哀叫）。

---

💥 犬类爆炸反射与弹道闪避

• 犬类爆炸反射（betterdogs:bd_canine_explosive_reflex_enabled）：狗会察觉可配置半径内即将发生的爆炸和危险（默认 14 格），并以 170% 的速度逃离。
• 弹道闪避反射（betterdogs:bd_ballistic_evasion_enabled）：驯服的狼会在可配置的反应时间窗口内（默认 20 ticks）察觉来袭弹射物，并通过侧向冲量进行闪避。
• 弹道拦截（betterdogs:bd_projectile_intercept）：当主人的生命值低于阈值（默认 10 颗心）时，忠诚的狗会拦截瞄准主人的弹射物。

---

📯 山羊角指令系统

• 号角指令（betterdogs:bd_horn_commands_enabled）：吹响山羊角，即可向范围内（默认 64 格）的所有驯服狼群广播指令。狗会在可配置的持续时间内（默认 600 ticks）前往号角召唤的目标位置。

---

🏰 动态领地意识与野生狼群战争

野生狼群会以有组织的队伍四处游荡，并由 Alpha 头狼带领：

• 领地遭遇：敌对狼群相遇时，头狼会根据性格协商结果：
• 好斗 vs. 好斗：引发激烈的头狼一对一决斗。
• 好斗 vs. 和平 / 普通：迫使狼群合并臣服，或和平撤退。
• 和平 vs. 和平：两个狼群会朝相反方向和平撤退。

---

🌕 恢复嚎叫音效与欢乐飞奔

• 全群嚎叫：满月之夜，狼群头狼会带领群体合唱嚎叫，使用恢复的经典狼嚎音效文件。
• 清晨与雨天飞奔：快乐健康的狗偶尔会在清晨或刚下过雨时，兴奋地高速奔跑玩耍。

---

🔍 Jade 模组 HUD 集成

• 动态数值生命值：显示精确的生命值数值（HP: X / Y）和爱心。
• 近亲繁殖状态标签：在提示框中显示遗传血统和近亲繁殖警告。
• 发现最爱零食：给狗喂食后，可识别它的秘密最爱零食。

---

💻 服务端可选与客户端门控

• 服务端可选：即使连接的客户端未安装该模组，在专用服务器上也能完整运行！
• 游戏内 GUI 配置：与 ModMenu + Cloth Config / YACL v3 无缝集成。

---

📊 快速参考与机制一览

🐺 性格对比表

| 性格 | 基础生命值偏移 | 速度修正 | 伤害修正 | 跟随距离 | 低生命值逃跑概率 | 巡逻模式 | 巡逻粒子效果 |
| :— | :—: | :—: | :—: | :—: | :—: | :— | :— |
| 好斗型 💢 | -10 HP | +15% | -15% | 10 blocks | 10% | 周边巡逻（12m） | 纯红色（0xFF3333） |
| 和平主义型 ❤️ | +20 HP | -10% | +15% | 6 blocks | 100% | 环绕巡逻（3m） | 蓝绿色 / 绿色（0x00FF88） |
| 普通型 ✨ | +0 HP | +0% | +0% | 10 blocks | 50% | 放射状警戒（已禁用） | 金黄色（0xFFD700） |

🧬 繁殖遗传继承矩阵

| 父母性格 | 后代主要结果 | 次要变异结果 |
| :— | :— | :— |
| 相同性格（例如：好斗型 + 好斗型） | 80% 继承父母性格 | 10% 变异为其他性格 |
| 普通型 + 非普通型 | 40% 显性遗传为普通型 | 40% 隐性遗传为非普通型 |
| 好斗型 + 和平主义型 | 50% 混合为普通型 | 25% 变异为好斗型 / 和平主义型 |

---

⌨️ 游戏内命令

所有命令均以 /betterdogs（别名 /bd）为前缀，并支持丰富的命令补全：

| 命令 | 权限 | 说明 |
| :— | :—: | :— |
| /betterdogs help | 所有人 | 显示游戏内命令参考手册。 |
| /betterdogs status | 所有人 | 显示当前模组配置和核心运行参数。 |
| /betterdogs get <rule> | 所有人 | 读取任意带命名空间的游戏规则的实时值。 |
| /betterdogs set <rule> <value> | OP（等级 2） | 实时更新游戏规则的值。 |
| /betterdogs reset | OP（等级 2） | 将所有 Better Dogs 游戏规则恢复为出厂默认值。 |
| /betterdogs reload | OP（等级 2） | 从磁盘重新加载配置文件。 |
| /betterdogs debug action <entity> <action> | OP（等级 2） | 触发动作（howl、zoomies、mischief、play_fight、retaliation）。 |
| /betterdogs debug personality <entity> <type> | OP（等级 2） | 强制设定狼的性格（aggressive、pacifist、normal）。 |
| /betterdogs debug territory <entity> | OP（等级 2） | 测试野生狼群的领地协商。 |

---

⚙️ 原生游戏规则与配置

[!重要]

💡 配置文件与游戏内游戏规则：全局配置文件仅为新建的地图设定默认值。在已有地图中，请通过编辑游戏规则界面或 /gamerule 命令更改设置。

关键游戏规则概览

| 类别 | 游戏规则标识符 | 默认值 | 类型 | 说明 |
| :— | :— | :—: | :—: | :— |
| 生存 | betterdogs:bd_cliff_safety | true | 布尔值 | 防止狼从致命悬崖（高差超过 3 格）上走下去。 |
| 生存 | betterdogs:bd_wolves_seek_water_on_fire | true | 布尔值 | 着火的狼会冲向 16 格内的水源。 |
| 生存 | betterdogs:bd_creeper_awareness | true | 布尔值 | 被驯服的狗会躲避嘶嘶作响的苦力怕。 |
| 生存 | betterdogs:bd_friendly_fire_protection | true | 布尔值 | 防止主人误伤被驯服的狼。 |
| 行为 | betterdogs:bd_storm_anxiety | true | 布尔值 | 开启雷雨天气下的颤抖和呜咽行为。 |
| 行为 | betterdogs:bd_zoomies_enabled | true | 布尔值 | 开启清晨和降雨时的兴奋狂奔行为。 |
| 行为 | betterdogs:bd_fetch_enabled | true | 布尔值 | 开启捡木棍游戏。 |
| 护卫 | betterdogs:bd_guard_patrol_range_aggressive | 12 | 整数 | 激进型护卫犬的巡逻半径（格）。 |
| 护卫 | betterdogs:bd_guard_patrol_range_normal | 0 | 整数 | 普通型护卫犬的巡逻半径（格，0 = 已禁用）。 |
| 护卫 | betterdogs:bd_guard_patrol_range_pacifist | 3 | 整数 | 和平型护卫犬的巡逻半径（格）。 |
| 遗传 | betterdogs:bd_wolf_litter_max_size | 4 | 整数 | 单窝幼犬数量上限（1–4）。 |
| 体型 | betterdogs:bd_wolf_min_scale_percent | 70 | 整数 | 最小体型比例（70%）。 |
| 体型 | betterdogs:bd_wolf_max_scale_percent | 145 | 整数 | 最大体型比例（145%）。 |
| 社交 | betterdogs:bd_dog_play_fighting | true | 布尔值 | 开启被驯服的狗之间无伤害的嬉闹式群体切磋。 |
| 社交 | betterdogs:bd_play_penalty_minutes | 10 | 整数 | 管教时轻咬后，顺从惩罚的持续时间（分钟）。 |
| 反射 | betterdogs:bd_canine_explosive_reflex_enabled | true | 布尔值 | 开启危险或爆炸威胁下的逃跑反射。 |
| 反射 | betterdogs:bd_ballistic_evasion_enabled | true | 布尔值 | 开启躲避弹射物的闪避反射。 |
| 反射 | betterdogs:bd_projectile_intercept | true | 布尔值 | 狗会拦截射向主人的弹射物。 |
| 号角 | betterdogs:bd_horn_commands_enabled | true | 布尔值 | 开启通过山羊角广播指令。 |
| 号角 | betterdogs:bd_horn_command_range | 64 | 整数 | 号角指令广播范围（格）。 |

---

📖 深度指南与玩法手册

通过这份全面的操作手册，掌握 Better Dogs 中的每种互动方式：

1. 驯服与发现性格

• 给任意野生狼喂骨头。驯服后，观察漂浮粒子的颜色（红色 = 激进型，绿色/青绿色 = 和平型，金色 = 普通型），或查看 Jade HUD 提示信息。

2. 潜行+右键手势指南

• 骨头 + Shift-右键：切换守卫模式（消耗 1 根骨头）。狗狗会停留在原地。坐着的狗狗会保持坐姿，继续站岗。
• 纸 + Shift-右键：让你的狗狗进入待领养状态（周围会出现闪烁的玫瑰粉色粒子轨迹）。任何非主人玩家都可以空手右键点击，将其领养。
• 木棍 / 烈焰棒 / 旋风棒 + Shift-右键：选中狗狗（出现一圈金色粒子）。然后右键点击任意载具（船、矿车、马、骆驼、椅子），命令狗狗以坐姿乘坐。

3. 选择性繁育与幼崽遗传

• 给两只驯服的狼喂肉。每窝会生下 1–4 只小狗。小狗会继承父母的体型和性格，并有小概率发生变异。异系繁育可避免近亲繁殖带来的减益。

4. 群体玩闹、切磋与管教机制

• 让驯服的同伴自由结伴漫游，观察它们进行无害的切磋和嬉戏扑跳。
• 精力过于旺盛的狗狗会受到成年同伴安抚性的轻咬管教。受到管教后，用骨头或肉安慰它们，每份零食可使其恢复冷静所需的等待时间缩短 10%！

5. 聆听声音提示与呜咽

• 只有当生命值低于狗狗最大生命值的 50%时才会触发呜咽。喂食肉类即可恢复生命值。
• 满月之夜，尽情聆听夜间狼群此起彼伏的嚎叫声。

6. 游戏内配置

• 打开世界设置 → 编辑游戏规则，即可在专属文件夹中浏览所有 Better Dogs 设置；也可以在游戏内使用 /betterdogs set <rule> <value>。

---

🧩 推荐的关联模组

如果你喜欢Better Dogs，这些来自Vanilla Outsider & Delayed Gratification Collections的配套模组可与你的游戏无缝兼容：

• 🐾 Natural Reproduction：为狼、牲畜及环境中的野生动物加入逼真的妊娠过程、季节性繁殖周期和遗传特征变化。
• 🦇 Better Bats：为原版蝙蝠加入动态的 3D Boids 集群飞行、黄昏时的飞行行为，以及蝙蝠粪便自然肥沃洞穴农作物的机制。
• 💤 True Sleep：将原版跳过睡眠的机制改为实时加速世界运转，让熔炉冶炼和生物成长自然进行。

🌟 探索完整的 Vanilla Outsider Collection，体验更多贴心的原版增强内容。

---

💬 加入社区并获取支持

需要帮助、想测试早期 Beta 版本，或为即将推出的功能投票？欢迎加入我的官方 Discord 社区！

---

☕ 支持

如果你喜欢Better Dogs和Vanilla Outsider Collection，欢迎支持后续更新！

[!NOTE]

🇮🇩 印度尼西亚用户： SocioBuzz 和 Saweria 支持本地支付方式（Gopay、OVO、Dana 等），如果你不想使用 PayPal/Ko-fi，可以通过它们来支持我！

---

📜 鸣谢与整合包授权

| 角色 / 属性 | 作者 / 链接 |
| :— | :— |
| 创作者 / 作者 | Dasik (Rifaditya) |
| 社区 | 官方 Discord |
| 合集 | Vanilla Outsider |
| 许可证 | GNU General Public License v3.0 (GPLv3) |
| 源代码 | GitHub – Rifaditya/Vanilla-Outsider-Better-Dogs |
| 问题追踪 | GitHub Issues |
| 文档 / Wiki | 官方文档与 Wiki (主要) \| GitHub Wiki (备选 / 11 种语言) |

[!IMPORTANT]

📦 整合包授权与分发：

非常欢迎你将此模组加入任何平台的任何整合包！但是，模组文件必须通过官方分发渠道（Modrinth 或 CurseForge）直接下载。严禁将原始模组 JAR 重新上传、镜像或再分发到第三方镜像站、爬虫门户或未经授权的启动器。

⚖️ 许可证与分支指南（禁止零改动重新上传）：

本项目基于 GNU GPLv3 开源。我们完全鼓励你查看代码、从中学习，并 fork 仓库以进行真正的修改、大幅功能扩展或社区移植——前提是你的项目保持 GPLv3 开源并给予适当署名。

但是，严格禁止直接的 1:1 重新上传、没有实质性功能改动的克隆分支，或以不同项目名称重新发布完全相同的构建（例如为了刷下载量或奖励）。

---