Akebi-GC 入门指南:版本获取、注入启动与核心功能模块源码解析

原创2026-10-15 11:27:501,839 阅读
文章标签:逆向工程

Akebi-GC 入门指南:版本获取、注入启动与核心功能模块源码解析

本篇指南以 Akebi-GC 官方繁体中文 README(README_zh-Hant.md)为骨架,结合仓库源码(injector、cheat-library 等)对完整功能列表进行逐一印证与深化。读者读完可掌握稳定版与最新版的获取方式、injector.exe + CLibrary.dll 的标准注入流程、界面打开方式,以及「一般 / 玩家 / 大世界 / 传送 / 视觉 / 调试」六大功能模块的参数细节与底层实现原理。


一、获取版本

Akebi-GC 面向 Genshin Impact(国际服 GenshinImpact.exe)与《原神》国服(YuanShen.exe)提供两种获取渠道:稳定版本与最新版本,另有自行编译路线。

1. 稳定版本(Releases)

  1. 前往 GitHub Releases 页面。
  2. 下载标记为 latest 的最新稳定发布版本。

稳定版适合日常使用,版本号(如 Release 0.7)也会在后续 Bug 报告中作为关键信息提交给开发者。

2. 最新版本(Actions / Publish 工作流)

  1. 前往 GitHub Actions 界面。
  2. 点击名为 Publish 的工作流。
  3. 选择带有绿色勾选标记(:heavy_check_mark:)的最新工作流运行,并在触发时选择你的客户端版本:
    • GLOBAL:国际服
    • CN:国服
    • BETA:测试服
  4. 从该次运行的 Artifacts 中下载名为 Akebi-GC-release 的构建产物。

注意:Publish 工作流按客户端版本分别产出对应构建,下载前务必确认所选版本与你的游戏客户端一致,否则可能出现注入失败或特征不匹配的问题。

3. 自行编译

如需自行从源码构建,请参阅仓库 wiki 中的 Building(建置) 页面。仓库结构如下,方便定位各工程:

  • cheat-base:通用注入与基础框架库(Hook 管理、配置系统、渲染、日志、模式扫描等);
  • cheat-library:游戏功能主体工程,包含全部功能模块(src/user/cheat/ 下按 Player / World / Teleport / ESP / Visuals 分类);
  • injector:注入器工程,负责拉起游戏进程并注入 CLibrary.dll;
  • 解决方案文件为 akebi-gc.sln。

二、使用方法(安装与启动)

  1. 确保 CLibrary.dll 与 injector.exe 位于同一个文件夹中。
  2. 运行 injector.exe。
  3. 等待游戏登录界面出现后,按下 F1 打开 Akebi 界面。

注入器实际启动流程(源码印证)

从 injector/src/main.cpp 可以看到整个启动序列:

  1. 注入器首先等待 GenshinImpact.exe(国际服)与 YuanShen.exe(国服)两个进程全部退出(WaitForCloseProcess),并 Sleep(1000) 等待旧 DLL 完全卸载,确保每次以干净状态注入;
  2. 读取同目录下的 cfg.ini(UTF-16/Unicode)配置;
  3. 调用 OpenGenshinProcess:通过 OpenProcessToken 提权,读取 [Inject] GenshinPath(首次运行会弹出文件选择框),随后以 CreateProcessAsUserA + CREATE_SUSPENDED 标志挂起启动游戏进程,并将父进程伪装为 explorer.exe;
  4. 默认注入名为 CLibrary.dll 的模块(可通过命令行第二个参数覆盖,即 injector.exe <dll名>),并在 _DEBUG 构建下会先拷贝到临时目录再注入;
  5. Sleep(2000) 后 ResumeThread 恢复游戏主线程执行。

注入方式在 injector/src/injector.cpp 中通过编译宏 MANUAL_MAP 二选一:

DLL 侧初始化

注入成功后,cheat-library/src/user/main.cpp 中的 Run 负责:

  • 设置资源模块与当前路径;
  • 初始化 cfg.json 配置(与注入器的 cfg.ini 分离,前者记录注入参数,后者记录功能开关与参数);
  • 按需开启文件日志(logs 目录)与控制台日志;
  • 等待 UserAssembly.dll 加载完成后执行 init_il2cpp() 解析 IL2CPP 元数据,最后调用 cheat::Init() 注册全部功能模块。

cfg.ini 中 <a href="https://link.gitcode.com/i/735d79f2ac91082d26e6c2a1cfd66d4c" target="_blank">Inject] 段的核心配置项(源码见 [injector/src/main.cpp):

配置键 说明 备注
GenshinPath 游戏主程序完整路径 首次运行自动弹出选择框,也可手动编辑
GenshinCommandLine 附加命令行参数 可留空

三、功能模块详解

功能模块的注册与分类顺序可在 cheat-library/src/user/cheat/cheat.cpp 中直接看到:Player → World → Teleport → ESP → Visuals → Hotkeys → Settings → About → Debug。以下按官方 README 的分类逐项展开。

1. 一般(General)

  • 绕过防作弊机制:对应 ProtectionBypass(cheat-library/src/user/cheat/misc/ProtectionBypass.cpp)。它会 Hook Unity_RecordUserData 与 CrashReporter,启动时模拟调用 RecordUserData 并尝试关闭 \Device\mhyprot2 句柄(成功会打印 "The Mhyprot2 handle was successfully closed");同时对 RecordUserData 的返回签名进行嗅探缓存,按类型回放正确签名。
  • 游戏内界面:基于 ImGui 绘制的游戏内叠加界面。
  • 快捷键:Hotkeys 模块(cheat-library/src/user/cheat/misc/Hotkeys.cpp)集中管理所有功能的开关热键,支持按名称搜索并按功能分组展示、就地修改按键。
  • 通知:功能开关、登录状态变化等会通过界面提示。

2. 玩家(Player)

  • 上帝模式(无敌):GodMode(cheat-library/src/user/cheat/player/GodMode.cpp)。实现上由三个 Hook 组成:
    • Miscs_CheckTargetAttackable:当目标为玩家角色时返回不可攻击,实现攻击免疫;
    • VCHumanoidMove_NotifyLandVelocity:落地速度超过阈值时压低下落速度并清零加速时间,消除摔落伤害;
    • ActorAbilityPlugin_HanlderModifierThinkTimerUp:通过黑名单(如 BlackMud、ElectricWater、SeiraiThunder 等)屏蔽环境伤害 modifier。
  • 攻击模式修改(多重打击 / 目标 / 动画):对应 RapidFire(快速射击)、AnimationChanger 等,可修改攻击连击、命中目标与动作表现。
  • 无冷却(技能 / 大招 / 冲刺 / 弓):NoCD(cheat-library/src/user/cheat/player/NoCD.cpp)提供四类开关:
    • Reduce Skill/Burst Cooldown:按倍率削减元素战技与大招冷却(1.0 即无 CD,2.0 及以上为增加计时值);
    • Burst max energy:移除大招能量需求(能量球显示可能不完整但技能仍可使用);
    • No Sprint Cooldown:移除冲刺间隔延迟;
    • Instant Bow:移除弓蓄力冷却(对菲谢尔存在已知问题)。
  • 无限体力:InfiniteStamina。
  • 穿墙模式:NoClip(cheat-library/src/user/cheat/player/NoClip.cpp)。开启后禁用 Rigidbody 碰撞检测,用 WASD + Space(上升)+ Shift(下降) 移动,可配置:
    • Speed(建议 0.1~5.0,过高会不稳定);
    • Camera-relative movement:改为相对镜头方向移动;
    • Alt Speed:按住 Ctrl(或自定义按键)时使用备用速度;
    • Velocity mode / Freeflight mode:分别改用速度驱动、保留碰撞;
    • Use Custom Keys:自定义全部方向键。 同时它会修正 MoveSyncEvent 中的速度与坐标同步包,避免服务端拉回。

3. 大世界(World)

  • 自动仙灵:AutoSeelie(cheat-library/src/user/cheat/world/AutoSeelie.cpp)。在 100 米半径内将仙灵直接拉到玩家身边;启用 Auto Electro seelie 后,无需手动触发电仙灵也会自动跟随启动。
  • 立即打开队伍:OpenTeamImmediately。
  • 游戏全局加速:GameSpeed(cheat-library/src/user/cheat/world/GameSpeed.cpp)。通过修改 Time.timeScale 实现全局加速,默认热键为 CapsLock,倍率可调(0~20)。源码中明确警告:请勿在大世界使用,仅限菜单等场景,非常危险。
  • 敌不攻击玩家:DumbEnemies。
  • 冻结敌人:FreezeEnemies。
  • 自动摧毁(矿石 / 护盾 / 物体 / 植物):AutoDestroy。
  • 自动收集 / 开启宝箱:AutoLoot(cheat-library/src/user/cheat/world/AutoLoot.cpp),包含两个子开关:
    • Auto-pickup drops:自动拾取掉落物,可配合拾取过滤器(Animals / Drop Items / Resources / Oculus)细分;
    • Auto-treasure:自动开启宝箱等战利品,可分别勾选 Chests(普通/珍贵/华丽等)、Leyline(地脉)、Search Points、Quest Interacts、Others(书页、旋曜晶髓等)。 两者都支持 Delay Time(默认 200ms,低于 200ms 不安全)与 Delay fluctuation(模拟人工点击的不一致延迟)。开启后界面状态栏会实时显示 AP/AT/CR/PF + ms/FL 组合状态。
  • 拾取范围:Custom Pickup Range(0.5~40 米)。源码注明:过高数值极易被服务器检测,且建议"先开自动拾取/自动宝箱,最后再开自定义范围"。
  • 自动谈话:DialogSkip(跳过对话)。
  • 自动砍树:AutoTreeFarm。
  • 自动烹饪:AutoCook。
  • 伪造时间:FakeTime(cheat-library/src/user/cheat/world/FakeTime.cpp)。通过 Hook LevelTimeManager_SetInternalTimeOfDay 将游戏内时间锁定在自定义的 TimeHour(0~24)与 TimeMinute(0~60)。
  • 自动钓鱼:AutoFish(cheat-library/src/user/cheat/world/AutoFish.cpp)。Hook 钓鱼模块的抛竿、咬钩、战斗开始/结束等回包,自动完成咬钩(RequestFishBite)、收竿(Catch Delay 默认 2000ms)与重新抛竿(Recast Delay 默认 500ms)。
  • 杀戮光环:KillAura。
  • 怪物吸尘器:MobVacuum,将周围怪物拉向玩家。
  • 战利品吸尘器:VacuumLoot,将掉落物聚拢到玩家附近。

4. 传送(Teleport)

  • 宝箱 / 神瞳传送(以最近的进行传送):ChestTeleport(cheat-library/src/user/cheat/teleport/ChestTeleport.cpp)与 OculiTeleport。宝箱传送提供精细筛选:按稀有度(Common / Exquisite / Precious / Luxurious / Remarkable)与状态(Locked / In rock / Frozen / Bramble / Trap)过滤,并支持 Investigates、Book pages、BGMs、Quest Interaction、Flora chest、Unknowns 等类型。
  • 地图传送(通过地图标记进行传送):MapTeleport(cheat-library/src/user/cheat/teleport/MapTeleport.cpp)。使用方式:打开地图 → 按住传送键(默认 T)→ 左键点击地图任意位置。实现上分四阶段:寻找最近的已解锁锚点发起服务端传送 → 改写加载位置 → 最终改写角色坐标,并自动计算地面高度;若无法取得地面高度,则使用 Override Height(默认 300m,推荐至少高于山体以防穿地),地下矿区(sceneId 6)使用单独的隧道高度计算逻辑。
  • 自订传送(通过列表进行传送):CustomTeleports,基于预先定义的坐标列表一键传送。

5. 视觉效果(Visuals)

  • ESP 透视:ESP(cheat-library/src/user/cheat/esp/ESP.cpp)。支持:
    • 绘制模式:Box / Rectangle / Tracer(直线或屏幕外箭头)等;
    • 绘制距离(Range,默认 100m)、名称与距离标签、字体/描边、全局配色;
    • 丰富的过滤分类(InstallFilters 注册数百个实体过滤器):宝箱(含埋藏宝箱检测)、神瞳与特色收集物、引导机关、生物(动物/NPC)、矿物、周本与首领/Boss、常规怪物、植物、谜题机关等;
    • 每个过滤器条目自带图标(来自 cheat-library/res/icons 与 cheat-library/res/iconsHD)、左键开关、右键调色、独立热键。
  • 交互地图:InteractiveMap(cheat-library/src/user/cheat/imap/InteractiveMap.cpp),场景数据由 cheat-library/res/map_teyvat.json、cheat-library/res/map_enkanomiya.json、cheat-library/res/map_golden_apple_archipelago.json、cheat-library/res/map_undeground_mines.json 提供。支持图标大小/动态缩放/HD 图标、完成与未完成点的透明度区分、按类别批量开合、搜索过滤;可自动检测新物品(绿线标记)、自动修正点位、采集后自动标记完成(蓝线标记),并可保存自定义点、固定点与已完成进度(分全局/账号两种保存范围),还提供"完成最近点 / 撤销最近完成"热键。
  • 元素视野:ElementalSight。
  • 除雾:NoFog。
  • FPS 解锁器:FPSUnlock(cheat-library/src/user/cheat/visuals/FPSUnlock.cpp)。直接改写 Application.targetFrameRate(可调 30~360,默认 240),关闭时恢复原始帧率。
  • 镜头放大:CameraZoom。
  • 宝箱探测器:ShowChestIndicator。
  • 隐藏 UI:HideUI。
  • 游戏内建浏览器:Browser,可在游戏内打开网页。
  • 窥视(第一人称视角):EnablePeeking。
  • 账号界面更改(UID / 名称 / 冒险等级 / 世界等级 / 角色 / 名片):ProfileChanger。
  • 自定义天气:CustomWeather。
  • 灵魂出窍(自由视角):FreeCamera。
  • 派蒙跟踪:PaimonFollow。
  • 材质替换器:TextureChanger。

6. 调试(Debug)


四、功能演示

官方 README 提供了以下功能演示 GIF(地图传送、穿墙模式、神瞳传送、宝箱传送、快速射击、自动谈话),可在对应语言版 README 的「功能演示」折叠块中查看。这些演示从侧面印证了上述六大模块的实际效果。


五、Bug 报告指南

官方文档建议按以下流程提交错误报告:

  1. 发现一个错误(Bug)。
  2. 记录接下来发生的情况,以及你认为导致该状况的第一判断。
  3. 判断它是否可以重现:
    • 如果可以:尽可能清楚地解释错误发生时会发生什么、为什么会发生;
    • 如果不可以:官方不建议报告(README 原文戏称"无须报告,建议求佛",因为开发者无法通灵)。
  4. 报告你使用的版本信息:复制构建 mod 时最新提交的 SHA Hash(例如 bd17a00ec388f3b93624280cde9e1c66e740edf9)或 Release 版本号(例如 Release 0.7)。
  5. 使用英文开启一个 Issue(官方提供模板)。

六、社群贡献

增加一个功能

  1. 建立新的分支(Fork)。
  2. 创建你的功能分支:git checkout -b feature/AmazingFeature。
  3. 提交更改:git commit -m 'Add some AmazingFeature'。
  4. 上传到分支:git push origin feature/AmazingFeature。
  5. 开启一个 Pull Request。

建议

用英文开启一个 Issue,并在描述中确保内容足够清楚,以便开发人员理解你想要什么以及期望的效果。新功能模块的开发可以参考 cheat-library/src/user/cheat/cheat.cpp 中的 manager.AddFeatures(...) 注册方式:每个功能继承 Feature 基类,实现 GetGUIInfo / DrawMain / DrawStatus,并挂接事件或 Hook 后即可被界面与配置系统自动接管。


七、使用风险提示(据源码与文档)

  • 作弊风险:本工具以绕过游戏反作弊机制为前提(cheat-library/src/user/cheat/misc/ProtectionBypass.cpp),使用即存在账号封禁风险,请自行评估。
  • 低延迟高风险:AutoLoot 的注释明确提示——自定义拾取范围配合过低延迟"滥用必定导致封号"("Abuse will definitely merit a ban")。
  • 高拾取范围易被检测:自定义拾取范围源码注释提示高数值会被服务器轻易识别。
  • 全局加速危险:GameSpeed 源码注释明确警告不要在大世界使用,仅限菜单等安全场景。
  • 穿墙速度限制:NoClip 建议速度不超过 5.0,过高可能引发不稳定。

以上风险均为仓库源码与 README 中的原文提示,使用时务必谨慎。

登录后查看全文
Akebi-GC