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