Akebi-GC 入门指南:构建获取、注入启动流程与功能模块全景解析
Akebi-GC 入门指南:构建获取、注入启动流程与功能模块全景解析
导读
本文以 Akebi-GC 仓库的 README.md 及其简体中文版 README_zh-Hans.md 为核心骨架,系统讲解该项目的获取方式(稳定版 Release 与最新版 Action 构建)、注入启动流程、配置文件体系与六大类功能模块。同时结合仓库内 injector/、cheat-base/、cheat-library/ 的实际源码,从进程创建、DLL 注入、IL2CPP 初始化、事件 Hook 到热键系统逐层还原底层实现,帮助读者在拿到成品之外,真正理解这个基于 Windows + C++/ImGui 的注入式辅助框架是如何运转的。
项目状态与版本说明
在开始之前需要先了解项目的分发状态。仓库 README 顶部有明确的公告:项目作者近期收到了来自 HoYoverse 的 DMCA 下架通知,因此最新版本的源代码已转为私有,仅对贡献者开放;公开仓库只上传稳定版(Stable Release)构建产物。这意味着:
- 普通用户应通过 Release 或 CI 构建产物获取可运行版本;
- 想要获取最新源码并自行编译的开发者,需要先通过贡献渠道与维护者建立联系,或使用仓库中已公开的历史源码进行学习研究。
README 同时提供了多语言入口,本文内容与以下文档相互补充:
获取方式:稳定版与最新版
按 README 的指引,项目提供两条下载路径,按需求二选一即可。
稳定版(Stable Release)
- 前往仓库的 Releases 页面;
- 下载最新的二进制压缩包,解压后即为完整的可运行目录。
稳定版适合大多数普通用户:经过了维护者验证,功能相对保守但稳定性更高。
最新版(Latest Release,CI 构建)
- 前往仓库的 Actions 页面;
- 选择
Publish工作流程,选取最近一次带绿色勾的构建记录; - 关键:按你的客户端版本选择对应的构建目标——
GLOBAL(国际服)/CN(国服)/BETA(测试服),不同客户端对应不同的游戏进程与函数地址,选错将无法正常注入; - 在本次构建的 Artifacts 中下载
Akebi-GC-release即可。
最新版基于当前主分支源码构建,通常包含最新的功能与修复,但也可能引入新的问题,适合愿意尝鲜并参与反馈的用户。
自行编译:仓库结构速览
README 指出源码构建方法可参考项目 Wiki 中的 "Building|建置" 页面。由于当前仓库源码已转为私有,此处基于仓库公开目录给出结构级指引,便于理解构建产物与源码的对应关系。
仓库由三个核心工程组成(解决方案文件为 akebi-gc.sln):
| 工程目录 | 构建产物 | 职责 |
|---|---|---|
| injector | injector.exe |
启动器:以挂起方式启动游戏进程、注入 DLL、恢复线程 |
| cheat-library | CLibrary.dll |
注入到游戏进程内的核心功能库(玩家/世界/传送/视觉/调试等) |
| cheat-base | 静态框架 | 供上面两个工程共用的基础库:配置系统、事件系统、注入、渲染、热键、日志、模式扫描等 |
编译产出物布局上,injector.exe 与 CLibrary.dll 必须位于同一文件夹,其余运行时文件(字体、地图数据、签名文件等)以资源形式编译进 DLL(见 cheat-library/res/res.rc,其中定义了 IMGUI_FONT(Ruda-Bold.ttf)、SIGNATURES(signatures.json)、MAPTEYVATDATA(map_teyvat.json)等 RCDATA 资源)。
使用方法:注入启动三步走
按 README_zh-Hans.md 的官方说明,运行流程只有三步:
- 确认
CLibrary.dll与injector.exe位于同一个文件夹内; - 运行
injector.exe; - 等待游戏登录界面出现后,按下 F1 键打开 Akebi GUI。
以下结合源码把这三步背后的真实流程展开。
第 1 步:DLL 与启动器同目录
injector.exe 运行时会以自身路径所在目录为基准定位 DLL。见 injector/src/main.cpp:
std::string filename = (argc == 2 ? argv[1] : "CLibrary.dll");
std::filesystem::path currentDllPath = std::filesystem::current_path() / filename;
即默认注入 CLibrary.dll,也支持通过命令行参数传入自定义 DLL 文件名。
第 2 步:injector.exe 的完整注入流程
运行 injector.exe 后,主程序依次执行以下步骤(源码对应 injector/src/main.cpp):
- 等待游戏关闭:调用
WaitForCloseProcess轮询GenshinImpact.exe(国际服)与YuanShen.exe(国服)进程,确保没有残留的游戏实例后继续,随后再等待 1 秒卸载残留 DLL(WaitForCloseProcess实现在 injector/src/util.cpp,通过 Toolhelp32 快照枚举进程); - 读取配置:加载同目录下的
cfg.ini(ini.LoadFile("cfg.ini")); - 提权并挂起启动游戏:
OpenGenshinProcess内部先打开当前进程令牌,再通过explorer.exe的进程句柄构造PROCESS_THREAD_ATTRIBUTE_PARENT_PROCESS属性列表,最后以CreateProcessAsUserA+CREATE_SUSPENDED挂起方式创建游戏进程(见 injector/src/main.cpp); - 注入 DLL:在 Debug 构建下先将 DLL 复制到系统临时目录再注入(便于替换调试),Release 下直接注入原路径(见 injector/src/injector.cpp,其中
MANUAL_MAP宏切换手动映射ManualMapDLL与常规LoadLibraryDLL两种注入方式,实现在 cheat-base/src/cheat-base/inject/); - 恢复线程:注入完成后
Sleep(2000)等待 DLL 初始化,再ResumeThread(hThread)让游戏正式运行。
第 3 步:DLL 内初始化与 F1 菜单
DLL 被注入后,cheat-library/src/framework/dllmain.cpp 在 DLL_PROCESS_ATTACH 时创建线程执行 Run。Run(见 cheat-library/src/user/main.cpp)的初始化顺序为:
- 设置资源模块句柄与当前工作目录;
- 初始化配置系统(读取 DLL 同目录下的
cfg.json,config::Initialize(...)); - 按配置启用文件日志 / 控制台日志;
DebuggerBypassPre()预处理调试器检测;- 轮询等待
UserAssembly.dll(IL2CPP 核心程序集)加载; - 等待约 15 秒等待游戏初始化完成(Debug 构建为 10 秒 + 附加延迟);
DebuggerBypassPost()后处理;init_il2cpp()初始化 IL2CPP 运行时;cheat::Init()注册全部功能模块并安装事件 Hook。
菜单按键本身来自全局设置(cheat-base/src/cheat-base/cheat/misc/Settings.cpp):NF(f_MenuKey, "Show Cheat Menu Key", "General", Hotkey(VK_F1)),默认即 F1。同时提供 Fast Exit 快捷键(默认 F12)用于快速退出进程(见 OnExitKeyPressed,且菜单打开时不会触发)。
配置文件体系
整套工具运行时会读写以下文件(均位于 injector.exe / DLL 所在目录):
| 文件 | 用途 | 生成/读取方 |
|---|---|---|
cfg.ini |
注入器配置:游戏可执行文件路径(GenshinPath)、启动命令行(GenshinCommandLine),由 injector.exe 读写 |
injector/src/main.cpp |
cfg.json |
功能配置:所有功能字段、多配置档案(Profile) | cheat-library/src/user/main.cpp、cheat-base/src/cheat-base/config/Config.h |
imgui.ini |
ImGui 界面布局持久化 | cheat-base/src/cheat-base/render/renderer.cpp |
themes/ |
ImGui 主题 JSON 文件,可导入/导出/删除 | cheat-base/src/cheat-base/cheat/misc/Settings.cpp |
logs/ |
文件日志输出目录(需在设置中开启 File Logging) | cheat-library/src/user/main.cpp |
关于 cfg.ini 中的 GenshinPath,源码注释给出了明确提示:若启动失败,可手动在 cfg.ini 中修正游戏可执行文件路径(injector/src/main.cpp)。启动器首次运行时会弹出文件选择对话框,选择 GenshinImpact.exe 或 YuanShen.exe 后将自动写入配置并保存。
cfg.json 背后的配置系统值得注意:每个功能字段通过宏 NF/NFS 注册(见 cheat-base/src/cheat-base/config/Config.h),支持多配置档案(Profile)、字段级序列化、以及"共享字段/非共享字段"的区分——后者是实现多账号独立配置的基础。账号与配置档案的绑定逻辑见 cheat-library/src/user/cheat/GenshinCM.cpp:检测到账号切换(events::AccountChangedEvent)时自动 config::ChangeProfile 切换到该账号对应的档案。
功能模块全景
README 的功能列表在源码中均有一一对应的实现模块。所有功能通过 cheat-library/src/user/cheat/cheat.cpp 中的 manager.AddFeatures({...}) 注册,并按 SetModuleOrder 指定的顺序在 GUI 中排列:Player → World → Teleport → ESP → Visuals → Hotkeys → Settings → About → Debug。
通用(General)
- 过检测(Protection Bypass):见 cheat-library/src/user/cheat/misc/ProtectionBypass.cpp。通过 Hook
Unity_RecordUserData与CrashReporter,并在初始化时尝试关闭\Device\mhyprot2设备句柄; - 游戏内 GUI:基于 ImGui,通过 Hook 游戏渲染管线实现(DX11/DX12 后端,见 cheat-base/src/cheat-base/render/renderer.cpp);
- 快捷键(Hotkeys):集中式热键管理,见 cheat-library/src/user/cheat/misc/Hotkeys.cpp,支持搜索、按功能区块分组展示;
- 通知(Notifications):右下角 Toast 通知,延迟可调(默认 500ms,范围 1~10000ms)。
玩家(Player)
| 功能 | 实现文件 | 说明 |
|---|---|---|
| 上帝模式(God Mode) | player/GodMode.h | 无敌 |
| 攻击修改(Multi-Hit/Target/Animation) | player/RapidFire.h 等 | 多次攻击/多目标/多动画 |
| 无冷却(技能/大招/冲刺/弓箭) | player/NoCD.h | Skill/Ultimate/Sprint/Bow |
| 无限体力 | player/InfiniteStamina.h | Unlimited Stamina |
| 自由飞行(No Clip) | player/NoClip.h | 穿墙飞行 |
| 其他 | player/AutoRun.h、player/FallControl.h | 自动奔跑、坠落控制 |
大世界(World)
README 中列出的大世界功能几乎全部可在 cheat-library/src/user/cheat/world/ 目录中找到对应实现,包括但不限于:
- 仙灵自动归位(AutoSeelie)、立即打开队伍(OpenTeamImmediately);
- 游戏全局加速(GameSpeed)、笨怪(DumbEnemies)、冻结敌人(FreezeEnemies);
- 自动摧毁矿石/护盾/杂物/植物(AutoDestroy)、自动收集/开宝箱(AutoLoot)、拾取范围(VacuumLoot)、吸怪(MobVacuum);
- 自动交谈(DialogSkip)、自动砍树(AutoTreeFarm)、自动烹饪(AutoCook)、自动钓鱼(AutoFish)、自动挑战(AutoChallenge);
- 伪造时间(FakeTime)、杀戮光环(KillAura)、自定义天气(CustomWeather)。
以 GameSpeed 为例看实现细节(world/GameSpeed.cpp):默认快捷键 VK_CAPITAL(CapsLock),速度倍率默认 5.0、可调范围 0~20,按住快捷键期间通过 app::Time_set_timeScale 修改全局时间缩放,松开后恢复 1.0。其 GUI 描述特别警告:不要在开放世界使用,仅在菜单等界面中使用,非常危险——这是一个值得用户注意的风险提示。
传送(Teleport)
- 宝箱/神瞳传送:传送到最近的宝箱或神瞳,见 teleport/ChestTeleport.cpp、teleport/OculiTeleport.cpp,二者共同继承 teleport/ItemTeleportBase.cpp:按下快捷键后通过
game::FindNearestEntity查找最近目标,再调用MapTeleport::TeleportTo(entity->absolutePosition())完成传送,GUI 中还会实时显示最近目标的距离; - 地图传送:点击大地图标记传送,teleport/MapTeleport.cpp;
- 自定义传送:通过自定义列表传送,teleport/CustomTeleports.cpp。
实体管理依赖 cheat/game/EntityManager.cpp:从 MoleMole_EntityManager 单例拉取全部 BaseEntity,过滤存活实体后封装为 Entity 列表供各功能遍历。
视觉效果(Visuals)
目录 cheat-library/src/user/cheat/visuals/ 覆盖 README 列出的全部视觉功能:
- 透视 ESP:esp/ESP.cpp;
- 互动地图:imap/InteractiveMap.cpp,地图数据(提瓦特/层岩巨渊/渊下宫/金苹果群岛)以 JSON 资源内嵌(见 cheat-library/res/res.rc),并配套大量 256x256 高清图标的 PNG 资源;
- 元素视野常驻、除雾(NoFog)、FPS 解锁(FPSUnlock)、无限视距(CameraZoom)、宝箱探测(ShowChestIndicator)、隐藏 UI(HideUI)、游戏内浏览器(Browser,基于内嵌浏览器控件)、窥视模型不消失(EnablePeeking)、自由视角(FreeCamera)、派蒙跟随(PaimonFollow)、材质替换(TextureChanger)、动作替换(AnimationChanger);
- 个人界面自定义(Profile Changer):可修改 UID / 昵称 / 冒险等级 / 世界等级 / 角色 / 名片,visuals/ProfileChanger.cpp。
调试(Debugging)
- 实体管理器(Entities Manager)、位置信息(Position Info)、FPS 曲线图(FPS Graph);
- 抓包工具:README 关联了独立项目 Akebi-PacketSniffer,同时仓库内置 cheat/misc/sniffer/PacketSniffer.h 模块供在游戏内进行网络包监听。
热键系统与 GUI 渲染
热键机制
热键是整套工具交互的核心。Hotkey 类(cheat-base/src/cheat-base/Hotkey.h、Hotkey.cpp)支持单个按键或组合键:
- 监听窗口过程
WndProc中的WM_KEYUP/鼠标按键抬起消息(cheat-base/src/cheat-base/render/renderer.cpp),触发events::KeyUpEvent; Hotkey::IsPressed()要求组合键全部按下才算触发,IsReleased()用于边沿检测;- 支持键盘按键(A-Z、F1-F12、方向键、数字键等)与鼠标按键(LMB/RMB/MMB/X1/X2)混合绑定;
Hotkey::GetPressedHotkey()用于录制模式——在 GUI 中点击热键框后按下新组合即可完成绑定。
输入锁定
当 GUI 菜单显示时,渲染层会通过输入锁(AddInputLocker/IsInputLocked)拦截键盘鼠标事件,避免菜单操作穿透到游戏(cheat-base/src/cheat-base/render/renderer.cpp)。
GUI 渲染栈
渲染层同时支持 DirectX 11 与 DirectX 12 后端(cheat-base/src/cheat-base/render/backend/dx11-hook.cpp、dx12-hook.cpp),在 SwapChain Present 前后注入 ImGui 帧;自定义字体从资源 Ruda-Bold.ttf 加载,并支持 8~64 号字体的动态缩放(renderer.cpp)。
设置面板详解
全局设置(Settings 模块)提供以下分组(cheat-base/src/cheat-base/cheat/misc/Settings.cpp):
- General:菜单开关按键(F1,不可为空,忘记时可到配置文件查看)、全局热键启用开关;
- Logging:控制台日志(默认开启,改动需重启生效)、文件日志(开启后日志写入
logs/目录,改动需重启生效); - Status / Info / FPS 窗口:各叠加窗口的显示与拖拽开关;
- Notifications:右下角通知开关与通知间隔(1~10000ms);
- Fast Exit:快速退出总开关与退出快捷键(默认 F12);
- Interface Customization:字体大小(8~64)、主题保存/替换/选择/删除、ImGui 内置主题编辑器开关。
问题反馈规范(Bug Reporting)
README 对 bug 报告给出了明确步骤,照此提交能显著提高问题定位效率:
- 复现 bug,记录问题发生时"发生了什么"以及你的初步判断;
- 判断能否稳定复现:能复现则尽量清晰描述触发条件(开启了哪些功能、什么操作序列);不能复现则不建议提交(README 简中版原话调侃:那就别报告了,建议重启);
- 务必附上版本标识:复制你构建所用最新提交的 SHA 或版本号,例如
bd17a00ec388f3b93624280cde9e1c66e740edf9或 Release 0.7——没有版本号的报告几乎无法定位; - 在 Issues 页按模板提交(README 要求使用英文,且提供了现成的 Issue 模板)。
贡献方式(Contributing)
README 提供的协作流程是标准的 GitHub 工作流,同时面向"增加功能"与"提建议"两种场景:
增加一个功能:
- Fork 本项目;
- 创建功能分支:
git checkout -b feature/AmazingFeature; - 提交更改:
git commit -m 'Add some AmazingFeature'; - 推送到分支:
git push origin feature/AmazingFeature; - 打开 Pull Request。
提建议: 在 Issues 中用英文新建 issue,标题写清建议,描述部分尽量详细具体,让维护者能够理解"想要什么、希望怎么实现"。结合上文提到的 DMCA 公告,参与贡献同时也是获取最新私有源码的途径之一。
风险与合规提示
基于仓库文档与源码可确认以下事实,使用者应自行评估风险:
- 项目收到过来自 HoYoverse 的 DMCA 下架通知,最新源码已转为私有(见 README.md 公告);
- 保护绕过功能会关闭
mhyprot2设备句柄并 Hook 数据上报与崩溃报告函数(见 ProtectionBypass.cpp),对抗性质明显,账号与设备风险均由使用者自负; - 部分功能自带危险警告,例如 GameSpeed 明确提示"不要在开放世界使用"(GameSpeed.cpp);
- 本文仅介绍项目的查看、获取、运行与配置方式,不构成对任何违规行为的鼓励。
总结
Akebi-GC 是一个结构清晰的注入式辅助框架:injector.exe 负责以挂起方式拉起游戏进程并注入 CLibrary.dll,DLL 内通过 IL2CPP 初始化、事件 Hook 与 ImGui 渲染构建出完整的六大类功能体系(通用/玩家/世界/传送/视觉/调试)。其配置系统(cfg.ini + cfg.json + 多 Profile)与热键系统(组合键录制、集中管理)设计成熟,README 提供的三步启动流程(同目录放置 DLL → 运行 injector.exe → F1 打开菜单)与实际源码执行路径完全吻合。对想深入理解 Windows DLL 注入、IL2CPP 游戏逆向与 ImGui 覆盖层的开发者而言,公开源码中的 cheat-base 与 cheat-library 目录是很有参考价值的研读材料。