通过 GitHub 分享 Valheim 世界：共享存档页签一键下载，共享按钮一键上传，支持 Steam 云存档、私有仓库与代理；GitHub Token 存放于 %AppData%ValheimSaveShare。通过 GitHub 分享 Valheim 世界：上传和下载存档并显示进度。Token 存放于 %AppData%。

英灵神殿存档共享 存档共享

通过 GitHub 分享 Valheim 世界存档的 BepInEx 模组。

通过你自己的GitHub仓库，在朋友之间分享英灵神殿世界。

功能

• “共享存档”标签页：在主菜单"开始游戏 / 加入游戏"旁新增第三个页签，列出你已添加为共享的存档（与开始游戏页签同样的世界列表样式）。选中即可开始游戏。
• 添加共享（下载）：页签内「添加共享」按钮 → 粘贴 GitHub 链接（仓库主页或世界文件夹链接均可）→ 自动下载 manifest.json + 全部存档文件到 世界本地化/<世界名>/，带逐文件进度与取消。下载完成后会自动出现在世界列表中。
• 支持中文世界名、私有仓库（下载时需配置 Token）、同名存档覆盖前自动 zip 备份、游戏版本不一致提示。

首次配置 / 设置

上传需要你有一个 GitHub 仓库和令牌（下载别人的公开分享不需要任何配置）：

1. 在 github.com/new 新建一个空仓库（如 英灵神殿共享世界，公开或私有均可）。
2. 编辑 BepInEx/config/SuperVikingDepartment.ValheimSaveShare.cfg，填入 [GitHub] 仓库：

[GitHub] 仓库 = 你的用户名/valheim-shared-worlds 分支 = ; 留空自动用默认分支 路径前缀 = worlds

1. 把 token 填进 %AppData%\ValheimSaveShare\token.dat（资源管理器地址栏粘贴该路径即可打开；首次运行游戏会自动生成带说明的模板文件）：github.com → 设置 → 开发者设置 → 细粒度令牌 → 生成，只勾选该仓库的 内容：读取和写入， 把 github_pat_ 开头的字符串粘贴到说明下方单独一行保存。

令牌存放位置 / 令牌存储：token 存放在 %AppData%\ValheimSaveShare\token.dat，不在 cfg 里。想换 token 直接覆盖文件里的 token 行；想作废 token 到 GitHub token 管理页 Revoke。

已共享的存档记录（世界名 → 链接）保存在 BepInEx/config/Valheim保存共享.json。

链接格式 / 接受的网址

• https://github.com/<user>/<repo> —— 自动在 世界/ 下找（仅一个世界时直接用）
• https://github.com/<user>/<repo>/tree/main/worlds/我的世界 —— 指定世界文件夹
• https://raw.githubusercontent.com/<user>/<repo>/main/worlds/我的世界/manifest.json

注意事项 / 备注

• 分块存档与上传速度：分块存档的世界（.db2 拆成几十上百个 .chunk）自动打包为单个 世界.zip 一次请求上传（zip 内部已压缩），上传期间弹窗显示已用时间，不是卡死。
• 国内网络/代理：直连 api.github.com 困难时，在 cfg 的 [GitHub] 代理 填写本地代理端口（如 http://127.0.0.1:7890），上传下载全部通过该代理。
• Steam 云存档开启 Steam 云的世界（存档在 世界/ 云端而非本地磁盘）上传时，通过游戏自带 FileReader/Steam 云存储读取，与本地存档（世界/本地/一样支持；下载的世界一律落地为本地存档（世界_本地/，列表中带“本地”图标）。若云端已有同名世界，下载时会提示无法自动覆盖，请先在游戏内删除或改名。
• 共享的是世界快照（手动传递式共享，并非实时同步）。建议每个世界仅由“房主”上传，其他成员只下载，以免互相覆盖进度。
• 游戏扫描器会删除不成组的存档文件，因此本 mod 总是整组上传/下载 .fwl2/.db2/.ok/.chunks/.chunk；手动搬运时也请整组复制。
• 打包后超过 90 MB 时上传会被拒绝（GitHub Contents API 100 MB 限制），后续版本考虑改走 Release Assets。
• 第三个页签基于原版控件克隆，手柄对列表行的导航暂未适配（页签左右切换、按钮点击正常），欢迎反馈。
• Token 保存在 %AppData%\ValheimSaveShare\token.dat（配置中无令牌字段）；请勿将令牌本身分享给他人。

构建 / 建造

./build-package.sh # 产物 dist/SuperVikingDepartment-ValheimSaveShare-<ver>.zip
./sync-install.sh # 同步到游戏 BepInEx/plugins 与 r2modman 配置文件（需先退出游戏）