(地狱熔炉) 爆炸物库

Explosives Library 为 HellForge 模组作者提供了一种共享方式，用于创建自定义爆炸定义并将其连接到私有伤害类型。模组可以调整自身的爆炸半径、伤害、护甲穿透、硬直和拆除力度，而无需更改其他武器使用的原生爆炸。

它为兼容模组提供了一个共享的爆炸注册表，并在运行时分配私有 ID。伤害类型使用 HellForge 现有的私有伤害系统。

版本 [b]0.2.0[/b] 还增加了与 HellForge 内置编辑器的兼容性，允许在现有的高级分类中显示自定义的 Explosion、Projectile 和 Damage Type ID，并编辑其支持的字段。无需替代编辑器。

[b][size=4]面向玩家[/size][/b]

当其他模组将 [b]Explosives Library[/b] 列为依赖项时，请安装此库。该库本身不会添加任何武器或战略配备，也不会更改原生伤害数值。

[list=1]
[*]将库的 ZIP 导入 HellForge 并启用它。[/*]
[*]启用需要它的兼容模组。[/*]
[*]更改库或其使用方模组后，请重启游戏。[/*]
[/list]
仅启用一份库副本。随附的示例会等待库就绪，因此其游戏玩法不依赖模组列表中的特定位置。其他使用方模组也必须正确处理就绪状态。对于编辑器集成，在可配置顺序的情况下，请将 EL 放在编辑器之前：自定义记录必须在编辑器读取其目录之前注册。

要编辑自定义记录，请打开 [b]F8 > Advanced > Projectiles / Damage Types / Explosions[/b] 并搜索其命名空间/来源名称。使用 [b]Enter/Tab[/b] 确认输入，然后 [b]APPLY/F9[/b]。重置也需要 APPLY。投射物载荷引用使用命名运行时视图；共享的爆炸或伤害记录会影响使用它们的每一个投射物。

可以通过在 explosives-library.ini 中设置 [editor] enabled=0 来禁用编辑器集成，然后重启。爆炸注册表仍然可用。
[line]
[b][size=4]面向开发者[/size][/b]

源代码、文档和示例可在 [url=https://github.com/HadePasianax/hd2-explosives-library]Explosives Library GitHub 仓库[/url] 中获取。

[list]
[*][url=https://github.com/HadePasianax/hd2-explosives-library/blob/main/docs/AUTHOR-GUIDE.md]作者指南[/url] — 将库集成到你的模组中。[/*]
[*][url=https://github.com/HadePasianax/hd2-explosives-library/blob/main/docs/API.md]API 参考[/url] — 注册、设置和 API 要求。[/*]
[*][url=https://github.com/HadePasianax/hd2-explosives-library/blob/main/include/explosives_library.h]公共 C 头文件[/url] — 在你的使用方模组中包含此文件。[/*]
[*][url=https://github.com/HadePasianax/hd2-explosives-library/tree/main/examples]示例[/url] — 包含轨道打击调试使用方。作者指南还链接了一个独立的十字弓示例。[/*]
[*][url=https://github.com/HadePasianax/hd2-explosives-library/blob/main/docs/EDITOR.md]编辑器指南[/url] — 自定义记录编辑、故障排除和当前限制。[/*]
[/list]
该库提供了一个共享的私有爆炸注册表；伤害类型使用 HellForge 现有的私有伤害 API。请使用共享提供程序，而不是将其引擎补丁复制到每个模组中。游戏玩法 [b]ABI 1 仍与现有使用方兼容[/b]。请使用 API 返回的 ID，而不是硬编码它们。共享池可容纳 [b]64 个唯一的私有爆炸[/b]；重复触发现有定义不会使用额外槽位。

请使用[带版本的发布版](https://github.com/HadePasianax/hd2-explosives-library/releases)进行下载，并在面向旧版本时阅读匹配发布标签处的文档。上述链接指向当前的 `main` 分支。请通过 [GitHub Issues](https://github.com/HadePasianax/hd2-explosives-library/issues) 报告错误。

[b][size=4]兼容性与当前状态[/size][/b]

[b]版本 0.2.0。需要 HellForge SDK 15 支持和游戏构建 25480438[/b]。游戏更新可能需要更新库。

私有爆炸和伤害行为已通过前体实验室中的手雷和十字弓覆盖进行测试，随后进行了由库支持的轨道打击测试，并记录了附近的爆炸伤害。自定义记录渲染和编辑也已在与其他模组的用户测试中正常工作。多人兼容性、数字 ID 重新分配后的持久性以及每种启动配置尚未验证。新的命名载荷引用已通过离线测试，但仍需在游戏内确认。

请勿启用第二个库提供程序、较旧的 [b]Private Explosion Lab[/b]，或另一个在此库之外独立扩展同一原生爆炸表的模组。不支持的表布局将在初始化期间被拒绝。更改模组集后请重启；不支持热卸载。

编辑器发现会捕获在其目录读取之前注册的自定义投射物和伤害记录；较晚的记录可能会缺失。EL 爆炸视图在运行时解析命中载荷，并公开半径和关联伤害，而不是每个原生爆炸字段。不包含专用的到期爆炸编辑视图。半径编辑必须保持 [b]inner <= outer <= shockwave[/b]。使用方可能会重新应用它们自己的配置文件，因此在更改其设置或模组集后请重新检查数值。

爆炸效果和音频继承自所选的原生供体。此版本不会公开单独的爆炸 FX/音频选择，也不会引入新的状态效果机制。供体从其加载状态复制，因此对供体的早期编辑可能会影响初始副本。

GitHub 上的 [b]OPS Debug mod[/b] 是一个单独的测试下载，用于展示该库的实际效果，并非正常使用所必需。它会将原版轨道精确打击覆盖为更大的私有等离子爆炸，并具有零直接命中伤害。它还存在一个已报告但未解决的编辑器暂存问题，即编辑可能在 APPLY 之前消失。测试后请禁用它，除非你有意保留该覆盖。