ValheimSaveShare

ValheimSaveShare 存檔共享

通過 GitHub 分享 Valheim 世界存檔的 BepInEx 模組。

Share Valheim worlds between friends via your own GitHub repository.

功能 / Features

• 「共享存檔」頁籤：在主菜單"開始遊戲 / 加入遊戲"旁新增第三個頁籤，列出你已添加爲共享的存檔（與開始遊戲頁籤同樣的世界列表樣式）。選中即可開始遊戲。
• 添加共享（下載）：頁籤內「添加共享」按鈕 → 粘貼 GitHub 鏈接（倉庫主頁或世界文件夾鏈接均可）→ 自動下載 manifest.json + 全部存檔文件到 worlds_local//，帶逐文件進度與取消。下載完成自動出現在世界列表。
• 支持中文世界名、私有倉庫（下載時需配置 Token）、同名存檔覆蓋前自動 zip 備份、遊戲版本不一致提示。

首次配置 / Setup

上傳需要你有一個 GitHub 倉庫和令牌（下載別人的公開分享不需要任何配置）：

• 在 github.com/new 新建一個空倉庫（如 valheim-shared-worlds，公開或私有均可）。
• 編輯 BepInEx/config/SuperVikingDepartment.ValheimSaveShare.cfg，填入 [GitHub] Repo：

[GitHub]

Repo = 你的用戶名/valheim-shared-worlds

Branch =; 留空自動用默認分支

PathPrefix = worlds

• 把 token 填進 %AppData%\ValheimSaveShare\token.dat（資源管理器地址欄粘貼該路徑即可打開；首次運行遊戲會自動生成帶說明的模板文件）：github.com → Settings → Developer settings → Fine-grained tokens → Generate，只勾選該倉庫的 Contents: Read and write，把 github_pat_ 開頭的字符串粘貼到說明下方單獨一行保存。

Token 存放位置 / Token storage：token 存放在 %AppData%\ValheimSaveShare\token.dat，不在 cfg 裏。想換 token 直接覆蓋文件裏的 token 行；想作廢 token 到 GitHub token 管理頁 Revoke。

已共享的存檔記錄（世界名 → 鏈接）保存在 BepInEx/config/ValheimSaveShare.shared.json。

鏈接格式 / Accepted URLs

• —— 自動在 worlds/ 下找（僅一個世界時直接用）
• —— 指定世界文件夾

-

注意事項 / Notes

• 分塊存檔與上傳速度：分塊存檔的世界（.db2 拆成幾十上百個.chunk）自動打包爲單個 world.zip 一次請求上傳（zip 內部已壓縮），上傳期間彈窗顯示已用時間，不是卡死。
• 國內網絡/代理：直連 api.github.com 困難時，在 cfg 的 [GitHub] Proxy 填本地代理端口（如
• Steam 雲存檔：開啓 Steam 雲的世界（存檔在 worlds/ 雲端而非本地磁盤）上傳時，通過遊戲自帶 FileReader/Steam 雲存儲讀取，與本地存檔（worlds_local/）一樣支持；下載的世界一律落地爲本地存檔（worlds_local/，列表中帶“本地”圖標）。若雲端已有同名世界，下載時會提示無法自動覆蓋，請先在遊戲內刪除或改名。
• 共享的是世界快照（手遞手式共享，不是實時同步）。建議一個世界只由"房主"上傳，其他人只下載，避免互相覆蓋進度。
• 遊戲掃描器會刪除不成組的存檔文件，因此本 mod 總是整組上傳/下載.fwl2.db2.ok.chunks.chunk；手動搬運時也請整組複製。
• 打包後超過 90 MB 時上傳會被拒絕（GitHub Contents API 100 MB 限制），後續版本考慮改走 Release Assets。
• 第三個頁籤基於原版控件克隆，手柄對列表行的導航暫未適配（頁籤左右切換、按鈕點擊正常），歡迎反饋。
• Token 保存在 %AppData%\ValheimSaveShare\token.dat（cfg 中無 Token 字段）；請勿把 token 本身分享給他人。

構建 / Build./build-package.sh # 產物 dist/SuperVikingDepartment-ValheimSaveShare-.zip./sync-install.sh # 同步到遊戲 BepInEx/plugins 與 r2modman profile（需先退出遊戲）