当前位置：首页 > news >正文

Akebi-GC 游戏辅助框架深度解析与实战指南

news 2026/5/22 11:24:12

Akebi-GC 游戏辅助框架深度解析与实战指南

【免费下载链接】Akebi-GC(Fork) The great software for some game that exploiting anime girls (and boys).项目地址: https://gitcode.com/gh_mirrors/ak/Akebi-GC

项目架构设计与核心模块剖析

Akebi-GC 是一个基于现代C++技术栈构建的游戏辅助框架，采用模块化设计理念，为《原神》等游戏提供高度可扩展的功能支持。项目采用经典的插件式架构，将核心功能、渲染层、注入机制和游戏特定逻辑完全分离，确保代码的可维护性和扩展性。

🏗️ 核心架构层次解析

项目采用三层架构设计，每一层都有明确的职责边界：

基础层 (cheat-base)- 提供通用基础设施

钩子管理模块：基于Detours库实现函数拦截与重定向
事件系统：支持类型安全的异步事件处理机制
配置管理：支持JSON序列化的动态配置系统
渲染引擎：支持DirectX 11/12的GUI渲染框架

功能层 (cheat-library)- 实现具体的游戏功能

玩家能力模块：无敌模式、无限体力、无冷却等
世界交互模块：自动拾取、自动对话、怪物控制等
传送系统：地图传送、神瞳传送、自定义坐标传送
视觉增强：透视、互动地图、FPS解锁等

注入层 (injector)- 提供进程注入能力

手动映射注入：避免防检测机制的DLL注入方案
加载库注入：传统的LoadLibrary注入方式
进程通信：通过管道实现注入器与DLL的通信

Akebi-GC项目标志性图标，代表项目的技术注入理念

🔧 核心技术实现机制

1. 钩子管理系统

项目的核心是HookManager类，它提供了统一的函数拦截接口：

// 钩子安装示例 HookManager::install(&OriginalFunction, &HookFunction); // 调用原始函数 CALL_ORIGIN(HookFunction, param1, param2);

这种设计允许开发者在任意游戏函数上安装钩子，同时保持原始函数的可访问性。钩子管理器内部使用std::map维护钩子关系，确保多钩子场景下的稳定性。

2. 事件驱动架构

项目实现了基于模板的事件系统，支持类型安全的回调注册：

// 事件定义示例 cheat::events::Event<GameUpdateEvent> GameUpdateEvent; // 事件订阅 GameUpdateEvent += METHOD_HANDLER(MyClass::OnGameUpdate);

事件系统采用RAII模式管理生命周期，自动处理事件的订阅与取消订阅，避免内存泄漏。

3. 配置系统设计

配置系统采用JSON作为存储格式，支持动态字段管理：

// 配置字段定义 config::Field<bool> f_Enabled { "Visuals.ESP", "Enabled", false }; config::Field<float> f_Range { "Visuals.ESP", "Range", 100.0f }; // 自动序列化到文件 Config::GetInstance().Save("config.json");

字段系统支持类型擦除，可以在运行时动态添加和修改配置项，为功能模块提供灵活的配置能力。

🚀 快速集成与开发指南

环境配置与编译流程

1. 开发环境要求

编译器: Visual Studio 2019+ (支持C++17)
依赖库: Detours、ImGui、nlohmann/json
游戏版本: 需要对应版本的签名文件
构建工具: CMake或Visual Studio解决方案

2. 项目编译步骤

# 1. 克隆项目 git clone https://gitcode.com/gh_mirrors/ak/Akebi-GC # 2. 恢复子模块 git submodule update --init --recursive # 3. 打开解决方案 # 使用Visual Studio打开akebi-gc.sln # 4. 选择构建配置 # - Debug: 调试版本，包含符号信息 # - Release: 发布版本，优化性能 # 5. 构建项目 # 按F7或使用构建菜单

3. 签名文件更新

项目使用模式扫描技术定位游戏函数，需要定期更新签名文件：

{ "ActorAbilityPlugin_AddDynamicFloatWithRange": { "signatures": [], "xref": [ { "offset": 0, "sig": "E8 ?? ?? ?? ?? 0F 28 74 24 50 B0 01 0F 28 7C 24 40" } ] } }

签名文件位于cheat-library/res/signatures.json，包含游戏函数的字节模式，用于运行时动态定位。

功能模块开发实战

1. 创建新功能模块

// MyFeature.h #pragma once #include <cheat-base/cheat/Feature.h> namespace cheat::feature { class MyFeature : public Feature { public: static MyFeature& GetInstance(); const FeatureGUIInfo& GetGUIInfo() const override; void DrawMain() override; void DrawStatus() override; // 功能配置 config::Field<bool> f_Enabled { "MyFeature", "Enabled", false }; config::Field<float> f_Speed { "MyFeature", "Speed", 1.0f }; private: MyFeature(); }; }

2. 实现功能逻辑

// MyFeature.cpp #include "pch-il2cpp.h" #include "MyFeature.h" namespace cheat::feature { MyFeature::MyFeature() { // 注册热键 HotkeyManager::GetInstance().RegisterHotkey( VK_F2, [this]() { f_Enabled.value() = !f_Enabled.value(); } ); } void MyFeature::DrawMain() { ImGui::Checkbox("启用功能", &f_Enabled.value()); ImGui::SliderFloat("速度", &f_Speed.value(), 0.1f, 10.0f); } void MyFeature::DrawStatus() { if (f_Enabled.value()) ImGui::Text("MyFeature [%.1f]", f_Speed.value()); } }

3. 注册功能到管理器

// 在cheat.cpp中注册 #include <cheat/MyFeature.h> void InitializeFeatures() { auto& manager = CheatManager::GetInstance(); manager.AddFeature(&MyFeature::GetInstance()); }

🎯 性能优化与反检测策略

1. 内存访问优化

项目采用智能指针和RAII模式管理游戏内存访问：

// 安全的内存读取 template<typename T> T SafeRead(uintptr_t address) { if (!IsValidAddress(address)) return T(); __try { return *reinterpret_cast<T*>(address); } __except(EXCEPTION_EXECUTE_HANDLER) { LOG_ERROR("读取内存失败: 0x%p", address); return T(); } }

2. 线程安全设计

多线程环境下的数据同步：

class ThreadSafeData { private: mutable std::mutex m_Mutex; std::unordered_map<uint32_t, EntityData> m_Entities; public: void UpdateEntity(uint32_t id, const EntityData& data) { std::lock_guard<std::mutex> lock(m_Mutex); m_Entities[id] = data; } EntityData GetEntity(uint32_t id) const { std::lock_guard<std::mutex> lock(m_Mutex); auto it = m_Entities.find(id); return it != m_Entities.end() ? it->second : EntityData(); } };

3. 反检测机制

游戏内道具图标资源，用于视觉识别和交互提示

项目实现了多层反检测策略：

代码混淆层

动态函数指针调用
字符串加密存储
控制流平坦化

行为隐藏层

随机化调用时机
模拟用户输入模式
内存访问模式伪装

通信加密层

进程间通信加密
网络流量伪装
心跳包模拟

🔍 调试与问题排查指南

1. 日志系统使用

项目内置分级日志系统，支持多种输出方式：

// 日志级别定义 LOG_DEBUG("调试信息: %s", data); LOG_INFO("普通信息: 玩家位置: %.2f, %.2f", x, y); LOG_WARNING("警告: 内存地址无效: 0x%p", address); LOG_ERROR("错误: 钩子安装失败: %s", functionName);

2. 实体调试器

内置实体管理器，实时监控游戏对象：

// 实体遍历示例 void DebugEntities() { auto entities = game::GetAllEntities(); for (auto& entity : entities) { LOG_INFO("实体ID: %u, 类型: %s, 位置: (%.2f, %.2f, %.2f)", entity.id, entity.type.c_str(), entity.position.x, entity.position.y, entity.position.z); } }

3. 性能分析工具

class PerformanceProfiler { public: void StartFrame() { m_FrameStart = std::chrono::high_resolution_clock::now(); } void EndFrame(const std::string& section) { auto end = std::chrono::high_resolution_clock::now(); auto duration = std::chrono::duration_cast<std::chrono::microseconds>(end - m_FrameStart); if (duration.count() > 16666) // 超过60FPS帧时间 LOG_WARNING("性能警告: %s 耗时 %.2fms", section.c_str(), duration.count() / 1000.0f); } private: std::chrono::time_point<std::chrono::high_resolution_clock> m_FrameStart; };

📈 扩展开发与二次开发方向

1. 插件系统扩展

项目支持动态插件加载，开发者可以创建独立的功能模块：

// 插件接口定义 class IPlugin { public: virtual ~IPlugin() = default; virtual const char* GetName() const = 0; virtual void Initialize() = 0; virtual void Update() = 0; virtual void DrawUI() = 0; }; // 插件管理器 class PluginManager { public: void LoadPlugin(const std::string& path); void UnloadPlugin(const std::string& name); private: std::unordered_map<std::string, std::unique_ptr<IPlugin>> m_Plugins; };

2. 脚本系统集成

支持Lua脚本扩展，提供更灵活的功能定制：

-- 示例Lua脚本 local config = { enabled = true, range = 100.0, keybind = "F3" } function OnUpdate() if not config.enabled then return end local player = GetLocalPlayer() local entities = GetEntitiesInRange(player.position, config.range) for _, entity in ipairs(entities) do if entity.type == "Chest" then TeleportTo(entity.position) break end end end function OnDrawUI() if ImGui.Begin("Lua脚本控制") then config.enabled = ImGui.Checkbox("启用", config.enabled) config.range = ImGui.SliderFloat("范围", config.range, 10.0, 500.0) ImGui.End() end end

3. 网络功能扩展

支持自定义网络协议和远程控制：

class NetworkManager { public: bool Connect(const std::string& address, uint16_t port); void SendCommand(const std::string& command, const json& data); void RegisterHandler(const std::string& command, CommandHandler handler); private: WebSocketClient m_Client; std::unordered_map<std::string, CommandHandler> m_Handlers; };