原神帧率解锁器注入机制全解:Shellcode 载荷 + NtCreateThreadEx 远程线程创建
原神帧率解锁器注入机制全解:Shellcode 载荷 + NtCreateThreadEx 远程线程创建
Genshin_StarRail_fps_unlocker 是一款专为原神(Genshin Impact)与崩坏:星穹铁道(Honkai: Star Rail)设计的帧率解锁工具。它通过 Shellcode 载荷注入 与 NtCreateThreadEx 远程线程创建 技术,绕过游戏自带的 60 FPS 上限,无需内核驱动即可完成代码写入。本文从外部注入程序视角,完整解析该项目的注入架构、Shellcode 载荷结构、远程线程执行流程及自研 syscall 调用链,帮助读者理解现代 Windows 代码注入的典型实现路径。
为什么需要代码注入而非简单内存写入?
早期版本仅通过 WriteProcessMemory 直接改写游戏内存中的 FPS 值,但米哈游后续版本加入了运行时完整性校验。若仅改写内存而不做 Hook,游戏会在下一帧重新将 FPS 写回上限值,或者触发反作弊检测。
因此当前版本的策略升级为:
- 完整 Shellcode 载荷注入:在目标进程中开辟 0x4000 字节的可执行内存,将一段自包含的 x64 机器码写入其中
- 函数级 Hook:Shellcode 运行时动态 Patch 游戏内部的 FPS 设置函数,使其始终读取解锁器下发的目标帧率
- 远程线程触发:通过
NtCreateThreadEx在目标进程中创建新线程,跳转至 Shellcode 入口执行初始化
核心源码集中在 src/main.cpp 的 inject_patch() 函数(L1419-L1609)。
注入全景流程图
整个注入过程可分为 5 个阶段,以下以原神为例:
┌─────────────────────────────────────────────────────────────┐
│ 1. 启动游戏(CREATE_SUSPENDED 挂起状态) │
├─────────────────────────────────────────────────────────────┤
│ 2. 定位 UnityPlayer.dll 的 .text 代码段 │
│ → 读取 PE 头 → 获取节区虚拟地址 │
├─────────────────────────────────────────────────────────────┤
│ 3. 特征码扫描(Pattern Scan) │
│ → SSE/AVX2/AVX512 加速的 SIMD 扫描器 │
│ → 定位 FPS 写入函数、UI Hook 点、验证函数等 │
├─────────────────────────────────────────────────────────────┤
│ 4. 构建并写入 Shellcode 载荷 │
│ → 本地 VirtualAlloc 组装载荷 │
│ → WriteProcessMemory 写入目标进程 0x4000 区域 │
│ → VirtualProtect 设为 PAGE_EXECUTE_READWRITE │
├─────────────────────────────────────────────────────────────┤
│ 5. NtCreateThreadEx 创建远程线程 → 执行 Shellcode │
│ → 等待线程完成 → 恢复游戏主线程(ResumeThread) │
└─────────────────────────────────────────────────────────────┘
Shellcode 载荷:自包含的 x64 机器码
载荷来源
Shellcode 以十六进制常量数组的形式硬编码在 src/shellcode_header.h 中,分为两块:
| 常量 | 说明 | 大小 |
|---|---|---|
_shellcode_Const[] |
主 Shellcode 载荷,包含 FPS Hook、UI Hook、节能模式等功能 | 0x4000 字节 |
_PE_MEM_LOADER[] |
轻量 PE 加载器,用于 -loadlib 参数注入第三方 DLL |
独立代码段 |
主 Shellcode 内部定义了多个子函数入口点(shellcode_header.h#L327-L331):
shellcode_entryVA = 0x1D0 // 主入口
HKSR_UISet_FuncVA = 0x220 // 星穹铁道 UI 设置
GI_UnHooked_UI_fVA = 0x240 // 原神 UI 取消 Hook
GI_hooked_Vfunc_VA = 0x2D0 // 原神 Hook 验证函数
PowerSaveSet_FuncVA = 0x560 // 低功耗模式
运行时 Patch(载荷定制)
Shellcode 并非"原样"写入。在 main.cpp#L1419-L1568 的 inject_patch() 中,解锁器会在本地内存中先组装载荷,再根据当前游戏状态动态 Patch 特定偏移处的常量:
- 偏移 0x00:写入解锁器自身的 PID
- 偏移 0x08:写入
FpsValue变量地址(跨进程内存映射,Shellcode 直接读取目标帧率) - 偏移 0x80/0x88/0x90:写入
MessageBoxA、CloseHandle、GetForegroundWindow的导出地址(供 Shellcode 内部调用,无需 IAT) - 偏移 0x10:原神 FPS 设置函数的远程地址
- 偏移 0x18:星穹铁道的 FPS 指针地址 / 原神的私有缓冲区地址
- 偏移 0x150/0x158:原神 30/60 帧档位的映射目标值
这种"模板 + 运行时 Patch"的设计使得同一段 Shellcode 可以适配不同游戏版本和配置。
设计亮点:Shellcode 是位置无关代码(PIC),不依赖任何导入表,所有 API 地址都在运行时由外部注入器填入,这使得它可以在目标进程的任何内存地址上执行。
特征码扫描:在 GB 级代码段中定位目标函数
在注入前,解锁器需要精确定位游戏代码中的多个关键函数。这些函数的地址每个版本都可能变化,因此采用特征码(Signature)扫描而非硬编码地址。
SIMD 加速扫描器
PatternScanRegionEx() 函数(main.cpp#L166-L587)实现了三级硬件加速:
| CPU 特性 | 检测方式 | 扫描宽度 |
|---|---|---|
| AVX512 | CPUID + _xgetbv 检查 |
64 字节/块 |
| AVX2 | CPUID EAX=7, EBX bit5 |
32 字节/块 |
| SSE2 | 基线(所有 x64 CPU 支持) | 16 字节/块 |
工作原理:
- 将特征码拆分为"有效字节"和"通配符(
??)"两类 - 用 SIMD 指令一次比较 16/32/64 字节,生成匹配位掩码
- 对掩码中的置位逐一验证完整特征码是否匹配
- 支持多结果返回(
PatternScanInfo结构体)
典型特征码示例
原神 FPS 写入函数的特征(main.cpp#L2165):
66 0F 6E 0D ?? ?? ?? ?? 0F 57 C0 0F 5B C9
这对应 movd xmm0, dword ptr [rip+???????]; xorps xmm0, xmm0; cvtsd2ss xmm1, xmm0,即 FPS 浮点值的读取指令序列。
NtCreateThreadEx:远程线程创建的核心
为什么不用 CreateRemoteThread?
Windows API 的 CreateRemoteThread 最终也会调用 NtCreateThreadEx,但它经过 Kernel32 → Ntdll 的多层转发。本项目的目标是不依赖任何 ntdll 导出函数(避免被 API Hook 检测到),因此直接构造系统调用。
自研 syscall 调用链
项目通过 src/NTSYSAPI.h 实现了一套完整的用户态 syscall 基础设施:
第一步:动态解析 syscall 编号
ParseSyscallscNum() 函数(NTSYSAPI.h#L899-L946)扫描 ntdll 中目标函数的机器码,提取 mov eax, imm32 指令中的 syscall 编号。编号不是硬编码的,而是每次启动时从当前系统版本的 ntdll.dll 中动态提取——这意味着即使 Windows 大版本更新改变了 syscall 表,只要 ntdll 导出名不变,工具依然可用。
第二步:构建 syscall 蹦床(Trampoline)
init_syscall_buff() 函数(NTSYSAPI.h#L1505-L1627)在一段可执行内存中动态生成 16 个独立的 syscall 调用桩。每个桩的指令序列为:
mov rax, <syscall_number> ; 加载 syscall 编号
jmp <callreturn> ; 跳转到汇编 trampoline
第三步:汇编 trampoline 执行真正的 syscall
src/syscall.asm 中的 asm_syscall 过程(syscall.asm#L4-L51)完成了最关键的伪装:
- 保存 RCX/R10(syscall 参数寄存器)
- 在栈上构建一个伪造的 syscall 栈帧,其中包含随机的
KUSER_SHARED_DATA相关字段 - 通过
int 0x2E(syscall指令的字节0F 05)进入内核 - 返回后恢复栈帧
伪造栈帧的目的是让内核在返回时读取到的 KiSystemCall64 上下文与正常 ntdll 调用一致,从而绕过基于栈帧校验的反作弊 Hook。
CreateRemoteThreadEx 的调用
static HANDLE WINAPI CreateRemoteThreadEx_Internal(
HANDLE hProcess,
LPSECURITY_ATTRIBUTES lpThreadAttributes,
LPTHREAD_START_ROUTINE lpStartAddress,
LPVOID lpParameter)
{
// 通过自研 syscall 蹦床直接调用 NtCreateThreadEx
NTSTATUS status = DecAPI->NtCreateThreadEx(
&retHandle, GENERIC_ALL, 0,
hProcess, // 目标进程句柄
lpStartAddress, // Shellcode 入口地址
lpParameter, // 参数(可选)
0, 0, 0xC000, 0x30000, 0 // 默认栈大小
);
return retHandle;
}
调用位置在 main.cpp#L1582-L1586:
hThread = CreateRemoteThreadEx_Internal(
Tar_handle, 0,
(LPTHREAD_START_ROUTINE)((uint64_t)Remote_payload_buffer + shellcode_entryVA),
NULL);
线程启动后,WaitForSingleObject(hThread, 1000) 等待 Shellcode 初始化完成(最多 1 秒),然后通过 GetExitCodeThread_Internal 检查线程是否异常退出。
注入全流程代码走读
以下按执行顺序梳理 main() 中的关键调用链(main.cpp#L1915-L2522):
阶段 1:挂起启动游戏
// main.cpp L2000
CreateProcessW_p(..., CREATE_SUSPENDED | GamePriorityClass, ...);
游戏主线程在创建后处于挂起状态,此时游戏尚未执行任何代码,是注入的最佳窗口期。
阶段 2:定位 UnityPlayer.dll
// main.cpp L2031 - 通过 PEB 读取模块基址
Unityplayer_baseAddr = RemoteDll_Inject(pi->hProcess, 0);
RemoteDll_Inject 在 DllPath == NULL 时仅读取 PEB 中第一个模块(主 exe)的基址,再通过 PE 解析获取 UnityPlayer.dll 的加载地址。
阶段 3:特征码扫描
将 UnityPlayer.dll 的 .text 段完整读入本地内存,然后对多组特征码执行 SIMD 加速扫描,定位:
- FPS 写入函数地址(
pfps) - 移动端 UI 函数地址(
Bootui) - 验证 Hook 点(
verfiy) - DPI 获取函数(
Func_getDPI) - 线程入口 OEP(
payloadoep,用于将 Shellcode 线程伪装为游戏自身的线程)
阶段 4:Shellcode 写入 + 远程线程
// main.cpp L1459 - 在目标进程分配 0x4000 可读写内存
Remote_payload_buffer = VirtualAllocEx_Internal(Tar_handle, NULL, 0x4000, PAGE_READWRITE);
// main.cpp L1571 - 将组装好的 Shellcode 写入
WriteProcessMemoryInternal(Tar_handle, Remote_payload_buffer, _sc_buffer, 0x4000, 0);
// main.cpp L1577 - 修改页保护为可执行
VirtualProtectEx_Internal(Tar_handle, Remote_payload_buffer, 0x4000, PAGE_EXECUTE_READWRITE, 0);
// main.cpp L1586 - 创建远程线程执行 Shellcode
hThread = CreateRemoteThreadEx_Internal(Tar_handle, 0,
(LPTHREAD_START_ROUTINE)((uint64_t)Remote_payload_buffer + shellcode_entryVA), NULL);
阶段 5:恢复游戏
// main.cpp L2444-L2445
SetThreadPriority(pi->hThread, THREAD_PRIORITY_TIME_CRITICAL);
ResumeThread_Internal(pi->hThread); // NtResumeThread → 游戏主线程开始运行
附加功能:DLL 内存注入(-loadlib 参数)
除了帧率解锁,解锁器还支持通过命令行参数注入任意 DLL:
unlocker.exe -Genshin -loadlib C:\Path\To\plugin.dll
这里有两种注入模式(main.cpp#L1612-L1810):
| 模式 | 函数 | 原理 |
|---|---|---|
| 标准 LoadLibrary 注入 | RemoteDll_Inject() |
写入 DLL 路径 + 一小段调用 LoadLibraryW 的 Shellcode,创建远程线程执行 |
| 内存加载注入 | RemoteDll_Inject_mem() |
将 DLL 文件内容读入目标进程内存,使用 _PE_MEM_LOADER 手动解析 PE 节区并映射,不触发 LoadLibrary 回调 |
内存加载模式更加隐蔽,因为目标进程的模块列表中不会新增任何条目。
关键源文件索引
| 文件 | 作用 |
|---|---|
| src/main.cpp | 主程序:进程管理、特征码扫描、注入流程、热键监听 |
| src/shellcode_header.h | Shellcode 十六进制常量 + 内部函数入口点定义 |
| src/NTSYSAPI.h | 自研 Nt* 系统调用封装、syscall 编号解析、蹦床构建 |
| src/syscall.asm | MASM 汇编:syscall 栈帧伪造与 int 0x2E 执行 |
| src/inireader.h | INI 配置文件解析(hoyofps_config.ini) |
| CMakeLists.txt | 构建配置(MSVC + MASM,要求 Win64) |
安全与兼容性说明
- 仅帧率解锁不会导致封号:官方已知晓此工具的存在,但仅针对 FPS 修改不做处罚(见 README_zh_cn.md#L54)
- DLL 注入功能有风险:使用
-loadlib加载第三方插件时,解锁器会弹出警告提示(main.cpp#L2422) - 放置位置:解锁器不要放在游戏目录内,否则会被游戏的文件完整性检测误判为游戏文件,触发
31-4302错误 - 管理员权限:必须以管理员身份运行,因为解锁器负责启动游戏进程,而游戏本身需要高权限
- 当前帧率上限:由于曾出现滥用情况,最大帧率已限制为 240 FPS
编译环境
使用 Visual Studio 2022 Community 或配置好 MSVC 的 VSCode,构建脚本见 CMakeLists.txt:
cmake_minimum_required(VERSION 3.15)
project(FPSUnlocker LANGUAGES C CXX ASM_MASM)
需要 MASM 汇编器支持(ASM_MASM),编译后生成 FPSUnlocker.exe。
上图展示了通过 Windows 快捷方式为解锁器添加自定义启动参数的配置方式——在"目标"栏的 exe 路径后追加 -Genshin -screen-width 3840 ... 等参数,即可实现一键启动特定分辨率和帧率设置。
