安装(Windows)
Windows 版 kmod 是两个文件:一个 dwmapi.dll(代理)和一个 kmod_core.dll(核心)。放进游戏的程序目录,不需要改游戏本体、不需要管理员权限。
需要什么
- Windows 10 / 11,64 位。
- Steam 或官方启动器安装的 KARDS(已在 1.61、UE 5.6 上测过)。
- 到 Releases 下载:
kmod-loader-windows-<版本>-release.zip:正式版,日常使用。kmod-loader-windows-<版本>-dev.zip:开发版,多一个控制台窗口和更详细的日志,写模组时用(见开发版控制台)。
安装步骤
-
关掉游戏。
-
找到游戏的程序目录,也就是放着
kards-Win64-Shipping.exe的那个:<游戏>\kards\Binaries\Win64\ -
把压缩包里的
dwmapi.dll和kmod文件夹复制到这个目录。 -
启动游戏。
Warning
如果这个目录里已经有
dwmapi.dll(比如 UE4SS 也是用dwmapi.dll注入的),先把它改名,例如dwmapi.dll.disable。两个加载器不能同时占用这个名字。
目录
第一次启动后,kmod 文件夹里会出现:
<游戏>\kards\Binaries\Win64\
├── dwmapi.dll # 代理:游戏启动时被加载,转发系统 dwmapi 的全部导出,并启动核心
└── kmod\
├── kmod_core.dll # 核心
├── mods\ # 模组:文件夹,或 .kmod 文件
├── data\<id>\ # 模组的用户数据(设置值)
├── logs\ # kmod.log 等日志(保留最近 5 次)
├── state.json # 启用列表和语言
├── boot\ # 崩溃保护的状态
├── net\ # 服务器重定向配置(可选)
└── .private\ # 加载器自己用:模组的私有副本
Windows 版没有 paks 文件夹:不加载 pak 模组。
装模组就是把文件放进 kmod\mods\:模组文件夹或 .kmod 文件。加载器启动时,或者你打开 Mods 页时,会把它们同步到 kmod\.private\mods\(.kmod 自动解压)再从那里加载。你可以在游戏运行时替换 mods\ 里的文件,下次同步时生效。
模组默认是关闭的。在游戏里启用:
- 设置页左侧的 Mods 标签。
确认装好了
- 设置页右下角出现
kmod 0.3.0 release(开发版是dev)。 - 设置页左侧多一个 Mods 标签。
kmod\logs\kmod.log的第一行是=== kmod loader 0.3.0 (release, Windows) started ===。
如果游戏起不来,或者没有出现 Mods 标签,看 kmod\logs\kmod.log;如果连 kmod\logs 都没有,看 kmod\proxy.log,里面会写代理没能加载核心的原因。
卸载
删掉 dwmapi.dll(需要的话连同 kmod 文件夹),游戏就恢复原样。加载器不修改游戏的任何文件。
更新
覆盖 dwmapi.dll 和 kmod\kmod_core.dll。mods、data、state.json 保持不变。
常见问题
游戏显示崩溃或启动不了。 连续几次没有正常走到稳定状态,kmod 会自动进入安全模式(不加载任何模组)。在开发版控制台里输入 safe off 可以退出安全模式。
走了系统代理。 模组的 Http、WebSocket 请求使用系统的代理设置(和浏览器一样)。