You are viewing a potentially older version of this package. View all versions.
TaegukGaming-Valheim_ServerGuard-2.4.0 icon

Valheim ServerGuard

Anti-cheat, mod allowlist, staff dev commands and admin tools for Valheim. One mod for both server and client: locks players to your modpack, gives owners/moderators dev commands, personal boss progression, Discord logging, raid alerts, build forensics.

Date uploaded a week ago
Version 2.4.0
Download link TaegukGaming-Valheim_ServerGuard-2.4.0.zip
Downloads 35
Dependency string TaegukGaming-Valheim_ServerGuard-2.4.0

This mod requires the following mods to function

ValheimModding-YamlDotNet-16.3.1 icon
ValheimModding-YamlDotNet

Shared version 16.3.0 of YamlDotNet from Antoine Aubry and contributors, net47 package for use in Valheim mods. Maintained by the ValheimModding team.

Preferred version: 16.3.1
ValheimModding-JsonDotNET-13.0.4 icon
ValheimModding-JsonDotNET

Shared version 13.0.3 of Json.NET from Newtonsoft, net45 package for use in Valheim mods. Maintained by the ValheimModding team.

Preferred version: 13.0.4
denikson-BepInExPack_Valheim-5.4.2333 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.2333

README

Valheim ServerGuard

A single mod that handles the messy parts of running a dedicated Valheim server with a curated modpack: mod allowlist, anti-cheat, dev commands for staff, moderation tools, Discord integration, and forensic logging — all configurable from YAML.

Install this same mod on the dedicated server and on every player's game. It detects which side it is on. (Since 2.0 there is no separate client package — if you still have Valheim_ServerGuard_Client installed, remove it.)

What it does (in plain English)

  • Locks your server to a specific modpack. Players running the wrong mods are kicked at the door.
  • Blocks common cheats. devcommands / god / fly / spawn and other console cheats are silently neutered for players. Emote attack-cancel exploit is blocked. Suspicious movement speed and skill levels are flagged.
  • Sees what the game marks as cheated. Valheim 1.0 flags spawned items, things crafted from them and nocost builds. Players carrying flagged gear — including gear spawned in single-player — are reported to your admin channel, optionally stripped. Players get a one-time notice about it, in your own words if you like.
  • Watch page for staff. Watch the server from a browser without logging in: a live map of every player, their health, equipment and inventory, the activity feed, and kick / ban / seal buttons. Owners can also edit the settings, allowed mods and moderators there, as forms that check every value before saving. Off by default; needs one extra port from your host.
  • Whitelist with join requests. Optionally let in only the players you approve. Anyone else who tries to join shows up on the watch page and in your admin channel, and one click lets them in from their next login. A notify mode lists newcomers without turning anyone away while you build the list.
  • Gives your staff dev commands. Owners get every dev command on the dedicated server, exactly as in single-player (devcommands, fly, god, spawn, goto, skiptime, world modifiers, ...) with no adminlist.txt needed. Moderators get only the commands you list in settings.yaml. Everything run server-side is logged to your admin Discord channel.
  • Makes boss progress personal. Vanilla shares every boss kill with the whole world, so a new player walks into traders, spawns and raids tuned for the server's veterans. ServerGuard gives each character their own progress: only the players who fought a boss earn it, each player's game only sees what their own character has earned, and the start-temple altars show only the trophies that character offered. Existing characters keep the kills their character file already records. On by default; sg progress lets staff inspect and adjust anyone.
  • Sends events to Discord. Public channel for player events (joined / kicked / died / shouts / raid alerts). Optional admin channel for moderation events (violations / config reloads / daily summary).
  • Announces raids by their real name. Random-event raids are posted to Discord using the in-game event name (e.g. "The Horde Is Attacking") with coordinates, plus pause/resume/end updates.
  • Strips cheat items on login. Configured items (SwordCheat, SledgeCheat by default) are removed from non-admin players' inventories when they join.
  • Can force everyone onto the map. Optionally override each player's "public position" toggle so all players are permanently visible on each other's maps. Enforced server-side; admins can be exempted.
  • Can mute the "I have arrived!" shout. Optional — useful when the server already posts login notifications.
  • Provides admin commands in the game console. Open the F5 console, type sg help. Kick, pardon, query the build log, hot-reload config — without leaving the game.
  • Records build / destroy events to CSV. Useful when investigating grief reports.

Quick setup

  1. Install this mod on your dedicated server.
  2. Install this same mod on every player's machine (add it to your modpack).
  3. Launch the server. It writes BepInEx/config/ServerGuard/conf/settings.yaml with a random sharedSecret.
  4. Copy that sharedSecret value. Each player pastes it into their BepInEx/config/ServerGuard/client.yaml.
  5. Add your modpack to BepInEx/config/ServerGuard/conf/allowed_mods.yaml. The mod generates a ready-to-paste snippet at mods_for_allowed_mods.yaml on each player's PC after they run Valheim once.
  6. Put your own SteamID in conf/owners.yaml — that gives you every dev command in-game. Staff go in conf/moderators.yaml and get the moderatorDevcommands list.

That's the minimum. Everything else is optional.

Documentation

For full configuration, admin commands, and feature details see the GitHub Wiki.

Try it out

This mod was built for the TaegukGaming community server running the Hearthbound modpack. If you want to see it in action, check out the modpack:

🏰 Hearthbound Valheim Modpack

Disclaimer

This mod is created using AI. No other mods were copied during the process. All feature ideas come from the uploader and are mainly to cater the needs of the TaegukGaming community server. If any features or ideas look similar to other mods, these are not intentional.

This mod is free to use as is. Voluntary support is appreciated.


Version: 2.4.0 Source / issues / wiki: https://github.com/yesu0725/Valheim-ServerGuard Required on every client: this same mod. The old Valheim_ServerGuard_Client package is retired.

CHANGELOG

Changelog

2.7.0

Watch page

  • Raids panel. Start the raid of your choice on one or more players, or on spots you click on the map, and line several up. The game runs one raid at a time, so extra raids wait in a queue and start one after another, 10 s apart. The panel shows the running raid (time, and whether it is waiting for someone to come near), lets you stop it, and lists the queue with remove and clear buttons. The map draws the raid's area and the queued spots. The page warns when a raid's monsters can't spawn in the chosen biome, or when nobody is near a spot: a raid there waits, and holds up the queue, until someone arrives. Every start and stop is posted to the admin channel under your name. In game: sg raid (list, start, queue, stop, remove, clear). Needs watchPageActions, like kick and ban. Nothing changed on the player's side, but keep the server and your modpack on the same version as usual.
  • Notes on approval. On the Access tab, each join request has an optional Note box, saved with the approval (like the note on the manual Add form). Enter approves.
  • Edit whitelist notes. Each whitelisted player has Edit note (or Add note): change it in place, Enter or Save to keep it, Esc or Cancel to drop it, empty to remove it. In game: sg whitelist note <steamid|name> [text]. Every change is posted to the admin channel with the old note.

Fixed

  • Raid posts. A raid that ran its course never got its "is over" post (only a raid you stopped did). And on a dedicated server every raid was reported as paused a few seconds after it started, because the check followed the local player, which a server doesn't have. A raid now counts as paused only when nobody is within its range, as in the game.

2.6.0

The new-character features are off by default. The three security fixes below are on: they only post to the admin channel or refuse a faked boss kill. Players need 2.6.0 on their game too.

Security fixes

  • Faked boss kills are refused (bossKillCheck, on). A boss's death is reported to the server by a player's game, and before 2.6.0 ServerGuard believed a report even when no boss was anywhere near: one line in a cheat mod could claim every boss, with the personal progression credit and the public "defeated for the first time" post. Now a boss kill reported with no such boss within 300 m of the player is refused: no credit, the world key is not set, and the admin channel gets rule FakeBossKill. This works with or without personal progression. Owners are exempt.
  • The speed check works again, and catches teleports (enableTeleportCheck, on). Every jump longer than speedCheckTeleportToleranceMeters was excused as a portal trip, and with the default settings (70 m/s per 1-second sample, 60 m tolerance) that meant the speed check could never fire: flying and teleporting went unnoticed. A fast jump is now excused only when it lands near a portal, or in the first minute after a respawn. Anything else fires the new rule Teleport (informational by default). The move is also measured from the player's last real movement, so a lag spike that catches up all at once is not mistaken for speed. Staff are not checked, as before. teleportCheckPortalRadius and teleportCheckSafePrefabs (modded teleporters) tune it.
  • Boss pace alert (bossPaceAlertCount: 3, bossPaceAlertHours: 6). The admin channel gets a :rotating_light: alert when one character defeats that many bosses for the first time within that many hours. It needs personal progression, which now records when each boss was first credited. Owners are exempt. 0 in either setting turns it off.
  • sg status shows the new checks (bossKillCheck, pace, and a Movement line).

Watch page

  • EpicLoot details in the inventory. Each magic item shows its rarity (in EpicLoot's colours), its magic or legendary name, every enchantment in the same words as the in-game tooltip (augmented ones marked), sockets and set. Items carrying other mods' data (a backpack's contents, for example) list that data by name. Click an item to open it, or use Expand all. Needs 2.6.0 on the player's game.
  • Shout from the watch page. A Shout box under the activity feed sends a message to every player's chat, styled like an in-game shout, from staffShoutName ("Server" by default). Tick On screen too to also show it in the middle of their screen. It is posted to the public channel like any shout, and to the admin channel under your name. In game, staff can do the same with sg shout <text> and sg announce <text> (also on screen). Players need 2.6.0 to see it.

New

  • New-character rule (requireFreshCharacter, off). Stops players bringing items and skills from other worlds into your server. Players must join with a brand-new character (never played anywhere), or with a character your server already knew when you switched the rule on: one registered here at that moment, with a record of your world in its character file (moderators need only the record). Anyone else is turned away with freshCharacterMessage on their connection-failed screen and asked to create a new character. Owners are exempt. Every accepted character is sealed automatically (see the inventory seal from 2.2.0): a new character from an empty inventory, an existing one with what it carries at that join. From then on, anything it did not carry here before is removed when it joins.
  • Audit mode (freshCharacterMode: audit, the default). The rule refuses nobody and removes nothing. Instead, it posts to the admin channel what it would have done ("would be refused", "would lose ..."), so you can check the results on a live server before switching to enforce. Characters it would have refused are marked and judged again once you enforce. Seals you make with sg seal, or a mod makes through the API, always enforce, as before.
  • Skill seal (sealSkills, off). Sealed characters also keep a record of their skill levels (whole levels), and any skill above it is lowered back on join. Levelling up and losing skills on this server update the record within seconds.
  • Starter kit (starterKitEnabled, off). A new player's first new character gets starterKit a few seconds after spawning: a club, a torch, 5 cooked meat, and rag armour (chest and legs) by default. Items are Prefab:count or Prefab:count:quality, and modded prefabs work too. It is given once per account and posted to the admin channel. If ServerCharacters (or another mod) already gives new characters a kit, keep only one of them on.
  • sg seal exempt / sg seal unexempt <steamid>. sg seal remove on a player the rule covers also exempts them, so the rule doesn't seal them again at their next join. sg seal now shows the rule's status, and sg seal show lists skills and which characters are new, existing or flagged.

Improved

  • The inventory seal sees enchantments. Items are now told apart by their item data as well (EpicLoot rarity and enchantments, backpack contents, and anything else a mod stores on an item). A plain sword kept here can no longer be swapped for an enchanted copy brought from elsewhere. Enchanting or re-rolling on your server is recorded within seconds. Existing seals carry over: an item recorded before 2.6.0 matches whatever data it has at the next join, and the record is then updated. If an audit shows a mod rewriting an item's data at login, list that data's key in sealIgnoredItemData.
  • Automatic seals survive a mod's "unseal all". ServerGuardApi.UnsealAll (Blót's Ragnarök) and sg seal clear lift manual seals only. Players the new-character rule sealed stay sealed. ServerGuardApi.IsSealed still reports manual seals only. The watch page's sealed badge shows both.
  • Works alongside ServerCharacters. ServerGuard checks the character after ServerCharacters has swapped in the server's copy, so the two can run together, for example while you audit.

2.5.0

New

  • Show staff logins in the public channel (discordPublicStaffLogins, off). Owners' and moderators' joins and leaves normally go to the admin channel only, so players don't see staff coming and going. Turn this on to post them to the public channel as well ("joined as owner", "joined as moderator", "left"). Their deaths and kicks stay in the admin channel.

2.4.0

New

  • Whitelist (whitelistMode, off). notify: everyone still gets in, but anyone not on the whitelist shows up as a join request. enforce: only whitelisted players (and staff) get in; everyone else is turned away and waits for approval. Join requests pop up on the watch page (with an optional sound) and in the admin channel; one click on Approve whitelists the player, and their next login gets in. The list is conf/whitelist.yaml. In game: sg whitelist add|remove|list|requests|deny|import. import adds everyone who has played on the server before, so switching to enforce doesn't lock out your regulars. sg test join <steamid> tries the check without a second account.
  • Edit the configuration from the watch page (owners only, watchPageConfigEditor). Settings, allowed mods and moderators are shown as forms, not raw YAML: switches, number boxes with their allowed range, choice buttons, list editors, a search box and a short explanation for every setting. Nothing is written until you review the changes. The server then checks every value, rewrites only the lines that changed (your comments stay), confirms the result reads back correctly, keeps the previous file as .bak, and reloads at once. Allowed mods takes a pasted list straight from mods_for_allowed_mods.yaml.
  • Access tab on the watch page: join requests, the whitelist and the bans in one place, with forms to whitelist or ban a SteamID and buttons to remove or unban.
  • Resizable watch page. Drag the dividers between the map, the activity feed and the side panels; the sizes are remembered on that device.
  • Players see why they were refused. A banned player is now told the reason and the end date, and a player who is not on the whitelist sees whitelistMessage, instead of Valheim's bare "You are banned". This needs 2.4.0 on the player's game.

2.3.0

New

  • Watch page. A web page served by your dedicated server where staff can watch without logging into the game: a live map of every player, each player's health, biome, ping, equipment and inventory, the server's activity (everything ServerGuard posts to Discord, plus builds), and kick, ban and seal buttons. Off by default. It needs one extra TCP port from your host (enableWatchPage, watchPagePort). Each staff member makes a personal key with sg watch key (copied to their clipboard); sg watch keys and sg watch revoke manage them. Every action is posted to the admin channel under the staff member's name. The page uses plain HTTP, so keep keys private; see the wiki for the safeguards. Players need 2.3.0 for their inventory to show.
  • Your own wording for the cheat-detection notice. cheatTaintNoticeTitle and cheatTaintNoticeText replace the popup players see on their first login after launching the game. Leave them empty to keep the built-in text. In your text, {consequence} becomes the built-in sentence for your current cheatTaintPolicy.

Improved

  • A clear error when a required library is missing. ServerGuard needs the YamlDotNet and JsonDotNET packages. A mod manager installs them automatically, but with a hand-copied DLL they could be missing, and the mod then silently did nothing: no config files, no protection. It now logs NOT STARTED: required library missing: ... naming the package to install.

2.2.0

New

  • Public API for other mods (ServerGuardApi). Mods can now read who has defeated which boss (GetAccountKeys), be told the moment a boss kill is credited (ProgressCredited), wipe chosen progress keys for every character at once (ResetProgress), and post to ServerGuard's Discord channels (PostDiscord), and check whether someone is ServerGuard staff (IsStaff). It is looked up by reflection, so no mod needs ServerGuard to load, and it does nothing on a player's game. First user: Blót — Cycle of Ragnarök. A reset through the API is posted to the admin channel like sg progress reset.
  • Inventory seal (enableInventorySeal, on). A sealed account's characters are bound to this server: every time they join, anything they did not carry here before is removed, however it arrived (another server, a single-player world, InterServerPortal). Nobody is sealed unless you or a mod say so: sg seal add <steamid> [hours] [reason], sg seal, sg seal show, sg seal remove, sg seal clear, or ServerGuardApi.SealInventories / UnsealAll / IsSealed. Blót uses it for the players it wipes at Ragnarök. Removed items are listed in the admin channel so staff can give back anything taken by mistake. Seals are kept in conf/seals.yaml.
  • sg test commands for staff to try the new features without waiting for the real thing: sg test kill [player] <boss> credits a boss kill through the same code as a real one (ledger, Discord, API event, world key); sg test reset <keys...> [altars] confirm runs the API's progress reset (a dry run without confirm); sg test listen posts every API credit event to the admin channel; sg test discord and sg test raid <event>|stop check the Discord posts; sg test api shows the API's state.

Fixed

  • Only real boss kills are announced in the public channel. 2.1.0 treated every defeated_* key as a boss, so killing a Serpent, a Writhan or the Hive, or finishing only the first phase of the Deep North boss, posted "... defeated X for the first time!". A key now counts as a boss when the creature that sets it is flagged as a boss in the game data. The Deep North boss is announced when its final phase dies, and the Hive is left out: it has no start-temple stone and no in-game name yet.
  • The Deep North boss (Kall Fimbulbringer), the Hive, the Serpent and the Writhan now show by name in sg progress and on Discord instead of as raw keys. sg progress grant/revoke accepts frozenking (also kall, fimbulbringer), frozenkingp1 (the phase-1 key only), hive, serpent and writhan.
  • Serpent and Writhan kills are no longer held to the strict boss rule: like trolls and bats, a one-hit kill falls back to "within 50 m".

2.1.0

Personal boss progression. On by default — read the first bullet before updating a running server.

New

  • Boss progress is personal to each character. Vanilla keeps boss kills as world keys: one player beats Eikthyr and every player — including one who joined five minutes ago — gets Haldor's and Hildir's later stock, the harder spawns and the later raids. ServerGuard now keeps progress per character (SteamID + character name) in conf/progress.yaml, and each player's game only ever receives the progress their own character has earned. World modifiers (no map, damage rates, ...) stay shared.
    • Who earns a boss: every player who damaged it and was within 50 m when it died (progressionRequireDamage, progressionCreditRadius). The same goes for the troll, surtling and bat keys that unlock raids, except that a creature killed in one hit falls back to "within 50 m". Hildir's quest rewards go to the player who handed in the chest.
    • Raids follow each player's own progress: the Player based raids world modifier is switched on (progressionForcePlayerRaids) and ServerGuard makes sure every raid — not only the ones vanilla already handles per player — checks the targeted player's progress. Switching the feature off switches the modifier back off if ServerGuard was the one that turned it on.
    • Existing characters keep their progress. The first time each already-registered character logs in, ServerGuard imports the boss kills their character file records (vanilla gives those to everyone near a kill), limited to bosses this world has actually seen (progressionSeedFromCharacters). New characters, and characters brought over from single-player, start from scratch; progress the server never granted is removed from the character and reported to the admin channel.
    • Personal start temple. The boss altars show only the trophies the viewing character offered. Offering a trophy lights the altar for that character alone, a forsaken power can only be chosen from an altar you filled yourself, and a trophy only takes hold once you have defeated that boss yourself (enablePersonalTemple, personalAltarsRequireKill). A power chosen from someone else's trophy is cleared on login. Trophies already sitting on the shared altars are hidden, not destroyed — switching the feature off shows them again.
  • sg progress — sg progress <player> shows a character's progress and altars; grant / revoke <player> <boss|key|all>, altar <player> <boss> [on|off] and reset <player> change it, and the player's game updates immediately. <player> is a character name, a SteamID, or steamid:name. Changes are posted to the admin channel. sg status has a new Progress line.
  • Discord: a first-time boss kill is announced in the public channel ("Alice and Bob defeated The Elder for the first time!", staff left out as usual). The admin channel gets every credit with the players involved and anyone who was nearby without damaging the boss, one-time imports, and players arriving with progress the server never granted (progressionDiscordPosts).
  • A ledger belongs to one world. Start a new world and the old progress.yaml is archived as progress.<worldid>.yaml.bak and a fresh one begins.
  • If progress.yaml cannot be read, the feature switches itself off (shared vanilla progress) and nothing is written until the file is fixed — a bad hand edit can't wipe everyone's progress.
  • The new settings are appended to an existing settings.yaml on first boot. progressionKeys decides which keys count as progress (default: every defeated_* boss, killedtroll, killed_surtling, killedbat, and Hildir's hildir* quests).

Upgrade note

  • Players must update too — the altars, raid checks and character-file sync run on each player's game. As always, keep the server and your modpack on the same version.
  • The feature is on by default. Set enablePersonalProgression: false in settings.yaml before starting 2.1.0 if you want to keep shared vanilla progress.

2.0.2

New

  • sg unregister <steamid> [character]. Forgets one registered character name, or every name for that SteamID when no character is given, so the player can register fresh ones. Use it with sg pardon and sg unban to fully reset someone who tripped the character limit.

Fixed

  • registrations.yaml and violations.yaml are now hot-reloaded, like the rest of conf/. They used to be read once at boot, so edits made while the server was running were ignored and then overwritten by the next strike or registration. In practice this meant sg unban on a player over characterLimit did not stick: the server still held their old names and strikes in memory and re-banned them on the next login. sg reload now re-reads these two files too, and sg help describes it accurately.

2.0.1

New

  • Cheat-check bypass key. The console command yesiuseddevcommandsbutiwantmyachievementsanyway sets a key on the character after which Valheim marks nothing that character does as cheated — items spawned in single-player then arrive on your server unmarked, and cheat-taint detection cannot see them. ServerGuard already reported the key once per session; a new setting, cheatTaintBypassPolicy, decides what happens next: log (the default) keeps the admin-channel post, kick also disconnects the player with a message explaining why, until they log in with a character that has never run the command. No strike, nothing is written to their character, owners are exempt. The setting is appended to an existing settings.yaml on first boot, with comments; sg status shows it on the CheatTaint line.

2.0.0

One mod for both sides, and dev commands for your staff. This is a breaking packaging change — read the upgrade note.

Changed

  • The server plugin and the client companion are now one mod. Install Valheim_ServerGuard on the dedicated server and on every player's game — the same package, the same DLL. It works out which side it is on when it loads: a headless dedicated server runs the server half, a player's game runs the client half.
  • The Valheim_ServerGuard_Client package is retired. Remove it from every profile and modpack before updating; it must not run next to 2.0. Config files are unchanged (conf/*.yaml on the server, client.yaml on each player).
  • Existing allowed_mods.yaml files keep working. The old client GUID com.taeguk.valheim.serverguard.client in required_mods is read as the new com.taeguk.valheim.serverguard; the server logs a reminder to update the line. If you had the old client DLL hash-pinned, re-pin against the 2.0 DLL — the old hash can never match.
  • The kick text for a client without the mod now reads ServerGuard is not installed on your client instead of naming the old companion.

New

  • Dev commands for owners. Valheim refuses every cheat command on a dedicated-server client, whoever types it. Owners (conf/owners.yaml) can now use all of them, exactly as in single-player: type devcommands, then fly, god, ghost, spawn, goto, heal, skiptime, tod, setworldmodifier, randomevent, and the rest. Owners are also treated as vanilla admins by the server, so nothing needs to be added to adminlist.txt. (enableOwnerDevcommands, default on.)
  • Dev commands for moderators — the ones you choose. Moderators (conf/moderators.yaml) get exactly the commands in moderatorDevcommands (default: goto, pos, removedrops, stopevent, find). Anything else is refused on their client with a short message, and the attempt is posted to the admin Discord channel — no strike, they're staff. (enableModeratorDevcommands, default on.) fly, debugmode, spawn, itemset, nocost, noplacementcost and location can never be given to a moderator, whatever the list says.
  • Moderators go through the mod check. Only owners skip attestation now. A new moderator_allowed_mods: section in allowed_mods.yaml lists mods only moderators may run (admin tooling), on top of the normal lists.
  • Moderator welcome. Every time a moderator logs in they get a chat message: a greeting, the dev commands they currently have, where the sg tools are, and a reminder to moderate responsibly.
  • Cheat-detection notice. When cheat-taint detection is on, every player sees a one-time notice panel on their first login after launching the game (not on a relog) explaining what is detected and what the consequence is under your current policy.
  • Map coordinates for staff. Owners and moderators see the world X/Z under the cursor on the large map, next to the biome name.
  • Speed check default raised from 15 to 70 m/s. The old default flagged modded mounts and skills; 70 only catches teleport-style movement. Existing servers keep whatever they have set.
  • Cheat-taint detection. Valheim 1.0 marks everything that came out of a cheat — spawned items, anything crafted from them, pieces built with nocost, creatures hit while in god/fly mode — and keeps the mark in the character file, so it survives a trip through single-player. ServerGuard now uses it: players carrying flagged items are reported to your admin channel (cheatTaintPolicy: log, the default), or have them removed (strip), or get a strike as well (violation). Cheat-flagged builds go into the build log with a new cheated column and are double-checked by the server against the piece itself. Debug fly is detected server-side. Owners are exempt; moderators are reported unless you say otherwise. Everything is informational by default — three new rules, CheatedItem, CheatedBuild and DebugFly, all start with countAsViolation: false. If your modpack has weapons over 10000 damage, add them to cheatTaintIgnoredItems (the game auto-flags those).
  • Every dev command that runs on the server (skiptime, sleep, randomevent, world modifiers, ...) is logged with who ran it and posted to the admin channel. Staff see a short [ServerGuard] acknowledgement in their console; on connecting they get one line telling them what they have been granted.
  • All three settings hot-reload, and so do owners.yaml / moderators.yaml, so promoting or demoting someone takes effect while they are online.
  • sg status shows a DevCmds line. The new settings are appended to an existing settings.yaml on first boot, with comments.
  • If you were running Server Devcommands only to give staff cheats, you no longer need it.

Upgrade note

  1. Server: replace the DLL (or update the package). Start it once and check the log for starting as SERVER.
  2. Players: remove Valheim_ServerGuard_Client, install Valheim_ServerGuard. Their client.yaml is untouched.
  3. Optionally edit allowed_mods.yaml to the new GUID.

1.8.1

Compatibility release for Valheim 1.0. No code changes — this version exists to state the compatibility and to keep the server and companion version numbers matched.

ServerGuard was verified against Valheim 1.0.7 (network version 39, Unity 6000.0.75) on BepInEx 5.4.23.5: the server plugin loads cleanly, its self-test passes, and every Valheim method it patches (ZNet.IsAllowed, ZNet.OnNewConnection, ZNet.RPC_PeerInfo, ZNet.RPC_ServerSyncedPlayerData, WearNTear.Damage/Destroy, Inventory.AddItem, the raid-event hooks) still exists with the same signature. Mod attestation, the ban layer, the console guard and the privilege tiers all behave as they did on the previous build.

If you are already running 1.8.0, you do not need this update for anything to work — take it only to keep both plugins on the same version number.

Note for modpack authors: Valheim 1.0 changed the Terminal.ConsoleCommand constructor, which breaks other mods that register console commands (Server Devcommands 1.109 throws MissingMethodException on startup). ServerGuard never constructs one and is unaffected.

Version-match release. The server plugin is functionally unchanged from 1.7.0 — all of 1.8.0's work is in the companion plugin, which gains a scrollable Announcements box with clickable links on its Quick Login title-screen panel (configured per-client in client.yaml, not on the server).

Update both plugins together so the versions stay matched.

1.7.0

Feature release. Three new subsystems: owner/moderator privilege tiers, an instant SteamID ban layer, and a console guard. Also fixes several settings that were invisible in settings.yaml. Requires companion plugin v1.7.0 — the console guard is enforced by the companion, so an older client will ignore it.

New

  • Two staff tiers: owner and moderator. conf/owners.yaml is a new list — normally just you. An owner is exempt from every rule in the mod, unconditionally, with no setting to turn that off: never kicked, never banned (an entry in bans.yaml matching an owner is ignored), never given a violation strike, never speed-checked or skill-capped, never subject to the character limit, cheat-item removal, forced map positions or the console guard. admins.yaml becomes conf/moderators.yaml — moderators keep every bypass the old "admin" tier had, but they remain bannable and kickable. Owners don't need to be listed as moderators as well.
  • admins.yaml migrates automatically. On the first boot after updating, your SteamIDs are copied into moderators.yaml and the old file is renamed to admins.yaml.legacy. Nothing to do, nothing lost. If the old file can't be parsed the migration stops and leaves it alone rather than guessing, and says so in the log.
  • Instant SteamID bans (enableBanLayer, default true). Valheim applies its own ban list on a five-second timer, which is why a banned player still loads in and gets a few seconds of play before being removed. ServerGuard keeps a separate list in conf/bans.yaml and checks it inside the connection handshake — the connection is refused before a character is ever spawned. banLayerMirrorToVanilla (default true) also writes each ban into Valheim's banlist.txt so it survives ServerGuard being uninstalled. Note the reverse doesn't apply: the in-game unban command clears only banlist.txt, so it can't quietly lift a ServerGuard ban.
  • Ban admin commands. sg ban <steamid> [for <N>d|h|m] [reason], sg unban <steamid>, sg bans [n]. The target doesn't have to be online or ever to have connected — a full 17-digit SteamID can be banned pre-emptively. Banning yourself or an admin is refused. Bans take effect immediately for anyone already in the world.
  • bans.yaml hot-reloads. Hand-edit it and the change lands within a second, including disconnecting anyone online who now matches. If the file fails to parse, the last good list stays in force rather than the server locking everyone out — the error goes to the log and the admin channel.
  • Console guard (consoleGuardMode, default restricted). Four modes: open (no gating), restricted (blocks cheat commands, anything Valheim flags as a cheat including other mods' commands, and a curated list of non-cheat commands that still mutate shared world state), whitelist (only consoleAllowedCommands permitted), disabled (the F5 console cannot be opened at all). consoleGuardExemptModerators (default true) keeps moderators unrestricted — worth leaving on, since sg commands are typed into that console. Owners are always exempt regardless.
  • Key-bind control (consoleGuardBindPolicy, default purge). A player could bind a command to a key in single-player and arrive on your server with it loaded. Two details made that worse than it sounds: Valheim runs binds from the chat update loop, so the console never has to be open — or even openable — for one to fire; and bind-dispatched commands skip Valheim's own "not valid in the current context" check. Binds are now cleared while a player is connected and the bind command is refused. wipe also erases them from the player's disk; block and allow are available if you want something looser.
  • consoleBlockedCommands / consoleAllowedCommands let you extend or replace the built-in lists without a code change.
  • New violation rule ConsoleCommandBlocked (default: does not count toward auto-ban) for non-cheat console blocks. These post to the admin channel only — a curious player typing bind shouldn't show up in the public channel as a cheater. Genuine cheat attempts still use DevcommandAttempt and still post publicly.
  • New metrics counters ban_layer_blocks and console_blocks.

Fixed

  • Options that default to off were missing from settings.yaml entirely. The file was generated by a serializer configured to omit any value still at its default, so every setting that defaults to false, 0 or an empty list was never written out — enableForceMapPositions, forceMapPositionsExemptAdmins, enablePingLog, allowUnlisted, logPeerManifest, selfTestPostOnPass, discordVerboseMirror and dailySummaryHourUtc. The features worked; their switches were simply invisible, which is indistinguishable from the feature not existing if you're reading the file to find them. Fresh installs now list every option, and existing servers get the missing ones appended on next boot, under a dated header, with the values already in effect. Your current settings, ordering and comments are untouched — the top-up only adds keys that aren't there.
  • countAsViolation was matching nothing on older config files. The lookup is case-sensitive in practice — the settings loader replaces the dictionary and the case-insensitive comparer is lost — while settings.yaml was generated with camelCase rule names (devcommandAttempt) and the code looks up PascalCase (DevcommandAttempt). Every lookup missed and fell back to "doesn't count", so no rule counted toward the auto-ban threshold and nothing in the log said so. Rule names are now matched case-insensitively regardless of how your file spells them.
  • metrics.yaml looked empty. Counters still at zero were omitted by the same serializer setting, so a quiet server wrote a file containing only a timestamp. All counters are now always written.
  • discordAdminWebhookUrl was silently ignored. The correct key is discordWebhookUrlAdmin; the loader skips unknown keys without complaining, so a server using the other word order had no admin channel at all — no violation alerts, no reload notices, no admin audit trail, no daily summary — with nothing in the log explaining why. The legacy spelling is now accepted (and a warning asks you to rename it). The settings top-up above also writes the correct key with your URL.

Changed

  • Auto-bans from violationThreshold now go through the ban layer, so a player who trips the threshold is refused instantly on their next connection attempt instead of getting in and being swept out. With enableBanLayer: false the old vanilla-only behaviour is preserved.
  • sg status now reports ban-layer and console-guard state plus owner/moderator counts; sg whois reports the player's tier and any active ban.
  • sg reload also reloads owners.yaml and bans.yaml.
  • Join notifications distinguish owner (👑) from moderator (🛡️).

1.6.3

Version-match release. No server-side behaviour changes — the fix in 1.6.3 is in the companion plugin.

Companion

  • Requires companion plugin v1.6.3, which fixes enableArrivalShout: false blocking every shout, not just the first-spawn one. If you turned that setting on in 1.6.2, your players could not use /s at all. Update both plugins.

1.6.2

Feature release. Two new settings.yaml options, one anti-cheat rule relaxed, and the server start/stop Discord notifications are back.

New

  • Forced map positions (enableForceMapPositions, default false). Overrides every player's "public position" minimap toggle so all players are permanently visible on each other's maps. Enforced server-side — the flag is rewritten as each client's position sync arrives, so a modified client can't opt out. forceMapPositionsExemptAdmins (default false) lets staff keep their own toggle. Both hot-reload; turning the feature off restores each player's own choice within a couple of seconds.
  • Arrival shout toggle (enableArrivalShout, default true). Set to false and the companion swallows the vanilla "I have arrived!" shout on first spawn — handy when the server already posts login notifications and the shout is just noise. Players can still shout manually. Hot-reloads to everyone already online, so nobody has to reconnect.

Changed

  • Sheathing is no longer part of the AnimationCancel rule. Holstering your weapon mid-attack is ordinary play — weapon swaps, picking up items, opening chests and building all do it — so gating it flagged honest players. Only the emote cancel is checked now. The server also discards sheathe reports from companions on 1.6.1 and earlier, so the rule stops applying the moment you update the server, without waiting for every player to update their client.

Fixed

  • Server start and shutdown Discord notifications are back. They were dropped when the 1.4.0 and 1.5.0 code lines were merged for 1.6.0.
  • The boot notification is now two messages. Server is starting... fires when the plugin loads; The server has started, you may now login. only once the world is loaded and location generation has finished. On a brand-new seed those can be minutes apart — the old single message invited players onto a server that would still refuse them. If generation never completes, no public message is sent and a timeout warning goes to the admin channel instead.
  • The shutdown notice now posts synchronously, so it actually reaches Discord before the process exits. A graceful stop is still required — a hard kill or host crash gives the plugin no chance to post.

Companion

  • Requires companion plugin v1.6.2. enableArrivalShout needs it; the rest is server-side.

1.6.1

Version-match release. No server-side behaviour changes — all fixes in 1.6.1 are in the companion plugin.

Companion

  • Requires companion plugin v1.6.1, which fixes the Quick Login panel's live player count always showing ?. See the client changelog.

1.6.0

Social/QoL feature drop on top of the 1.4.0 anti-cheat + admin toolkit (everything from 1.4.0 is still here).

New

  • Raid event alerts. When a random event / raid begins, pauses (no players in the area), resumes, or ends, ServerGuard posts to the public Discord channel using the actual in-game event name (e.g. "The Horde Is Attacking", "You Are Being Hunted") instead of the internal code name, with world coordinates.
  • Player shout logging. Player shouts (/s) are forwarded by the companion and posted to the public Discord channel (chat can no longer be observed server-side, so the companion reports them).
  • Cheat-item removal. On login, non-admin players have configured cheat items stripped from their inventory (SwordCheat, SledgeCheat by default). Configure via enableCheatItemRemoval and cheatItems in settings.yaml; admins are exempt.

Companion

  • Requires companion plugin v1.6.0 (adds the optional title-screen Quick Login panel — see the client changelog).

1.4.0

Big feature drop — anti-cheat, admin tools, and Discord cleanup.

New: anti-cheat

  • Devcommands gate. Players can't type devcommands, god, fly, spawn, etc. on your server. Vanilla cheat commands are blocked client-side and reported to you.
  • Animation-cancel gate. Blocks the classic emote / sheathe attack-cancel exploit (used to spam secondary attacks faster than vanilla allows).
  • Movement-speed sanity check. Flags players moving impossibly fast across the ground.
  • Inventory validation. Flags unknown items and over-sized stacks server-side.
  • Skill-level cap. Catches players with skill levels above the cap (default 100 + tolerance).

New: forensic tools

  • Build/destroy heatmap. Every piece place / destroy is logged to a daily CSV with attribution, including creature destroys (Troll smashes your base = logged as "Troll").
  • Death log. When a player dies, an entry is posted to your public Discord with the cause (creature name, PvP killer with SteamID, or environmental cause like "drowned"/"fell").
  • Modset fingerprint. Each server publishes a short hash (e.g. 8ce8906e) that uniquely identifies its modpack — players can verify they're connecting with the matching pack.

New: admin console commands

Press F5 to open the console, then type sg help. You'll get a moderation toolkit without leaving the game:

  • sg status, sg reload, sg modset, sg selftest
  • sg whois <name>, sg violations, sg pardon, sg kick
  • sg build at <x> <z> / by <name> / today — query the heatmap
  • sg destroyed at|by|today and sg placed at|by|today — filter to destroys or placements only

Discord channel split

  • Public channel = community-friendly events only: joined, left, kicked, died. Safe to share with all players.
  • Admin channel (new) = curated moderation events: violations, config reloads, admin command audit, daily summary. Set discordWebhookUrlAdmin in settings.yaml.
  • Admins are hidden from the public channel. Their join/leave/death events go to the admin channel only.
  • Daily summary posts a one-paragraph digest each UTC midnight (joins, leaves, kicks, bans, top kick reasons).

New: ping / latency log

Optional admin-only feature: posts each player's first ping after join and their session-average on disconnect. Helps spot VPN / proxy users. Default off.

Other improvements

  • Self-test on boot. Smoke-tests config (HMAC, webhook URLs, file permissions). Alerts the admin channel on any failure.
  • Player death cause messages. Now show creature names, killer SteamID for PvP, or environmental cause (burned / drowned / fell / etc.).
  • Per-rule "counts as violation" toggle so you can tune which rules can lead to auto-ban vs which are just informational.
  • Hot-reload of all config files — edit settings.yaml / admins.yaml / allowed_mods.yaml and the server picks it up within a second.
  • Mod-set fingerprint mismatch detection. When a player connects with the right mods but different versions, the admin channel notes it.

Bug fixes

  • Admin connection event now shows up properly.
  • Hammer-removed pieces now log correctly with attribution.
  • Build positions now record the real world coords (not the prefab origin).
  • Several Mono compatibility fixes for current Valheim builds.

1.3.0

Initial public release. Mod allowlist with HMAC-signed attestation, per-peer auto-ban for repeat violations, hot-reload of configs, Discord webhook integration.