未驯服的奥德赛

Untamed Odyssey – Modrinth 描述与操作指南

🎮 概述

Untamed Odyssey 为 Minecraft 1.16.5 添加了三种可完全驯服、可骑乘的“神话坐骑”：

坐骑	核心主题	玩法风格
凤凰	烈焰重生与翱翔	快速空中旅行、火焰滑翔、凤凰火焰攻击
海龙	海洋掠食者	水下敏捷、摧毁船只、强力咆哮
剑齿虎	原始陆地掠食者	冲刺奔跑、伏击扑击、咆哮眩晕

所有坐骑共享统一的驯服/坐下/跟随系统、可骑乘的鞍具以及骑乘时可激发的独特能力。该模组还包含一套自定义音效、粒子效果和精致的用户界面，让每个生物都感觉高级且栩栩如生。

目标： 提供一种高级、视觉效果惊艳的坐骑系统，从第一眼起就令人赞叹，并拥有流畅的动画、动态粒子效果和响应灵敏的操作。

✨ 主要特性

• 驯服与骑乘 – 使用每种生物的自然食物（例如，生鳕鱼喂凤凰，热带鱼喂海龙，肉喂老虎）驯服，并立即骑乘。
• 动态骑手偏移 – 骑手高度平滑跟随坐骑的坐下动画，消除坐骑坐下时的漂浮感。
• 能力系统 – 每种坐骑在骑乘时都可触发独特能力：

坐骑	能力	激活方式	效果
凤凰	飞行	骑乘时右键（或使用“飞行”按键）	在飞行、下降和着陆状态间切换，实现快速空中旅行。
凤凰	火焰滑翔（被动）	飞行时自动激活	给予骑手抗火效果，并产生火焰粒子拖尾。
海龙	咆哮	骑乘时按 R	发出咆哮，伤害附近生物，造成击退，并短暂重置海龙的咆哮冷却。
海龙	摧毁船只（被动）	骑乘时靠近船只自动触发	船只破碎，所有乘客被弹飞并受到轻微向上推力。
剑齿虎	扑击	骑乘时双击 W	短距离跳跃，造成高额伤害并短暂眩晕目标。
剑齿虎	咆哮	骑乘时按 R	给予骑手抗性提升效果，并产生短距离的眩晕场。
所有坐骑	跟随 / 停留	（未骑乘时）Shift + 右键	在停留（命令坐下）和跟随（命令站立）间切换。

• 流畅动画 – sitProgress（0 → 10）驱动每种坐骑的10刻坐下/站立动画，骑手偏移随之同步插值。
• 自定义音效与粒子 – 独特的火焰、咆哮和受伤音效（见 ModSounds），以及动态的火焰、水花和粒子拖尾。
• AI 目标 – SitGoal、FollowOwnerGoal、TerritorialApexGoal、AmbushPounceGoal、WaterAvoidingRandomWalkingGoal 以及自定义 SeaDrake 水中漫步目标，确保驯服和野生状态下的逼真行为。
• 兼容性 – 适用于 Minecraft 1.16.5 的 Forge 36.2.0（或更高版本），不依赖其他模组。

🌍 栖息地与自然生成

实体	主要生物群系（栖息地）	生成条件
凤凰	下界 玄武岩三角洲、灵魂沙峡谷	光照等级 7-15，上方至少2格空气，生成权重 5
海龙	海洋、深海、温暖海洋	水下生成，光照等级 0-7，生成权重 8
剑齿虎	平原、热带草原、黑森林	陆地生成，光照等级 7-15，生成权重 10

🗺️ 各实体能力总结

凤凰

能力	触发方式	描述
飞行	骑乘时，按 空格（或任何自定义“飞行”按键）	进入飞行状态，使凤凰起飞并持续飞行。飞行计时器到期后自动转为下降，然后安全着陆。
火焰滑翔（被动）	飞行时自动激活	给予骑手抗火效果（40刻），并持续产生火焰粒子拖尾。
驯服	手持 烈焰棒 右键（无10分钟倒计时）	立即驯服凤凰；界面显示驯服状态条。
坐下 / 停留	手持鞍具时 Shift + 右键	命令凤凰坐下；它停止移动并播放坐下动画。
跟随	相同的切换操作	恢复凤凰正常AI移动和跟随主人行为。

海龙

能力	触发方式	描述
咆哮	骑乘时按 R	发出响亮的咆哮（自定义音效），伤害附近敌对生物（10点生命值）并击退它们。触发3秒冷却（roarCooldown）。
摧毁船只（被动）	骑乘时撞向船只（无需额外按键）	海龙将船只撞碎并弹飞乘客，造成6点生命值伤害并向上弹射。
驯服	手持 生鱼（鳕鱼、鲑鱼、热带鱼）右键	立即驯服海龙。
坐下 / 停留	Shift + 右键	强制海龙在陆地或水上坐下，停止导航并播放坐下动画。
跟随	相同的切换操作	海龙游向主人，空闲时使用自定义的 WaterWanderGoal。

剑齿虎

能力	触发方式	描述
扑击	骑乘时双击 W	老虎向前猛扑（约1.5格），造成8点生命值伤害，并短暂眩晕目标。
咆哮	骑乘时按 R	发出咆哮，给予骑手抗性提升效果（40刻），并产生短距离眩晕场。
驯服	手持 生肉（牛肉、猪肉）右键	立即驯服老虎。
坐下 / 停留	Shift + 右键	命令老虎坐下（停止移动，播放坐下动画）。
跟随	相同的切换操作	老虎以快速冲刺追逐主人，未被命令坐下时使用 FollowOwnerGoal。

🎮 操作（默认）

操作	默认按键	描述
骑乘 / 下坐骑	在鞍具上 右键（坐骑已被拥有时）	如果实体尚未成为乘客，则骑乘它。
切换坐下/跟随	（未骑乘时）Shift + 右键	切换命令坐下标志。
激活能力	（骑乘时）R	调用坐骑特定的主动能力（海龙和剑齿虎的咆哮、剑齿虎的扑击等）。
飞行（仅凤凰）	（骑乘时）空格（或任何自定义“飞行”按键）	切换飞行模式。
扑击（仅剑齿虎）	（骑乘时）双击 W	执行扑击跳跃。
打开背包（仅主人）	未装备鞍具时 Shift + 右键 坐骑	打开坐骑的自定义背包界面。
打开鞍具界面	手持鞍具时 Shift + 右键 坐骑	打开坐骑背包，以装备鞍具、箱子等。

所有按键绑定均可在控制界面下的 神话坐骑 类别中重新分配。

📦 安装

1. 从 Modrinth 下载最新的 untamedodyssey-<版本号>.jar。
2. 将文件放入 mods/ 文件夹。
3. 使用适用于 1.16.5 的 Forge 36.2.0+ 启动 Minecraft。
4. 模组会自动注册其实体、音效和物品——无需进一步配置。

🔧 配置（可选）

模组包含一个 config/untamedodyssey.cfg 文件，您可以在其中调整：

• 驯服食物列表 – 添加或移除驯服每种坐骑的物品。
• 能力冷却时间 – 调整咆哮、扑击和飞行的计时器。
• 生成率 – 更改每种坐骑的自然生成权重。

🧩 兼容性

• Minecraft： 1.16.5
• Forge： 36.2.0+
• 可与大多数原版兼容模组（例如，生物群系模组、资源包）一起使用。
• 目前已知与其他添加坐骑或实体的模组无冲突；如果其他模组替换了相同实体 ID，请相应调整 ModEntityTypes 类。