# Perfectly Balanced Horses: 让马匹再次伟大！
## 为什么？
在Minecraft中，由于与其他交通方式（例如鞘翅或船只）相比，马匹的实用性常常被忽略。这个插件旨在通过增强繁殖过程，允许玩家用具有改进属性的马匹进行繁殖，从而提高马匹的效用。通过修改诸如移动速度、跳跃强度和生命值等属性，玩家可以创建出速度极快、跳跃高度高、生命值健康的马匹，使其更具竞争力，可以与其他交通方式相媲美。
而且，繁殖马匹并观察结果也很有趣！
## 安装
[](https://modrinth.com/plugin/perfectlybalancedhorses)
1. 从 [Modrinth](https://modrinth.com/plugin/perfectlybalancedhorses) 下载您需要的插件版本。
2. 将下载的JAR文件放置在您的服务器的 `plugins` 目录中。
3. 启动或重新加载您的服务器。（建议重启服务器以确保插件已正确加载。）
4. 通过编辑 `plugins/PerfectlyBalancedHorses` 目录中的 `config.yml` 文件来配置插件以满足您的需求。
5. 使用 `/pbhreload` 命令或重新启动服务器来重新加载插件。
6. 享受繁殖完美平衡的马匹吧！
> [!TIP]
> 建议使用 **Horse Power** 客户端模组来查看马匹的属性。此模组会在马匹的物品栏界面上显示马匹的速度、跳跃高度和生命值。它可以在以下链接找到：
[Horse Power](https://modrinth.com/mod/horse-power)。
## 描述
PerfectlyBalancedHorses 是一个Minecraft插件，它通过允许玩家用具有改进属性的马匹进行繁殖来增强马匹繁殖。它修改诸如移动速度、跳跃强度和生命值等属性，从而能够创建出速度极快、跳跃高度高、生命值健康的马匹。
该插件还被设计为高度可配置，允许服务器所有者自定义繁殖过程以满足其服务器的需求。这包括调整每个属性的最大值以及后代可以遗传的值范围的能力。配置选项涵盖移动速度、跳跃强度和生命值，并具有额外的设置来控制是否应忽略过剩或不足的属性值。
## 截图
## 配置
插件的配置文件 `config.yml` 位于 `plugins/PerfectlyBalancedHorses` 目录中。它分为三个部分，每个部分对应一个不同的属性：*速度*、*跳跃*和*生命值*。每个部分包含以下设置：
- **modify**: 一个布尔值，确定是否应在繁殖期间修改属性。
- **multiplier**: 一个双精度值，确定繁殖时属性应乘以多少。
- **offspring-attribute-range**: 一个双精度值的范围，确定繁殖时应用于父母属性值的值。范围由 `start` 和 `end` 值定义。如果 `start` 值大于 0，后代将继承一个始终大于父母属性平均值的数值。请注意，`end` 值必须大于 `start` 值。数学计算如下：
- `parentAverage + (parentDifference + rangeBuffer) * randomFactor`
- `randomFactor` 是 `start` 和 `end` 值之间的随机值。
- `rangeBuffer` 是最大值（游戏原版或自定义）与游戏原版最小值之间的差值的 0.3 倍。
- `parentDifference` 是父母属性值之间的绝对差值。
- **ignoreExcess**: 一个布尔值，确定是否应忽略过剩的属性值。
- **ignoreDeficit**: 一个布尔值，确定是否应忽略不足的属性值。
**use-vanilla-offspring-attribute-range** 设置控制是否使用Minecraft的默认后代属性范围。将其设置为 `true` 以获得平衡的属性。如果设置为 `false`，则将使用配置文件的 `offspringRange`，这可能导致非常高或非常低的属性，从而导致繁殖系统不平衡且缺乏稳定的进展。 建议将其设置为 `true` 以获得平衡的游戏体验。
这是一个示例配置文件：
```yaml
use-vanilla-offspring-attribute-range: true
attributes:
movement-speed:
modify: true
multiplier: 150.0
offspring-attribute-range:
start: -0.5
end: 0.5
ignore-excess: false
ignore-deficit: false
jump-strength:
modify: true
multiplier: 150.0
offspring-attribute-range:
start: -0.5
end: 0.5
ignore-excess: false
ignore-deficit: false
health:
modify: true
multiplier: 150.0
offspring-attribute-range:
start: -0.5
end: 0.5
ignore-excess: false
ignore-deficit: false
```
> [!IMPORTANT]
> `multiplier` 设置是一个百分比值。例如，`multiplier` 为 150.0 将增加属性的最大值 50%。
## 命令
该插件提供了以下命令：
- `/pbhreload`: 重新加载插件的配置文件。需要 `pbh.reload` 权限。
## Bug 和建议
### Discord 社区
需要帮助解决小问题或有疑问吗？加入我们的支持性社区 [Discord 服务器](https://lyzev.dev/discord)。我们的友好成员和工作人员将为您提供帮助！
[](https://lyzev.dev/discord)
### GitHub Issues
对于错误或建议，请通过 [GitHub 问题追踪器](https://github.com/Lyzev/PerfectlyBalancedHorses/issues) 提交。 友善地使用提供的模板，并包含所有相关详细信息，以确保我们能够快速解决您的问题。 您的配合将不胜感谢！
## 贡献指南
我们欢迎社区的贡献！ 请阅读我们的 [贡献指南](https://github.com/Lyzev/PerfectlyBalancedHorses/blob/master/CONTRIBUTING.md) 以开始贡献。
## 安全
如果您发现此项目中的安全漏洞，请参阅 [SECURITY.md](https://github.com/Lyzev/PerfectlyBalancedHorses/blob/master/SECURITY.md) 文件，
以获取更多关于如何报告它的信息。
**请不要公开披露安全相关问题。**
> [!WARNING]
> 此项目采用 AGPL-3.0 许可，这意味着此软件不提供任何担保。 请自行承担风险使用。
有关更多详细信息，请参阅 [LICENSE](https://github.com/Lyzev/PerfectlyBalancedHorses/blob/master/LICENSE)。
## LICENSE
Copyright (C) 2025 Lyzev
本程序是自由软件：您可以在 GNU 通用公共许可证条款下重新发布和/或修改
条款，即自由软件基金会发布的许可证版本 3 或（根据您的选择）
任何后续版本。
本程序是分发的，希望它会很有用，
但没有任何担保；即使暗示的担保也没有
适销性或特定用途的适用性。 有关更多详细信息，请参阅
GNU 通用公共许可证。
您应该已收到一份 GNU 通用公共许可证
同时与此程序一起分发。 如果没有，请参阅
。
---
*Perfectly Balanced Horses 由 Lyzev 开发和维护。感谢您使用 Perfectly Balanced Horses!*
