用于交换和保存的SF1Edit补丁脚本（仅武器）

[heading]描述[/heading]
[color=#e4e4e7][size=2]这些是用于 [/size][/color][b][color=#e4e4e7][size=2]SF1Edit[/size][/color][/b][color=#e4e4e7][size=2] 的自定义 Pascal 自动化脚本，旨在仅针对[/size][/color][b][color=#e4e4e7][size=2]武器[/size][/color][/b][color=#e4e4e7][size=2]生成松散模组物品系统和需求补丁。这些脚本适用于任何包含武器或配件的 .esm/模组。[/size][/color]

[color=#e4e4e7][size=2]为什么不做护甲模组？护甲掉落时并不会附带任何模组，所以做这个没什么意义。武器掉落时会附带随机搭配的配件，所以做这个是理所当然的。[/size][/color]

这些脚本旨在写入补丁文件，以兼容 [url=https://www.nexusmods.com/starfield/mods/8245]Swap and Save Weapon and Armor Mods - The Good Ol' Fallout Mods Restored[/url]（由 LarannKiar 制作，专门针对武器记录和配件进行了定制）。

[heading]安装说明[/heading]
[list=1]
[]下载 .pas 脚本文件并将其直接解压到你的 SF1Edit Edit Scripts 文件夹中。[/]
[/list][b]“脚本编译 / 缺少单元”错误的快速修复：[/b] 如果你在 SF1Edit/xEdit 中运行脚本时遇到脚本编译错误或缺少单元的消息，请确保将 Edit Scripts 文件夹的副本直接放在你的模组管理器中链接的工具可执行文件（SF1Edit64.exe）所在的同一目录下（如果你是从 Vortex 或 MO2 中启动它的话）。无论你如何启动它，它都应该始终位于 .EXE 旁边。这能确保 xEdit 找到其编译路径和内部解释器依赖项。

[heading]使用方法[/heading]
[list=1]
[]创建你新的空白小型主 .esm 补丁文件（例如 ModRequired_WeaponModName.esm 或 SwapNSave_WeaponModName.esm 或 SwapNSavePlus_WeaponModName.esm，其中 WeaponModName 是你要修补的特定武器模组的准确名称）。[/]
[]在 SF1Edit 中，右键点击你想要修补的武器或配件模组文件（例如 bublumi.esm 或 atom74.esm），选择 [b]Apply Script[/b]。选择匹配的脚本文件（ModRequired、SwapNSavePlus 或 SwapNSave）。[/]
[]让脚本执行其构建（在一秒内处理数百条记录）。保存你的插件，就可以使用了！[/]
[]如果你重新运行脚本，它只会清除补丁文件并重写它。例如，如果你对脚本做了更改或更新了字典中的任何内容。[/]
[/list]
[b][size=3]关于 SF1Edit/xEdit 的有趣事实：
如果你右键点击 .exe 并选择属性，你可以点击“更改高 DPI 设置”并选择“系统（增强）”来让程序更加易读。不额外收费。我只是希望有人早点告诉我。[/size][/b]

[heading]主要功能 v1.0（请参阅下方的 1.1 更新）[/heading]
[list]
[][size=3][b]ModRequired：[/b][/size] 专为特定以拾取为核心的游玩风格量身定制。此脚本使松散模组成为该配件的唯一制作配方。制作武器模组所需的所有研究/资源/技能要求都被移除。所有脚本都会根据模组页面上的说明生成 MISC 物品和 OMOD 覆盖，并在 LNAM 中链接 MISC 物品。这是唯一一个移除所有要求并且只接受松散模组来制作配件的脚本。这是根据我的偏好制作的最极端版本。还将价值降低到 1 信用点并移除重量。当我说“移除要求”时，我指的是在 COBJ 记录（工作台配方）中。

[b]v1.1 新增[/b] - 将松散模组的 3D 模型更新为 weaponscase_pistols01.nif。[/]
[][size=3][b]SwapNSave：[/b][/size] 一个仅针对武器的精简版本，纯粹专注于生成松散 MISC 物品并链接 OMOD 覆盖。不触碰任何技能、研究或制作配方——其他一切都保持完全原版。保留原模组作者设置的 .50 重量和 100 信用点价值，并保留默认 3D 模型。[/]
[][b]SwapNSavePlus：[/b] 一个仅针对武器的精选版本，专注于生成松散 MISC 物品，从默认/标准/无中移除研究/资源/技能要求，并将价值降低到 1 信用点并完全移除重量。[url=https://www.nexusmods.com/starfield/mods/7351]Free Default Mods - Weapons and Armor[/url] 是添加此功能的灵感来源。我一直认为它与 Swap and Save 配合得很好。现在全都为你完成了！

[b]v1.1 新增[/b] - 双重配方选项 - 如果你拥有松散模组，它会显示为制作要求。如果你没有，要求则默认为原版！两全其美！没有松散模组在库存中时，原版要求（资源、技能和研究）保持不变。同时将松散模组的 3D 模型更新为 weaponscase_pistols01.nif。感谢 Adrilex98 从 [url=https://www.nexusmods.com/starfield/mods/15310]Alternative Recipes[/url] 带来的灵感[/]
[]这是我第一次尝试制作自动化脚本，所以如果有任何遗漏或拼写错误请告诉我。它会过滤掉大部分无意义的内容，只复制武器配件。在所有的 HyperX、Bub200、Starfield、Shattered Space、Terran Armada 和 Tracker's Alliance（含 DLC）.ESM 上试过，它们似乎都能干净地提取所有武器模组并进行设置。适用于 Shengokai 的 Weapon Modifications 及其所有变体模组。也适用于 Functional Reflex Sights and Scopes Without Overlays！我发现了手动编辑记录有多么繁琐，并对任何在下班后或休息日牺牲时间的模组作者有了新的敬意。“你能对 1300 条记录做这个更改吗？”“不能。”我现在懂了。这个脚本相当简单，会通过合理的猜测自动修复大多数孤立或空的 CNAM 引用。它捕获了我为 G17x 和 Atom-74 手动编辑的所有内容，这些是我为个人补丁文件所做的。它的过滤器很容易添加关键词来排除。我想我已经全部搞定了，但你可以随意在脚本中添加/删除。在脚本方面我是个外行，但我能够轻松地进行手动添加和编辑。[/]
[]无需 Swap and Save 作为主文件：虽然脚本和生成的补丁插件对 Swap and Save 没有硬性 .esm 主文件依赖，但整个松散模组配件机制依赖于 LarannKiar 的 SFSE 插件才能在游戏中运行。如果没有安装 Swap and Save，底层的松散模组配件引擎就不会运行！我这样做是因为 LarannKIar 有无 DLC、单 DLC 和双 DLC 版本的 Swap and Save。这将适用于其中任何一个。这就是他们的制作方式。模组作者说明在描述页面上有添加兼容性的说明，但并非每个武器模组作者都提供补丁。现在你可以制作自己的了！即时完成！你应该很兴奋。这过去需要数小时的手动编辑，哈哈。我不确定这到底是给谁用的，但我希望在我花那么多时间制作自定义补丁之前就有它。[/]
[][b]SF1Edit[/b]：运行脚本所必需。[/]
[/list]
[heading]全局框架升级 v1.1[/heading]
[list]
[][b]智能 WEAP 字典：[/b] 用硬编码的翻译矩阵替代暴力解析，覆盖 Starfield、Shattered Space、Terran Armada、Tracker's Alliance 和 At Hell's Gate。它还会从自定义武器模组中动态提取武器名称。[/]
[][b]智能配件检测：[/b] 如果模组作者对配件使用了非标准命名，脚本会智能检测它属于哪把武器，并正确命名生成的 MISC 松散模组物品。[/]
[][b]改进的 MISC 物品自动命名：[/b] 保留标准的 [Mod - WeaponName - AttachmentName] 命名约定，但会澄清模糊的描述。例如，它会自动将通用的“No Mod”激光配件更改为“Laser No Mod”，以便更轻松地管理库存。[/]
[][b]动态 DoSetup 遍历：[/b] 即时扫描并缓存模组添加的武器在游戏中的显示名称。[/]
[][b]分层记录过滤：[/b] 跨三个不同层级评估 EditorID 和 FULL 名称，允许有效物品例外安全绕过垃圾过滤器。它会过滤掉 Quality Tiers 和 NG+ 伤害升级等臃肿内容，同时确保 ARMOR PIERCING 或 OLD WORLD 等有效物品通过，而不会拖入未使用的 OLD_MOD 或 ARMOR 记录。[/]
[][b]孤立 COBJ 修复（最终遍历）：[/b] 检测并动态修复缺少目标对象链接的损坏制作配方。如果模组作者有意（删减内容）或错误地留下了空引用，脚本会通过将 COBJ 名称与 OMOD 名称匹配来自动恢复它。此外，如果 COBJ 记录完全没有有效的 OMOD，它就不会被复制过来，从而保持你的工作台菜单整洁。[/]
[/list]
我对这些脚本投入的所有时间唯一的愿望就是，它能帮助其他人节省数小时的手动编辑和记录创建时间，这样我们都能在使用我们最喜欢的武器模组的同时，使用我们另一个最喜欢的模组：Swap and Save。

[heading]致谢[/heading]
非常感谢 ElminsterAU 和 SF1Edit/xEdit 团队，esennolisto 制作的 Free Default Mods，Adrilex98 制作的 Alternative Recipes，以及 LarannKiar 创造了 Swap and Save 和使整个框架成为可能的 SFSE 插件。

[heading]AI 生成披露[/heading]
自动化脚本使用 Gemini 编写