Immersive Vehicles 为 Minecraft Java 增加了车辆所需的技术基础。若要真正获得汽车或飞机，你还需要合适的 Content Packs。本指南帮助你区分基础模组、车辆包和设置，并准备一套共同安装方案。这里以搭配 NeoForge 的 Minecraft 1.21.1 作为具体示例；其他 Minecraft 版本需要各自适配的版本组合。
为什么只有 Immersive Vehicles 还不包含车辆
基础模组提供底层基础。车辆包提供相应内容；额外的零件包也可能是进一步依赖项。项目明确指出，基础模组本身不附带车辆。根据作者说明，这些 Packs 同样应放入 mods 目录。Immersive Vehicles：项目说明
不要把这些包和普通资源包混淆。如果提示缺少 Packs，请从安装它们及其依赖项开始排查。分配更多 RAM 不会生成缺失的车辆定义。
哪些组件需要配套？
| 组件 | 示例中的作用 | 选择时需要注意什么 |
|---|---|---|
| Minecraft Java 1.21.1 | 共同游戏版本 | 客户端和服务器使用相同目标版本 |
| NeoForge | 模组加载器 | 面向 Minecraft 1.21.1 的构建，以及各模组要求 |
| Immersive Vehicles 24.0.0 | 车辆基础 | 选择具体的 NeoForge-/1.21.1 下载 |
| Official Content Pack V29，简称 OCP | 官方内容包 | 检查该 Pack 的依赖项和要求 |
| Official Automobile Pack V3，简称 OAmP | 官方汽车包 | 注意指定的基础模组和其他 Packs |
示例版本来自 IV 24.0.0、OCP V29 和 OAmP V3 的具体发布版本。它们只是一个版本示例，并不是关于当前推荐版本或与其他所有模组组合情况的笼统结论。
对于 Minecraft 1.21.1，Java 21 是合适的主版本。实际使用哪套运行时，需要在启动器或服务器启动时检查。单独安装的 Java 不一定就是你的 Minecraft 实例所使用的运行时。NeoForge 指南说明了 Java 选择和安装。
受控地搭建安装环境
- 创建独立测试实例： 使用单独的游戏目录。在用新模组打开已有世界前，先备份该世界。创建一个新的测试世界会更清晰。
- 选择 Minecraft 和 NeoForge： 在启动器中设置目标版本。首次启动时检查实际使用的是目标配置文件。
- 获取 IV 和 Packs： 通过官方项目页面下载合适文件，并检查其依赖项。将它们放入该实例的
mods目录。 - 检查基础功能： 启动测试实例。检查启动信息、已加载模组以及所需内容是否可用。此时不要再添加其他车辆或图形实验内容。
- 单独核对服务器： 多人游戏需要设置对应的 NeoForge 服务器安装，并检查所需 Gameplay 模组及 Packs。不要把完整客户端目录未经检查就当作服务器模板。
- 共同测试： 检查加入服务器、车辆可见性、上车、移动，以及重启后的状态。之后再把这套安装用于你们的共同世界。
通用服务器搭建可参考指南 设置 Mods 和 Modpacks 来补充这些步骤。对于已有 Modpack，其文档中规定的版本要求优先于自由组合的列表。
哪些车辆设置会改变玩法？
IV 24.0.0 在 NeoForge 21.1.248 下单独启动时，会在游戏目录中生成文件 config/mtsconfig.json。以下键位于其中的 general 对象内，分别带有 value 和 comment。另一个文件 config/mtsconfigclient.json 包含客户端设置。对于其他发布版本，请检查实际生成的文件；不要盲目补齐缺失条目。
| 键 | 默认值 | 文档中的含义 | 对你们游戏组的考虑 |
|---|---|---|---|
fuelUsageFactor |
1.0 |
燃料消耗系数；数字 0 会将其禁用 |
加油是否应成为游戏流程的一部分？ |
engineHoursFactor |
1.0 |
发动机运行小时数累积系数 | 发动机磨损应有多重要？ |
keyRequiredToStartVehicles |
false |
当为 true 时，启动车辆需要手持钥匙 |
车辆使用权限是否应更强地绑定钥匙？ |
opPickupVehiclesOnly |
false |
当为 true 时，服务器上只有 Operator 可用扳手收起车辆；根据注释，对客户端世界无效 |
谁可以收起车辆？ |
来源：已检查 commit 中的 IV 配置定义。这些 Gameplay 设置不是通用 FPS 调节项，也不能替代完整权限系统。
修改设置并检查效果
先备份实际生成的配置，并在手动编辑文件前关闭相关实例。保持现有 JSON 格式：修改目标键的 value 字段，而不是名称或注释。0 是数字；既不要写成 JSON 值 null，也不要写成字符串 "0"。保存后完全重启，并检查文件是否有解析错误。这个流程不假设设置会在游戏运行中即时生效。多人游戏还必须在具体测试服务器上额外验证规则；本地启动不能证明服务器权限有效。
用一个具体问题来测试效果。对于访问规则，用普通玩家和 Operator 分别执行同一操作。对于消耗规则，在尽量相同的条件下比较同一辆车。仅有已保存的数值，还不能证明当前会话已经采用它。
如果结果不符合预期，就恢复备份配置。对已修改世界的回退，应通过完整备份来规划。不要轻率地从生产世界移除内容模组，然后再保存，误以为这就是修复。
排查常见问题
| 症状 | 首先检查 |
|---|---|
| 基础模组已加载，但没有车辆 | 是否存在所需车辆包及其依赖项？ |
| 客户端能启动，但加入服务器失败 | 核对 Minecraft、加载器、Gameplay 模组和 Pack 版本 |
| 车辆存在，但无法驾驶 | 检查具体 Pack 对零件、组装和操作的要求 |
| 去掉其他模组后车辆才正常 | 在测试实例中逐个比较最近添加的组件 |
| 修改似乎无效 | 检查实例是否正确、配置页面是否匹配，以及是否完成所需重启 |
是否有适用于每种车辆的统一控制方式？
不要从基础模组名称推断这一点。车辆包可以规定不同的操作流程和部件。请检查你的实例中的按键绑定，以及具体车辆的说明。这里给出适用于每辆汽车和每架飞机的通用按键，并不可靠。
我可以直接把自己的 3D 模型复制到 mods 文件夹吗？
一个模型文件还不是完整的 Minecraft 车辆包。正常游玩请使用合适的已发布 Pack。自定义模型开发是另一项独立任务，本安装指南不涵盖。
我需要特殊的托管套餐吗？
先检查所需服务器软件和模组安装是否受支持。Minecraft 服务器方案 是你们共同世界的入口。仅凭 JAR 文件数量无法可靠推导 RAM 需求；这需要结合你们的世界和玩家人数进行测试。若操作延迟，可参考 服务器 Lag 诊断。
相关指南
本指南的其他语言版本
Deutsch · العربية · বাংলা · English · Español · Français · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Nederlands · Polski · Português · Русский · Türkçe · اردو