(教程)如何为《黑神话:悟空》制作你自己的模组

(教程)如何为《黑神话:悟空》制作你自己的模组

这是你使用Fmodel和Wukong Data Editor制作自己的mod、制作自己的.pak文件以及如何安装它的唯一指南

[center][size=6][b]黑神话:悟空 – 从 FModel 到你的第一个数据模组[/b][/size]
[size=4]用 FModel 提取游戏数据表,用 Wukong DataEditor Plus 编辑,打包即可游玩[/size]
[size=2]作者:Yang · Made By Yang With Love[/size][/center]

[line]

[size=5][b]为什么写这篇指南[/b][/size]

Nexus 上已经有一篇指南,讲的是如何在 FModel 中打开游戏文件。但它就到此为止了。
这一篇则会从头讲到尾:从打开文件,到编辑数据表,再到生成一个能在游戏里正常工作的 [b].pak[/b]。

你会制作一个小的示例模组(让天命人的基础属性更强)。文末还有一份 [b]ID 速查表[/b]:我在做模组时找到的文件和 ID、它们各自的作用,以及哪些东西不该碰。
先用示例学会方法,再用速查表做你自己的模组。

[b]本指南会带你经历以下内容[/b]
[list]
+为《黑神话:悟空》配置 FModel 并导出数据表(PBTable)。+在 Wukong DataEditor Plus 中读取并编辑数据表。+将编辑好的数据表打包成 .pak 并安装。+避开那些会让模组“毫无作用”或让游戏崩溃的错误。[/list]
[b]目录[/b]
[list=1]
[]你需要准备什么[/]
[]配置 FModel[/]
[]导出数据表[/]
[]Wukong DataEditor Plus 快速导览[/]
[]示例模组:更强的基础属性[/]
[]打包模组(Generate PAK)[/]
[]安装并测试[/]
[]能省下你数小时的规则[/]
[]故障排除[/]
[]ID 速查表[/]
[]致谢[/]
[/list]
[quote][b]仅限单人游戏。[/b] 在测试任何模组之前,请备份你的存档文件夹。[/quote]
[line]

[size=5][b]1. 你需要准备什么[/b][/size]

[list]
[][b]黑神话:悟空[/b] Steam 版。[/]
[][b]FModel[/b] – 使用 GitHub 上 [url=https://github.com/nnrucn/Black-Myth-Wukong---Model-extract]nnrucn/Black-Myth-Wukong---Model-extract[/url] 提供的版本。它自带 AES 密钥和悟空的映射文件(.usmap)。[/]
[][b]Wukong DataEditor Plus(我自己做的)[/b] – [url=https://drive.google.com/drive/folders/1__w5K0dGpUkj0ykV9dNyNV8GidxsFTi1?usp=sharing]https://drive.google.com/drive/folders/1__w5K0dGpUkj0ykV9dNyNV8GidxsFTi1?usp=sharing[/url] 。它是 [url=https://www.nexusmods.com/blackmythwukong/mods/1275]Wukong DataEditor[/url] 的改进版(英文行名、字段注释、以 % 显示的比率,以及我在 Plus 版中修复的 bug)。[/]
[][b].NET 8 Desktop Runtime (x64)[/b] – 编辑器需要它。[/]
[/list]
[b]为什么用这个 FModel 版本?[/b]
当我尝试最新的官方 FModel 时,悟空的文件树一直是空的。上面仓库里的版本能直接打开游戏文件,所以本指南使用它。

[quote][b]安全提示:[/b]那个 FModel.exe 是第三方上传的程序,不是 FModel 官方发布版。运行前请先扫描它(例如在 VirusTotal 上)。如果你更愿意用官方 FModel,只需要从仓库里拿两个文件:[i]BlackMythWukong 密钥 Key.txt[/i](AES 密钥)和 [i]Wukong_Release.usmap[/i](映射文件)。[/quote]
[b]下载仓库[/b]
[list=1]
[]打开 GitHub 页面,点击绿色的 [b]<> Code[/b] 按钮,然后点击 [b]Download ZIP[/b]。[/]
[]将 ZIP 解压到一个较短的路径,例如 [i]D:\WukongModding\FModel[/i]。[/]
[/list]



[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663072-2076425009.png[/img]

[line]

[size=5][b]2. 配置 FModel[/b][/size]

[b]2.1 让 FModel 指向游戏[/b]
[list=1]
[]运行 [b]FModel.exe[/b]。[/]
[]在目录选择器中,添加游戏文件夹:
[code]...\BlackMythWukong\b1\Content\Paks[/code][/
]
[]关于虚幻引擎版本,如果列表中有 [b]Black Myth: Wukong[/b] 就选它,否则选 [b]GAME_UE5_0[/b]。[/]
[/list]

[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663169-291907445.png[/img]


[b]2.2 添加 AES 密钥[/b]
前往 [b]Directory > AES[/b],将以下密钥粘贴到 [b]Main Static Key[/b] 框中:
[code]0xA896068444F496956900542A215367688B49B19C2537FCD2743D8585BA1EB128[/code]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663221-823504958.png[/img]

[b]2.3 添加映射文件[/b]
前往 [b]Settings > General[/b],打开 [b]Local Mapping File[/b] 并选择 [i]Wukong_Release.usmap[/i]。重启 FModel。

[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663270-1698087466.png[/img]

[b]2.4 加载归档[/b]
在 [b]Archives[/b] 标签页中,选中所有 pak([b]Ctrl+A[/b]),然后点击 [b]Load[/b]。[b]Folders[/b] 标签页现在会显示游戏文件。

[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663305-492022492.png[/img]

[line]

[size=5][b]3. 导出数据表[/b][/size]

几乎所有的玩法数值(属性、法术、增益、掉落、物品)都存储在扩展名为 [b].data[/b] 的 [b]PBTable[/b] 文件中。它们是 protobuf 数据表,不是文本。

[list=1]
[]在 [b]Folders[/b] 标签页中,打开 [b]b1 > Content > 00Main > PBTable[/b]。[/]
[]右键点击 [b]PBTable[/b] 文件夹,选择 [b]Export Folder's Packages Raw Data (.uasset)[/b]。[/]
[]文件会保存到 FModel 的输出文件夹([b]Settings > General > Output Directory[/b])下:
[code]Output\Exports\b1\Content\00Main\PBTable\Runtime
Output\Exports\b1\Content\00Main\PBTable\NoneRuntime[/code][/
]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663366-303452483.png[/img]

[quote][b]保持这份导出文件不动。[/b] 把它复制到某处作为你的“干净”参考,永远不要编辑它。你每次做模组都应该从干净文件开始。
[b]绝不要在记事本或任何文本编辑器中打开 .data 文件。[/b] 在那里保存会破坏字节。[/quote]
[line]

[size=5][b]4. Wukong DataEditor Plus 快速导览[/b][/size]

[list=1]
[]如果你还没有安装 [b].NET 8 Desktop Runtime (x64)[/b],请先安装。[/]
[]将 DataEditor Plus 解压到任意位置,运行 [b]Wukong_PBData_ReadWriter_GUI.exe[/b]。[/]
[][b]File > Open Data directory[/b],选择你导出的 [b]PBTable[/b] 文件夹(包含 Runtime 和 NoneRuntime 的那个)。[/]
[/list]
窗口有三列:
[list]
[][b]左侧 – 文件。[/b] 每个 .data 数据表。使用 [b]Search config files[/b] 按名称查找。[/]
[][b]中间 – 行。[/b] 所选数据表的行,带有英文名称。使用 [b]Search ID or notes[/b] 跳转到某个 ID。[/]
[][b]右侧 – 字段。[/b] 所选行的值。列表和嵌套数据通过 [b]Open[/b] 按钮在新窗口中打开。[/]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663487-331829119.png[/img]

Plus 版本新增的内容:
[list]
[]每个数据表中的[b]英文行名[/b](有官方游戏名称的地方就用官方名称)。[/]
[][b]字段注释[/b]:许多字段在名称旁边有简短含义。将鼠标悬停在名称上可查看完整说明。[/]
[][b]ID 旁的名称[/b]:ID 字段会显示它指向什么,例如 [i]ItemId 3211 → Millennium Ginseng[/i]。[/]
[][b]以百分比显示的比率[/b]:按 1/10000 比例的数值会显示百分比,例如 [i]500 = 5%[/i]。[/]
[][b]Open 旁的摘要[/b]:打开列表前就能看到里面有什么。[/]
[/list]
[quote][b]切换文件前先保存。[/b] 编辑器会警告:“Switching data files will discard current changes”(切换数据文件将丢弃当前更改)。完成一个数据表,保存它,然后再打开下一个。[/quote]
[line]

[size=5][b]5. 示例模组:更强的基础属性[/b][/size]

天命人的基础属性位于一个数据表的一行中:
[code]Table : FUStUnitLevelUpDesc
File : b1\Content\00Main\PBTable\NoneRuntime\FUStUnitLevelUpDesc.data
Row : 9900001 (QualityType = Player)[/code]
[b]第 1 步 – 创建模组文件夹[/b]
在任意位置创建以下文件夹结构(第一个文件夹名会成为 .pak 的名称):
[code]zzz_BaseStats_P\b1\Content\00Main\PBTable\NoneRuntime\[/code]
[b]第 2 步 – 找到该行[/b]
[list=1]
[]在 [b]Search config files[/b] 中,输入 [b]FUStUnitLevelUpDesc[/b] 并点击该数据表。[/]
[]在 [b]Search ID or notes[/b] 中,输入 [b]9900001[/b]。[/]
[/list][quote]不要把它和 [b]9800001[/b]([i]PlayerSummon[/i])混淆。那一行是给身外身法的分身用的。[/quote]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663549-67304219.png[/img]

[b]第 3 步 – 修改数值[/b]
在我的副本中,该行在修改前是这样的:
[code]HpBase 300
MpBase 200
AtkBase 0
DefBase (empty = 0)[/code]文件中为空的字段按 0 计算。你仍然可以在其中输入数值。

在这个示例中,我将生命和法力翻倍,并提高攻击:
[code]HpBase 300 -> 600
MpBase 200 -> 400
AtkBase 0 -> 50[/code]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663630-462808101.png[/img]

[quote]只修改数字。保持 [b]ID[/b]、[b]QualityType[/b]、[b]CommAbnormalAttrConfigPath[/b] 和 [b]Guard[/b] 不变。[/quote]
[b]第 4 步 – 保存[/b]
[list=1]
[][b]File > Save as Data file[/b]。[/]
[]你应该能看到保存数据文件的 b1 文件。[/]
[]创建一个遵循 zzz_name_P 的文件夹,并把 b1 放进去。(在这个例子中,我将其命名为 [i]zzz_BaseStats_P)[/i][/]
[]选择文件夹 [i]zzz_BaseStats_P\b1\Content\00Main\PBTable\NoneRuntime[/i]。[/]
[]检查文件是否以原始名称存在:[b]FUStUnitLevelUpDesc.data[/b]。永远不要重命名它。[/]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663882-1013752311.png[/img]

[line]

[size=5][b]6. 打包模组(Generate PAK)[/b][/size]

编辑器内置了一个打包器(它使用 repak,pak 版本 V11,Zlib 压缩)。

[list=1]
[][b]File > Generate PAK[/b]。[/]
[]将 [b]zzz_BaseStats_P[/b] 文件夹(最上层文件夹,不是 .data 文件)拖入窗口。[/]
[][b]zzz_BaseStats_P.pak[/b] 会在该文件夹旁生成。[/]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794663956-643507941.png[/img]

[quote][b]为什么要用这么长的文件夹路径?[/b] 游戏会在 [i]b1\Content\00Main\PBTable\NoneRuntime\FUStUnitLevelUpDesc.data[/i] 查找该文件。你的 pak 必须包含完全相同的路径,否则游戏永远找不到你的文件。[/quote]
[line]

[size=5][b]7. 安装并测试[/b][/size]

[list=1]
[]打开 [b]BlackMythWukong\b1\Content\Paks[/b],如果不存在名为 [b]~mods[/b] 的文件夹,就创建一个。[/]
[]将 [b]zzz_BaseStats_P.pak[/b] 复制到 [b]~mods[/b] 中。[/]
[]启动游戏并加载存档。这些数值会在每次加载存档时重新读取,所以你不需要开新游戏。[/]
[]打开角色属性界面,对比生命、法力和攻击。[/]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6713/images/1567/1567-1794664624-279730448.png[/img]

要卸载,只需从 ~mods 中删除该 .pak 文件。

[line]

[size=5][b]8. 能省下你数小时的规则[/b][/size]

[b]一个 .data 文件,只有一个赢家[/b]
如果两个 pak 包含相同的 .data 文件,游戏只会使用其中一个:[b]按字母顺序排在最后[/b]的那个 pak。这就是为什么模组名以 [b]zzz_[/b] 开头并以 [b]_P[/b] 结尾。
如果你的模组“毫无作用”,检查 ~mods 中是否有另一个模组包含相同的文件。

[b]合并而不是堆叠[/b]
想要属性 + 掉落 + 法术?把所有编辑过的文件放进[b]一个[/b]模组文件夹(每个文件放在各自的 Runtime / NoneRuntime 子文件夹中),然后打包一次。

[b]有些数据表被拆成了多个文件[/b]
大表会被拆分:[i]FUStBuffDesc-lz.data, FUStBuffDesc-Talent.data, FUStBuffDesc-rd.data...[/i] 以及 [i]FUStSkillSDesc-lz.data...[/i]
编辑包含你 ID 的那个文件,只打包你修改过的文件。大多数玩家数据在 [b]-lz[/b] 文件中。

[b]Runtime 还是 NoneRuntime?[/b]
在我的副本中,名称以 [b]FUSt[/b] 开头的数据表位于 [b]NoneRuntime[/b],其他的(ItemDesc、EquipAttrDesc、CommDropRuleDesc……)位于 [b]Runtime[/b]。始终复制 FModel 显示的确切路径。

[b]始终从干净文件开始[/b]
编辑干净导出文件的副本。如果你编辑的文件已经来自另一个模组,你也会把那个模组的改动一起打包进去。

[b]不要碰的东西[/b]
[list]
+行 ID(ID、Id、DropId):其他数据表会指向它们。+任何保存路径的字段(…Path、TemplatePath、DBCDAPath…):错误的路径可能导致游戏崩溃。+类型 / 枚举字段(EffectType、QualityType…),除非你确切知道新值的作用。+删除行或列表内的条目。[/list]
[line]

[size=5][b]9. 故障排除[/b][/size]

[b]模组毫无作用[/b]
[list]
+pak 内的路径错误(在 FModel 中打开你的 pak 来检查)。+~mods 中另一个 pak 包含相同的 .data 并胜出(重命名你的 pak 或合并)。+你编辑了错误的拆分文件(再次搜索该 ID)。+你在保存前切换了编辑器中的文件。[/list]
[b]游戏在加载时崩溃[/b]
移除该 pak,将你的文件与干净副本对比。通常是修改了 ID、路径或类型值,或者删除了某个条目。

[b]FModel 不显示文件[/b]
检查 AES 密钥、.usmap 和 UE 版本(第 2 节)。

[b]编辑器无法启动或显示错误[/b]
安装 .NET 8 Desktop Runtime (x64)。DataEditor Plus 会将错误写入 exe 旁边的 [i]WukongEditorPlus.log[/i]。

[line]

[size=5][b]10. ID 速查表[/b][/size]

这些是我在制作自己的模组时使用的数据表和 ID。数值来自我的游戏副本。
[color=#55cc55][b]SAFE[/b][/color] = 可以自由修改的数字。[color=#ffaa00][b]CAREFUL[/b][/color] = 有效,但请阅读注释。[color=#ff5555][b]DON'T[/b][/color] = 会破坏东西或毫无作用。

[size=4][b]角色[/b][/size]

[b]FUStUnitLevelUpDesc[/b] – NoneRuntime\FUStUnitLevelUpDesc.data
[list]
+9900001 – 天命人:HpBase、MpBase、AtkBase、DefBase、CritRateBase、CritMultiplierBase。SAFE+9800001 – PlayerSummon,身外身法的分身:HpBase 300、MpBase 200、AtkBase 30、DefBase 10。SAFE+其他行 – 敌人和首领:HpBase、AtkBase、ExpDropNum(经验)、SpiritDropRate / SpiritDropMin / SpiritDropMax。SAFE(仅数值)+CommAbnormalAttrConfigPath、QualityType、LevelNumericalStrength。DON'T[/list]
[b]FUStPlayerCommDesc[/b] – NoneRuntime\FUStPlayerCommDesc.data,行 [b]10[/b](天命人)
[list]
+StaminaMaxBase(最大体力)、StaminaRecoverBase(体力回复)、StaminaCostMoveFast(冲刺消耗)、JumpSpeedNormal / JumpSpeedFast、FallingDamageMultiplier。SAFE+以 SkillID 或 Path 结尾的字段。DON'T[/list]
[b]PlayerLevelDesc[/b] – 每级一行(1–342)
[list]
+NextLevelExp(升到下一级所需经验)、NextLevelGainTalent(获得的火花)。SAFE[/list]
[b]EquipAttrDesc[/b] – Runtime\EquipAttrDesc.data
[list]
+8001–8014 – 葫芦。BloodBottomNumMaxBase = 饮用次数(4 到 8)。SAFE+装备属性:EquipDesc → AttrEffectId 指向保存属性的 EquipAttrDesc 行。在那里编辑属性。[/list]
[size=4][b]法术:冷却和法力消耗[/b][/size]

法术消耗在[b]两[/b]个地方。这是最常见的陷阱:
[list]
+FUStSkillSDesc → MinAttrCostType1 / MinAttrCostBase1 只是检查“你的法力够不够施放?”。+FUStSkillEffectDesc → CostAttr 行才是真正扣除法力的地方。[/list]如果你只移除 MinAttrCost,法术可以在 0 MP 时施放,但仍然会消耗你的法力。

[b]FUStSkillSDesc[/b] – NoneRuntime\FUStSkillSDesc-lz.data
[code]10095 聚形散气 CooldownTime 35
10505 铜头铁臂 CooldownTime 15
10516 身外身法 CooldownTime 120
10518 定身术 CooldownTime 50
10520 安身法 CooldownTime 50
10521 禁字法 CooldownTime 90[/code]变体:铜头铁臂还有 10507 / 10509(左 / 右),定身术还有 10517 / 10519。也要编辑它们。
CooldownTime(秒)、MinAttrCostBase1(施放检查)。[color=#55cc55][b]SAFE[/b][/color]

[b]FUStSkillEffectDesc[/b] – 真正的法力消耗(EffectType = CostAttr)。这个数据表也被拆分了:搜索该 ID。ID 通常是法术 ID × 100 + 51(聚形散气是例外:1009501)。
[code]1009501 聚形散气 30
1050551 铜头铁臂 30
1051651 身外身法 120
1051851 定身术 50
1052051 安身法 60
1052151 禁字法 [0, 1.0] = 最大法力的 100%[/code]EffectParamsFloat = [固定消耗, 最大法力占比]。将两者都设为 0 即可免费施放。[color=#55cc55][b]SAFE[/b][/color]

[b]FUStBuffDesc[/b] – NoneRuntime\FUStBuffDesc-lz.data
[list]
+122 – 隐身期间聚形散气的法力流失(每 1000 毫秒)。CAREFUL 当你的法力降到 0 时,游戏也会结束聚形散气。那部分在游戏代码中,不在数据表里。+10055 – 禁字法的法力消耗增益(CostAttr [0, 1.0])。CAREFUL[/list]
[b]天赋“万千化身”[/b] – TalentSDesc [b]101203[/b] → 被动 [b]11213 / 11223[/b](FUStPassiveSkillDesc)
[list]
+这两个被动会给身外身法增加法力消耗(+20 / +40)。如果你让法术免费了但它仍然消耗一点法力,就是这个天赋的原因:也要编辑这些被动。CAREFUL[/list]
[size=4][b]棍势[/b][/size]

[b]每次命中的棍势[/b] – FUStSkillEffectDesc 中 EffectType = [i]IncreasePevalue[/i] 的行。数值在 EffectParamsFloat 中。ID 通常是攻击 ID × 100 + 91。
[code]1080191 / 1080291 / 1080391 / 1080491 / 1080591 轻攻击连段,第 1-5 击
1080091 冲刺轻攻击
1060191 / 1060291 空中攻击
1050291 铜头铁臂反击[/code][color=#55cc55][b]SAFE[/b][/color]

[b]蓄力时的棍势[/b] – FUStBuffDesc-lz
[list]
+246 劈棍式、285 立棍式、286 戳棍式:蓄力重击时每 100 毫秒获得的棍势(5.5 / 3.5 / 4.0)。SAFE[/list]
[b]完美闪避获得的棍势[/b] – FUStBuffDesc-Talent.data,[b]1019[/b](+40)。[color=#55cc55][b]SAFE[/b][/color]

[b]棍势条阈值[/b] – NoneRuntime\FUStPotentialEnergyConfigDesc.data,行 [b]1–20[/b](ResID 10 = 玩家)
[list]
+LevelValue 100 / 210 / 330 / 480 / 880 = 每个棍势点的起始位置。CAREFUL 这会改变棍势条的划分方式,而不是填充速度。要更快填充,请提高上面的获得量。[/list]
[size=4][b]闪避[/b][/size]

[list]
+FUStBuffDesc-lz 10105–10109 – 连段中每次翻滚的无敌时间(Duration,单位毫秒:400、400、433、466、500)。SAFE(保持合理)+FUStBuffDesc-Talent 1093 – 更大的完美闪避判定 [1.5, 1.5, 1.5],来自头冠“不净”(EquipDesc 17007 → TalentSDesc 907007)。SAFE+完美闪避时机:它设置在动画文件中,不在 PBTable 里。DON'T(无法用 DataEditor 修改)[/list]
[size=4][b]物品和掉落[/b][/size]

[list]
+ItemDesc – SellPrice、CarryMax(可携带数量)。SAFE+CommDropRuleDesc – Runtime\CommDropRuleDesc.data,每条掉落规则一行(DropId)。GroupDropRate 和每个物品的 Rate 使用 1/10000 比例(10000 = 100%)。MinNum / MaxNum = 数量。SAFE+掉落规则的 RollType 会改变物品的选取方式。CAREFUL+UnitDropRuleDesc – 每个敌人使用哪条掉落规则。CAREFUL[/list]
[line]

[size=5][b]11. 致谢[/b][/size]
[list]
+原始数据编辑器:禽兽-云轩,bilibili。+英文 UI:Wukong DataEditor(Nexus mod 1275)。+FModel:4sval 及贡献者。悟空版本、AES 密钥和 .usmap:nnrucn。+repak(与编辑器捆绑):trumank 及贡献者。+《黑神话:悟空》由游戏科学制作。[/list]
有疑问、发现错误或找到了新 ID?留下评论,我会把它们添加到速查表中。

[center][b]Made By Yang With Love[/b][/center]