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, shouts, and built / destroyed pieces to the server's logs.
• Reports your skill levels for cap enforcement.
• Removes server-configured cheat items from your inventory on login (non-admins).

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

Optional: Quick Login panel

The companion can add a one-click login panel to the title screen so you (or your community) can join a specific server without the server browser, IP entry, or password prompt. It shows the server logo, name, description, and a live player count.

It's off by default. To enable it, edit BepInEx/config/ServerGuard/client.yaml:

quickLoginEnabled: true
serverAddress: "my.server.com"   # or an IP
serverPort: 2456
serverPassword: ""               # if the server has one
serverName: "My Server"
serverDescription: "Welcome!"
serverLogoPath: "logo.png"       # PNG/JPG placed in BepInEx/config/ServerGuard/

Click Connect → pick a character → you're in. (Or click Start Game, pick a character, then Connect — the panel stays visible on the character screen.)

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

Changelog

1.6.0

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

New: Quick Login panel (optional, off by default)

• Adds a panel to the title screen so you can join your server with one click — no server browser, no IP entry, no password prompt.
• Clicking Connect takes you to character selection; after you pick a character you connect straight to the configured server. (You can also click Start Game first, pick a character, then Connect — the panel stays on screen.)
• Shows the server logo (PNG/JPG), name, description, and a live player count (queried while you sit on the menu).
• Uses the game's own font and button styling.
• Enable and configure it in BepInEx/config/ServerGuard/client.yaml (quickLoginEnabled, serverAddress, serverPort, serverPassword, serverName, serverDescription, serverLogoPath). Place the logo image in BepInEx/config/ServerGuard/.

New: player-facing

• Shout reporting. When you /s shout, the companion forwards it so the server can post it to the public Discord channel.
• Cheat-item removal. If the server enables it, configured cheat items (e.g. SwordCheat, SledgeCheat) are removed from your inventory on login unless you're an admin.

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 (cause + position) so the admin's death log can show the killer.
• 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.