堆叠的板条箱 - 战利品箱大修

[center]******************************************************************
* 叠加式战利品箱 - 作者：Puff The Magic Dragon *
******************************************************************[/center]

===========
描述
===========
彻底改造了战利品箱系统。改动很大，请继续阅读。
[b]版本 7 是与 DLC 7 兼容的最新版本[/b]


============
特性
============
在战利品箱中找到武器、装备和战斗机甲
添加了高价值甚至失落科技战利品的稀有战利品箱
添加了极其稀有的星际联盟仓库！但小心守卫！
根据喜好自定义任何战利品掉落的概率和质量
给原版"空"箱子、酒馆任务箱子和目标突袭箱子填充战利品
自定义探测和扫描距离！
自定义扫描时间！
自动扫描箱子！
AI 队友可以探测和扫描箱子！
为已发现的箱子添加地图标记！
使用原版灯塔或[url=https://www.nexusmods.com/mechwarrior5mercenaries/mods/970]沉浸式战利品箱烟雾[/url]以及自定义亮度和颜色，完全自定义战利品箱指示器！
还有更多更多！


============
更多详情
============
此模组完全改变了随机战利品的生成方式，让你不仅可以从随机战利品掉落中获得武器，还能获得装备甚至机甲。战利品会在任务开始时或当你更改选项和设置时完全重新生成。

持续记录所有选项的工作量太大了。


===========
秘密配方
===========
此模组通过编辑 TreasureActor 类蓝图（代表战利品箱的 Actor）来工作，这样在 BeginPlay 时会调用一个新函数，该函数会生成全新的战利品，忽略 ScenarioGen 已经生成的战利品。根据 Mod 选项菜单中设置的权重，新的战利品生成函数将选择生成机甲、装备还是武器。然后，它会构建一个有效战利品列表，考虑了 DLC、引入日期、失落科技和难度级别，并完全随机地选择一个随机战利品。

有效战利品列表是使用给定类的所有有效数据资产类型构建的——因此，添加机甲、变体、装备或武器的模组，其资产也会出现在这些战利品箱中。甚至氏族装备也是如此。你无需采取任何特殊操作。其他模组作者只需确保资产的引入日期、科技等级和等级设置正确即可（它们本来就应该如此），但我不能保证其他模组作者的工作质量。

这一切都发生在你开始新任务时的 BeginPlay 事件中。从版本 3 或更高版本开始，在任务开始时，生成器运行时会出现短暂的帧数下降。这每场任务只发生一次，或在更改游戏设置后发生一次，并且只有当地图上有很多战利品箱时才会明显。当敌人被摧毁时生成的战利品箱不应导致任何性能下降，因为大部分随机数生成（RNG）在任务开始时就已经完成了。


============
需求
============
BobbertModdert 的 Mod 选项 - https://www.nexusmods.com/mechwarrior5mercenaries/mods/537


============
安装
============
将文件直接解压到你的 Mods 文件夹中。
在 MW5 中激活模组。
进入选项 > Mod 选项并自定义你的设置。（我建议即使不做任何更改也保存设置。这可以确保 Mod 选项在你加载任务之前获取到当前值。）

============
更新
============
版本 7.0 将我们带入了 DLC7 时代。
像往常一样安装即可，但在加载游戏存档之前，请务必进入选项菜单，检查/确认并保存你的 Mod 选项。
我建议用文本编辑器打开 [i]%localappdata%\MW5Mercs\Saved\Config\WindowsNoEditor\Game.ini[/i]，并删除标有 "StackedCratesConfig" 的部分，以移除任何可能导致新版本问题的旧选项。这会将你的配置重置为默认值。


=======
卸载
=======
在 MW5 中停用模组。
从你的 Mods 文件夹中删除 StackedCrates 文件夹。
可选：导航到 %LocalAppData%\MW5Mercs\Saved\Config\WindowsNoEditor，打开 Game.ini，并删除标题为 "StackedCratesConfig" 的部分。


=============
兼容性
=============
此模组只修改了一个游戏组件，即与战利品箱相关的 TreasureActor 类。它应该与任何其他模组完全兼容。只要添加正确（包括正确的对象类型、等级、引入日期等），它也应该与向游戏中添加新机甲、武器或装备的模组兼容。

此模组与 MercTech* 和 YAML 兼容。
* 部分限制适用。


=========
集成
=========
如果你想将此模组的功能集成到你自己的模组中，我已上传源代码。如果在你的模组中使用此功能，请注明出处并链接回此页面。
在制作衍生作品之前请先联系我。
请勿将此模组或其源代码重新上传到 Nexus 或任何其他网站。

版本 6.5 引入了任务实例 Actor（CIA）来处理所有繁重的工作。CIA 将大部分繁重的 RNG 工作转移到了游戏启动时，减少了任务开始时的性能影响。对 TreasureActor 的大多数修改都是在运行时动态处理的。还有许多其他自定义资产用于处理自定义指示器和标记。

有一个被覆盖的 uasset：TreasureActor。此资产的事件图已被修改，以确保它能与 CIA 进行通信。

源代码仅供模组制作者资源使用。如果你不是模组制作者，请不要下载。此资源按"原样"提供，不提供任何支持、保证或适销性。部分限制适用。并非所有地区都可用。副作用包括睡眠紊乱、疲劳、眼睛干涩和腕管综合症。请咨询你的医生模组制作是否适合你。


============
已知问题
============
- 缴获的机甲在任务结束后的结算界面中显示正常，但底盘/变体名称不会显示在回收屏幕的目标奖励摘要中（仅显示通用的"战场战利品"）。要改变这一点，需要对蓝图进行修改，这可能会破坏与其他模组的兼容性。
- 有时，即使箱子中包含有效战利品，回收摘要的通话信息也不会显示。这是原始通话对话框系统中的防抖动计时器问题，我无法修复。
- MercTech v2 将机甲的"特性"作为"EquipmentItem"添加。由于 Stacked Crates 会拉取 EquipmentItem 列表来生成战利品，这些特性可能会作为相当无用的装备或以"???"等名称出现在战利品箱中。由于没有简单的方法修复这个问题（要么破坏与其他模组的兼容性，要么制作一个专门的 MT 补丁），这个问题可能不会得到修复。


===============
版本历史
===============
[b]版本 1.0[/b]
- 我终于做出了能用的东西！
[b]版本 1.1[/b]
- 改进了稀有战利品掉落的失落科技过滤。增加了时间旅行选项。
[b]版本 1.2[/b]
- 改进了数量概率。如果任务进行中更改了选项，战利品箱现在会重新生成。一些小的性能调整。
[b]版本 2.0[/b]
- 增加了自动或手动配置的"模式"选择
- 增加了弹药箱选项
- 增加了传感器加成
- 增加了扫描时间选项
- 增加了自动扫描选项
- 增加了无限范围作弊（按请求）
- 增加了调试日志输出
- C币倍率完全动态化
- 修复了阻止机甲掉落的错误
- 大量其他错误修复和细微调整
[b]版本 3.0[/b]
- 移除了"模式"选择，并增加了更细粒度的按设置选项
- 所有"任务相关"箱子（酒馆任务箱子、定点击杀箱子、目标突袭箱子）现在始终是"稀有"箱子
- 增加了星际联盟仓库
- 增加了 AI 队友扫描
- 增加了可自定义的机甲/武器等级选项和其他设置
- 恢复了可自定义的 C币支付
- 修复了多人游戏中地图标记的错误
- 对战利品生成系统进行了大规模改造，以提高性能并支持新选项
- 大量其他错误修复和调整
[b]版本 3.1[/b]
- 修复了如果禁用 DEBUG 则无法生成新战利品的错误（呃）
- 将包含机甲的稀有箱子掉落更高等级机甲的概率从固定的 10% 改为基于稀有箱子概率的加权概率
- 将星际联盟仓库守卫数量从 1 到（最大声望）改为 1 到 8，取决于任务难度和仓库内容
- 修复了导致寻宝猎人任务开始时地图标记与自定义颜色不匹配的错误
- 调整了机甲、稀有箱子和 SL 仓库的默认生成概率
[b]版本 3.2[/b]
- 修复了只有在 Debug 设置为 Advanced 时 SL 仓库守卫才会生成的错误（哎呀）
- 修复了在自动扫描时切换机甲导致音频故障的错误（禁用了自动扫描期间的机甲切换，重写了自动扫描代码）
- 移除了星际联盟仓库目标地图标记——替换为仅地图标记选项
- 增加了可自定义的任务开始时仅地图标记选项
- 移除了选项菜单中的"自定义战利品箱指示器可见性、颜色、缩放"选项——自定义现在默认开启（如果你真的禁用了这个功能，请告诉我）
- 从标准战利品掉落中移除了弹药箱（稀有/失落科技弹药箱仍可在稀有/SL 战利品箱中掉落）
[b]版本 4.0[/b]
- (PGI) 指示器发射器（灯塔）的新默认颜色——模组默认值已相应更新
- (PGI) 新的"情报"战利品类型
- 新增：重新武装/重新装填选项
- 新增：静音 Ryana 选项（警告：这会静音 Ryana 在剧情任务中的通话！）
- 修复：（希望如此？）导致 AI 队友射击战利品箱的错误
- 重新排序了 Mod 选项菜单中的一些选项
[b]版本 5.0[/b]
- 更多新选项！
- 更多（希望如此）错误修复！
[b]版本 6.0[/b]
- 新功能！
- 新选项！
- 现在包含沉浸式烟雾！非常感谢 SankaraSamsara 分享代码和资源！
- 为大家准备了新的错误！
- 此版本在单人游戏中运行良好，但我仍在努力解决多人游戏的问题。也仍然与 DLC5 剧情任务不兼容。
- 此版本文件大小稍大，因为它处于重构中期，旨在尝试修复合作和 DLC5 的错误。
[b]版本 6.5[/b]
- 主要代码改造！
- 新选项和功能！
- 性能大幅提升！
- 改进了与其他模组的兼容性！
- 改进了多人游戏兼容性（不完美，但不再崩溃）！
[b]版本 6.6[/b]
- 修复了 6.5 中的错误，合并了 6.5.1 和 6.5.2 的错误修复
- 改造了战利品验证代码，以提高性能和调试日志记录
[b]版本 7.0[/b]
- 使模组兼容 DLC7！接招吧，氏族佬！
- 修复了可怕的"所有目标都锁定并射击战利品箱"的错误。（不，这次是真的）
- 修复了一些战利品生成错误，并有望大幅改进失落科技探测。

==========
待办事项列表*
==========
- 基于任务难度的分级战利品 - 这已实现，但仍在开发中。目前仅适用于标准箱子。你有时可能会在标准箱子中看到稀有或失落科技武器/装备。
- 添加"补给仓库" - 目标是在单个军事基地位置生成半打新箱子，但它可能最终只是一个包含大量额外好东西的单个箱子。
- 添加一些花哨的脚本，以便你可以从战利品箱中获得机甲升级（酒馆生涯进度奖励） - 这仍在开发中，并且非常困难。
- 将酒馆任务与机甲升级完全解耦（如果我能抽出时间，这很可能会最终成为一个单独但相关的模组）
[s]- 添加一个选项，当在范围内时自动拾取战利品箱（用于 MechCommander 模组兼容性）[/s] 已完成

*由于其他优先事项（主要是现实生活占用了我时间），我可能永远不会处理这些中的任何一个。我会尽可能多地支持错误修复，但新功能将让位于赚取薪水。


===============
鸣谢：
===============
感谢我自己想出了如何做到这一点。
感谢 yrrot 和 czolee 以及 Discord 上所有帮助我解决问题的模组作者！
感谢 BobbertModdert 使 Mod 选项可供其他模组作者使用。
感谢 PGI 制作了 MW5！