WorldSavePlus

WorldSavePlus

Save a dedicated Valheim world from the ESC menu with a clear Save Server / Salvar Server button — separate from vanilla Save.

Built for Valheim 1.0 + BepInEx.

Support: ko-fi.com/tudoecriativo

---

Why

On dedicated servers it is unclear whether ESC Save affects the world or only the character. WorldSavePlus adds an explicit Save Server entry that asks the dedicated server to write the world now, with a simple permission policy and a global cooldown.

Vanilla Save is left unchanged.

---

How to use

1. Install the mod on the dedicated server and on your game client
2. Join the server
3. Press ESC
4. Click Save Server (English) / Salvar Server (Portuguese)
5. Wait for the confirmation toast (or cooldown / permission message)

Hotkey (optional): F6 by default (client config).

| Action | Default | |---|---| | ESC button | Save Server / Salvar Server | | Hotkey | F6 | | Global cooldown | 30 seconds |

The button is hidden in singleplayer (vanilla Save already covers the local world).

---

Install

Both sides matter:

| Where | Required? | Why | |---|---|---| | Dedicated server | Yes | Enforces permissions, cooldown, and runs the world save | | Client | Yes | ESC button, hotkey, and localized toasts |

Steps

1. Install BepInExPack Valheim 5.4.2350 or newer
2. Install WorldSavePlus (r2modman / Thunderstore Mod Manager, or copy plugins/WorldSavePlus.dll into BepInEx/plugins/)
3. Restart the server, then the client

---

Permissions

Server config file (created on first run):

BepInEx/config/poneis.valheim.WorldSavePlus.cfg

| AllowEveryone | adminlist.txt | Who can save | |---|---|---| | true | any | Everyone connected | | false (default) | has player IDs | Only listed admins | | false | empty | Nobody |

Recommended setups

• Private friends server: set AllowEveryone = true
• Public / shared server: keep AllowEveryone = false and put admin Platform User IDs in adminlist.txt

Platform User IDs come from the in-game F2 panel or the server log ([Platform]_[UserID]).

---

Configuration

Server (Permissions)

| Key | Default | Description | |---|---|---| | AllowEveryone | false | If true, any player may request a server world save | | CooldownSeconds | 30 | Global cooldown after an accepted client save (5–300) |

Client

| Key | Default | Description | |---|---|---| | EnableHotkey | true | Allow hotkey save requests | | Hotkey | F6 | Key to request a server world save (None to disable) | | Language | Auto | Auto, English, or Portuguese |

---

Features

• Dedicated ESC button: Save Server / Salvar Server
• Optional hotkey (F6)
• Server-side permission check (AllowEveryone or adminlist.txt)
• Global cooldown (default 30s)
• Toast + console feedback (EN/PT)
• Does not replace vanilla ESC Save
• Autosaves on the dedicated server are unchanged

---

Notes

• Only client-originated save requests use this mod’s permission + cooldown rules
• Server-local / automatic saves keep vanilla behaviour
• If the server does not have WorldSavePlus installed, the client button cannot enforce the custom policy / reliable dedicated save flow

---

Support

If WorldSavePlus helps your server, you can support continued maintenance here:

ko-fi.com/tudoecriativo

Tips help cover the time spent keeping mods working after game updates. Thank you!

---

Changelog

1.0.1

• Add ESC button Save Server / Salvar Server (separate from vanilla Save)
• Hide the button in singleplayer
• Clearer save toasts for server world saves

1.0.0

• Initial release: dedicated world save via ESC Save / F6
• AllowEveryone + adminlist permission policy
• Global 30s cooldown
• EN/PT localization