# 装甲车辆轻度改装（Armor Tweaks）
**项目地址 / 下载：** https://github.com/junze0910/junze-hd2-lua-mod/releases/latest
**当前版本：** v1.1.0
## Description · 简介
把《绝地潜兵 2》的**三辆装甲载具**变成可配置：
* **TD-110 风暴漩涡坦克**（`tank_storm`）—— 驾驶员位 / 炮手位各装什么、四种预设模式；
* **TD-220 堡垒 MK XVI** —— 同轴重机枪位要不要换成 40mm 机炮；
* **M-102 快速侦查载具**（含「地图产出」变体）—— 车载武器三选一；
* **四条炮塔**（TD-110 激光炮塔 + 加特林主炮、TD-220 主炮 + 同轴重机枪）的**水平射界**要不要放到 360°；
* **40mm 机炮的弹种**在 40mm 穿甲高爆 ⇄ 20mm 高射（近炸子母）之间切换。
它取代旧版 `TD-110 Co-Op` 与 `Busier TD-110 Driver`（两者改的是**同一条记录的同一个槽位**，本来只能二选一）。
> 所有改动都发生在**运行时内存**，不修改任何游戏文件；禁用 mod + 重启游戏即完全还原。
## Main features · 主要特性
### 1. MODS 页 6 行（原生设置页，分组 `A HD2 MOD COLLECTION`）
| 行 | 作用 |
|---|---|
| `[TD-110] 预设` | 原装 / 合作·烟雾 / 合作·40mm / 忙碌·重机枪 / 忙碌·40mm / 自定义 |
| `[TD-110] 炮手槽位` / `[TD-110] 驾驶员槽位` | 各 5 选 1（直接改 = 自动切「自定义」） |
| `[TD-220] 重机枪位` | 原装「堡垒同轴重机枪」⇄「40mm 机炮武器站」 |
| `[40mm] 弹种` | 40mm 穿甲高爆 ⇄ 20mm 高射（近炸子母） |
| **`[M-102] 车载武器`** | **原装车载重机枪 ⇄ 重机枪武器站 ⇄ 40mm 机炮武器站** |
### 2. 射界 360°（独立开关、默认开）
* 把 **TD-110 激光炮塔 + 加特林主炮**、**TD-220 主炮 + 同轴重机枪**的水平射界从 ±20° 放宽到 **±180°（360°）**；
* **与模式无关**（原装 / 合作 / 忙碌 / 自定义都生效）；关掉开关会写回原装 ±20°；
* 射界是引擎**实时读**的，改完**立刻生效**，不用重新召唤；
* ⚠ **只解水平射界，不解除视角限制**（炮塔转得满，看得未必满）。
* **M-102 没有射界腿** —— 它的车载武器在游戏数据里没有炮塔记录。
### 3. M-102 车载武器三选一（v1.1.0 新增）
* **原装车载重机枪**（`frv_mg`，默认）⇄ **重机枪武器站** ⇄ **40mm 机炮武器站**；
* 一次写**两个变体**：`M-102 快速侦查载具` 与 `M-102 快速侦查载具（地图产出）`；
* 挂载换完要**重新召唤 M-102** 才生效。
### 4. 按车独立（v1.1.0 起）
挂载腿**逐辆车独立定位 / 独立复核 / 独立写入**：哪辆车的记录缺失、挂点对不上，**只跳过那辆车**，
其它车照常生效（日志写明跳过了谁、为什么）。TD-110 不会再因为别的车改了数据而一起停写。
### 5. TD-110 硬规则：两个槽位恰好一个是激光
* **必须有一个**激光、**不能两个都是**（会互相抢引导）；
* 违反规则的改动会被**拒绝**并把控件弹回当前值 —— 自定义模式也一样。
### 6. 随便改 / 一键还原
* 模式与子选项可以**反复来回切换**，改完再改照样生效（判据是「本 mod 可能写过的任何一件挂载」，不是只认原装）；
* **初始化**（Scanner 分组的全局按钮）一键全部回原装：TD-110 驾驶员=烟雾弹 / 炮手=激光、TD-220 重机枪位=原装同轴重机枪、
**M-102 = 原装车载重机枪**、40mm = 穿甲、四条炮塔射界 = ±20°、cfg 一并复位；
* **即使槽位被别的 mod 改成了认不出来的值，初始化也能强制写回**。
## Operation flow · 操作流程
### 第一步：安装前置
1. 安装 **Bingus Shared Loader v15+（API 1）**，或兼容的 MDL；
2. 安装 **Mod Options Menu v1.1+**（提供原生 MODS 设置页）；
3. 安装 **HD2 Scanner v0.8.2+**（提供挂载表 / 炮塔表 / 弹道表地址）—— **硬前置，缺了本 mod 零写入**；
4. 用 HD2 管理器导入 `Armor-Tweaks-v1.1.0.zip`，启用并部署；
5. 启动游戏。
### 第二步：进入设置页
1. 游戏里按 **ESC** 打开菜单；2. 切到 **MODS** 页；3. 找到分组 **`A HD2 MOD COLLECTION`**。
### 第三步：选择配置
1. TD-110：**预设**（6 档）或单独点**炮手槽位 / 驾驶员槽位**；
2. TD-220：**重机枪位**（原装同轴重机枪 / 40mm 机炮武器站）；
3. **M-102：车载武器**（原装车载重机枪 / 重机枪武器站 / 40mm 机炮武器站）；
4. 40mm：**弹种**（穿甲高爆 / 20mm 高射）；
5. 射界 360° **默认已开**，不需要可以关掉；
6. 改完**立即写入**，不需要按 Apply。
也可以不进游戏改：编辑 `%LOCALAPPDATA%\CowboyBingus\Helldivers2\ArmorTweaks.cfg`（**1 秒热重读**）。
### 第四步：进任务，先别召唤载具
⚠ **这是本 mod 最容易踩的坑**：挂载表（`MountComponentData`）是**生成载具时读一次**的静态配置，补丁必须**早于召唤**。
1. 进入任务后**先不要召唤载具**；
2. 等日志出现写入行：
```text
[ArmorTweaks] 已接上 HD2Scanner（前置）：挂载表 + 射界表由 Scanner 提供
[ArmorTweaks] 已写：TD-110 驾驶员位(+48) … -> …（recIdx 123，node/flags 未动）
[ArmorTweaks] 已写：M-102 车载武器位(slot0) = 重机枪武器站 … -> …（recIdx 19，node/flags 未动）
```
3. 看到之后再召唤载具。
> 射界 / 40mm 弹种是引擎**实时读**的 —— 写进去就生效，不需要等、也不需要重新召唤。
### 第五步：确认生效
召唤出来的载具就是当前配置。状态盘可以随时核对：
```text
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\ArmorTweaks_STATUS.log
```
第一行出现 `OK - 补丁生效中（挂载 N 处 / 射界 N 处）` 即表示生效。
### 第六步：后续修改 / 初始化
* 每次改配置后：等日志出现新的 `已写：…` → **重新召唤**那辆车（射界 / 弹种不需要）；
* 要回到原始默认：点 Scanner 分组的**全局「初始化」**按钮。
## Requirements · 依赖
* **Helldivers 2**（测试于 `1.8.45850.0`）
* **Bingus Shared Loader v15+（API 1）**，或兼容的 MDL
* **Mod Options Menu v1.1+** —— 设置 UI 前置
* **HD2 Scanner v0.8.2+** —— **必需**：挂载表 / 炮塔表 / 弹道表地址的前置
* 一个能导入 zip 的 HD2 mod 管理器（HD2MM / Arsenal 等）
* Windows x64
> 缺少 Scanner 时本 mod **零写入**，只把原因写进日志与状态行（不会乱写内存）。
> 缺少 ModOptionsMenu 时改不了设置页，但仍可手改 cfg（1 秒热重读）。
## Compatibility · 兼容性
* 取代 `TD-110-Co-Op` 与 `TD-110-Busier-Driver`（两者**已废弃、不再分发**）；建议不要与旧版同时启用。
* **v1.1.0 与 v1.0.0 的 GUID / 模块 id 相同** ⇒ 管理器里是同一个条目，可直接换包。
* 只改本机内存；**联机时其他玩家通常看不到你的改动**（本 mod 不发任何网络包）。
* **按车独立**：某辆车的表认不出来时只跳过那辆车，其它车照常。
* 与其它改同一辆车的 mod 同时使用时，若槽位出现本 mod 不认识的值，会**拒写**（不覆盖别人的改动）。
* 游戏启用 nProtect GameGuard，使用第三方工具的风险由使用者自行承担。
## Known limits · 已知限制
* 挂载是「**生成载具时读一次**」：改完必须**重新召唤**该载具；射界与弹种是实时读的，不受此限。
* **M-102 的重机枪武器站 / 40mm 机炮武器站**用的是与其它车相同的挂载项，但**挂点与原厂不同** ——
**已实机运行通过**（用户确认，2026-10-05）；个别构建若异常，切回「原装车载重机枪」即可。
* **不提供 M-104 火焰喷射器**：该武器有资源加载问题（用户 2026-10-05 决定不用）。
* **只解水平射界**：视角范围原样保留，炮塔转得满、看得未必满。
* TD-110「忙碌」档的**重机枪武器站**在游戏数据里不是挂载项（是独立武器实体），弹药走它自己的默认配置；
旧版曾为它打过「弹匣 1000 发」补丁，**本版已去掉**。
* 设置页用 ModOptionsMenu，只支持开关 / 固定选项，**不支持自由文本输入**。
* 首次加载后没有热重载；更新 mod 版本需要重启游戏。
## Logs · 日志
```text
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\ArmorTweaks.log
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\ArmorTweaks_STATUS.log
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\HD2Scanner.log
```

# Armor Tweaks
**Project / downloads:** https://github.com/junze0910/junze-hd2-lua-mod/releases/latest
**Current version:** v1.1.0
**One-liner**: Turn three Helldivers 2 armoured vehicles — the **TD-110 Storm tank**, the **TD-220 Bastion MK XVI**
and the **M-102 Fast Recon Vehicle** — into configurable ones: pick the mounted weapons, widen the horizontal
traverse to a full 360°, and switch the 40mm gun between its two ammo types.
**Tags**: `vehicle` `TD-110` `TD-220` `M-102` `FRV` `loadout` `traverse` `vehicle-v2.0`
## Description
Makes three armoured vehicles configurable:
* **TD-110 Storm tank** (`tank_storm`) — what goes in the driver slot and the gunner slot, plus four presets;
* **TD-220 Bastion MK XVI** — keep the coaxial HMG or swap it for the 40mm autocannon turret;
* **M-102 Fast Recon Vehicle** (including the *Map Spawn* variant) — three-way choice of the vehicle weapon;
* **Horizontal traverse** of four turrets (TD-110 laser turret + gatling main gun, TD-220 main gun + coaxial HMG):
optionally widened from ±20° to **±180° (full 360°)**;
* **40mm ammo type**: 40mm AP/HE ⇄ 20mm AA (proximity-fused cluster).
It replaces the older `TD-110 Co-Op` and `Busier TD-110 Driver` packages — they wrote to the **same slot of the
same record**, so only one could ever be used. Everything happens in **runtime memory only**: no game files are
touched, disabling the mod + restarting restores everything.
## Main features
### 1. Six rows on the native MODS page (group `A HD2 MOD COLLECTION`)
| Row | What it does |
|---|---|
| `[TD-110] Preset` | vanilla / co-op·smoke / co-op·40mm / busy·HMG / busy·40mm / custom |
| `[TD-110] Gunner slot` / `[TD-110] Driver slot` | 1 of 5 each (changing one auto-switches to *custom*) |
| `[TD-220] Coaxial mount` | stock coaxial HMG ⇄ 40mm autocannon turret |
| `[40mm] Ammo type` | 40mm AP/HE ⇄ 20mm AA (proximity-fused cluster) |
| **`[M-102] Vehicle weapon`** | **stock vehicle HMG ⇄ HMG turret ⇄ 40mm autocannon turret** |
### 2. 360° traverse (independent toggle, on by default)
* Widens the **TD-110 laser turret + gatling main gun** and the **TD-220 main gun + coaxial HMG** horizontal
traverse from ±20° to **±180°**; independent of the selected mode; turning the toggle off writes ±20° back;
* Read live by the engine — applies immediately, no re-summon needed;
* ⚠ **Horizontal only — the camera / view limits are NOT removed.**
* **M-102 has no traverse leg** — its vehicle weapon has no turret record in the game data.
### 3. M-102 vehicle weapon — three choices (new in v1.1.0)
* **stock vehicle HMG** (`frv_mg`, default) ⇄ **HMG turret** ⇄ **40mm autocannon turret**;
* Writes **both variants** in one go: `M-102 Fast Recon Vehicle` and `M-102 Fast Recon Vehicle (Map Spawn)`;
* Changing a mount requires **re-summoning** the M-102.
### 4. Per-vehicle independence (new in v1.1.0)
The mount leg locates, verifies and writes **each vehicle separately**: if one vehicle's record is missing or its
mount node does not match, **only that vehicle is skipped** (the log says which and why) — the others still apply.
The TD-110 no longer stops working because another vehicle's data changed.
### 5. TD-110 hard rule: exactly one of the two slots is a laser
* **One is required**, **two are refused** (they fight over designation);
* A refused change is logged and the UI control snaps back — the same applies in *custom* mode.
### 6. Change it as often as you like / one-click restore
* Modes and sub-options can be switched back and forth: the overwrite check accepts any mount this mod may have
written before, not just vanilla;
* **Initialize** (the Scanner group's global button) restores everything at once — and can force its way back even
when another mod wrote an unrecognised value into the slot.
## Operation flow
1. Install **Bingus Shared Loader v15+ (API 1)** (or a compatible MDL).
2. Install **Mod Options Menu v1.1+** (the native MODS page).
3. Install **HD2 Scanner v0.8.2+** — a **hard requirement**: it supplies the table addresses. Without it the mod writes nothing.
4. Import `Armor-Tweaks-v1.1.0.zip` in your HD2 mod manager and enable/deploy it.
5. Launch the game → **ESC → MODS page → `A HD2 MOD COLLECTION`** → pick presets / slots / ammo type.
6. **After dropping into a mission, do not summon a vehicle yet** — wait until the log shows the mounts were written.
7. Changing a loadout later requires **re-summoning that vehicle**. Traverse and ammo type are exempt (apply live).
```text
[ArmorTweaks] 已接上 HD2Scanner（前置）：挂载表 + 射界表由 Scanner 提供
[ArmorTweaks] 已写：TD-110 驾驶员位(+48) … -> …（recIdx 123，node/flags 未动）
[ArmorTweaks] 已写：M-102 车载武器位(slot0) = 重机枪武器站 … -> …（recIdx 19，node/flags 未动）
```
## Requirements
* **Helldivers 2** (tested on `1.8.45850.0`)
* **Bingus Shared Loader v15+ (API 1)**, or a compatible MDL
* **Mod Options Menu v1.1+**
* **HD2 Scanner v0.8.2+** — **required**; without it the mod writes nothing and only logs the reason
* An HD2 mod manager able to import zips (HD2MM / Arsenal …)
* Windows x64
## Compatibility
* **Replaces** `TD-110-Co-Op` and `TD-110-Busier-Driver` (deprecated, no longer distributed) — do not run them together.
* **v1.1.0 keeps the same GUID / module id as v1.0.0** — it is the same entry in your mod manager, just swap the package.
* Local memory only: **other players in co-op will not see your changes** (the mod sends no network packets).
* **Per-vehicle independence**: an unrecognised vehicle is skipped on its own, the others still apply.
* If another mod writes a value this mod does not recognise, it **refuses to overwrite** it; use **Initialize** to force vanilla back.
* The game runs nProtect GameGuard; use third-party tools at your own risk.
## Known limits
* **Mounts are read once, when a vehicle spawns**: re-summon the vehicle after changing the loadout. Traverse and ammo type are read live.
* The **M-102 HMG turret / 40mm autocannon turret** reuse normal mount items, but their **mount node differs from the
stock `frv_mg`** — **verified in-game** (user-confirmed, 2026-10-05); if it misbehaves on your build, switch back to the stock vehicle HMG.
* The **M-104 flamethrower is not offered** (that weapon has resource-loading problems; user decision, 2026-10-05).
* **Horizontal traverse only**: the camera/view limits stay as-is, so the turret turns further than you can look.
* The *Busy* mode's **HMG turret** is **not a real mount entry** in the game data (it is a standalone weapon entity),
so it uses its own default ammo setup. An older build patched its magazine to 1000 rounds — **removed on request**.
* Settings use **ModOptionsMenu** (toggles / fixed choices only) — **no free text input**; edit the cfg for custom hashes.
## Logs
```text
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\ArmorTweaks.log
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\ArmorTweaks_STATUS.log
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\HD2Scanner.log
```