Guildrun Demo MOD 生態系

玩家自製 MOD 框架 - 為 Unity 6 + IL2CPP 的 Guildrun Demo (Steam) 量身打造。

🌟 倉庫家族

Guildrun Demo 玩家自製 MOD 框架,由 4 個獨立倉庫 組成,可單獨使用:

#	倉庫	用途	狀態
1	Guildrun-MOD-Core	模組核心:載入器與共用 API	✅
2	Guildrun-MOD-TraditionalChinese	繁體中文化補強(42+ 條目)	✅
3	Guildrun-MOD-Tools	遊戲內控制台 + 一鍵動作按鈕	✅
4	Guildrun-SaveEditor	Python 存檔編輯器(已可用!)	✅

編號 1-3 是遊戲內 BepInEx MOD(需要 BepInEx 6 IL2CPP) 編號 4 是獨立 Python 工具,不需要 BepInEx,但要關閉遊戲才能用

🏗️ 系統架構

Guildrun Demo/
└── BepInEx/
    ├── core/                  ← BepInEx 6 IL2CPP 核心
    ├── plugins/
    │   ├── Guildrun.MOD.Core.dll        ← [1] 核心(必須)
    │   └── Guildrun.Modules/             ← 模組資料夾
    │       ├── Guildrun.MOD.TraditionalChinese.dll  ← [2]
    │       └── Guildrun.MOD.Tools.dll               ← [3]
    └── interop/                ← BepInEx 自動產生

存檔路徑(用 [4] 修改):

%LocalAppData%\Low\Leyline\Guildrun\Saves\steam-<你的 SteamID>\
├── Profile        ← 跨 Run 進度(等級/XP/BonusTokens)
└── Run            ← 當前 Run 資料(巢狀 MessagePack)

🚀 5 分鐘快速開始

方案 A:純存檔修改(推薦新手)

1. 安裝 Python 依賴

   pip install msgpack rich

2. 下載 Guildrun-SaveEditor
3. 關閉遊戲
4. 執行

   python save_editor.py gold 99999
   python save_editor.py maxall

5. 啟動遊戲 享受修改後的進度

方案 B:完整 MOD 框架

1. 安裝 BepInEx 6 IL2CPP 至遊戲根目錄
2. 下載 Guildrun-MOD-Core 的 Guildrun.MOD.Core.dll
3. 放到 BepInEx/plugins/
4. (選用) 下載 TraditionalChinese 與 Tools
5. 放到 BepInEx/plugins/Guildrun.Modules/
6. 啟動遊戲 → 按 F1 開啟控制台

🎮 功能對照

功能	Core	TraditionalChinese	Tools	SaveEditor
模組載入	✅
繁體中文化		✅
遊戲內控制台			✅
一鍵動作按鈕			✅
修改金幣			⚠️ mock	✅
修改等級			⚠️ mock	✅
修改難度			⚠️ mock	✅
修改存檔無需啟動遊戲				✅
不需 BepInEx				✅

⚠️ Tools 的「一鍵按鈕」目前大多為 mock 輸出,實作需更多 reflection 修正。 對於實際修改遊戲資料,SaveEditor 是目前最可靠的方式。

📊 技術棧

項目	採用
遊戲引擎	Unity 6000.0.64f1
編譯	IL2CPP
注入器	BepInEx 6.0.0-be.785
程式語言	C# (.NET 6.0)
存檔格式	MessagePack (巢狀)
平台	Windows / Steam

🤝 貢獻

歡迎開 PR 到任何一個子倉庫!

• 新的功能模組 → Core
• 新的翻譯條目 → TraditionalChinese
• 新的控制台命令 → Tools
• 新的存檔功能 → SaveEditor

📜 授權

所有倉庫使用 MIT License - 自由使用、修改、商業化。

遊戲本體版權屬 Leyline。

🔗 相關連結

• Steam - Guildrun Demo
• BepInEx Build
• Leyline 開發者 (正式版)

---

📜 開發筆記

• 開發日期: 2026-08-09
• 開發者: edmun + Claude Fable 5
• 狀態: 全部 v0.1.0 已發佈