Small Ships 为 Minecraft Java 带来可操控的船只。对于共同游玩的世界，Mod 文件必须匹配客户端和服务器的 Minecraft 版本及 Loader。本指南说明安装、已记录的基础操控，以及配置更改流程。版本示例为 Minecraft 1.21.1，搭配 NeoForge 和 Small Ships 2.0.0-b2.1；其他组合请分别检查。
选择正确的 Small-Ships 下载
项目概览列出了多个 Minecraft 版本和 Loader。但这并不意味着每一个文件都适用于每一种组合。打开具体下载项，并将 Minecraft 版本、Loader 和依赖项与你的实例进行核对。项目将 Small Ships 标注为适用于客户端和服务器。官方项目页面
对于本示例，存在适用于 Minecraft 1.21.1 的 NeoForge 构建 2.0.0-b2.1。这里提到的版本是一个具体参考，不是通用更新目标。如果使用现成 Modpack，请先检查其要求。
在测试世界中准备安装
- 记录版本并备份数据： 记下 Minecraft 版本、Loader 和 Mod 文件。更改前备份现有世界和配置。首次功能测试适合使用新世界。
- 使用匹配的客户端实例： 设置所需 Loader，并将 Small-Ships 文件放入其
mods目录。只补充该构建声明的依赖项。 - 启动客户端并检查内容： 确认 Mod 是否已加载，其内容是否可用。如果启动失败，检查第一条具体错误信息以及版本匹配情况。
- 相应设置服务器： 使用同样匹配的游戏版本和 Gameplay Mod 版本。不要未经检查就把完整的额外客户端图形 Mod 集合上传到服务器。
- 以普通玩家身份加入： 在没有特殊管理员权限的情况下检查可访问性和内容。成功安装不应只在 Operator 账号下可用。
- 实际检查一艘船： 测试放置、上船、船帆、航行、物品栏和下船。随后在一次干净的服务器重启后检查状态。
通用设置可参考安装 Mods 和 Modpacks。对于 Minecraft 1.21.1，NeoForge 文档还说明了合适的 Java 21 运行时。
哪个按键做什么？
以下绑定来自项目说明。请检查你实例中的实际绑定，尤其是在 Modpack 中。已更改或重复绑定的按键可能导致不同表现。
| 操作 | 文档记录的操作方式 |
|---|---|
| 上船 | 右键使用船只 |
| 打开或关闭船帆 | 在船内按 R |
| 提高或降低船帆速度 | 分别为 W 和 S |
| 调整相机距离 | 在第三人称视角中按住 F5 并使用鼠标滚轮 |
| 从外部打开物品栏 | 潜行并右键船只 |
| 发射火炮 | 看向火炮方向并按空格键；炮弹必须位于船只物品栏中 |
项目页面指出按键绑定可以更改。如果没有效果，请先检查绑定、你在船上的位置，以及该操作的前提条件。Small Ships：操作与火炮
为什么船只速度可能不同
并非每次较慢航行都是服务器问题。官方 Wiki 描述了船只类型、水域生物群系、火炮和载货的影响。在更改性能设置之前，应将这些游戏机制纳入比较。对于具体版本，Wiki 信息仍必须与实际观察到的行为相符。Small-Ships-Wiki
为了进行可复现的比较，请使用同一艘船和同一段路线。记录载货、装备和水域。先只更改一个因素。如果你同时换了船并进入另一个生物群系，就无法再明确归因差异。
如果多个玩家同时遇到操作延迟，还应额外检查连接和服务器。Minecraft Lag 和 TPS 指南有助于区分这些问题。
分开更改按键绑定和游戏规则
按键更改回答的是你如何触发某个操作。Gameplay 设置则影响共同世界的规则。因此，不要把本地按键冲突和服务器端配置问题混为一谈。
对于操作，请打开你的 Minecraft 实例的按键绑定，并搜索 Small Ships 注册的操作。如果有冲突，选择一个空闲按键，记录旧绑定，并立即测试同一操作。这样在需要时可以撤回更改。
对于 Gameplay 调整，只使用你具体构建提供的配置选项。文件名、键名和存放位置不能可靠地从另一个 Loader 的指南中照搬。先备份实际生成的文件。手动编辑前关闭服务器，并且每次只更改一个已有且有文档说明的值。启动后检查日志，确认配置是否被接受，然后以普通玩家身份测试效果。
Small Ships 2.0.0-b2.1 中的具体设置
使用 Minecraft 1.21.1 和 NeoForge 21.1.248 进行隔离首次启动时，该构建在游戏目录中生成了两个文件：config/smallships-client.toml 用于本地显示，config/smallships-common.toml 用于通用 Mod 规则。以下选项来自这些生成文件，包括其注释和值范围。客户端启动成功并不确认其已与 Dedicated Server 同步。
| 文件和键 | 默认值和允许范围 | 该设置影响什么 |
|---|---|---|
Client: shipModSpeedUnit |
0；值 0 到 3 |
速度显示单位：0 = km/h，1 = m/s，2 = 节，3 = mph |
Client: shipGeneralCameraAutoThirdPerson |
true |
自动切换到第三人称相机 |
Client: shipGeneralCameraZoomEnable |
true |
船只相机的缩放功能 |
Client: shipGeneralCameraZoomMin / shipGeneralCameraZoomMax |
5.0 / 20.0；各自为 1 到 50 |
缩放下限和上限；保持最小值小于最大值 |
Common: shipGeneralContainerModifier |
10.0；−500 到 500 |
满载货舱对速度的最大百分比影响 |
Common: shipGeneralCannonModifier |
2.5；−500 到 500 |
每门火炮对速度的百分比影响 |
Common: shipGeneralBiomeModifier |
20.0；0 到 500 |
生物群系带来的最大速度百分比加成或减益 |
Common: shipGeneralCollisionDamage |
7.5；0 到 100 |
碰撞伤害；根据配置注释，0 会禁用它 |
Common: shipGeneralDespawnTimeSunken |
15.0；0 到 600 分钟 |
沉船被移除前的时间 |
在该构建中，shipAttributeCogMaxSpeed 的默认值是 30.0。因此，不要未经检查就套用旧 Wiki 示例中的速度和生物群系数值。允许的极端值也不等于合理建议：从默认值开始，以小而可追踪的步骤更改。
编辑时保留现有 TOML 段落，并且不要更改内部 schematicVersion。在编辑文件前关闭相关实例，之后完整重启；这样该流程不假定游戏运行中会发生未经确认的热加载。这里不承诺某个具体值无需重启就会生效。对于共同规则，随后在测试服务器上以普通玩家身份检查同一操作。
用简单流程缩小错误范围
| 观察现象 | 检查 | 预期结果 |
|---|---|---|
| 船只无法放置 | 使用空旷且足够大的水域 | 船只出现，且未接触狭窄岸边或障碍物 |
R 没有触发船帆操作 |
检查座位位置和实际按键绑定 | 已分配的操作有响应 |
| 物品栏无法从外部打开 | 检查右键时是否在潜行 | 船只物品栏打开 |
| 火炮无响应 | 检查视线方向、弹药和绑定 | 操作可在空旷测试环境中触发 |
| 某位玩家无法加入 | 将其版本组合与可用客户端进行比较 | 加入时没有 Mod/Loader 冲突 |
| 重启后船只状态意外改变 | 检查干净停止、保存和服务器日志 | 状态在重复测试中可追踪地保持一致 |
请在单独世界中测试火炮，确保周围空旷且目标区域没有他人建筑。功能测试应回答一个具体操作问题，而不是损坏现有存档。
常见问题
所有共同游玩的玩家都必须安装 Small Ships 吗？
对于这里描述的改造客户端/服务器运行方式，你们应规划一套匹配的共同版本组合。不要依赖未经修改的客户端能够使用额外内容。
Small Ships 会自动兼容每个 Shader 吗？
匹配的 Mod 文件并不能证明 Shader 显示一定无误。先在没有 Shader 的情况下检查船只，然后再使用你们具体的 Shader 组合检查。在同一场景中检查水面、船帆和相机。
我可以直接从世界中移除 Small Ships 吗？
安装前保留完整备份。从已经保存的世界中移除内容 Mod 并不是一个中性的回退方式。要进行干净的回退测试，请使用备份及其对应的版本组合。
我从哪里开始搭建共同服务器？
在 Minecraft 服务器方案中检查哪种服务器软件适合你们的 Modpack。根据你们世界和玩家数量的测试结果选择资源。仅仅安装一个船只 Mod 并不能给出可靠的 RAM 需求。
相关指南
本指南的其他语言版本
Deutsch · العربية · বাংলা · English · Español · Français · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Nederlands · Polski · Português · Русский · Türkçe · اردو