Akebi-GC 入门指南:版本获取、注入启动与核心功能模块源码解析
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)
- 前往 GitHub Releases 页面。
- 下载标记为 latest 的最新稳定发布版本。
稳定版适合日常使用,版本号(如 Release 0.7)也会在后续 Bug 报告中作为关键信息提交给开发者。
2. 最新版本(Actions / Publish 工作流)
- 前往 GitHub Actions 界面。
- 点击名为 Publish 的工作流。
- 选择带有绿色勾选标记(:heavy_check_mark:)的最新工作流运行,并在触发时选择你的客户端版本:
- GLOBAL:国际服
- CN:国服
- BETA:测试服
- 从该次运行的 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。
二、使用方法(安装与启动)
- 确保
CLibrary.dll与injector.exe位于同一个文件夹中。 - 运行
injector.exe。 - 等待游戏登录界面出现后,按下
F1打开 Akebi 界面。
注入器实际启动流程(源码印证)
从 injector/src/main.cpp 可以看到整个启动序列:
- 注入器首先等待
GenshinImpact.exe(国际服)与YuanShen.exe(国服)两个进程全部退出(WaitForCloseProcess),并Sleep(1000)等待旧 DLL 完全卸载,确保每次以干净状态注入; - 读取同目录下的
cfg.ini(UTF-16/Unicode)配置; - 调用
OpenGenshinProcess:通过OpenProcessToken提权,读取[Inject] GenshinPath(首次运行会弹出文件选择框),随后以CreateProcessAsUserA+CREATE_SUSPENDED标志挂起启动游戏进程,并将父进程伪装为explorer.exe; - 默认注入名为
CLibrary.dll的模块(可通过命令行第二个参数覆盖,即injector.exe <dll名>),并在_DEBUG构建下会先拷贝到临时目录再注入; Sleep(2000)后ResumeThread恢复游戏主线程执行。
注入方式在 injector/src/injector.cpp 中通过编译宏 MANUAL_MAP 二选一:
LoadLibraryDLL(默认):走kernel32.LoadLibraryA远程线程注入路径(见 cheat-base/src/cheat-base/inject/load-library.cpp);ManualMapDLL:手动映射注入,不触发常规加载器调用。
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)。它会 HookUnity_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)。通过 HookLevelTimeManager_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)
- 实体管理器:查看当前场景中全部实体列表(cheat-library/src/user/cheat/game/EntityManager.cpp)。
- 位置信息:实时显示角色坐标等信息。
- FPS 曲线图:帧率监控曲线。
- 抓包工具:
PacketSniffer(cheat-library/src/user/cheat/misc/sniffer/PacketSniffer.cpp),用于抓取/修改游戏网络数据包。
四、功能演示
官方 README 提供了以下功能演示 GIF(地图传送、穿墙模式、神瞳传送、宝箱传送、快速射击、自动谈话),可在对应语言版 README 的「功能演示」折叠块中查看。这些演示从侧面印证了上述六大模块的实际效果。
五、Bug 报告指南
官方文档建议按以下流程提交错误报告:
- 发现一个错误(Bug)。
- 记录接下来发生的情况,以及你认为导致该状况的第一判断。
- 判断它是否可以重现:
- 如果可以:尽可能清楚地解释错误发生时会发生什么、为什么会发生;
- 如果不可以:官方不建议报告(README 原文戏称"无须报告,建议求佛",因为开发者无法通灵)。
- 报告你使用的版本信息:复制构建 mod 时最新提交的 SHA Hash(例如
bd17a00ec388f3b93624280cde9e1c66e740edf9)或 Release 版本号(例如Release 0.7)。 - 使用英文开启一个 Issue(官方提供模板)。
六、社群贡献
增加一个功能
- 建立新的分支(Fork)。
- 创建你的功能分支:
git checkout -b feature/AmazingFeature。 - 提交更改:
git commit -m 'Add some AmazingFeature'。 - 上传到分支:
git push origin feature/AmazingFeature。 - 开启一个 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 中的原文提示,使用时务必谨慎。