解锁台（Unlock Kit）
**项目地址 / 下载：** https://github.com/junze0910/junze-hd2-lua-mod/releases/latest
**当前版本：** v0.6
## Description · 简介
把「解锁某件东西」变成游戏 **原生 ESC → MODS 页**里的**一行一个 是/否 开关**——**打开就写、关掉就还原**。
- **武器 2 把**：P-41 巡察者（副武器）、G-11 铁蒺藜（投掷物）——做法是**克隆同类样板，只替换身份字段**
- **战备 6 条**：轨道照明弹 / FRV 补给型（M-103）/ 快速侦察载具 FRV（M-102）/ FRV 炽热型（M-104）/ 飞鹰·空空导弹（废弃条目）/ 风暴漩涡
- **只读侦察**一行：打印目标 key、是否已登记、样板下标、战备记录与选择位
- 全部改动发生在**运行时内存**，不修改任何游戏文件；禁用 mod 后重启游戏即完全还原
> **v0.6 已实机验证通过（用户确认，2026-10-04）**：武器 2 把 / 战备 6 条 / 只读侦察均正常。
> **只做指定条目，不做"全解锁"**；**不含武器配件解锁**（v0.6 已移除，原因见下）。
## Main features · 主要特性
### 1. 一行一个开关
在游戏原生 **ESC → MODS 页 → 「解锁台」** 下，每个目标一行；**打开即写、关掉即按行精确回滚**。
### 2. 武器解锁 = 克隆同类样板 + 只换身份字段
把同类样板（P-41 ← P-2、G-11 ← G-6）的 184B 注册表记录与 24B 映射**逐字节复制**到追加位，
只改 `+0x00/+0x04/+0x08` 三个身份字段，`count` 最后发布。实机已验证：两把武器正常进军械库。
### 3. 战备解锁 = ② 选择位 + ③ 记录状态
- ② `StratagemInfo +0x80 bit1` 置 1（= 明文数据 `selectable`）
- ③ 注册表记录 `+0x14 = 2`（∈{2,4} 即"可用/已登记"）
实机已验证 6 条战备（ID5/26/105/135/146/50）。
### 4. 开局自动套用（注册表每局重建）
注册表在每局重建、内存写入是会话级 → 每次启动游戏，mod 会把 MOM 里仍开着的开关**自动重写**一遍。
### 5. 每 5 秒复核
复核"武器条目还在不在 / 战备选择位与记录有没有被改回"，被改回就立刻补回。
### 6. 会话级、可还原
写入只在本次游戏进程内有效；重启游戏即回到原装。想立刻还原：把对应开关**关掉**即可。
### 7. 只读侦察
`● 侦察（只读）` 打开时打印一次现状（不写任何字节），用于排障。
## Operation flow · 操作流程
1. **装前置**：Bingus Shared Loader **v15+**（MODS 页来自它提供的 `ModOptionsMenu`）
2. **装本 mod**：`Unlock-Kit-v0.6.zip`
3. **进一次任务**（注册表/升级树只在进任务后加载）
4. **配置**：ESC → MODS → 「解锁台」→ 打开需要的开关
5. **生效**：打开即写；战备列表在进任务时构建，改完一般**下一局**在列表里看到
## Requirements · 依赖
| 组件 | 版本 |
|---|---|
| Bingus Shared Loader | **v15+**（API 1；本版验证环境 loader-v17） |
| HD2 Scanner | **可选**（检测到就优先用它的战备表 API，没有也能用内置签名兜底） |
| 游戏构建 | `helldivers2.exe` 1.8.46015.0（Steam build 25480438） |
## Compatibility · 兼容性
- 只写**指定条目**的注册表记录/映射 + 对应 `StratagemInfo` 选择位；不碰其它表
- 与其它 mod 共存；但**改同一条战备记录的 mod（例如 Strat-Unlock）算改同一块内存** —— 同时装时两边开关会互相影响，建议二选一
- 不新增槽位、不改槽位数量；**不含配件解锁**
## Known limits · 已知限制
- **没有"全部解锁"**：目标表是源码里的显式白名单
- 战备列表在进任务时构建 → 改完一般下一局才看到
- **武器配件（JAR-5 弹药）解锁已移除**：v0.5 写入全部成功但**打开主宰配装页会崩溃**（用户决定停线）
- 游戏版本变化可能导致定位失败 —— 此时 mod **拒绝写入并记日志**，不会乱写
## Logs · 日志
```
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\UnlockKit.log
```
正常应有：`★ P-41 … 追加完成 count …`（武器）或 `★ 战备 …：选择位 +0x80 … → 0x03` + `记录#… +0x14 … → 2`。
## Shout outs · 鸣谢
- **LAS-22 切变**（`_inspect/shear`）—— 武器"克隆同类样板"与战备"三条件"配方的参照实现
- **CowboyBingus / Bingus Shared Loader** —— addon 加载器与 `ModOptionsMenu` 原生 MODS 页
- **HD2 Scanner** —— 战备表 AOB 定位（本 mod 检测到就用，作为可选加速）
- `Helldivers2_RawData` —— 组件表明文数据（定位与"选择位 = selectable"的依据）

# Unlock Kit
**Project / download:** https://github.com/junze0910/junze-hd2-lua-mod/releases/latest
**Current version:** v0.6
## Description
Turns "unlock X" into an **on/off switch per target** on the game's native **ESC → MODS page** — writing on enable, reverting on disable.
- **2 weapons**: P-41 Ombudsman (sidearm), G-11 Incendiary (throwable) — done by **cloning a same-class template and replacing identity fields only**
- **6 stratagems**: Orbital Illumination Flare / FRV Resupply (M-103) / Fast Recon Vehicle (M-102) / FRV Incinerator (M-104) / Eagle Air-to-Air Missiles (unused entry) / Maelstrom
- **One read-only recon row**: prints target key / registered? / template index / stratagem record and selectable bit
- Everything happens in **runtime memory** — no game files are modified; disable the mod and restart to fully revert
> **v0.6 is in-game verified** (user confirmed, 2026-10-04): both weapons, all 6 stratagems and the read-only recon work.
> **Explicit whitelist only — there is no "unlock everything".** **No attachment unlocks** (removed in v0.6, see below).
## Features
### 1. One switch per target
Under the native **ESC → MODS page → "解锁台"** group; enabling writes immediately, disabling rolls back precisely (per row).
### 2. Weapon unlock = clone a same-class template, identity fields only
The template's 184-byte registry record and 24-byte mapping (P-41 ← P-2, G-11 ← G-6) are copied **byte-for-byte** to the append slot;
only `+0x00/+0x04/+0x08` are replaced, and `count` is published last. In-game verified: both weapons appear in the armory.
### 3. Stratagem unlock = selectable bit + record state
- `StratagemInfo +0x80 bit1 = 1` (equals the data table's `selectable`)
- registry record `+0x14 = 2` (2 or 4 means available/registered)
In-game verified for 6 stratagems (ID 5 / 26 / 105 / 135 / 146 / 50).
### 4. Auto-applied on every launch
The registry is rebuilt each session and memory writes are session-scoped, so every launch the mod re-writes whatever switches are still ON.
### 5. Re-checked every 5 seconds
Weapon entries and stratagem bits/records are re-verified and restored if the game reverts them.
### 6. Session-scoped and revertible
Writes only live in the current game process; restart the game to go fully stock. To revert immediately, turn the switch **off**.
### 7. Read-only recon
The `● 侦察（只读）` toggle prints the current state once and writes nothing — useful for troubleshooting.
## Operation flow
1. **Install the prerequisite**: Bingus Shared Loader **v15+** (its `ModOptionsMenu` provides the MODS page)
2. **Install** `Unlock-Kit-v0.6.zip`
3. **Enter one mission** (registry / upgrade trees only load in-mission)
4. **Configure**: ESC → MODS → "解锁台" → enable the switches you want
5. **Takes effect** immediately on enable; the stratagem list is built on mission start, so changes usually show up **next mission**
## Requirements
| Component | Version |
|---|---|
| Bingus Shared Loader | **v15+** (API 1; verified on loader-v17) |
| HD2 Scanner | **Optional** (used when present for the stratagem table, otherwise a built-in signature fallback) |
| Game build | `helldivers2.exe` 1.8.46015.0 (Steam build 25480438) |
## Compatibility
- Writes only the **listed targets'** registry records/mappings and their `StratagemInfo` selectable bit; nothing else
- Coexists with other mods; but mods writing the **same stratagem record** (e.g. Strat-Unlock) touch the same memory — install only one of them
- No new slots, no slot count changes; **no attachment unlocks**
## Known limits
- **No "unlock everything"** — the target list is an explicit whitelist in the source
- The stratagem list is built on mission start → changes usually appear next mission
- **Weapon-attachment (JAR-5 ammo) unlocking was removed**: v0.5 wrote everything successfully but **opening the Dominator customization page crashed the game** (line parked by the author)
- A game update may break locating — the mod then **refuses to write** and logs it
## Logs
```
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\UnlockKit.log
```
Expected: `★ P-41 … 追加完成 count …` (weapons) or `★ 战备 …：选择位 +0x80 … → 0x03` + `记录#… +0x14 … → 2`.
## Shout outs
- **LAS-22 Shear** (`_inspect/shear`) — the reference implementation for "clone a same-class template" and the stratagem three-condition recipe
- **CowboyBingus / Bingus Shared Loader** — addon loader and the native `ModOptionsMenu` MODS page
- **HD2 Scanner** — AOB stratagem-table locator (used when present, as an optional speed-up)
- `Helldivers2_RawData` — plain-data component tables (basis for offsets and "selectable bit")