指南:以撒腳本擴展器一次跑通)
REPENTOGON 安裝實戰(zhàn)指南以撒腳本擴展器一次跑通【免費下載鏈接】REPENTOGONScript extender for The Binding of Isaac: Repentance項目地址: https://gitcode.com/gh_mirrors/re/REPENTOGONREPENTOGON 是《以撒的結(jié)合懺悔》的 Lua 腳本擴展器它直接掛鉤游戲本體在官方 API 之外提供數(shù)百個新接口、性能優(yōu)化與存檔保護。 讀完本文你將在 Windows 或 Linux/Steam Deck 上完成從獲取啟動器、首次初始化到存檔導(dǎo)入、手柄配置的全部流程。什么情況下該上它適合這三類人你的模組功能已經(jīng)卡在官方 Lua API 的邊界上只能靠又慢又脆的 hack 繞路多個模組同時加載卡頓切房間掉幀想讓整個生態(tài)跑得穩(wěn)你在懺悔與懺悔之間來回切換成就和解鎖項在存檔里失蹤。它不是又一個模組而是生態(tài)的地基基于與 Antibirth 同源的 LibZHL 框架直接掛鉤游戲內(nèi)部做到普通 Lua 模組做不到、或需要重寫到性能爆炸才能做到的事。裝之前先把這幾項對上檢查項要求確認方式游戲本體懺悔 最新官方 Steam 版或v1.9.7.12.J273二選一Steam 屬性中查看游戲版本操作系統(tǒng)Windows 10/11或 Linux含 Steam Deck查看系統(tǒng)信息磁盤空間預(yù)留 200MB 以上查看磁盤剩余容量啟動器獲取 REPENTOGONLauncher下文主線第 1 步克隆完成后確認REPENTOGONLauncher.exe存在一個版本常識REPENTOGON 基于 v1.9.7.12.J273 開發(fā)但啟動器允許你基于 Steam 最新版安裝。運行時游戲會缺少個別最新官方補丁的內(nèi)容——這是設(shè)計如此官方文檔有明確說明不用當(dāng)作故障處理。安裝實戰(zhàn)一條主線兩個分叉4.1 通用主線三步完成初始化第 1 步獲取。克隆倉庫里面自帶完整文檔與工具鏈git clone https://gitcode.com/gh_mirrors/re/REPENTOGON第 2 步放對位置。啟動器要放在穩(wěn)定、無同步的目錄。兩條禁忌記牢不要直接解壓進游戲安裝目錄根下可能引發(fā)文件沖突不要在游戲目錄里預(yù)先創(chuàng)建叫repentogon的文件夾這個路徑后面由啟動器自己使用。第 3 步首次初始化。運行REPENTOGONLauncher.exe會彈出首次設(shè)定窗口詢問懺悔可執(zhí)行文件的位置。多數(shù)情況下自動檢測檢測不到就點Select executable...定位到isaac-ng.exe點Next繼續(xù)。啟動器每次啟動都會檢查更新——看到更新提示就接受保持最新能避開大部分兼容性問題。4.2 Windows 分叉Windows 與主線的差異只有兩處位置選點和接入 Steam。位置推薦兩個穩(wěn)妥落點——磁盤根目錄新建C:/REPENTOGONLauncher/或游戲安裝目錄內(nèi)新建REPENTOGONLauncher子文件夾。桌面、文檔這類 OneDrive 同步目錄容易出權(quán)限問題別放。Steam 啟動選項Steam 遠程暢玩正常工作的前置條件Steam 庫右鍵《以撒的結(jié)合重生》→屬性→常規(guī)在啟動選項填入(你的 REPENTOGONLauncher.exe 完整路徑)--isaac%command%路徑替換成真實值引號保留參數(shù)一個字符都不能少。4.3 Linux / Steam Deck 分叉這個平臺的差異在于啟動器必須放進游戲目錄再用一條命令把啟動流程交給它。Steam Deck 用戶先切換到桌面模式Steam 中進入《以撒的結(jié)合重生》屬性→已安裝文件→瀏覽打開安裝目錄在游戲目錄內(nèi)新建REPENTOGONLauncher文件夾把啟動器解壓進去若文件夾里已有舊版升級帶來的REPENTOGONLauncher.exe此步可跳過核對最終路徑必須是.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe——不要多套一層文件夾也不要改錯名字回到屬性→常規(guī)把啟動選項替換為這一行echo %command% | sed s|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe| | sh它的作用是把 Steam 原本要執(zhí)行的isaac-ng.exe替換成 REPENTOGON 啟動器。在兼容性區(qū)域開啟兼容層鎖定為Proton 9.0-4。?? 啟動后毫無反應(yīng)時按路徑 → 啟動參數(shù) → Proton 版本的順序逐項復(fù)查三處必須全部吻合。首次運行冒煙測試進入標(biāo)題界面后依次做這三件事每件都很快。驗證安裝隨便開一局按~打開 REPENTOGON 控制臺輸入help能看到命令列表即一切正常??刂婆_也是后續(xù)一切調(diào)試的入口。補回失蹤的成就懺悔 與懺悔使用不同存檔文件而官方只在首次啟動懺悔時自動導(dǎo)入一次——所以你過去的進度很可能還停著。在標(biāo)題屏幕按~→ 左上角Tools→Game Options→ 切到Save Management標(biāo)簽 → 點Import from Repentance。按鈕是灰色的話說明你沒在標(biāo)題屏幕該操作只補齊另一版本缺的內(nèi)容永遠不會刪除已有成就。規(guī)范手柄按鍵8BitDo 等第三方手柄到游戲?qū)傩浴刂破靼?Override 設(shè)為Enable Steam Input。?? 這個改動必須完全關(guān)閉 Isaac 和 REPENTOGON 啟動器后重啟才生效仍異常時進游戲內(nèi)按鍵映射菜單點Reset To Default。兩個長期習(xí)慣順手帶上啟動器的每次啟動更新提示直接接受重大模組變動前先備份存檔。進階玩法接入你的開發(fā)流Basement Renovator 聯(lián)動。房間編輯器需要3.3.1 及以上版本才能與 REPENTOGON 配合。確認 REPENTOGON 初始化正常后打開 Basement Renovator 的File→Set Paths把.exe Path改為你的REPENTOGONLauncher.exe。之后測試房間會自動經(jīng) REPENTOGON 啟動游戲安裝若損壞會彈啟動器窗口而不是靜默失敗。API 與源碼在哪。Lua API 完整文檔在 docs/docs/Lua 接口實現(xiàn)位于 repentogon/LuaInterfaces/底層掛鉤框架在 libzhl/。啟動器自帶的模組管理器還會替換游戲原有的模組加載邏輯加載時間有明顯改善。源碼構(gòu)建最小流程必須 Windows與游戲同編譯器CMake 3.13、Git、Visual Studio 2019git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON打開 CMake源碼目錄指向倉庫根目錄產(chǎn)物目錄任選點Configure編譯器與你的 VS 版本一致平臺必須選 Win32其余保持默認點Generate生成.sln用 Visual Studio 打開按Release模式構(gòu)建把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll復(fù)制到游戲目錄或把ISAAC_DIRECTORY設(shè)為游戲根目錄構(gòu)建后自動復(fù)制。出問題先查這張表癥狀第一反應(yīng)解決路徑啟動器提示安裝損壞/無效重啟啟動器接受更新提示主窗口Choose exe重走首次設(shè)定Steam 校驗游戲文件完整性有重下就等完Update/Repair Installation→Re-install/Repair REPENTOGON仍無效則刪除游戲目錄下repentogon子文件夾后重開啟動器游戲啟動即崩潰先懷疑新官方補丁新補丁剛發(fā)布就先更新啟動器仍失敗則等待官方最多約一天跟進走完上一條修復(fù)流程用Check Game Logs按鈕取日志再報告Steam 遠程暢玩失效啟動選項沒配對Windows 核對--isaac%command%是否完整Linux 核對 sed 命令與Proton 9.0-4是否鎖定成就與解鎖突然不見存檔沒丟只是跨版本結(jié)構(gòu)不同按首次運行冒煙測試第 2 條做存檔導(dǎo)入一鍵補齊手柄按鍵錯亂設(shè)置未生效完全關(guān)閉 Isaac 與啟動器后重啟或進游戲內(nèi)按鍵映射Reset To Default收尾下一個動作很明確在標(biāo)題屏幕按~敲help確認控制臺響應(yīng)正常。然后翻一翻 docs/docs/ 里的 API 文檔看看新增的幾百個接口能做什么。配置途中摸出任何捷徑發(fā)到社區(qū)里幫下一個人少走彎路?!久赓M下載鏈接】REPENTOGONScript extender for The Binding of Isaac: Repentance項目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考