TaegukGaming-Valheim_ServerGuard icon

Valheim ServerGuard

Anti-cheat + mod allowlist + admin tools for Valheim dedicated servers. Locks players to your modpack and provides Discord logging, build forensics, and console admin commands.

Last updated a week ago
Total downloads 88
Total rating 0 
Categories Mods Tools Server-side Utility AI Generated
Dependency string TaegukGaming-Valheim_ServerGuard-1.4.0
Dependants 0 other packages depend on this package

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, moderation tools, Discord integration, and forensic logging — all configurable from YAML.

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. Emote attack-cancel exploit is blocked. Suspicious movement speed and skill levels are flagged.
  • Sends events to Discord. Public channel for player events (joined / kicked / died). Optional admin channel for moderation events (violations / config reloads / daily summary).
  • 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 Valheim_ServerGuard_Client on every player's machine.
  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 companion plugin generates a ready-to-paste snippet at mods_for_allowed_mods.yaml after a player runs Valheim once.

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: 1.4.0 Source / issues / wiki: https://github.com/yesu0725/Valheim-ServerGuard Companion (required on every client): TaegukGaming-Valheim_ServerGuard_Client