Valheim ServerGuard — Client

Companion plugin for Valheim ServerGuard. Install this if you're joining a server that uses ServerGuard. Without it, the server kicks you on connect.

This is the client-side half of the system. The server-side mod (Valheim_ServerGuard) is installed by the server host, not by you.

What it does

When you connect to a ServerGuard server, this plugin tells the server which mods you have loaded so it can decide whether to let you in. While you play, it also:

• Blocks cheat console commands (devcommands, god, fly, etc.) on multiplayer servers — single-player and host-and-play keep full cheats.
• Blocks the emote / sheathe attack-cancel exploit.
• Reports your deaths and built / destroyed pieces to the server's logs.
• Reports your skill levels for cap enforcement.

You don't need to do anything in-game — it runs silently in the background.

Quick setup

1. Install via your mod manager (r2modman / Thunderstore Mod Manager).
2. Launch Valheim once to the main menu, then close the game.
3. Open BepInEx/config/ServerGuard/client.yaml and paste in the password your server host gave you:

   sharedSecret: "<paste here>"
   

4. Save. Restart Valheim. You're done.

The password is unique to each server. Ask the server host — they'll find it in their server's BepInEx/config/ServerGuard/conf/settings.yaml on the sharedSecret: line.

Documentation

For setup, troubleshooting, and admin-command 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:

🏰 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: 1.4.0 Source / issues / wiki: https://github.com/yesu0725/Valheim-ServerGuard Server-side package: TaegukGaming-Valheim_ServerGuard

Changelog

1.5.0

• Reports player shouts to the server so they appear in the public Discord channel.
• Reports player deaths (with attacker info) to the server's death log.
• Must be used with server plugin v1.5.0.

1.4.0

Companion update for ServerGuard 1.4.0 server. Required version match — install both at the same time.

What this version adds (player-facing)

• Anti-cheat blocks. Cheat console commands (devcommands, god, fly, spawn, etc.) are silently blocked while you're on a multiplayer server. Single-player keeps full cheats.
• Animation-cancel block. Emote and sheathe inputs during attack recovery are now blocked client-side. Your attacks play out at their normal speed.
• Death reporting. When you die, the companion sends a short report to the server (killer + position) so the admin's death log can show the cause.
• Shout reporting. When you use /s to shout, the companion forwards the message to the server so it can be posted to the Discord public channel.
• Build-event reporting. Pieces you place / destroy / hammer-remove are sent to the server's forensic log.
• Skill-level reporting. Periodically reports your skill levels so the server can spot impossibly high values.
• sg admin console commands. If you're an admin (in the server's admins.yaml), open the F5 console and type sg help for a moderation toolkit.

Other

• Modset fingerprint. Logged on startup so you can verify it matches the server admin's published fingerprint.
• Several Mono compatibility fixes for current Valheim builds.

Setup reminder

After installing, launch Valheim once. The companion creates BepInEx/config/ServerGuard/client.yaml — paste your server's sharedSecret value into it and you're done.

1.3.0

Initial public release. Reports your mod list to a ServerGuard-protected server so it can let you in.