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.

CHANGELOG

Changelog

1.5.0

  • Player shout logging: shouts (/s) are now posted to the public Discord channel.
  • Player death logging: posts cause, attacker (creature / PvP / environmental) to public Discord. Admin deaths suppressed.
  • Player join / leave notifications on public Discord; admin login / logout on admin Discord.
  • Removed whisper logging (architecture limitation — whispers are sent directly peer-to-peer, not visible server-side).
  • Requires companion plugin v1.5.0.

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: player joined/left, shouts, deaths, raid events. Safe to share with all players.
  • Admin channel (new) = moderation events: admin login/logout, kicks, bans, violations. Set discordAdminWebhookUrl in settings.yaml.
  • Admins are hidden from the public channel. Their join/leave events go to the admin channel only; deaths are suppressed entirely.
  • Shout logging. When a player uses /s to shout in-game, it is posted to the public channel.
  • Death logging. When a player dies, the cause is posted to the public channel: creature name, PvP killer with SteamID, or environmental cause (burned / froze / fell / etc.).
  • Daily summary posts a one-paragraph digest each UTC midnight (joins, leaves, kicks, bans, top kick reasons).

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. Show creature names, killer SteamID for PvP, or environmental cause (burned / froze / fell / etc.). Admin deaths are suppressed.
  • 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.