REFrameworkRE Engine 游戲的 Mod Loader 與 Lua 腳本平臺(tái)4 條命令跑通第一個(gè)腳本【免費(fèi)下載鏈接】REFrameworkMod loader, scripting platform, and VR support for all RE Engine games項(xiàng)目地址: https://gitcode.com/GitHub_Trending/re/REFrameworkREFramework 是面向 RE Engine 全家桶生化危機(jī)系列、怪物獵人、鬼泣 5、街霸 6、鬼泣、死亡之屋重制等 18 款游戲的 Mod Loader、Lua 腳本平臺(tái)和 VR 支持框架。它把自己偽裝成 DirectInput 的dinput8.dll搭著游戲的渲染循環(huán)進(jìn)來(lái)把一套能直接讀寫(xiě)游戲?qū)ο蟮哪_本 API 交到你手里——FOV 滑塊、自由相機(jī)這些內(nèi)置 Mod 解壓即生效想改游戲行為就寫(xiě)幾行 Lua。它是什么 為什么值得試一句話它是 RE Engine 游戲的Mod 加載器 反射式腳本層 VR 運(yùn)行時(shí)三合一靈感來(lái)自 Kanan 并復(fù)用了部分代碼README 里寫(xiě)得明明白白。對(duì)調(diào)參黨來(lái)說(shuō)內(nèi)置 Mod 已經(jīng)夠用對(duì)想動(dòng)手的人來(lái)說(shuō)它最大的賣(mài)點(diǎn)是你不需要知道任何字段偏移量——按類(lèi)型名和字符串名調(diào)方法就行。最小可運(yùn)行路徑5 行以?xún)?nèi)# 1. 從 Releases 頁(yè)下載最新 zip鏈接見(jiàn) [README](https://link.gitcode.com/i/7a9623761a1b0858b278334ff004980b) # 2. 非 VR只解壓 dinput8.dll 到游戲安裝目錄 # 3. VR裝好 SteamVR整個(gè) zip 解壓到游戲安裝目錄 # 4. Proton/LinuxSteam 啟動(dòng)選項(xiàng)加 WINEDLLOVERRIDESdinput8.dlln,b %command% # 5. 啟動(dòng)游戲DirectX 11/12 通吃一句話總結(jié)別人給你的是怎么改游戲的說(shuō)明書(shū)它給你的是改游戲的能力。按場(chǎng)景走第一次跑起來(lái)文件放對(duì)位置Proton 有個(gè)坑非 VR 場(chǎng)景下只需dinput8.dll一個(gè)文件整包解壓容易把一堆 VR 相關(guān)的 DLL 帶進(jìn)游戲目錄沒(méi)必要。VR 則相反需要整個(gè)包。README 里還順手列了幾個(gè)內(nèi)置修復(fù)——RE8 開(kāi)局崩潰、RE8 擊殺/受傷卡頓、MHRise 的第三方 DLL 崩潰——如果你的游戲本來(lái)就修不好這些加載器本身就回本了。?? 有個(gè)容易忽略的行為檢測(cè)到聯(lián)機(jī)對(duì)戰(zhàn)時(shí)框架會(huì)主動(dòng)卸載所有已加載的腳本ScriptRunner.cpp里寫(xiě)死了這個(gè)邏輯。單機(jī) Mod 沒(méi)問(wèn)題別指望它在線上用。寫(xiě)第一個(gè) Lua 腳本從 reframework/autorun 到渲染循環(huán)腳本放在持久目錄下的reframework/autorun/框架啟動(dòng)時(shí)會(huì)把這個(gè)目錄里的所有.lua全量加載并注冊(cè)進(jìn) Lua 的package.path。倉(cāng)庫(kù)里 scripts/ 目錄就是現(xiàn)成的范本庫(kù)scripts/utility/ 里還有GameObject.lua、Statics.lua這類(lèi)工具庫(kù)require(utility/Statics)直接復(fù)用。核心模式只有三步找類(lèi)型、拿方法、掛在游戲入口上local td sdk.find_type_definition(via.Transform) local get_position td:get_method(get_Position) re.on_application_entry(UpdateMotion, function() -- 游戲每幀的 UpdateMotion 入口觸發(fā)一次 end)實(shí)際腳本里就是這么寫(xiě)的比如 re2_smooth_movement.lua 里緩存了一堆get_Position/set_Rotation方法引用再在UpdateMotion回調(diào)里做 EMA 平滑。可用的掛載點(diǎn)還有re.on_frame、re.on_draw_ui、re.on_pre_application_entry鉤子里能返回sdk.PreHookResult.SKIP_ORIGINAL這類(lèi)結(jié)果來(lái)攔截原邏輯。改完不用重啟菜單里有 Reset scripts 按鈕或者重載場(chǎng)景即可。編譯框架源碼從 CMake 到指定游戲目標(biāo)只想跑 Mod 的看到這里就可以關(guān)掉了要改框架或?qū)?C 插件的環(huán)境要求很干脆C23、Visual Studio 2022 起步、CMake官方明說(shuō)其他編譯器沒(méi)測(cè)過(guò)。四條命令git clone https://gitcode.com/GitHub_Trending/re/REFramework git submodule update --init --recursive cmake -S . -B build -G Visual Studio 18 2026 -A x64 -DCMAKE_BUILD_TYPERelease cmake --build ./build --config Release --target RE2最后一條的--target RE2是關(guān)鍵——每個(gè)游戲是獨(dú)立構(gòu)建目標(biāo)不帶 target 會(huì)全量編譯慢得能泡杯咖啡。COMPILING.md 里還有 VSCode CMake Tools 的流程和build_vs2022.bat一鍵全量腳本。C 或 C# 寫(xiě)插件兩個(gè)入口一條目錄規(guī)則C 插件的規(guī)則很簡(jiǎn)單DLL 丟進(jìn)持久目錄的reframework/plugins/PluginLoader會(huì)掃描目錄里所有.dll調(diào)用你導(dǎo)出的reframework_plugin_required_version檢查版本再調(diào)reframework_plugin_initialize拿初始化參數(shù)——之后你注冊(cè)on_present每幀畫(huà) UI、on_lua_state_created給 Lua 注入自定義全局函數(shù)等回調(diào)即可。examples/example_plugin/ 是完整的可編譯樣例連 ImGui 的 D3D11/D3D12 雙后端初始化都寫(xiě)好了。走 C# 的話看 csharp-api/REFrameworkNET是托管層測(cè)試項(xiàng)目 csharp-api/test/Test/ 里每個(gè)游戲一份TestRE2.cs、TestMHWilds.cs……[MethodHook]屬性直接掛在生成的引用程序集類(lèi)型上[MethodHook(typeof(app.CameraManager), nameof(app.CameraManager.isInside), MethodHookType.Pre)] public static PreHookResult isInsidePreHook(Spanulong args) PreHookResult.Continue;引用程序集不是手寫(xiě)的AssemblyGenerator會(huì)根據(jù) TDB 現(xiàn)場(chǎng)生成。本地聯(lián)調(diào)用make_symlinks.py --gamedir游戲目錄把構(gòu)建產(chǎn)物軟鏈到游戲目錄要管理員權(quán)限r(nóng)equirements.txt里就一個(gè)fire。測(cè)試工程還帶了 WebAPI 控制臺(tái)和 MCP server 的管道代碼test/Test/WebAPI/說(shuō)明官方自己在往游戲狀態(tài)可被外部程序消費(fèi)的方向走。順帶一提dependencies/里打包了 imnodes 節(jié)點(diǎn)編輯器組件框架代碼里也有 imnodes 的初始化與清理調(diào)用開(kāi)發(fā)者工具的圖形化能力有這塊打底。機(jī)制拆解為什么不用手寫(xiě)偏移量TDB 反射是整套設(shè)計(jì)的地基RE Engine 的托管類(lèi)型系統(tǒng)自帶一套叫 TDBType Definition Database的描述格式?？蚣軉?dòng)時(shí)把它解析成內(nèi)存里的類(lèi)型庫(kù)——每個(gè)方法、字段、屬性、單例都有名字和簽名版本號(hào)還分游戲RE2 是 tdb70、RE4 是 tdb71、RE9 已經(jīng)到 tdb83shared/sdk/regenny/下各游戲的生成頭文件目錄名直接寫(xiě)明了。這套東西解決的真實(shí)痛點(diǎn)是版本漂移。比如角色骨骼鏈的碰撞數(shù)據(jù)TDB 71 以下在偏移0x5871 及以上挪到了0x60ChainViewer.cpp 的注釋里原話記錄了這個(gè)坑。手寫(xiě)偏移的代碼每次游戲更新就報(bào)廢REFramework 的做法是按類(lèi)型名方法名字符串在運(yùn)行時(shí)查表分發(fā)ViaDispatch.hpp、GameIdentity.hpp這類(lèi)文件負(fù)責(zé)按 TDB 版本路由到對(duì)應(yīng)布局。你寫(xiě)腳本時(shí)看到的是sdk.find_type_definition(via.Transform):get_method(get_Position)偏移量的存在與否根本進(jìn)不了你的上下文。代價(jià)是調(diào)用比直調(diào)慢一點(diǎn)但對(duì)腳本場(chǎng)景完全無(wú)感。為什么是 dinput8.dll借 DirectInput 的殼借渲染循環(huán)的心跳注入點(diǎn)選dinput8.dll是因?yàn)樗闩渲糜螒虮緛?lái)就加載 DirectInput 庫(kù)你把文件往那兒一放DLL 就進(jìn)進(jìn)程了不需要改 loader、不需要驅(qū)動(dòng)。但光注入還不夠框架還需要一個(gè)穩(wěn)定的心跳來(lái)驅(qū)動(dòng) UI 和腳本回調(diào)。答案在 src/D3D11Hook.cpp 和 src/D3D12Hook.cpp鉤住 DX 的 Present每幀觸發(fā)on_present——ImGui 界面在這里畫(huà)Lua 的on_frame在這里跑VR 的覆蓋層也掛在這條鏈上OpenVR/OpenXR 運(yùn)行時(shí)抽象在 src/mods/vr/runtimes/。選 Present 當(dāng)心跳而不是自造定時(shí)器好處是節(jié)奏天然和渲染幀一致on_device_reset時(shí) ImGui 上下文還能整體重建狀態(tài)不懸空。決策參考路線適合代價(jià)Lua 腳本調(diào)參、改游戲?qū)ο?、快速試錯(cuò)改完即生效跑在主線程渲染循環(huán)里重計(jì)算會(huì)直接掉幀C 插件 DLL性能敏感邏輯、渲染層操作、常駐 ImGui UI要編譯導(dǎo)出函數(shù)和初始化流程不能少C# / REFrameworkNET強(qiáng)類(lèi)型、寫(xiě) MethodHook、復(fù)用 .NET 生態(tài)依賴(lài) AssemblyGenerator 生成的引用程序集鏈路多一環(huán)換方案的信號(hào)也很明確游戲不在支持列表RE2/3/4/7/村莊/ requiem、DMC5、SF6、MH 系、DD2 等 18 款之外——框架的生成頭文件和鉤子都是按游戲定制的沒(méi)有銀彈帶反篡改的 REENGINE_AT 游戲框架有IntegrityCheckBypass模塊且只對(duì)這類(lèi)游戲啟用但你仍要接受過(guò)校驗(yàn)這件事本身的存在要純靜態(tài)分析、不碰運(yùn)行時(shí)走 reversing/ 下的 rsz dumperUnicorn 模擬反序列化鏈推結(jié)構(gòu)布局和 pathdumper注意 rsz 工具鏈要求 Python ≤ 3.9想跨引擎通用這套 TDB 反射深度綁定 RE Engine 的類(lèi)型格式離開(kāi)這個(gè)引擎就沒(méi)有復(fù)用價(jià)值下一步構(gòu)建細(xì)節(jié)COMPILING.md腳本范本scripts/C 插件模板e(cuò)xamples/example_plugin/C# 測(cè)試工程csharp-api/test/Test/逆向工具鏈reversing/dumper、IDA 命名腳本、PAK 路徑提取完整 Lua API 文檔和最新構(gòu)建鏈接都放在 README 里【免費(fèi)下載鏈接】REFrameworkMod loader, scripting platform, and VR support for all RE Engine games項(xiàng)目地址: https://gitcode.com/GitHub_Trending/re/REFramework創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考