PauseMyServer

Pause My Server

Pause a server-hosted Valheim game.

Vanilla only pauses when you host the world yourself and nobody else is connected. On a dedicated server the menu never pauses anything: the day rolls on, raids fire, your smelter finishes and the boar you were fighting keeps chewing. This mod gives you two ways to pause a server.

Everyone asking for a pause pauses the game

When every player online has asked for a pause, the world pauses, exactly like solo. Opening the ESC menu is how you ask; a mod can ask for you (see below):

• Every client freezes (monsters, ships, physics, crafting, everything you see).
• The server freezes its world clock, so day and night, weather, plant growth, fermenters, beehives and respawn timers stop too.
• Raids and other random events are held.
• A sleep time-skip in progress waits.

Alone on the server, that is just you: open the menu and the world stops. With friends, the game pauses the moment the last of you asks. Anyone closing their menu resumes it instantly, and so does a new player arriving (you will see a small message if your menu is still open).

While you have asked for a pause but the game keeps running because others are still playing, the label reads "Unpaused" in bright red, with "1/3 want to pause" underneath, so a pause you asked for and did not get is never silent.

Vanilla behavior is kept for hosted (non-dedicated) games, where the host already pauses when alone; with guests online the host's request counts like everyone else's.

Other mods can ask for a pause

Any mod that calls Valheim's own Game.Pause() and Game.Unpause() takes part, with no reference to this mod and no API to call. The request goes to the server like a menu request, counts towards "everyone has asked", and the red warning appears if it is refused. Two of ours do it: The Greatest Map pauses while the large map is open, and Grab Materials while the inventory panel is open.

For a mod that wants to show its own state, Game.IsPaused() is the honest answer: it is true only when the game really is frozen, whether this mod is installed or not. There is nothing else to query.

One caveat, and it is vanilla's: the game keeps a single pause flag, not a count. If two mods ask at once and one of them calls Game.Unpause(), the request is dropped for both. A mod that pauses for a panel should re-assert while its panel is open.

Admin pause

An admin (listed in the server's adminlist) presses the pause key, by default the keyboard's Pause key, to pause the whole server for everyone, whatever their menus:

• Every client freezes, whether or not their menu is open.
• Players who join during the pause are frozen as soon as they spawn.
• The pause stays until any admin presses the key again. A non-admin who presses it gets a notice.
• The label reads "Paused by <admin>", and everyone gets a "Game resumed by <admin>" message afterwards.
• Safety net: when the last player leaves, an admin pause is dropped, so the next player to log in is not frozen with nobody online to resume.

Console commands (F5): pms_pause toggles the admin pause like the key, and pms_status prints the state. On the dedicated server's own console pms_pause toggles directly, which is the way out if no admin is online.

The admin pause is designed for dedicated servers. On a hosted (non-dedicated) game the host freezes with everyone else, and a player joining during the pause may have to wait until it is lifted.

The on-screen label

A persistent label is shown while the game is paused, in solo games too: "Paused", or "Paused by <admin>". When a pause has been asked for and the game is still running, it turns bright red and reads "Unpaused", with "1/3 want to pause" on a second line in a smaller font. It waits half a second first, so the trip to the server and back never flashes red, and it stays quiet during the intro and cinematics. Texts, position (top or bottom) and size are configurable, and each mode can be turned off.

Telling a monitor or dashboard

The server keeps a small JSON file up to date so anything outside the game can see the pause state without scraping the log:

BepInEx/config/PauseMyServer.state.json

{"paused":true,"by":"Genius","wanting":1,"players":2,
 "since":"2026-09-23T17:45:12.482Z","written":"2026-09-23T17:46:02.114Z",
 "heartbeat":5,"version":"1.5.0"}

| Field | Meaning | |---|---| | paused | Whether the world is frozen right now. | | by | Who holds it: an admin's name, a player's name, or everyone. Empty when not paused. | | wanting | How many players have asked for a pause. | | players | How many are online. | | since | When paused last flipped, UTC. | | written | When this file was last written, UTC. | | heartbeat | Seconds between rewrites while nothing changes. | | version | The mod version that wrote it. |

Read it by age, not just by content. The file is rewritten on every change and again every few seconds regardless, so written tells you the mod is alive. That is the whole trust model: fresh means live, stale means ignore it. Allow three missed heartbeats before calling it dead, and treat a missing file as "not running", which is also what you get deliberately when the world shuts down.

Writes are atomic, to a temporary file that is then swapped in, so a reader can never catch a half-written file. Only servers write it, clients never do, and Publish State File under Server turns it off.

Installation

Install on the server and on every client (Gale, r2modman or Thunderstore Mod Manager, or drop PauseMyServer.dll into BepInEx/plugins). Keep the same version everywhere.

• Server without the mod: clients simply never pause, same as vanilla. Nothing breaks.
• Client without the mod: that player cannot ask for a pause, so the game never pauses while they are online unless an admin pauses; they are not frozen by an admin pause either.