Guildrun Demo 存檔編輯器

直接讀寫 MessagePack 格式存檔,繞過 Unity IL2CPP 反射,100% 可靠。

功能

• 📋 檢視 Profile 與 Run 存檔(已遞迴解碼巢狀 Payload)
• 💰 修改金幣:直接設定 CurrentShards 數值
• ⚡ 一鍵全滿:等級/XP/BonusTokens/金幣/難度全部拉滿
• 🔧 自訂修改:設定任意 key 的值,支援巢狀路徑
• 💾 自動備份:每次修改前自動備份為 .bak

系統需求

• Python 3.10+
• pip install msgpack rich

安裝

pip install msgpack rich

使用方式

0. 關閉 Guildrun Demo(必要!)

存檔被遊戲鎖住,一定要先關閉遊戲才能修改。

1. 顯示存檔內容

python save_editor.py show both
python save_editor.py show profile
python save_editor.py show run

2. 修改金幣

python save_editor.py gold 99999

3. 一鍵全滿

python save_editor.py maxall

4. 設定任意 key

# 修改 Run 檔案
python save_editor.py run CurrentShards 99999
python save_editor.py run DifficultyIndex 8

# 修改 Profile 檔案
python save_editor.py profile CurrentLevel 99
python save_editor.py profile BonusTokens 999

5. 重啟遊戲

修改完必須重啟遊戲才會生效。

存檔位置

自動找:

C:\Users\edmun\AppData\LocalLow\Leyline\Guildrun\Saves\steam-<你的SteamID>\
├── Profile        ← 跨 Run 進度(等級/XP/BonusTokens)
├── Run            ← 當前 Run 資料(金幣/HP/章節/遺物)
└── steam_autocloud.vdf

可手動指定:

python save_editor.py --save-dir "D:\path\to\Save" gold 99999

Profile 欄位

Key	說明
CurrentLevel	等級 (Int)
CurrentXP	經驗值 (Int)
BonusTokens	Bonus 代幣 (Int)
TotalStartedRuns	開始 Run 數 (Int)
TotalRunsBeaten	通關 Run 數 (Int)
HighestDifficultyBeaten	最高通關難度 (Int)
MetaProgressionVersion	Meta 進度版本 (Int)

Run.Payload 欄位

Run 檔案的 Payload 是巢狀 MessagePack:

Key	說明
PlayerDataDto.CurrentShards	金幣 (Int)
PlayerDataDto.AccumulatedShards	累積金幣 (Int)
PlayerDataDto.IsPlayerDefeated	玩家是否死亡 (Bool)
PlayerDataDto.IsStabilizerActive	穩定器啟用 (Bool)
PlayerDataDto.ActiveRelics	持有遺物 (Dict)
DifficultyDto.DifficultyIndex	難度 (Int)
RunSessionDto.CurrentAct	當前 Act
RunSessionDto.CurrentFloor	當前樓層

Windows 批次檔範例

存成 guildrun.bat:

@echo off
cd /d %~dp0
set PYTHONIOENCODING=utf-8
python save_editor.py %*

之後用:

guildrun gold 99999
guildrun maxall

自動備份

每次修改前自動建立 .bak:

Profile        ← 目前檔案
Profile.bak    ← 上次修改前的備份

要還原:

cp Profile.bak Profile

技術細節

• 格式:MessagePack (含巢狀)
• 編碼:UTF-8 (用 use_bin_type=True)
• 依�:僅 msgpack + rich(可選)
• 解碼策略:自動解碼 Run.Payload 內層巢狀 MessagePack

授權

MIT

---

🌐 Guildrun MOD 生態系

倉庫	用途
Guildrun-MOD-Core	模組核心
Guildrun-MOD-TraditionalChinese	繁中補強
Guildrun-MOD-Tools	遊戲內控制台
Guildrun-SaveEditor ← 本倉庫	Python 存檔編輯器