从零给 GTA 5 增强版菜单加功能YimMenuV2 注入菜单框架实战指南【免费下载链接】YimMenuV2Experimental menu for GTA 5: Enhanced项目地址: https://gitcode.com/GitHub_Trending/yi/YimMenuV2给 GTA 5 写菜单最折磨人的从来不是功能本身而是功能背后的三件事游戏一更新写死的函数地址就全废了想拦截网络消息得先知道它藏在哪个调用点写好的逻辑想塞进 ImGui 菜单里还得手动对位。YimMenuV2 是面向 GTA 5: Enhanced 的开源注入菜单框架用 C23 把特征扫描、函数钩子、Lua 热重载脚本这几套基础设施一次搭好你只管写功能。这篇就走一遍完整流程克隆、构建、读懂三个关键子系统最后亲手加一个自动回血功能。项目全景一个注入式 GTA 5 增强菜单YimMenuV2 最终产物是一个 DLL用 Xenos 这类注入器在加载界面或主菜单注入到GTA5_Enhanced.exe之后按INSERT或Ctrl\呼出菜单。它分三层src/core/是通用引擎内存扫描、钩子、Lua、日志、设置src/game/是 GTA 专属逻辑反作弊绕过、玩家管理、各类功能特性src/game/frontend/是 ImGui 界面。对玩家它提供神行模式、瞬移、载具管理这类现成功能对开发者它把菜单底座的部分彻底抽象掉了——你不需要再操心 D3D12 怎么钩、Lua 沙箱怎么建。适合两类人想魔改菜单行为的玩家以及想研究注入式菜单到底怎么落地的逆向方向开发者。构建流程一条主线加四张检查清单先 clonegit clone https://gitcode.com/GitHub_Trending/yi/YimMenuV2 cd YimMenuV2CMakeLists.txt只做了三件事GLOB_RECURSE收走src/下全部源码、把src/common.hpp设为预编译头、以MODULE类型即 DLL链接 AsyncLogger、ImGui、MinHook、nlohmann_json、LuaJIT。真正值得注意的是 cmake/cross-compile.cmake在 Windows 上它默认关闭用 Visual Studio 2022 即可在非 Windows 上它默认开启自动选 Zig 或 ClangMinGW 交叉编译出 Windows DLL——这意味着 Linux 机器也能直接出包。清单一 · 工具链Windows 侧要 Visual Studio 2022含 C 工作负载 CMake ≥ 3.20 NinjaCMakeSettings.json 里两条预设都是 Ninja 生成器一条走 MSVC一条走 clang-clLinux 交叉编译侧装 Zig或者 Clang 加x86_64-w64-mingw32ucrt工具链二者缺一脚本会直接FATAL_ERROR。清单二 · 配置cmake -B build -G Ninja -DCMAKE_BUILD_TYPERelWithDebInfo选 Ninja 是为了和官方预设保持一致RelWithDebInfo是仓库预设里自带的配置出问题的时候还能看调用栈。清单三 · 编译cmake --build build产出是YimMenuV2.dllMODULE 库不是 exe——它是被注入的没有自己的进程。清单四 · 跑起来在启动器里关闭 BattlEyeSteam/Epic 版可能还要加-nobattleye启动参数正常启动游戏在加载界面注入 DLL进主菜单按INSERT。日志落在%appdata%/YimMenuV2/cout.log后面排障全靠它。三个子系统拆解指针扫描地址为什么会失效怎么让它别失效注入菜单面对的第一个现实问题是游戏更新一次所有函数地址都漂了。硬编码地址的方案从第一天起就是错的。YimMenuV2 的做法是把找地址变成找字节特征入口在 src/game/pointers/Pointers.cpp// 带通配符的字节序列作为特征 constexpr auto screenResPtrn Pattern75 39 0F 57 C0 F3 0F 2A 05(ScreenRes); scanner.Add(screenResPtrn, this { ScreenResX ptr.Add(0x5).Add(4).Rip().Asstd::uint32_t*(); });PatternScanner在模块映像里搜?通配符特征命中后回调里用PointerCalculator做Add/Rip/AsT*链式偏移从命中点走到真正要用的指针。注意很多特征是路过式的比如InitNativeTables的特征命中在函数中间要Sub(0x2A)回函数头。扫描只在全局初始化时跑一遍结果写进 src/core/backend/PatternCache.cpp 维护的哈希缓存后续启动直接命中缓存不必重新扫全模块。排障时记住一点某个指针为nullptr一定是对应特征失配日志里会有记录别急着怀疑注入器。钩子系统菜单的全部超能力从这里过钩子层的实现在 src/core/hooking/Hooking.cpp所有拦截点以静态列表形式注册到BaseHook统一挂DetourHook最后由 MinHook 的ApplyQueued()批量生效。名单大致分四块——反作弊路径GameSkeletonUpdate、GetThreadContext、HttpStartRequest、脚本引擎ScriptVM、RunScriptThreads、网络同步ReceiveNetMessage、WriteSyncTree、匹配MatchmakingAdvertise。菜单之所以能实时看到谁进了房间靠的就是AssignPhysicalIndex和ReceiveNetMessage上的 hook。两条使用纪律hook 函数里处理完必须调用原始函数断掉调用链游戏直接崩卸载时Hooking::Destroy()会统一DisableAll并BytePatches::RestoreAll()还原字节补丁退出路径尽量完整减少残留。Lua 脚本层不重启就能换功能C 改完要重编译注入而 Lua 是菜单的热插拔层。src/core/scripting/LuaManager.cpp 的RunScript每帧做三件事处理加载队列、处理禁用队列、推进已加载脚本。设计上有两个值得注意的点。第一加载与卸载全走队列由脚本帧线程串行消费UI 线程只 push 请求不会在渲染线程里动文件系统。第二禁用/启用是通过移动文件实现的禁用把脚本移进disabled/子树保留原目录结构启用再移回原位所以重启后脚本状态天然一致不需要额外持久化。沙箱方面每个脚本独立 LuaJIT 状态io/os/ffi/loadfile全部禁用require被改写成只能加载 scripts 目录内的文件目录名含include的被视为模块自动跳过加载供require用含disabled的进禁用列表。API 细节在 docs/lua-api.md给编辑器做补全的类型标注在同目录的yimmenu_v2.lua。实战给你的第一个功能走一遍闭环做个自动回血开关打开后每帧补血关闭时归零。C 路线分四步。第一步在src/game/features/self/下新建AutoHeal.cpp继承LoopedCommand——它的构造会自动注册进命令中心Tick每帧替你调OnTick#include core/commands/LoopedCommand.hpp #include game/backend/Self.hpp #include game/gta/Natives.hpp namespace YimMenu::Features { class AutoHeal : public LoopedCommand { using LoopedCommand::LoopedCommand; virtual void OnTick() override { if (auto ped Self::GetPed()) PED::SET_ENTITY_HEALTH(ped.GetHandle(), 100, false); } }; static AutoHeal _AutoHeal{autoheal, Auto Heal, Keep regenerating health}; }第二步把它挂进 UI。打开src/game/frontend/submenus/Self.cpp在toolsGroup里加一行AddItem(std::make_sharedCommandItem(autoheal_J));与旁边的heal、suicide并列。第三步编译并按清单四注入。菜单 Self 页的 Tools 分组里应出现 Auto Heal 开关状态会自动写进settings.json重启不丢。如果不想碰 C同样需求一个 Lua 脚本就够放在%appdata%/YimMenuV2/scripts/menu.get_submenu():add_category(Heal):add_looped_checkbox( luaautoheal, Auto Heal (Lua), Regen health every frame, function() local self ped.get_self() if self then self:set_health(100) end end )新脚本会出现在 Settings → Lua Scripts 的 Disabled 列表点一下即加载。两条路线的取舍要改底层碰 hook、碰内存走 C功能逻辑走 Lua后者改完不用重编译迭代快得多。性能与稳定性四条可落地的建议1. 新增特征前先查缓存。模式扫描只在首次全量执行命中后按特征哈希存入PatternCache之后每次启动只查哈希。你要加新指针时走PatternScanner.Add的既有流程别自己起循环去扫——重复全模块扫描会直接拉长注入后的初始化时间。2. 循环逻辑里别做重活。LoopedCommand的Tick每帧执行且只跑已启用的项这是框架帮你做的第一层控制第二层靠自己tick 内避免堆分配和文件 IO。参考SuperRun的写法——它每帧只做一次 native 调用把恢复默认值这种一次性动作放到了OnDisable里。3. 阻塞操作交给脚本协程。Lua 侧的 latent 调用等待模型加载、等网络结果会yield当前协程让出帧给别的脚本。自己写循环时同理script.run_in_callback里用script.yield(ms)分段执行而不是while true do ... end卡死协程。4. imgui 回调只做布局。group:imgui(fn)这类回调在菜单打开时每帧执行文档明确说不要在回调里script.yield。把数据计算挪到commandmgr.add_looped_command的 tick 里imgui 回调只负责读缓存好的值画图。新手避坑清单现象注入后菜单直接卸载日志报特征失配。根因Pointers::Init()发现GTA5_Enhanced.exe里没有可命中的特征或某个关键指针为nullptr——通常是游戏版本更新导致字节序列变了。 解法先翻cout.log确认是哪个特征失配再用util.get_game_version()对照你的游戏 online version跨版本用script.require_game_build给脚本加版本门槛避免旧偏移硬撑新游戏。现象公局每五分钟被踢出。根因README 自己写了——项目没有 BattlEye 完整绕过正常房主的心跳检查会把你清掉。 解法要么留在非严格环境要么等上游补上真正的 bypass别把这当成注入姿势问题去调。现象去掉 FSL 后之前的进度全没了甚至游戏起不来。根因FSL 把账号存档重定向到了磁盘去掉它后游戏读的是另一份数据。 解法存档回不来的只能认栽游戏起不来时删掉Documents/GTAV Enhanced/Profiles目录即可恢复。现象新放的 Lua 脚本在菜单里看不到。根因脚本名含disabled子串大小写敏感会被归档不加载文件放在含include的目录里则被当作模块跳过。 解法改名、挪出 include 目录等目录周期刷新后它出现在 Disabled 列表。现象Linux 上配置直接 FATAL_ERROR提示找不到交叉编译工具链。根因cmake/cross-compile.cmake在非 Windows 平台默认开CROSSCOMPILE找不到 Zig 和 MinGW 就会硬停。 解法装 Zig 或 Clangx86_64-w64-mingw32ucrt如果本机就是 Windows加-DCROSSCOMPILEOFF关掉即可。YimMenuV2 把注入菜单最脏活扫描、hook、沙箱、热重载封装成了可直接继承的基类你加功能时面对的是一层干净的 API。想继续往下挖Lua 全量 API 看 docs/lua-api.mdhook 注册与还原逻辑看 src/core/hooking/Hooking.cpp所有游戏结构体定义集中在src/types/对着读一遍基本就通了这个框架的骨架。【免费下载链接】YimMenuV2Experimental menu for GTA 5: Enhanced项目地址: https://gitcode.com/GitHub_Trending/yi/YimMenuV2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考