运行时装备切换器 - UE4SS

[size=3][b]免责声明：[/b] 本模组是在 AI 辅助下制作的。[/size]

一个 UE4SS 框架，用于通过即插即用的 Lua 配置来编辑战机挂载——SPW id、SPW 弹药量、机炮、MSL 和干扰弹——使用与 [b]PlayerPlaneDataTable[/b] 相同的字段名。无需 UAssetGUI，也无需打包 PPDT pak。

原版《皇牌空战 7》将这些数值按[b]每架战机[/b]存储。本模组会监视所选战机和机库皮肤（[b]NimbusGameInstance[/b]），在你的配置匹配时重写实时的 PPDT 行，然后在你离开该皮肤（或战机）时恢复原版数值。此工具可以针对整架战机或按皮肤更改战机挂载——这也是我最初创建它的原因。

[center][img]https://staticdelivery.nexusmods.com/mods/2777/images/3799/3799-1793196645-754424011.gif[/img][/center]
[center][i]这就是我最初做这个的原因。[/i][/center]

配置文件是位于 [b]SkinSpw\Scripts\configs\[/b] 下的纯 Lua 文件。发布你自己的配置包；其他用户添加他们的配置时无需改动核心脚本。只有 [b]PlaneStringID[/b]、[b]PlaneID[/b] 和 [b]SkinSlot[/b] 是必填的——所有挂载字段都是可选的（注释掉即保持原版）。至少需要设置一个挂载字段。

提供了一个支持 Urvopteryx 的 [url=https://www.nexusmods.com/acecombat7skiesunknown/mods/2279]FA-22B Peregrine（皮肤槽位与武器替换）[/url] 的配置包示例——其中包含按皮肤逐个配置的选项，或一个涵盖皮肤 2 到皮肤 12 的单一 Lua 文件（即 Peregrine 模组支持的皮肤槽位）。

[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[size=4][b]前置需求：[/b][/size]
[list]
[*][size=3][url=https://www.nexusmods.com/acecombat7skiesunknown/mods/2474]Unreal Engine 4 Scripting System (UE4SS) for Ace Combat 7[/url][/size][/*]
[/list]
[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[size=4][b]安装：[/b][/size]
[list=1]
[*][size=3]为《皇牌空战 7》安装 UE4SS。[/size][/*]
[*][size=3]下载本模组。[/size][/*]
[*][size=3]将内容直接解压到游戏文件夹。[/size][/*]
[*][size=3]大功告成。不过，如果你真想看到效果，还需要正确的配置。[/size][/*]
[/list][size=3]如果这是你第一次为《皇牌空战 7》安装模组，请参阅此[url=https://modding.wiki/en/acecombat7skiesunknown/users]页面[/url]。关于 UE4SS 的目录结构，也请参阅该模组自己的安装说明。[/size]

[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[size=4][b]编写配置：[/b][/size]
[size=3]将你的 [b].lua[/b] 文件放入 [b]SkinSpw\Scripts\configs\[/b]（仅顶层目录会被自动加载）。将其重命名为 [b]*.lua.disabled[/b] 即可禁用。

[b]单个皮肤：[/b][/size]
[code]
return {
  Name = "My F-22A skin 14 pack",
  PlaneStringID = "f22a",
  PlaneID = 110,
  SkinSlot = 14,

  GunLoadCount = 2400,
  MainWeaponLoadCount = 136,
  FlareLoadCount = 3,

  SpWeaponID1 = "sod",
  SpWeaponLoadCount1 = 18,
  SpWeaponID2 = "lacm",
  SpWeaponLoadCount2 = 15,
  SpWeaponID3 = "8aam",
  SpWeaponLoadCount3 = 76,
}[/code][size=3]
[b]多个皮肤，相同挂载：[/b][/size]
[code]
return {
  Name = "F-22A skins 13+14",
  PlaneStringID = "f22a",
  PlaneID = 110,
  SkinSlot = { 13, 14 },

  SpWeaponID1 = "qaam",
  SpWeaponLoadCount1 = 20,
  SpWeaponID2 = "gpb",
  SpWeaponLoadCount2 = 30,
  SpWeaponID3 = "8aam",
  SpWeaponLoadCount3 = 80,
}[/code][size=3]
[b]整架战机（任意皮肤）：[/b][/size]
[code]
return {
  Name = "F-22A — more MSL only",
  PlaneStringID = "f22a",
  PlaneID = 110,
  SkinSlot = "All",

  MainWeaponLoadCount = 200,
}[/code]
[b]SkinSlot[/b] —— 机库皮肤编号（[b]10[/b]）、一个列表（[b]{ 11, 12 }[/b]），或 [b]"All"[/b] 表示该战机的所有皮肤。同一战机上，特定的 SkinSlot 规则优先于 [b]"All"[/b]。

[b]PlaneID[/b] —— PlayerPlaneDataTable 中的数字 id（例如 F-22A 为 [b]110[/b]）。[b]PlaneStringID[/b] —— 内部字符串 id（例如 [i]f22a[/i]）。

挂载字段使用 PPDT 名称：[b]SpWeaponID1..3[/b]、[b]SpWeaponLoadCount1..3[/b]、[b]GunLoadCount[/b]、[b]MainWeaponLoadCount[/b]（MSL）、[b]FlareLoadCount[/b]。省略或注释掉任意一行即可让该列保持原版。不同皮肤使用不同挂载 → 使用单独的文件，或在一个文件中放置多个规则表——模组文件中已提供示例。

[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[size=4][b]注意事项：[/b][/size]
[list]
[*][size=3]在切换皮肤时，机库中的 SPW 文本可能短暂延迟或显示异常；表格数值和任务挂载会跟随当前生效的配置。[/size][/*]
[*][size=3]这不会永久修改游戏资源。它仅在匹配的配置被选中时更改实时的 PlayerPlaneDataTable 行。[/size][/*]
[*][size=3]避免两个配置声明相同的战机 + 皮肤槽位。[/size][/*]
[/list]
[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[size=4][b]兼容性：[/b][/size]
[list]
[*][size=3]其他同样在运行时重写 PlayerPlaneDataTable 挂载字段的模组可能会与本模组冲突。仅修改资源的 PPDT 编辑在规则生效期间通常会被覆盖，然后在你离开该皮肤时恢复。与 [url=https://www.nexusmods.com/acecombat7skiesunknown/mods/3797]AC7MultiSP[/url] 的兼容性尚未确认。[/size][/*]
[/list]
[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[size=4][b]致谢：[/b][/size]
[list]
[*][size=3][url=https://www.nexusmods.com/acecombat7skiesunknown/mods/2474]Unreal Engine 4 Scripting System (UE4SS) for Ace Combat 7[/url] —— 本模组所运行的运行时环境。[/size][/*]
[*][size=3][url=https://www.nexusmods.com/acecombat7skiesunknown/mods/3797]AC7MultiSP[/url] —— 经许可作为 Nimbus 选择 API（[i]GetSelectedPlaneID[/i] / [i]GetSelectedPlaneSkinNo[/i]）的参考；本模组未复制任何 DualSP 代码。[/size][/*]
[*][size=3][url=https://cursor.com]Cursor[/url] —— AI 辅助开发。[/size][/*]
[/list]
[size=3]==========[size=3]==========[/size][size=3]==========[/size][size=3]==========[/size]=======[/size]

[list]
[*][size=4][url=https://modding.wiki/en/acecombat7skiesunknown]Ace Combat 7 的 Modding.wiki 页面[/url][/size][/*]
[/list]