Protobuf 加载器

在运行时加载 protobuf（.data）文件。

所有 mod 均开源在 github。

特别感谢 @chenstack 提供 CSharpLoader

以下文本主要面向开发者。

如果你是用户，你其实不需要了解此 mod 的细节。

你只需要在另一位作者说他的 mod 需要此 mod 时，遵循他的安装说明。

并知道 Ctrl+F7 是重新加载热键。

如何加载 .Data 文件：

剧透

**1.**安装 CSharpLoader 和此 mod。

**2.**用 DataEditor 编辑任意有效的 .data 文件

按 “[TableName]_[Comment].data” 的形式重命名。

例如：

EquipAttrDesc_青田葫芦改为上限10口.data

FUStSuitDesc_lalalalal_abcd_imgood.data

FUStBuffDesc_MyMod.data

（“-” 之后的部分不是必需的。例如，如果你修改 “FUStBuffDesc-Item.data”，可以命名为 “FUStBuffDesc_MyName.data”）

错误示例：

ABC_青田葫芦改为上限10口.data //错误。必须以原始表名开头(EquipAttrDesc)

EquipAttrDesc_青田葫芦改为上限10口aabc //错误。必须以 .data 结尾

FUStSuitDesc_lalalalal_abcd_imgood.bak.data //错误。“.bak.data” 会被自动忽略。

2.5.（可选）如果你将数据文件重命名为 “[TableName]_[Comment].insert.data”，任何记录都会被插入到第一个空行，并可能获得一个新 ID。

3.

将数据文件放在一个文件夹中。将该文件夹复制到 BlackMythWukong\b1\Binaries\Win64\CSharpLoader\Mods\ProtobufLoader[AnyFolder]。

例如：

-- b1\Binaries\Win64\CSharpLoader\Mods\ProtobufLoader

-- ProtobufLoader.dll

-- 300_青田葫芦改为10口上限

-- EquipAttrDesc_青田葫芦改为上限10口.data

-- 200_锦鳞套加2条套装效果_日金乌套改为加大量攻防

-- EquipAttrDesc_锦鳞套加2条效果_日金乌套改为加1800攻击2_修改属性.data

-- FUStSuitDesc_锦鳞套加2条套装效果日金乌套装改为加1800攻击1_修改套装.data

**4.**运行游戏。

此 mod 会加载正确文件夹中的 .data 文件。

为什么你需要这个？

此 mod 可以逐条加载记录，而不是覆盖整个表。

如果 mod 作者制作 “.data” mod 而不是 “.pak” mod，它们之间极有可能不会互相冲突。

（此 mod 不会魔法般地消除所有冲突！即使你安装了此 mod，你旧的 “pak” mod 仍会像以前一样冲突。）

对于 mod 作者，你可以修改 .data 文件并在运行时重新加载。节省你打包、调试或为用户合并 pak 的时间。

注意：不是说你装了这个mod，原本冲突的mod就突然间不冲突了！！

意思是以后修改数据类的mod可以直接以data文件的形式发布并以该mod加载，就不会像以前pak文件那样极易冲突了

还省了把data文件打包成pak的工夫

注意：

0.重新加载与重置

按 Ctrl+F7 重新加载数据文件。

重新加载前，内存中的数据 将被重置（自 v1.1 起）。

但不可克隆的数据类型不会被重置。

重新加载时，此 mod 会同时修改 prorobuf 并刷新 GameDB 中的缓存。

按 Ctrl + F8 重置。

加载数据文件时，此 mod 会存储修改前的值。

重置时，此 mod 会将存储的记录写回。

如果另一个 mod 在加载和重置之间修改了此 mod 修改的记录，那些更改将会丢失。

当按 Ctrl+F7 重新加载时，此 mod 会在重新加载前自动重置。

按 Ctrl+F9 超级重置。

从虚拟文件重新加载所有内容。

“重置”时，此 mod 尝试仅恢复已修改的数据。“超级重置”时，此 mod 丢弃所有内容并从 .pak 文件加载（就像游戏启动时所做的那样）。

如果没有 bug、加载失败或另一个 mod 更改 protobuf，“重置”和“超级重置”应具有完全相同的效果。

1.加载顺序：

此 mod 按 字典序（又称字典顺序）加载子文件夹。

例如，文件夹 “100_abc” 必须在 “200_lalla” 之前加载。

不会递归搜索文件夹。例如，“CSharpLoader/Mods/ProtobufLoader/BestSuit/MoreSuitSubDir/” 下的文件不会被加载。

强烈建议按 [Number]_[Name] 的形式命名文件夹，以防你需要按特定顺序加载。

对于同一文件夹中的文件：

此 mod 首先按字典序加载所有 “.data”（不包括 “.insert.data” 或 “.bak.data”），

然后按字典序加载所有 “.insert.data”。

2.加载规则

当加载 “.data” 中的一条记录时。

如果它不在内存中的表里，它将被添加到表中。

如果它已经在内存中的表里，旧记录将被新记录 完全替换。

意味着你可以有多个修改同一张表的数据文件，只要它们不修改同一条记录，就不会冲突。

如果它们确实修改了同一条记录，最后加载的获胜。

当加载 “.insert.data” 中的一条记录时。

如果它不在内存中的表里，它将被添加到表中。

如果它已经在内存中的表里，则递增其 ID，直到新 ID 不在表中。修改其 ID 并用新 ID 插入表中。

此 mod 会在本地化初始化后加载文件。

当此 mod 由 CSharpLoader 加载时，如果 GameInstance 和 GSLocalization 都已完成初始化，此 mod 将立即加载文件。

否则，此 mod 将在 GSlocalization 初始化后尽快加载文件。

3.此 mod 修改什么？

通常，游戏中的数据存在于：

A) .pak 中的虚拟文件。

B) 内存中的 GSProtobufRuntimeAPI/BG_ProtobufDataAPI 缓存。

C) 内存中的 GameDBRuntime/BGW_GameDB 缓存

D) 内存中的其他实例

游戏启动时，游戏将所有数据从 A 读入 B，然后在 C 中构建某些数据的缓存。

在游戏过程中，一些实例直接从 B/C 读取，另一些在初始化时在 D 中构建 B/C 的缓存，之后从 D 读取。

当你使用传统的 pak mod 时，你实际上是在覆盖 A。

当此 mod 加载 mod 时，它 修改 B 并强制重建 C。

4.2.配置文件：

ProtobufLoader/Config.json:

ShutUp：如果为 true，则减少日志输出。默认 false。

如果你有大量数据文件要加载，开启此项以提高性能。

ShuutUp：如果为 true，则进一步减少日志输出。默认 false。

ShuuutUp：如果为 true，除非遇到错误，否则不会有任何日志输出。默认 false。

EnableChineseConsoleLog：将 CSharpLoader 控制台的代码页设置为 UTF-8，以正确显示中文控制台日志。默认 true。（如果你需要在控制台中使用其他字符，请关闭此项。）

4.3.注意： 如果你想修改一张表中的多条记录。

你的数据文件应 只 包含已修改的记录，以避免冲突。（因为这就是使用此加载器的全部意义。）

（如果你需要 DataEditor 中的 “删除除此以外的任何内容” 按钮。

你可以等待 DataEditor 作者添加它。

或使用 我的 Data Editor 分支。）

**5.**以下表不受支持。

剧透

UISettingControlDesc

ScrollDesc

ActivityTaskDesc

ActivityDesc

CombatSkillDesc

FUStCollectionSpawnInfoDesc

6.注意同名但不同 id 的物品。

例如，

一种药可能在物品表中有一个配方物品和一个药品物品，名称相同。但它们是不同的。

一件装备可能在装备表中每一级都有若干条记录。

一个根骨被动效果也可能每一级都有若干条记录。

等等。

7.注意仅在初始化时从 desc 表读取的数据。

例如，

TransQiTianDaShengConfigDesc 表用于初始化 BUS_QiTianDaShengComp。

如果你在开始游戏后重新加载该表，它可能不会生效，因为初始化函数尚未再次调用。

数据文件示例：

你可以在文件页面下载以下示例。

100_增加一个珍玩套装(君子牌风铎仙篆)增加火抗

200_锦鳞套加2条套装效果_日金乌套改为加大量攻防

300_青田葫芦改为10口上限

400_金箍棒(大圣套)添加天龙棍效果

500_行者套改为1件即可触发

600_InsertData_插入全局设置和被动技能映射

将现有 mod 转换为数据文件版本的示例

你可以使用 DataEditor 查看它们具体做了什么。

（注意，有些示例修改同一张表，它们可以同时工作。

并且每个示例数据文件只包含必要的记录。）

手动安装：

0.安装 CSharpLoader（>= v0.0.8）

（注意，较低版本的此 mod 可能无法与最新 CSharpLoader 一起工作。如果你想升级 CSharpLoader，建议也升级此 mod）https://www.nexusmods.com/blackmythwukong/mods/19

1.下载 zip 文件并解压。

将 [ModName] 文件夹复制到 *[GameFolder]\b1\Binaries\Win64\CSharpLoader\Mods*

目录结构应如下：

-- b1\Binaries\Win64\CSharpLoader\Mods\

-- [ModName]

    -- [ModName].dll

通过 Vortex 安装：

支持