Better Boat Movement

更好的船只移动

让船跳起来！新增船只跳跃功能，并可自定义部分船只行为，让水上冒险更加丰富多彩。
使用全新的船只跳跃机制和个性化设置，掌控你的航程！

✨ 功能

• 识别障碍物的跳跃：船只会根据障碍物实际的碰撞形状，自动跳过能够越过的障碍，而不是试图冲过太高的墙。
• 可选手动跳跃：启用跳跃按键绑定后，每按一次按键即可跳跃一次；默认按键为 H，也可以重新绑定。
• 可调节行为：微调船只跳跃方式，让它更符合你的游玩风格。
• 支持多人游戏：Fabric、NeoForge、Paper、Folia 和 Purpur 服务器会验证移动，并将游戏设置同步给已连接的模组玩家。Paper 系列服务器的自动跳跃功能也支持原版客户端。

🎬 演示 – 看看船是如何跳跃的

设置：stepHeight = 0.4, extraCollisionDetectionRange = 2.0

⚙️ 配置

Fabric 和 NeoForge 使用 config/better-boat-movement.json。Paper、Folia 和 Purpur 使用 plugins/better-boat-movement/better-boat-movement.json。

安装

| 平台 | 安装位置 | 必需依赖 |
| — | — | — |
| Fabric / Quilt | mods | Fabric API、Fabric Language Kotlin 和 YACL |
| NeoForge | mods | KotlinLangForge 和 YACL |
| Paper / Folia / Purpur | plugins | 无 |

玩家无需安装模组，也可以加入 Paper、Folia 或 Purpur 服务器，并使用自动船只加速功能。不过，我们强烈建议安装对应的客户端模组：客户端预测更流畅，船只移动的响应更加即时，操作体验也更令人满意。此外，它还会启用手动跳跃按键绑定，以及只读的服务器同步设置界面。

在 Paper 系列服务器上，两种客户端选项的区别如下：

• 原版客户端：自动加速和已配置的弹出时机完全由服务器插件处理。没有手动跳跃按键绑定或设置界面。
• 已安装客户端模组（强烈推荐）：提供更流畅的客户端加速预测，让跳跃响应更迅速、体验更顺畅；还支持可选的手动跳跃按键绑定，以及只读查看服务器同步设置。服务器仍拥有最终控制权。

在所有平台上，都可以使用相同的 JSON 选项配置船只跳跃体验：

{
    "version": 7, // just ignore this, this is for migration purposes only
    "config": {
        "stepHeight": 0.35, // Sets the upward velocity applied by an automatic boost.
        "playerEjectTicks": 200.0, // Sets how many ticks the game waits before ejecting a player who has lost control of a boat.
        "boosting": {
            "boostStates": [
                "UNDER_WATER",
                "ON_LAND",
                "IN_WATER",
                "UNDER_FLOWING_WATER"
            ], // Sets the preferences under which states the boat should be boosted.
            "allowedSupportingBlocks": [], // Restricts boosts to boats resting on these block IDs or #tags. An empty list allows every block.
            "allowedCollidingBlocks": [], // Restricts boosts to the nearest block ID or #tag hit by the boat's path. An empty list allows every block.
            "onlyForPlayers": true, // Restricts automatic boosts to boats carrying a player.
            "extraCollisionDetectionRange": 0.5, // Looks this many blocks farther along the boat's path so it can boost before contact.
            "heightTolerance": 0.25 // Allows an obstacle to exceed the boat's predicted rise by this many blocks and still trigger a boost.
        },
        "keybind": {
            "allowJumpKeybind": false, // Enables manual boat jumping with the configurable keybind.
            "keybindJumpHeightMultiplier": 1.2, // Specifies the multiplier applied to stepHeight for a manual jump.
            "onlyKeybindJumpOnGroundOrWater": true // Prevents manual jumping while the boat is in the air.
        }
    }
}

在本地或单人游戏配置界面中所做的更改会在保存时生效。远程服务器的游戏玩法配置以只读方式显示，并且具有权威性。专用服务端的文件更改需要重启后才能生效。

详细行为

有关精确的自动加速、碰撞、手动跳跃以及多人游戏权威规则，请参阅游戏玩法行为参考。

ℹ️ 关于多人游戏安全性的说明

在 v1.1.1 之前，可能会在多人游戏服务器上被反作弊系统标记。
请使用 v1.1.1 或更高版本以确保安全。

💬 支持与反馈

• 如遇 Bug 或有建议，请提交issue。
• 加入我们的 Discord 获取帮助并参与社区交流。