PONEIS-WorldSavePlus icon

WorldSavePlus

Adds ESC 'Save Server' / Salvar Server for dedicated worlds. AllowEveryone or adminlist, 30s cooldown.

Last updated a week ago
Total downloads 149
Total rating 0 
Categories Mods Misc Tools Server-side Client-side
Dependency string PONEIS-WorldSavePlus-1.0.1
Dependants 1 other package depends on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350

README

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