更新日志
0.3.0(Windows,pre-release)
Windows 版加载器:和 Android 版同一套 Lua 宿主、模组加载脚本、反射层和 kmod.h,平台相关的部分重写。见安装(Windows)、Windows 版是怎么工作的。
- 注入:
dwmapi.dll代理(99 个导出转发到系统库),不改游戏文件;核心在单独的线程里加载。 - 引擎地址:全部运行时从 PE 映像里找(
GObjects、GNames、ProcessEvent、Blueprint 解释器和GNatives),不带写死的偏移。 - x64 内联钩子(Zydis):重定位 RIP 相对寻址和相对跳转,安装时挂起其他线程。
- 布局检查:启动时抽样验证反射层的结构偏移,不自洽就不加载模组。
- 开发版:控制台窗口、对象转储(
dump objects)、热加载脚本(见开发版控制台)。 - C++ 模组:
kmod.h级别 3,同一份源码可以编成 Android 的.so或 Windows 的.dll;mod.json的native可以按平台写成表{"Android": "...", "Windows": "..."};api->platform。见 C++ 模组。 - 网络:WinHTTP(
Http,用系统代理)、Winsock(TCP / UDP)、SChannel(TLS,用系统证书)。 - 没有的:pak 模组(没有
paks文件夹)、原生模组的 Android UI / JNI 接口。 - 修复了一批只在 Windows 上出现的问题:
ProcessEvent的虚表槽位、属性的ArrayDim/ElementSize偏移(Windows 与 Android 不同)、.private目录创建、安全模式对短时间运行的误判。
Android 版同步:kmod.h 升到级别 3(platform 字段),mod.json 的 native 支持按平台的表。
0.3.0 Android
安卓版加载器 0.3.0:C++ 原生模组、包格式 2、UE4SS 兼容补齐、网络层、安装器。
Worker:独立线程、独立 Lua 状态,消息通信(见 Worker);ExecuteAsync(别名)。FastLoop,NotifyOnNewObject的快速模式;新对象检测改为比较槽位序号,不再漏掉被复用的槽位。kmod/paks/里的 pak 启动后自动挂载,优先级高于游戏自带 pak(见 Pak 模组)。- 控制台指令
paks(可开关单个 pak)、safe、unquarantine、selftest。 - 版本抗性:
GObjects、GNames、ProcessEvent、pak 挂载函数改为运行时验证和查找,写死的偏移失效时自动重新定位,找不到时安静地不活动(见版本支持)。 - 崩溃保护:记录崩溃时正在运行的模组或 pak,下次启动隔离它;原因不明的连续崩溃进入安全模式(见崩溃保护)。
- pak 由核心在引擎就绪时挂载,比之前早约 5 秒。
Events(模组间事件总线)、Store(模组的持久化存储)、Mod.data_dir。- 游戏自身的网络:服务器重定向(
kmod/net/server.json,运行时修改内存里的服务器地址,不用重打包);Net(观察、修改游戏收到的 WebSocket 消息,连接状态,Net.send),权限game_network。 - 模组的网络:WebSocket 客户端、TCP(可选 TLS)、UDP;
Http.download流式下载到文件,带进度。 - 钩子里给字符串参数赋值现在可用(引擎分配的副本)。
- 自定义界面:
UI(UI.window、toast),用游戏自己的控件搭窗口。 - 网络:
Http(get、post、request),需要mod.json声明permissions: ["network"]。 - 布局检测与缓存:用 MobileDumper-7 的检测在游戏进程里取得引擎的结构布局,按游戏版本缓存,和核心里的 SDK 对比;不一致时不加载模组(见版本支持)。控制台
layout。 - 运行时反射布局:核心的反射读取改走
reflect.h的运行时布局表,检测到的引擎布局会被采用;引擎函数按类名、函数名、参数名调用,不再用 SDK 强类型包装。布局偏移变了不必重编译核心(见版本支持)。 - 安装器(Android 应用):在手机上选游戏、检查、注入、签名并安装,不需要电脑(见安装器)。
- 核心启动时就创建
mods、paks、data目录。 inbox文件夹取消:模组文件夹和.kmod文件统一放进kmod/mods/。加载器启动(和打开 Mods 页)时把它们同步到应用的私有目录再加载:文件夹复制,.kmod自动解压;原文件保留,删除后私有副本跟着删除。C++ 原生模组的库也因此不再需要再复制一次。- 注入工具(
tools/kmod_inject.py):检查 APK 能不能注入(引擎库、启动类、防篡改、是否已注入),并生成注入后已签名的 APK。启动类从清单读出,不再写死SplashActivity。见注入工具。 - 核心的版本依赖:包名运行时读取;
FFrame偏移运行时学习;启动自检(金丝雀)验证对象表、FString、FText、TArray布局,不对就不加载模组。 - C++ 模组:
mod.json的native字段,库先复制到私有目录再加载;kmod.h提供稳定的 C 接口(内联钩子、签名扫描、反射、UFunction 钩子、tick、注册 Lua 函数);模板kmod-native-template;内联钩子能重定位开头 4 条指令里的ADR/ADRP/LDR/B/BL。见 C++ 模组。 - C++ 模组的界面(接口级别 2):
ui_show/ui_set/ui_close,用普通 Android 控件(开关、滑块、输入框、下拉、按钮)在游戏上弹出面板,不依赖游戏的 UI 控件;另有原始 JNI 接口。见 C++ 模组。 - 包格式 2:
mod.json新增platform(Android、Windows,可多选;缺省 = 所有平台)。当前平台不在列表里的模组显示“不适用于本平台“,不加载。format接受 1 和 2。 - UE4SS 兼容补齐(见 UE4SS 兼容):钩子回调的返回值可替换函数返回值;延迟动作句柄一整套(
MakeActionHandle、ExecuteInGameThreadWithDelay、LoopInGameThread*、Pause/Cancel…);RegisterBeginPlay/EndPlay/InitGameState/LoadMap/ProcessConsoleExec钩子、RegisterCustomEvent、RegisterCustomProperty;StaticConstructObject、ForEachUObject、FindObjects、LoadExport、线程查询、DumpAllObjects/Actors、模组重启/卸载;对象方法IsChildOf、GetSuperStruct、ForEachProperty/Function、get;TMap/TSet可读、TMap值可原位修改;委托属性(Broadcast、Execute、IsBound、GetBindings、Clear);FString/FText属性可写,数组可原位写。 - 原生函数钩子:蓝图虚拟机直接调用的原生函数也能钩了(参数可读可改),
GNatives在运行时从解释器里定位。Net.on_send、Net.on_open补齐。 - 蓝图脚本函数钩子:
RegisterHook现在钩在引擎执行蓝图字节码的解释器上,能看到所有蓝图函数调用(包括蓝图直接调蓝图,之前完全看不到),参数可读可改,后置回调里能读返回值(见钩子)。 - 修复:
GetName()曾在反射改造后多出实例编号后缀(ScaleBox_2),导致 Mods 页找错控件,已恢复。 - 心跳:用引擎定时器驱动 tick,游戏静止时定时器不再停摆(之前在静止画面上
ExecuteWithDelay(300)可能拖到几十秒)。 - UObject 句柄现在也比较槽位序号,对象被销毁、槽位被复用后旧句柄不会指向新对象。
Lua API
- 查找:
FindFirstOf、FindAllOf、FindObject、StaticFindObject、CreateInvalidObject。 - 资源:
LoadAsset(同步加载 pak 内容);obj:GetPathName()。 - 钩子与定时:
RegisterHook、UnregisterHook、ExecuteWithDelay、ExecuteInGameThread、LoopAsync、NotifyOnNewObject。 - 模组环境:
Mod、Log、Settings、Lang、Console、require、kmod。
工具
- 控制台指令系统:
help、version、mods、enable、disable、reload、lang、settings、log、find、search、props、funcs(带参数类型)、hook/unhook/hooks(监听函数调用并打印参数)、typegen(生成 LuaLS 类型声明),模组可注册指令。 - 日志:滚动文件日志(保留 5 次运行),原生崩溃处理写入
FATAL回溯。
数据位置
- 所有数据放在共享存储的
Android/media/<包名>/kmod/:游戏不需要存储权限,文件管理器和adb放进去的文件游戏都读得到;旧位置的数据首次启动时自动搬迁。
已知缺口
- 只有 Android(Windows 版见上面的 Windows 条目)。
- 没有 USMAP / SDK 头文件转储(
DumpAllObjects、DumpAllActors有)。 - 安装器和注入工具只处理完整 APK,分包安装的应用暂不支持。
0.2.0
首个有文档的版本(Android,KARDS 1.61)。
加载器
- 无 root:重新打包并签名 APK,
SplashActivity静态初始化里加载libkmod.so,再加载核心。 - 内联钩子
UObject::ProcessEvent,Lua 5.4 运行在游戏线程上。 - 开发版 / 正式版两种构建;开发版有悬浮控制台、热加载核心和脚本。
模组
.kmod包格式(format 1):mod.json、main.lua、lang/*.json;包和用户数据分开。- 设置项:
bool、number、choice、string。 - 依赖:
id加版本条件(>=、>、<=、<、=,逗号分隔),保留 idkmod(加载器)和kards(游戏,只取前两段版本)。 - 本地化:12 种语言标签,回退链
zh-CN → zh → en → 默认文字 → 键名。 - 脚本报错自动禁用:钩子、定时器、新对象回调累计 10 次错误。
- 游戏内 Mods 页:嵌在设置界面,跟随游戏的 UI 缩放,显示名称、说明、版本、状态、启用开关和设置项。