[SBW] 卓越战争附加包

SuperbWarfre Addon 是一个为 SuperbWarfare 制作的附加组件和兼容层，适用于 Minecraft Forge 1.20.1。它侧重于实用的游戏整合：可见的抛壳、可配置的弹壳 ejection 规则、MTS 燃料/控制兼容性，以及 SuperbWarfare 的内容控制（卸载未使用的资源以释放内存）。

请与 SuperbWarfare 及其所需的库文件一同安装。

功能

• 为枪械、霰弹枪、重武器、自动炮和大型炮弹武器添加了使用过的弹壳物品。
• 为 SuperbWarfare 的枪械和载具武器提供了数据驱动的弹壳 ejection 规则。
• 支持特定弹药的弹壳行为，适用于具有多种弹药类型的武器。
• 包含一个 /superbaddon shell_ejection scan 工作流，用于为已安装的内容生成候选规则文件。
• 添加了可选的内容控制，包括配方、被阻止的资源、载具配方覆盖以及矿石生成移除。
• 添加了可选的 MTS 兼容性：   - MTS 油桶可以通过 Forge Energy 为 SuperbWarfare 载具充能。   - MTS 加油泵可以为附近的 SuperbWarfare 载具加油。   - MTS 飞行器可以选择使用 SuperbWarfare 风格的控制桥。  
• 即使未安装 MTS 也能正常工作；MTS 支持是软集成的，仅在检测到 MTS 存在时激活。
• 包含英文和简体中文本地化。

需求

• Minecraft：1.20.1
• 模组加载器：Forge 47.4.0+
• Java：17
• 所需模组：   - SuperbWarfare 0.8.9+
• 可选：   - Minecraft Transport Simulator / MTS 兼容包，仅当你想要 MTS 燃料、弹药或控制桥功能时需要。

配置

该附加组件基于配置和数据包风格的规则构建，而非硬编码的单一行为。

• 内置的数据包弹壳 ejection 规则位于 data/superbaddon/shell_ejection/ 下。
• 外部服务器配置规则位于 config/superbaddon/shell_ejection/ 下。
• 生成的扫描输出旨在启用前进行编辑。
• 内容控制支持多种模式，例如保留内容、仅移除配方，或在可能的情况下阻止已配置的资源。
• 载具配方覆盖可以禁用或重写 SuperbWarfare 的载具组装配方。
• MTS 兼容性拥有自己的配置，用于燃料转换、油桶行为、油泵行为和控制桥行为。

使用方法

1. 在客户端和服务器上安装SuperbWarfare 和本附加组件。
2. 启动游戏或服务器一次，以便创建默认配置文件。
3. 正常使用模组；受支持的 SuperbWarfare 枪械和载具武器在开火时会掉落配置好的使用过的弹壳物品。
4. 对于 MTS 燃料支持，请安装 MTS，并在能够接收 Forge Energy 的 SuperbWarfare 载具附近使用 MTS 油桶或加油泵。
5. 对于 MTS 飞行器控制支持，请打开 Minecraft 的按键绑定菜单并绑定：    - 切换 MTS 控制桥。

命令

这些命令供整合包作者、服务器管理员和测试世界使用。

• /superbaddon shell_ejection scan   - 为已安装的 SuperbWarfare 内容生成禁用的候选弹壳 ejection 规则。   - 当你想获取模板但不想立即改变游戏玩法时使用。
• /superbaddon shell_ejection scan active   - 生成 enabled 设置为 true 的候选规则。   - 仅当你准备测试生成的行为时才使用。
• /superbaddon shell_ejection reload_external   - 从 config/superbaddon/shell_ejection/ 重新加载外部弹壳 ejection 规则。
• /superbaddon content_control reload   - 从 config/superbaddon/content_control.json 重新加载内容控制配置。

弹壳 Ejection 工作流

1. 运行 /superbaddon shell_ejection scan。
2. 打开 config/superbaddon/shell_ejection/generated_scan/ 目录下生成的文件。
3. 检查每个生成的目标。不要盲目启用所有内容；扫描器创建的是候选方案，而非完美设计。
4. 当武器只应接受特定弹药时，填写或调整 ammo_override.allowed。
5. 填写或调整 ejection.by_ammo，以决定每种弹药类型应掉落哪种弹壳物品。
6. 将你想要的规则的 enabled 设置为 true。
7. 运行 /superbaddon shell_ejection reload_external 或重启服务器。

内容控制工作流

当您需要在整合包中控制 SuperbWarfare 内容的可用性时，请使用 config/superbaddon/content_control.json。

• keep：保留内容及其配方。
• recipes_only：移除配方，但不尝试阻止运行时内容。
• block_load：移除配方，阻止已配置的资源，并在可能的情况下取消支持的运行时行为。

当您只需要禁用或重写载具组装配方时，请使用 config/superbaddon/vehicle_recipe_override.json。当物品或载具仍应存在，但其进程成本需要更改时，这是更简洁的选择。

MTS 兼容性用法

• 油桶支持会消耗 MTS 油桶的燃料数据，并将其转换为用于 SuperbWarfare 载具的 Forge Energy。
• 油泵支持会消耗 MTS 油泵的燃料，并为最近的可用 SuperbWarfare 载具充能。
• 如果燃料不起作用，请检查 config/superbaddon/mts_compat.json；该燃料可能需要一个能量转换条目。
• 控制桥默认处于关闭状态。这是有意为之：除非玩家选择加入，否则不应更改现有的 MTS 控制。

给整合包作者的说明

此附加组件专为希望对 SuperbWarfare 的进程和兼容性进行更严格控制整合包作者设计。您可以移除不需要的配方、调整载具组装输入、抑制选定的矿石生成，并为自定义或扩展的武器组添加弹壳 ejection 行为。

现有的 Forge 注册表在 SuperbWarfare 加载后无法取消注册，因此内容控制是务实的：它会移除配方、阻止已配置的资源，并在可能的情况下取消支持的运行时行为。