安装 C++ Mod

安装 C++ Mod

  1. 本节假设已经为游戏安装 UE4SS，并确认其正常工作。若尚未安装，请参阅安装指南。
  2. 构建后会生成以下文件：
    • MyMods\Binaries\<Configuration>\MyAwesomeMod 中的 MyAwesomeMod.dll。
  3. 进入游戏可执行文件所在文件夹，打开 Mods，执行以下操作：
    • 在 Mods 中创建 MyAwesomeMod\dlls 文件夹结构。
    • 将 MyAwesomeMod.dll 移入 dlls 并重命名为 main.dll。

注意：保留 MyAwesomeMod.dll 文件名也可以。如果不存在 main.dll，UE4SS 会使用 MyAwesomeMod.dll。

最终结构如下：

Mods\
    MyAwesomeMod\
        dlls\
            main.dll
  1. 要让游戏加载 Mod，需编辑 Mods 文件夹中的 mods.txt。默认内容类似：
CheatManagerEnablerMod : 1
ActorDumperMod : 0
ConsoleCommandsMod : 1
ConsoleEnablerMod : 1
SplitScreenMod : 0
LineTraceMod : 1
BPModLoaderMod : 1
jsbLuaProfilerMod : 0



; Built-in keybinds, do not move up!
Keybinds : 1

在 Keybinds 上方添加以下行，即可启用 MyAwesomeMod：

MyAwesomeMod : 1

另一种方式是在 MyAwesomeMod 文件夹中放置名为 enabled.txt 的空文本文件。不建议使用此方式，因为它绕过 mods.txt，无法指定加载顺序；但对最终用户而言，安装可能更容易。

  1. 启动游戏。如果操作正确，UE4SS 控制台靠近顶部的位置（所有扫描开始之前）应显示蓝色的 MyAwesomeMod says hello。如果注册了 on_unreal_init 回调，还应在扫描完成后立即看到蓝色的 Object Name: /Script/CoreUObject.Object。

自动化

了解上述流程后，可以使用 UE4SS CPP Template 仓库，自动完成 Mod 创建、构建和安装。注意，new_mod_setup.bat 会检出最新发布版本对应的提交，以确保 Mod 使用与最新发布版一致的 ABI 构建。

注意：所有影响 Mod 模板的构建系统变更都会先推送到 dev 分支，在发布新 UE4SS 版本时再合并至 main。这样可以确保模板始终与最新 UE4SS 发布版保持同步。

原文：docs/guides/installing-a-c++-mod.md · 固定提交 560411f18512 · 来源与 MIT 许可