自定义补给（Custom Supply）
**项目地址 / 下载：** https://github.com/junze0910/junze-hd2-lua-mod/releases/latest
**当前版本：** v0.1e（已实机通过，已发布）
## Description · 简介
把补给包架的 **4 个槽位**变成可配置：**放什么，决定补给给什么；放多少，决定冷却多久。**
- 上层每槽 7 选 1：`无 / 弹药盒 / 针剂盒 / 手雷盒 / 补给包 / 医疗包 / 爆炸筒`
- v0.1e 新增 **SEAF 大炮覆盖**：存在超级地球大炮时手动打开，下层 4 槽可选 6 种炮弹 / 爆炸筒；选「补给类」则回退上层
- 冷却按实际生效内容自动计算：**30 s（四槽全无 / 爆炸筒）～ 150 s（四槽针剂盒 / 补给包 / 迷你核弹）**
- 全部改动发生在**运行时内存**，不修改任何游戏文件；禁用 mod 后重启游戏即完全还原
## Main features · 主要特性
### 1. 四个槽位独立配置
在游戏原生 **ESC → MODS 页 → 「自定义补给」** 下，4 个下拉各自选择，互不影响。
### 2. 内容决定冷却
| 槽位里放的 | 简称 | 单件冷却增量 |
|---|---|---:|
| （空槽） | 无 | +0 s |
| 资源点弹药盒 | 弹药盒 | **+5 s** |
| 资源点治疗针剂 | 针剂盒 | **+30 s** |
| 资源点手榴弹包 | 手雷盒 | **+15 s** |
| 补给（模型） | 补给包 | **+30 s** |
| 医疗补给（模型） | 医疗包 | **+15 s** |
| 爆炸筒（Explosive Barrel） | 爆炸筒 | **+0 s** |
```
冷却 = 30 + 5×弹药盒 + 30×针剂盒 + 15×手雷盒 + 30×补给包 + 15×医疗包
+ 0×爆炸筒
```
| 举例 | 冷却 |
|---|---:|
| 无 / 无 / 无 / 无 ← **默认** | **30 s** |
| 弹药盒 ×4 | 50 s |
| 手雷盒 ×4 或 医疗包 ×4 | 90 s |
| 弹药盒 + 针剂盒 + 手雷盒 + 医疗包 | 95 s |
| 针剂盒 ×4 或 补给包 ×4 | **150 s（上限）** |
| 爆炸筒 ×4（或四槽全无） | 30 s |
### 3. 摆位自动套用
针剂盒与手雷盒放在包架上时，mod 会自动套用调好的位置与朝向：
| 物品 | 偏移 (X,Y,Z) | 旋转 (X,Y,Z) |
|---|---|---|
| 针剂盒 | `(0, -0.1, -0.1)` | `(-90, 0, 0)` |
| 手雷盒 | `(0.1, -0.3, 0)` | `(-90, 0, 0)` |
| 爆炸筒 | `(0, 0, 0)` | `(0, 0, 0)` |
爆炸筒与其余物品写 0，不改变外观。
### 2.5 SEAF 大炮覆盖（v0.1e）
仅当场上**存在超级地球大炮 / SEAF Artillery** 时，由玩家手动打开开关。
- **关闭**（默认）：只读上层 4 个补给槽，下层 4 槽忽略。
- **打开**：新增的 4 个「大炮槽位」逐槽生效：
- 选「**补给类**」→ 沿用上面对应补给槽的物品；
- 选炮弹 / 爆炸筒 → 用下层选中的物品。
- 上下两层**独立配置**，不互相同步。
| 下层可选 | CD 增量 |
|---|---:|
| 补给类 | 取上层 |
| 大炮 迷你核弹 | +30 s |
| 大炮 高爆弹 | +20 s |
| 大炮 炸弹 | +15 s |
| 大炮 凝固汽油弹 | +10 s |
| 大炮 静电场 | +10 s |
| 大炮 烟雾弹 | +5 s |
| 爆炸筒 | +0 s |
炮弹摆位统一 `(0,0,0)/(0,0,0)`。
### 4. 自带"让补给可用"
不需要再装解锁类 mod：本 mod 会自己完成让这台补给战备可用所需的处理。
### 5. 每 5 秒复核
自动复核 **选择位 / 可用状态 / 冷却 / 4 个槽位**，被游戏改回会立刻补回。
### 6. 会话级、可还原
写入只在本次游戏进程内有效；重启游戏即回到原装。想立刻还原：把 4 个槽位都选「无」并进一次任务，或禁用 mod 后重启。
## Operation flow · 操作流程
1. **装前置**：Bingus Shared Loader（v15+ / API 1）+ **HD2 Scanner v0.8.0+**（本 mod 靠它定位战备表与包架表）
2. **装本 mod**：`Custom-Supply-v0.1e.zip`
3. **进一次任务**（战备表/包架表只在进任务后加载）
4. **配置**：ESC → MODS → 自定义补给 → 上层 4 个下拉；若场上存在超级地球大炮，再手动打开「SEAF 大炮覆盖」并配置下层 4 个「大炮槽位」；下拉描述里会**实时显示当前冷却**
5. **生效**：改完立刻生效；若在任务中修改，下一局生效（战备列表在进任务时构建）
## Requirements · 依赖
| 组件 | 版本 |
|---|---|
| Bingus Shared Loader | v15+（API 1） |
| Mod Options Menu | **v1.1+**（设置 UI 前置） |
| HD2 Scanner | **v0.8.0+**（必需） |
| 游戏构建 | `helldivers2.exe` 1.8.46015.0（Steam build 25480438） |
## Compatibility · 兼容性
- 只改**补给战备（ID77 `CONSUMABLES. HEALTH PACK RACK`）所用的那台包架**的 4 个激活槽，不碰其它表
- 运行时内存写入，不改磁盘文件；与其它 mod 共存
- 不新增槽位、不改槽位数量
## Known limits · 已知限制
- 未做"一键还原"按钮；没有"预设组合"（四槽独立选）
- **v0.1d 的「爆炸筒」与 v0.1e 的「SEAF 大炮覆盖」均已实机通过**（用户确认，2026-10-04）
- 队友那一侧显示成什么**未验证**（取决于他们自己的游戏数据）
- 游戏版本变化可能导致定位失败 —— 此时 mod 会**拒写并记日志**，不会乱写
## Logs · 日志
```
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\CustomSupply.log
```
正常应有：`★ 选择位 …` → `★ 可用状态 …` → `包架表已定位 0x…` → `★ 槽1..4 = …` → `★ 冷却 id=77 = xx s`
## Shout outs · 鸣谢
- **HD2 Scanner** —— 战备表 AOB 定位与通用 `scan_request` 服务
- 社区哈希表（Hellextractor / hd2-name-db / HD2 Hashlist）—— 物品与资源名反查
- `Helldivers2_RawData` —— 组件表明文数据（本 mod 的字段布局依据）

# Custom Supply
**Project / download:** https://github.com/junze0910/junze-hd2-lua-mod/releases/latest
**Current version:** v0.1e (in-game verified, released)
## Description
Turns the supply rack's **4 slots** into something you configure: **what you put in decides what the supply drops — how much you put in decides the cooldown.**
- Upper slots: one of 7 items — `None / Ammo box / Stim box / Grenade box / Supply crate / Medical crate / Explosive Barrel`
- v0.1e adds **SEAF Artillery Override**: when the Super Earth Artillery exists, manually enable it and fill the lower 4 slots with 6 shell types / Explosive Barrel; choosing `Supply` falls back to the upper slot
- Cooldown is computed from the effective contents: **30 s (all four empty / explosive barrels) up to 150 s (four stim boxes / supply crates / Mini Nukes)**
- Everything happens in **runtime memory** — no game files are modified; disable the mod and restart to fully revert
## Features
### 1. Four independent slots
Configured in the game's native **ESC → MODS page → "自定义补给"**, four independent dropdowns.
### 2. Contents decide the cooldown
| In the slot | Added cooldown |
|---|---:|
| (empty) | +0 s |
| Ammo box | **+5 s** |
| Stim box | **+30 s** |
| Grenade box | **+15 s** |
| Supply crate | **+30 s** |
| Medical crate | **+15 s** |
| Explosive Barrel | **+0 s** |
```
cooldown = 30 + 5·ammo + 30·stim + 15·grenade + 30·supply_crate + 15·medical_crate
+ 0·explosive_barrel
```
| Example | Cooldown |
|---|---:|
| empty ×4 ← **default** | **30 s** |
| ammo ×4 | 50 s |
| grenade ×4 / medical ×4 | 90 s |
| ammo + stim + grenade + medical | 95 s |
| stim ×4 / supply crate ×4 | **150 s (cap)** |
| Explosive Barrel ×4 (or all four empty) | 30 s |
### 3. Placement is applied automatically
Stim boxes and grenade boxes get a tuned offset/rotation on the rack; the Explosive Barrel and the other items keep zero.
### 2.5 SEAF Artillery Override (v0.1e)
Only for missions where the **Super Earth Artillery / SEAF Artillery** exists; the player enables the toggle manually.
- **Off** (default): only the upper 4 supply slots are read; the lower 4 are ignored.
- **On**: the four new "Artillery slots" take effect one by one:
- `Supply` → reuse the corresponding upper supply slot (CD and placement);
- shell / Explosive Barrel → use the lower selection.
- The two layers are **independent** — no syncing.
| Lower choice | Added cooldown |
|---|---:|
| Supply | from upper slot |
| Mini Nuke (SEAF) | +30 s |
| High-Yield Explosive (SEAF) | +20 s |
| Explosive (SEAF) | +15 s |
| Napalm (SEAF) | +10 s |
| Static Field (SEAF) | +10 s |
| Smoke (SEAF) | +5 s |
| Explosive Barrel | +0 s |
All shells use offset/rotation `(0,0,0)/(0,0,0)`.
### 4. Self-contained
No separate unlock mod needed — it makes the supply stratagem usable on its own.
### 5. Re-checked every 5 seconds
Selection bit / availability state / cooldown / the 4 slots 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 and everything is stock again.
## Operation flow
1. **Install prerequisites**: Bingus Shared Loader (v15+ / API 1) + **HD2 Scanner v0.8.0+** (required for table location)
2. **Install** `Custom-Supply-v0.1e.zip`
3. **Enter one mission** (the stratagem/rack tables only load in-mission)
4. **Configure**: ESC → MODS → the group, four upper dropdowns; if the Super Earth Artillery exists, manually enable **SEAF Artillery Override** and configure the four lower Artillery slots; each description shows the live cooldown
5. **Takes effect** immediately; if changed mid-mission, from the next mission
## Requirements
| Component | Version |
|---|---|
| Bingus Shared Loader | v15+ (API 1) |
| Mod Options Menu | **v1.1+** (settings UI prerequisite) |
| HD2 Scanner | **v0.8.0+** (required) |
| Game build | `helldivers2.exe` 1.8.46015.0 (Steam build 25480438) |
## Known limits
- No "reset" button; no preset combos (four independent slots)
- **Both the Explosive Barrel (v0.1d) and the SEAF Artillery Override (v0.1e) have been in-game verified** (user confirmed, 2026-10-04)
- What teammates see is **unverified** (depends on their own game data)
- A game update may break locating — the mod then **refuses to write** and logs it
## Logs
```
%LOCALAPPDATA%\CowboyBingus\Helldivers2\Logs\CustomSupply.log
```