ValheimSaveShare

ValheimSaveShare Save Share

Share the BepInEx mod for the Valheim world archive via GitHub.

Share Valheim worlds between friends via your own GitHub repository.

Features / Features

• "Shared Archives" tab: Add a third tab next to "Start Game/Join Game" in the main menu to list the archives you have added as shared (the same world list style as the Start Game tab). Select to start the game.
• Add sharing (download): "Add sharing" button in the tab → Paste the GitHub link (either the warehouse homepage or the world folder link) → Automatically download manifest.json + all archive files to worlds_local//, with file-by-file progress and cancellation. The download will automatically appear in the world list.
• Supports Chinese world names, private warehouses (Token needs to be configured when downloading), automatic zip backup before overwriting archives with the same name, and game version inconsistency prompts.

First time configuration/Setup

Uploading requires you to have a GitHub repository and token (downloading other people's public shares does not require any configuration):

• Create a new empty warehouse (such as valheim-shared-worlds, public or private) at github.com/new.
• Edit BepInEx/config/SuperVikingDepartment.ValheimSaveShare.cfg and fill in [GitHub] Repo:

[GitHub]

Repo = yourusername/valheim-shared-worlds

Branch =; Leave blank to automatically use the default branch

PathPrefix = worlds

• Fill in the token into %AppData%\ValheimSaveShare\token.dat (paste this path in the address bar of the resource manager to open it; a template file with instructions will be automatically generated when running the game for the first time): github.com → Settings → Developer settings → Fine-grained tokens → Generate. Only check Contents: Read and write of the repository, and paste the string starting with github_pat_ into a separate line below the description to save.

Token storage location/Token storage: token is stored in %AppData%\ValheimSaveShare\token.dat, not in cfg. If you want to change the token, directly overwrite the token line in the file; if you want to invalidate the token, go to Revoke on the GitHub token management page.

Shared save records (world name → link) are saved in BepInEx/config/ValheimSaveShare.shared.json.

Link format / Accepted URLs

• —— 自动在 worlds/ 下找（仅一个世界时直接用）

-——Specify world folder

-

Notes/Notes

• Chunked archive and upload speed: The world of chunked archives (.db2 is split into dozens or hundreds of .chunks) is automatically packaged into a single world.zip and uploaded with one request (the zip is internally compressed). During the upload, a pop-up window displays the elapsed time, and it is not stuck.
• 国内网络/代理：直连 api.github.com 困难时，在 cfg 的 [GitHub] Proxy 填本地代理端口（如
• Steam cloud archive: When uploading a world in the Steam cloud (the archive is in the worlds/ cloud instead of the local disk), it can be read through the game's own FileReader/Steam cloud storage, which is supported in the same way as local archives (worlds_local/); downloaded worlds will always be local archives (worlds_local/, with a "local" icon in the list). If there is already a world with the same name in the cloud, you will be prompted when downloading that it cannot be automatically overwritten. Please delete or change the name in the game first.
• What is shared is a snapshot of the world (hand-to-hand sharing, not real-time synchronization). It is recommended that a world be uploaded only by the "host" and others only download it to avoid overwriting each other's progress.
• The game scanner will delete archive files that are not grouped, so this mod always uploads/downloads .fwl2.db2.ok.chunks.chunk as a group; please also copy the entire group when moving manually.
• If the package size exceeds 90 MB, the upload will be rejected (GitHub Contents API 100 MB limit). Consider switching to Release Assets for subsequent versions.
• The third tab is based on a clone of the original control. The handle is not yet ad …