ModProfile (.me3文件) 配置参考

什么是ModProfile (.me3文件)配置？

ModProfile 配置 是一个版本化的 TOML 文件，它告诉me3要加载哪些mod，如何加载，以及它支持的游戏。它是你的mod设置的一个清单, 列出了游戏资产覆盖包（packages）和本地的DLL（natives），带有可选的加载顺序。

• 如何使用： me3 读取ModProfile (.me3文件) 以了解需要加载的模组以及顺序。 您可以通过双击它(在Windows中) 或使用 CLI (me3 launching --profile my-profile.me3)来启动一个配置文件。
• 版本化： profileVersion字段确保配置文件的格式在发生破坏性变更后，旧版本配置仍能保持兼容性。
• 灵活性： 配置文件（.me3文件）支持任意位置存储，可引用相对路径或绝对路径，并保持对 me3 新功能特性的兼容。

配置示例（.me3文件）

profileVersion = "v1"

[[packages]]
id = "my-cool-texture-pack"
path = 'mods/MyCoolTexturePack/'

[[packages]]
id = "my-cool-model-pack"
path = 'mods/MyCoolModelPack/'

[[natives]]
path = 'mods/MyAwesomeMod.dll'

解析配置示例

• ProfileVersion：这是为me3编写此配置文件的版本。 它允许在对配置文件格式进行破坏性更改后，旧版本配置文件继续正常工作。
• [[packages]]：每个块定义一个游戏资产覆盖包。 id 是包的唯一名称， path 指向包含mod文件的文件夹。 您可以通过添加更多的 [[packages]] 来添加多个包，每个 [[packages]] 都有唯一的id。 请注意，我们在这里使用单引号，以避免在Windows路径中转义反斜杠。
• [[natives]]：每个块定义一个要加载的 DLL mod。 path指向DLL文件。 您可以通过添加更多的 [[natives]] 来添加多个DLL mod。

参考

下方提供Mod Profile（.me3文件）的格式规范。

Mod Profile (.me3文件) 格式规范

v1版本

• profileVersion (必填): 只能是: "v1"。
• savefile (非必填): 这个可选字段指定游戏将使用的存档文件的文件名，而不是默认的(例如：Elden Ring中的ER0000.sl2)。
• start_online (非必填): 默认情况下，me3会阻止游戏连接到官方多人游戏匹配服务器。 此功能可重新启用。默认值: false。
• supports (必填): 设置要启动的游戏。格式参考：Supports。
• natives (非必填): 将要加载的dll文件路径列表。格式参考：Native。
• packages (非必填): 游戏资产覆盖包。格式参考：Package。

v1版本配置示例

profileVersion = "v1"

savefile = "MyModdedSave.sl2"
start_online = true

[[supports]]
game = "eldenring"

[[natives]]
path = 'SeamlessCoop/ersc.dll'

[[natives]]
path = 'C:/Users/admin/Desktop/ErdTools.dll'
enabled = false

[[packages]]
id = "默认游戏资产覆盖包"
path = 'eldenring-mods'
enabled = false

[[packages]]
id = "default-eldenring"
path = 'C:/Users/admin/Desktop/mod'

注意事项

配置文件内所有标点符号都为英文，文件路径(比如path)需要用 单引号 包裹

Supports

• game (必填): 要启动的游戏。格式参考：Game。
• since (非必填): (暂无实际作用)

Game

me3支持的游戏列表

• 任选一个
  • 黑暗之魂3 (Steam App ID: 374320). 必须其中一个: ["darksouls3", "ds3"].
  • 只狼：(Steam App ID: 814380). 必须其中一个: ["sekiro", "sdt"]。
  • 艾尔登法环: (Steam App ID: 1245620). 必须其中一个: ["eldenring", "er", "elden-ring"]。
  • 机甲核心6: (Steam App ID: 1888160). 必须其中一个: ["armoredcore6", "ac6"]。
  • 黑夜君临: (Steam App ID: 2622380). 必须其中一个: ["nightreign", "nr", "nightrein"]。

Native

• path (必填): dll文件路径，支持相对路径(相对于.me3文件)和绝对路径。
• enabled (非必填): 是否启用此DLL。默认值: true。默认启用。
• load_early (非必填): 是否在游戏初始化之前加载它。默认值: false。
• finalizer (非必填): 这是一个可选的符号（函数指针），当该dll成功加入卸载队列时将被调用。
• initializer (非必填): 一个可选符号（函数指针），在dll成功加载后调用。
• load_after (非必填): 默认值: []。
• load_before (非必填): 默认值: []。
• optional (非必填): 如果此dll加载失败且此值为false，则将其视为严重错误。默认值: false。

Package

游戏资产覆盖包(相当于mod引擎2中的mod文件夹)

• id (非必填): 覆盖包的唯一名称。
• path (必填): 游戏资产覆盖包路径。支持相对路径(相对于.me3文件)和绝对路径。
• enabled (非必填): 是否启用。默认值：true。默认启用。
• load_before (非必填): 应在此包加载前加载的包ID列表。 默认值: []。
• load_after (非必填): 应在此包加载后加载的包ID列表。 默认值: []。