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.

Works on Windows and Linux dedicated servers. Requires BepInExPack for Valheim.

Configuration

BepInEx/config/DeathMonger.PauseMyServer.cfg (client side):

Section	Setting	Default	Meaning
General	Mod Enabled	true	Master toggle; disables every patch without removing the DLL. Restart required.
General	Show Messages	true	Top-left HUD message when the game resumes for a reason other than you closing your menu.
Admin	Pause Key	Pause	Admins only: toggle the server-wide pause. Ignored while typing in chat, the console or a text box.
Server	Publish State File	true	Keep PauseMyServer.state.json up to date for a monitor or dashboard. Servers only.
Pause Message	Show Pause Message	true	Show the persistent on-screen label while paused.
Pause Message	Text	Paused	The label text.
Pause Message	Admin Text	Paused by {0}	The label text during an admin pause; {0} is the admin's name.
Pause Message	Position	Bottom	Centered at the Top or the Bottom of the screen.
Pause Message	Font Size	40	Label size at a 1920x1080 reference; scales with the screen.
Pause Message	Show Unpaused Warning	true	Red label while a pause has been asked for and the game is still running.
Pause Message	Unpaused Text	Unpaused	The warning's first line.
Pause Message	Unpaused Count Text	{0}/{1} want to pause	The warning's second line, smaller: {0} have asked for a pause, {1} are online. Empty for no second line.

Label settings apply the next time the label appears, no restart needed. The server needs no configuration.

How it works

The server is the single authority. Clients only ever send wishes: "my menu is open", "my menu is closed", "toggle the admin pause". Every frame the server works out whether the world should be paused, either because every player online wants it or because an admin set the pause, and broadcasts the state to everybody when it changes, along with how many players want the pause. A client freezes only after the server confirms, so a server without the mod cannot leave a client frozen while the world runs on without it. A player who spawns asks for the current state, which is how a joiner during an admin pause is frozen too.

Client side, a handful of small Harmony patches: postfixes on Game.Pause and Game.Unpause track the menu, a postfix on Game.IsPaused reports "paused" once the server has confirmed and either the menu is still open or the pause is an admin pause, and a postfix on Player.OnSpawned requests the state. Vanilla's own Game.UpdatePause then sets the time scale to zero, the same code path solo uses. Closing the menu resumes locally at once, without waiting for the round trip.

Server side, three prefixes hold the parts of the world the server itself runs while its clients are frozen: ZNet.UpdateNetTime (the world clock), RandEventSystem.FixedUpdate (raids) and EnvMan.UpdateTimeSkip (sleeping). The server's own frame time is deliberately left running: at time scale zero the server would stop sending player lists and world data, and a joining player could never load in. Everything near a player is owned and simulated by that player's client, so freezing the clients freezes the rest.

While frozen, a client still answers the server's keep-alive pings (Valheim's receive loop does not depend on frame time), so nobody gets disconnected.

The label is drawn on the mod's own overlay canvas, above the menu, using the font of the game's own HUD messages. It shows whenever the game reports itself paused, which includes a solo host pausing.

Compatibility

• Does not touch Game.CanPause, so mods that let you pause in debug mode still work.
• Mods that change Time.timeScale themselves (speed-up or slow-motion mods) may fight with the freeze.
• Autosave keeps running on the server while paused; that is harmless.
• 1.1.0 and 1.2.0 work together either way round; older clients just do not see the counts in the red label.

Source

github.com/gbahns/ValheimMods