HorseOverhaul-Revamp

马匹大修

驯服一匹马，装备马鞍，给它配储物，用口哨召唤它，通过 /horses 菜单管理它，随着旅行提升等级，并通过世界地图上的标记追踪它。

这是原版 Horse Overhaul 的改进版本，原作者为 XxKillaIciclexX，该原版已不再更新。

XxKillaIciclexX 本人已在 Discord 上授权我使用其公开的 GitHub 源代码来开发此版本。

现已兼容 "Aures - Horse Skins"

预览

主要特性

• 马匹喂食 —— 你现在可以配置能喂给马匹的物品，默认可以是胡萝卜、苹果或其他东西！
• 马匹升级 —— 马匹会随着你与它们一同旅行而升级，逐渐获得更多生命值和耐力值。
• 自定义马匹 HUD —— 马匹的生命值和耐力值现在与玩家属性分开显示。
• 真实的马匹耐力 —— 冲刺会消耗马匹的耐力，耐力会随时间慢慢恢复。
• 分级马鞍与储物 —— 从基础马鞍升级到铜马鞍、铁马鞍和金马鞍，可获得更多储物空间。
• 马匹口哨 —— 召唤你的当前活跃马匹，它会以更智能的寻路方式回到你身边。
• 原生 /horses 菜单 —— 通过一个更整洁、使用原版游戏风格的 UI 来管理你的马匹。
• 马匹所有权 —— 将马匹与玩家绑定，可以重命名、锁定、释放或将马匹转让给其他玩家。
• 活跃马匹系统 - 默认情况下，每位玩家最多可拥有 3 匹马，服务器所有者可以在属性文件中将此上限配置为最高 8 匹。你可以将一匹马标记为你的活跃马匹，这会将改变其地图标记图标，并使其成为你使用口哨物品时响应的那匹马。
• 持久化地图标记 —— 即使你离得很远，你的马匹也会根据其最后已知位置在地图上保持可见。
• 多人游戏安全移动 —— 骑乘时，装备了马鞍的马匹会正常行动，不会再有旧的橡皮筋式滞后问题。

版本 6.0.2 新增内容

升级系统

马匹现在会随着你与它们一起探索世界而升级。每次升级都会为马匹增加生命值和耐力值，使得长期饲养的马匹更有价值，并为玩家提供了不断改进同一坐骑的理由。

自定义马匹生命值与耐力值 HUD

马匹大修现在使用专用的马匹 HUD，而非仅在骑乘时显示玩家的原版属性。

马匹耐力会在冲刺时消耗并随时间恢复。马匹生命值也会被单独跟踪，使马匹感觉像真正的坐骑，而不仅仅是一个可骑乘的实体。

这个系统也为未来的马铠、配饰、食物、加速道具和基于耐力的效果打开了大门。

通知系统

插件消息不再仅限于聊天栏。重要的反馈现在会以右下角通知的形式出现，并配有自定义图标和自定义音效。

重新设计的 /horses 菜单

/horses 菜单现在使用原版 UI 包，使其感觉更整洁、更精致、更贴合游戏本身。

更智能的马匹行为

马匹现在会在你靠近时自动醒来，因此你不再需要在夜间为了召唤坐骑而吹口哨。

马匹跟随也得到改进。当你用口哨召唤时，你的马匹现在会更自然地避开墙壁、障碍物和地形，而不是容易被卡住。

持久化地图标记

马匹标记现在会记住马匹的最后已知位置。如果你移动到远处且马匹所在的区块被卸载，该标记在地图上仍将保持有用。

马鞍与储物

所有物品都在 耕作用工作台 上制作。

物品	默认槽位数	配方
马鞍	9	3x 厚重皮革 + 2x 亚麻布碎片
铜马鞍	18	1x 马鞍 + 4x 铜锭
铁马鞍	27	1x 马鞍 + 6x 铁锭
金马鞍	36	1x 马鞍 + 8x 金锭
马匹口哨	—	1x 铜锭 + 1x 亚麻布碎片

铜、铁和金马鞍是通过升级标准 马鞍 制作的，因此你会沿着同一条马鞍路线不断进步。

工作原理

绑定马匹

1. 按正常方式驯服一匹马。
2. 为驯服的马装备马鞍。
3. 这匹马就会与你绑定。
4. 你现在可以从 /horses 菜单管理它。

野马在被驯服之前无法使用马鞍。

管理你的马匹

使用 /horses 打开马匹管理菜单。

在这里，你可以：

• 查看你的马匹
• 检查马匹的生命值和耐力值
• 选择你的活跃马匹
• 重命名马匹
• 锁定或解锁访问权限
• 释放一匹马

只有你的活跃马匹会响应口哨。

重要提示： 释放一匹马会永久摧毁其装备的马鞍以及其中储存的所有物品。

召唤你的马匹

制作一个 马匹口哨 并在手持时使用它。你的活跃马匹会尝试回到你身边。

你绑定的第一匹马会自动成为活跃马匹。你可以随时从 /horses 菜单更改你的活跃马匹。

马匹背包

你可以通过多种方式访问马匹储物：

• 手持马鞍时使用它可以打开其储物空间
• 与一匹未骑乘但装备了马鞍的马互动以打开马匹背包
• 骑乘时按你的常规背包键打开马匹背包

转让马匹

在骑乘属于你的马时，运行：

/horse transfer <用户名>

接收者必须在线，并且必须有空位来容纳另一匹马。

转让会保留马匹的名字、马鞍、储物、等级、生命值、耐力值和锁定状态。

命令

命令	描述
/horseoverhaul	打开游戏内帮助窗口。
/horses	打开马匹管理菜单。
/horse name <名字>	为你当前骑乘的马命名。
`/horse lock <名字> on	off`
/horse transfer <用户名>	将你骑乘的马转让给另一位在线玩家。

面向服务器所有者

本节包含更技术性的设置和配置细节。

安装

1. 从 CurseForge 下载 HorseOverhaul-6.0.2.jar。
2. 将 jar 文件放入你的 Hytale 服务器模组文件夹。
3. 启动服务器一次以生成 HorseOverhaul.properties。
4. 根据需要编辑配置。
5. 更改配置值后重启服务器。

对于本地测试，模组文件夹通常位于：

%APPDATA%\Hytale\UserData\Mods

配置

马匹大修在首次启动时会在模组 jar 文件旁边创建一个 HorseOverhaul.properties 文件。

配置示例：

Horse_Limit=3
saddle_storage_slots_standard=9
saddle_storage_slots_copper=18
saddle_storage_slots_iron=27
saddle_storage_slots_gold=36
saddled_horse_petting_enabled=false

# 马匹升级
horse_max_level=10
horse_health_per_level=5
horse_stamina_per_level=5
horse_blocks_required_per_level=1000

trace_logging_enabled=false

可配置的值

• Horse_Limit 控制每位玩家可以绑定的马匹数量。默认值：3。有效范围：1 到 8。
• 马鞍储物槽位可以分别为标准、铜、铁和金马鞍进行配置。
• 马匹升级可以配置最高等级、每级增加的生命值、每级增加的耐力值以及每级所需的移动距离。
• saddled_horse_petting_enabled 控制装备马鞍的马是否保留与牲畜的抚摸互动。
• trace_logging_enabled 启用详细的调试日志记录，通常应保持禁用。

警告： 在现有世界中降低马鞍储物槽位可能会导致马鞍中的物品消失。在更改储物值之前，请备份你的世界。

兼容性说明

• 更改马匹上限时，已绑定的马匹会被保留。
• 降低 Horse_Limit 不会删除马匹，但会阻止玩家在未低于上限前进行新的绑定。
• 旧的 saddle_storage_slots 键仍可作为标准马鞍的旧版值被接受。

寻找 3D 美术师

目前，每个级别的马鞍在装备到马上时仍使用原版游戏中的马鞍模型。我正在寻找一位 3D 建模师，帮助为铜、铁和金马鞍创建独特的模型，以及未来的马匹装备。

致谢

基于 XxKillaIciclexX 的原版 Horse Overhaul。

原版插件已不再维护。此版本延续了该项目，包含了多人游戏修复、分级马鞍、马匹储物、口哨、地图标记、马匹命令、马匹升级、自定义马匹 HUD 等等。