Guided Rounds v1.9.10 —— 制导弹丸 / Guided Rounds

---

一句话说明（中文）
弹丸出膛后自动追踪敌人，而伤害、初速、弹道仍然使用武器自己的数值（不会统一变成法令手枪的 90 伤害）。带索敌范围圆环、锁定标记与目标方框；武器按类型分页、可锁定的敌人按阵营分页，每把武器/每个敌人都能单独设置。

来源声明（基于他人作品二次修改）
本 mod 是 DIY your weapon to shoot like Donk（APW-1 反器材锁头 DIY-able） 的二次修改产物：制导机制、内存偏移与大部分实现都来自那个 addon（最新上游为原作者 v4.16），本包在其基础上做独立开发与修复。如果你更偏好原作，请直接用原作；两个包修改同一批武器字段，不要同时启用。

依赖 / Requirements

• Bingus Shared Loader —— v18+ / API 1（必需）
• HD2Runtime —— v0.40.0+（必需）
• WeakPoint Lock-On v2 —— v3.0（强烈推荐）
• Vanilla Plus Megapack —— 必需：提供游戏内 MODS 页签（分类较多，需要新版带翻页的 ModOptionsMenu）

缺少 HD2Runtime 时弹丸材质不会加载，弹丸会显示成缺材质的问号图标。

安装

1. 先装 mod 加载器：HD2 Arsenal
2. 在 HD2 Arsenal 里装齐这四个 mod：Bingus Shared Loader、hd2runtime、Vanilla Plus Megapack（游戏里的 MODS 设置菜单就是它提供的，必须有）、以及本 mod（用管理器导入 Guided-Rounds-v1.9.10.zip）
3. 加载顺序，自上而下（换成别的顺序会不生效）：Guided Rounds → Vanilla Plus Megapack → Bingus Shared Loader → hd2runtime
4. 进游戏即可；设置菜单在 Esc → MODS

注意：装过原版「APW-1 制导弹 / DIY-able」类 addon 的话请先卸载——两者改同一批武器字段，会互相冲突。

使用方法
快速上手

1. 把前置装齐、按上面的顺序排好，进游戏（第一次进任务会扫一次内存，开局几秒掉帧属正常）
2. Esc → MODS → 01 · GUIDED ROUNDS：打开「开启」与「加载弹丸材质」
3. 把要用的枪写进 cfg 的 weapons= 行（%LOCALAPPDATA%/Hd2ApwGuidance/apw_guidance.cfg）——这一步决定哪些武器能制导，清单为空时连锁定环都不会画；哈希看日志里的 WEAPON carried: 0x…
4. 去这把枪的类别页（例如 07 · GUIDED PISTOLS）把它从 OFF 改成「准心优先 / 最大血量大优先 / 最大血量小优先」
5. 拿在手上：中央出范围圆环，敌人进圈出现锁定标记与方框，开枪后弹丸自动转向
6. 想改「先锁谁」：在 13 · GUIDED TARGET PRIORITY 打开「手动瞄准优先级」，再到 14–19 的阵营页给单位填 1–9（1 最先锁，0 = 未设置）
7. 想给某把枪单独一套：在 12 · GUIDED WEAPON PRIORITY 选类别 → 把枪拨到「自定义此枪优先级」→ 回阵营页调数字（页名前缀会变成这把枪）
8. 爆炸武器改自爆时间：02 · GUIDED EXPLOSIVE FUSE 的 round_life（秒，0 = 出厂值）

生效时机：数字和开关走 api.set，当帧生效；文字（类别名 / 行名 / 页名前缀）只在每次打开菜单时刷新，所以换类别或换编辑目标后要关一次菜单再打开。手改了 cfg 想立刻生效按 F7。
常见现象：锁定环、标记、方框全不出现 → weapons= 空了或拿的不是清单里的枪；12–19 页不存在 → cfg 里 glob_on=0（只在文件里改）；阵营页名不跟着换枪 → 关开一次菜单；弹丸是问号 → 没开「加载弹丸材质」或没装 hd2runtime；子弹不转向 → 这把枪在类别页是 OFF，或目标不在索敌锥 / 被掩体挡住；偶发锁不上 → 按 F7 重启 mod。

逃生菜单的 MODS 页签里一共有这些分类（新版 ModOptionsMenu 支持翻页，分类多也不会挤掉别人的）：

• GUIDED ROUNDS —— 总开关与通用参数（32 项）
• GUIDED ASSAULT RIFLES / MARKSMAN RIFLES / SUBMACHINE GUNS / SHOTGUNS / EXPLOSIVE / SUPPORT WEAPONS / ENERGY WEAPONS / SPECIAL WEAPONS / PISTOLS —— 104 把武器按类型分页（12 / 7 / 8 / 10 / 3 / 31 / 12 / 3 / 18），支援武器一律进 SUPPORT。每把一个四选一：
  • OFF：打普通弹
  • 准心优先：制导，锁离准心最近的敌人
  • 最大血量大优先：制导，锁最大血量最大的
  • 最大血量小优先：制导，锁最大血量最小的
• GUIDED TARGET PRIORITY —— 手动瞄准优先级总开关
• GUIDED TERMINIDS 1/2（43 个单位）、GUIDED AUTOMATONS 1/2/3（69 个）、GUIDED ILLUMINATE（23 个）—— 每个可锁定敌人一个 0–9 滑动条

手动瞄准优先级

• 总开关：打开后下面的数字才生效；关掉就完全回到原来的逻辑
• 数字含义：1 = 最先锁定，数字越大越靠后；0 = 未设置（排在所有已设数字之后）
• 数字相同 → 交给当前瞄准模式判断：准心优先就锁离准心更近的；最大血量大/小优先照旧
• 例：范围内有 A(1) 与 B(2) → 锁 A；A、B 都是 1 → 准心优先时锁离准心更近的那个
• 页面没列出的目标也能设：cfg 里写 tp_<16位十六进制>=<数字>

常用参数（GUIDED ROUNDS）

• 开启：总开关。关闭会把所有改过的内存按字节还原
• 锁定角度：索敌锥半角，同时决定屏幕上范围圆环的大小；0 = 不画圆环
• 锁定距离：索敌距离上限（米），出厂 250
• 出膛锁定生效时间：出厂 0.25 秒
• 自己绑定目标：引擎没锁上时由 mod 在瞄准锥里挑一个绑上，建议保持开启
• 掩体后不锁 / 忽略植物遮挡：视线检测用引擎自己的碰撞射线，从手上的枪口发出
• 范围圆环 / 锁定标记 / 目标方框：三个锁定视觉元素，各自独立开关
• 锁定光能族穿梭舰 / 锁定机器人运输舰：默认都关（运输舰是投送部队的载具，锁它会把弹丸从真正的目标上引开）
• 开镜锁定系数 / 开镜锁定范围跟随倍镜：默认关；关闭时圆环在任何倍率下屏幕大小一致，腰射与开镜锁的范围相同
• 加载弹丸材质：必须保持开启，否则弹丸显示为缺材质问号

快捷键

• F7：重启本 mod（还原所有写入后重新武装），不会关闭 mod
• F10：循环切换追踪弹类型（需先在 cfg 里把 seek_cycle 设为 1）

配置文件（以下开关只写在 cfg 里，不占菜单行：ship_scan / debug / los_debug / los_desc / scan_ms / targets_extra / targets_debug）

• targets_extra=0x…,0x…：追加可锁定实体（例如想重新允许锁干扰器本体）
• targets_debug=1：日志会为血量表里每个资源打一行 TARGET CENSUS …，用来查清单里没有的实体

语言：分类名、武器名、单位名、选项文字都跟随游戏语言——简体/繁体中文显示中文，其余语言显示英文；改了 Text Language 后重开一次逃生菜单即可。

亮点

• 每把枪一套敌人优先级（v1.9.3）：MODS → GUIDED WEAPON PRIORITY 先选武器类别，再给该类别的枪选「自定义此枪优先级」或「编辑此枪优先级」（后者会把那 5 页指向它，选完自动退回「自定义」，v1.9.7），然后去那 5 页阵营优先级里单独调它；没调过的目标继续用共用表，关掉开关也不丢数字；开着自定义时，那 5 页的分类名前面会带上这把枪的名字（v1.9.4）；这一页只列已打开锁定的枪，关着的枪不出现，且分类名带 `01`–`19` 编号把同类页面排在一起（v1.9.5）；v1.9.6 起优先级分三层：类别页的笼统设定 < 全局层（可整体关闭）< 单枪层，第 13 页多了「全局优先级层」「编辑全局层」两个开关
• 所有设置都会记住（v1.9.2 修复：优先级数字、总开关等重启后不再丢失）
• 把 P-92 法令的原版制导机制移植到 104 把武器，弹丸出膛后自动追踪
• 伤害、初速、弹道仍用武器自己的数值，不会统一成法令手枪的数据
• 武器按类型分 9 页，找枪不用在长列表里翻
• 手动瞄准优先级按阵营分页（135 个单位），数字小的先锁，相同则按当前瞄准模式
• 索敌范围圆环 + 原版锁定标记 + 目标方框，各自独立开关；圆环画多大就锁多大
• 掩体后不锁从枪口发射射线判定，判的是子弹实际路径
• 开镜与腰射锁定范围不再打架，可选「跟随倍镜」按系数自适应
• 认知干扰器的电源可以锁定了：建筑没有姿态节点，本版回退到单位根骨骼取位置；不可摧毁的本体已从清单移除
• 菜单选项、分类名、单位名跟随游戏语言自动中/英
• F7 一键重启，清掉偶发的锁不上状态

已知问题

• 开局时有一小段扫描（正常，不修复）：mod 要先在内存里找到游戏数据表，一次性开销，找到后不再扫描。v1.9.2 起预算降到 1.5 毫秒/帧（原来 4），同样的查找拖得更长但基本不卡；cfg 的 scan_ms 仍可手改
• 作为主机时，没装本 mod 的队友会看到粉色问号弹丸：弹丸被换成 P-92 的弹丸实体，而资源包按机器加载；作为客机加入别人的战局通常不会出现。缓解：队友把 HD2Runtime 升到 0.31 以上、或队里有人带 P-92 副武器
• 激光、电弧、火焰、喷射类等非弹丸武器无法制导，且不会支持（没有可追踪的弹丸）
• 认知干扰器的本体不再出现在锁定清单里（v1.9.0 起有意移除）；它的可摧毁电源可以锁。想锁本体：cfg 加 targets_extra=0x1445DF29152C9BE2
• 近战、投掷物与非玩家武器行不列在菜单里（仍可写进 cfg 的 weapons=）
• 与其它修改同一批武器/弹丸字段的 mod 可能冲突（包括修改 APW-1 准心的 mod）

多人游戏建议

• 推荐以客机身份加入别人的战局：制导只由你自己的机器计算，队友不会看到问号弹丸
• 作为主机时请提前告知队友可能看到问号弹丸，并按上面的办法缓解
• 建议 Friends Only / 邀请制房间

日志
参数改动、锁定目标、制导状态、TARGET CENSUS 普查都写在这里；排查问题时把相关段落发出来即可。

卸载
关闭 mod 后所有内存写入都会还原；直接删除包即可。

源码与致谢
本 mod 以 MIT 许可证开源：github.com/cancan23333/Helldiver2-Guided-Rounds（旧链接会自动跳转）。
本包是 DIY your weapon to shoot like Donk（APW-1 反器材锁头 DIY-able） 的二次修改产物，制导机制与内存偏移来自那个 addon。也感谢 Bingus Shared Loader、HD2Runtime、WeakPoint Lock-On、Vanilla Plus Megapack 的作者们。制导组件与场景资源版权属于 Arrowhead Game Studios。作者：cancan2333 & SoS2430。

---

Guided Rounds v1.9.10 —— Guided Rounds

In one line
Your rounds track the enemy after they leave the barrel, while damage, muzzle velocity and ballistics stay the weapon's own (they do not become the Warrant's 90 damage). Includes an aim-cone ring, lock markers and a target box; weapons are grouped by type and lockable enemies by faction, and every weapon and every enemy can be tuned on its own.

Derivation notice (built on someone else's work)
This mod is a modified derivative of DIY your weapon to shoot like Donk (APW-1 Anti-Materiel lock-on, DIY-able): the guidance mechanism, the memory offsets and most of the implementation come from that addon (latest upstream: the author's v4.16), and this package is independent development and fixes on top of it. If you prefer the original, use that mod instead — both edit the same weapon fields, so do not enable the two together.

Requirements

• Bingus Shared Loader —— v18+ / API 1 (required)
• HD2Runtime —— v0.40.0+ (required)
• WeakPoint Lock-On v2 —— v3.0 (highly recommended)
• Vanilla Plus Megapack —— required: supplies the in-game MODS tab (the category list wants the new paging ModOptionsMenu)

Without HD2Runtime the projectile materials are never loaded and rounds show as missing-material question marks.

Installation

1. Install the mod loader first: HD2 Arsenal
2. Install these four mods through HD2 Arsenal: Bingus Shared Loader, hd2runtime, Vanilla Plus Megapack (this is what provides the in-game MODS menu - it is required), and this mod (import Guided-Rounds-v1.9.10.zip)
3. Load order, top to bottom (any other order will not take effect): Guided Rounds → Vanilla Plus Megapack → Bingus Shared Loader → hd2runtime
4. Launch the game; settings are in Esc → MODS

Note: if the original "APW-1 guided rounds / DIY-able" addon is installed, remove it first — both edit the same weapon fields and conflict.

How to use
Quick start

1. Install the prerequisites in the order above and launch the game (the first mission walks memory once; a few seconds of frame drops is normal)
2. Esc → MODS → 01 · GUIDED ROUNDS: enable ENABLE and LOAD PROJECTILE MATERIALS
3. Append the weapon's hash to the weapons= line in %LOCALAPPDATA%/Hd2ApwGuidance/apw_guidance.cfg - this decides which weapons can be guided at all, and an empty list draws no range ring; the hash is in the log as WEAPON carried: 0x…
4. Open that weapon's class page (e.g. 07 · GUIDED PISTOLS) and change OFF to AIM FIRST / BIG FIRST / SMALL FIRST
5. In hand: the range ring appears, the lock marker and box appear for enemies inside it, and the round turns after firing
6. To change who is locked first: enable MANUAL AIM PRIORITY in 13 · GUIDED TARGET PRIORITY, then set 1-9 per unit on the faction pages 14-19 (1 first, 0 = unset)
7. For one weapon's own order: in 12 · GUIDED WEAPON PRIORITY pick the class, flip the weapon to CUSTOM PRIORITY, then edit the faction pages (their titles take that weapon's name)
8. Explosive fuse time: round_life on 02 · GUIDED EXPLOSIVE FUSE (seconds, 0 = factory)

When it applies: numbers and toggles go through api.set and apply in the same frame; texts (category names, row labels, page prefixes) refresh only when the menu opens, so changing the class or the edit target needs one close/open. Press F7 to re-read a hand-edited cfg.
Troubleshooting: no ring, marker or box - weapons= is empty or the weapon is not on the list; pages 12-19 missing - glob_on=0 in the cfg; faction titles stale - close and reopen the menu; question-mark rounds - LOAD PROJECTILE MATERIALS is off or hd2runtime is missing; a round that never turns - the weapon is OFF in its class page, or the target is outside the aim cone / behind cover; lock fails intermittently - press F7.

The escape menu's MODS tab carries these categories (the new ModOptionsMenu pages them, so a long list no longer pushes other mods out):

• GUIDED ROUNDS —— master switch and the shared parameters (32 rows)
• GUIDED ASSAULT RIFLES / MARKSMAN RIFLES / SUBMACHINE GUNS / SHOTGUNS / EXPLOSIVE / SUPPORT WEAPONS / ENERGY WEAPONS / SPECIAL WEAPONS / PISTOLS —— 104 weapons grouped by type(12 / 7 / 8 / 10 / 3 / 31 / 12 / 3 / 18); support weapons always go to SUPPORT. One four-way choice each:
  • OFF: plain rounds
  • AIM FIRST: guided, locks the enemy nearest the crosshair
  • BIG FIRST: guided, locks the enemy with the most maximum health
  • SMALL FIRST: guided, locks the enemy with the least maximum health
• GUIDED TARGET PRIORITY —— the manual aim priority master switch
• GUIDED TERMINIDS 1/2 (43 units), GUIDED AUTOMATONS 1/2/3 (69), GUIDED ILLUMINATE (23) —— one 0–9 slider per lockable enemy

Manual aim priority

• Master switch: the numbers below only count while it is on; off restores the old behaviour exactly
• The number: 1 = locked first, larger numbers come later; 0 = not set (those sort after every number you did set)
• Equal numbers fall back to the aim mode: aim-first takes the enemy nearest the crosshair, big-first / small-first as before
• Example: A(1) and B(2) in range → A is locked; both 1 → aim-first takes the nearer one
• Targets not on the page can still be set in the cfg as tp_<16 hex digits>=<n>

Common settings (GUIDED ROUNDS)

• ENABLE: master switch; turning it off restores every byte it wrote
• LOCK ANGLE: aim-cone half angle, and it sizes the on-screen range ring; 0 removes the ring
• LOCK RANGE: furthest target accepted, in metres (250 shipped)
• ARM TIME AFTER MUZZLE: 0.25 s shipped
• BIND TARGET OURSELVES: when the engine locked nothing, pick one in the aim cone; keep it on
• REQUIRES LINE OF SIGHT / SHOOT THROUGH FOLIAGE: the sight test uses the engine's own ray, cast from the muzzle in your hands
• RANGE RING / LOCK MARKERS / TARGET BOX: the three lock visuals, each with its own switch
• LOCK ILLUMINATE WARPSHIPS / LOCK AUTOMATON DROPSHIPS: both off as shipped (a transport is what lands troops, not a target)
• SCOPE LOCK SCALE / FOLLOW THE SCOPE ZOOM: off by default; off keeps the ring the same on-screen size at every zoom
• LOAD PROJECTILE MATERIALS: keep it on, or rounds render as missing-material question marks

Hotkeys

• F7: restarts the mod (restores every write, then takes it again); it does not switch the mod off
• F10: cycles the seeker entity (set seek_cycle=1 in the cfg first)

Config file (these live in the cfg only and cost no menu row: ship_scan / debug / los_debug / los_desc / scan_ms / targets_extra / targets_debug)

• targets_extra=0x…,0x…: add extra lockable entities (e.g. to allow the Cognitive Disruptor's body again)
• targets_debug=1: logs one TARGET CENSUS … line per resource in the health list, for finding an entity that is not in the addon's list

Language: category names, weapon names, unit names and option texts follow the game language (Simplified/Traditional Chinese → Chinese, everything else → English). After changing Text Language, open the escape menu again.

Highlights

• Per-weapon enemy priority (v1.9.3): on MODS -> GUIDED WEAPON PRIORITY pick a class, pick CUSTOM PRIORITY (or EDIT THIS WEAPON, which points the five pages at it and then falls back to CUSTOM, v1.9.7) for weapons of that class, then tune them on the five faction priority pages; untouched targets keep the shared table and switching a weapon off keeps its numbers; while a weapon is customised the five priority pages are named after it (v1.9.4); the page lists only lock-enabled weapons and the category names carry `01`-`19` numbers that keep pages of one kind together (v1.9.5); since v1.9.6 priority has three layers - the class-page mode < the GLOBAL table (switchable) < a weapon's own table, with two switches on page 13
• Every setting is remembered (v1.9.2: priority numbers, the master switch and the rest survive a restart)
• The P-92 Warrant's guidance, ported to 104 weapons: rounds track after they leave the barrel
• Damage, muzzle velocity and ballistics stay the weapon's own
• Weapons grouped into 9 type pages, so finding a gun is not a long scroll
• Manual aim priority split by faction (135 units): lower number first, ties decided by the aim mode
• Range ring + stock lock markers + target box, each switchable; what the ring shows is what is locked
• Cover is respected: the ray starts at the muzzle in your hands, the bullet's real path
• Hipfire and scope agree, or follow the scope zoom with your own scale
• The Cognitive Disruptor's power unit can be locked now: structures have no pose node, so the addon falls back to the unit's root bone; the indestructible body is no longer a target
• Menu, category and unit names follow the game language
• F7 restarts in one keypress

Known issues

• A short scan when a mission starts (expected, not going to be fixed): the addon has to locate the game's data tables in memory once. Since v1.9.2 the budget is 1.5 ms/frame instead of 4 - the same search takes longer but no longer stutters; scan_ms in the cfg still overrides it
• As the host, squadmates without this mod see pink question-mark rounds: the round is swapped for the P-92 projectile entity and packages load per machine; joining as a client usually does not show it. Mitigation: squadmates on HD2Runtime 0.31+, or someone carrying the P-92 sidearm
• Non-projectile weapons cannot be guided and never will be (laser, arc, flame, spray — there is no projectile to steer)
• The Cognitive Disruptor body is deliberately not a target since v1.9.0; its destructible power unit is. To allow the body again: targets_extra=0x1445DF29152C9BE2
• Melee weapons, throwables and non-player weapon rows are not in the menu (the cfg's weapons= line still accepts them)
• May conflict with mods that edit the same weapon or projectile fields (including ones that change the APW-1 reticle)

Multiplayer advice

• Join other squads as a client: guidance is computed on your own machine and squadmates never see question-mark rounds
• If you host: tell your squadmates they may see question-mark rounds, and use the mitigations above
• Friends Only / invite-only lobbies are recommended

Log
Settings changes, locked targets, guidance state and the TARGET CENSUS lines are written here; attach the relevant part when reporting a problem.

Uninstall
Switching the mod off restores every memory write; deleting the package afterwards is enough.

Source and credits
Open source under the MIT license: github.com/cancan23333/Helldiver2-Guided-Rounds (the old URL redirects).
This package is a modified derivative of DIY your weapon to shoot like Donk (APW-1 Anti-Materiel lock-on, DIY-able); the guidance mechanism and memory offsets come from that addon. Thanks also to the authors of Bingus Shared Loader, HD2Runtime, WeakPoint Lock-On and Vanilla Plus Megapack. Guidance components and scene assets are copyright Arrowhead Game Studios. Authors: cancan2333 & SoS2430.