Valheim DevCommandsGuard

Valheim_DevCommandsGuard

Valheim BepInEx plugin for Thunderstore.

Features

• Server-side Connection Guard (BepInEx/config/com.valheim.devcommandsguard.cfg):
• RejectClientsWithDevCommands (true by default): Rejects non-admin clients launched with -console or with devcommands active. Server admins (adminlist.txt) are never rejected.
• RejectClientsWithoutPlugin (true by default): Rejects non-admin clients connecting without Valheim_DevCommandsGuard installed.
• Guarded Commands ([Guards] section — all true by default):
• GuardConsoleArg (-console launch argument)
• GuardDevCommands (devcommands toggle)
• GuardGod (god mode)
• GuardDebugMode (debugmode)
• GuardFly (fly mode / debug fly keybind)
• GuardSpawn (spawn command)
• GuardTp (tp / goto command)
• Configurable Highlight & Red Tag Visibility ([Visibility] section):
• HighlightVisibility (Admin by default): Controls who sees the 3D red character highlight (All, Admin, Disabled).
• TagVisibility (All by default): Controls who sees the red tag on overhead player names and in game chat messages (All, Admin, Disabled).
• TagFormat ("[DEV] {name}" by default) and TagColor ("red" by default).
• Server Console & Game Chat Event Logging ([ChatLogs] section):
• Every guarded event (-console join, or any user/admin enabling, disabling, or executing devcommands, god, debugmode, fly, spawn, tp) is logged to the Server Console and broadcast to Game Chat.
• Each command's Game Chat log visibility is independently configurable (All, Admin, Disabled; all default to Admin):
• ChatLogConsoleArg, ChatLogDevCommands, ChatLogGod, ChatLogDebugMode, ChatLogFly, ChatLogSpawn, ChatLogTp.
• Runtime Admin Console Command (dcg):
• Server admins can view or update settings in real time from the in-game F5 console; changes are persisted to com.valheim.devcommandsguard.cfg and broadcast to connected clients:
• dcg status — Print current configuration.
• dcg reject <on|off> — Enable/disable rejecting non-admin clients with -console / devcommands (immediately checks and disconnects violating active non-admin connections when enabled).
• dcg requireplugin <on|off> — Enable/disable rejecting non-admin clients missing the plugin.
• dcg highlight <all|admin|disabled> — Set 3D red model highlight visibility.
• dcg tagvis <all|admin|disabled> — Set overhead and chat red tag visibility.
• dcg guard <all|console|devcommands|god|debugmode|fly|spawn|tp> <on|off> — Enable or disable guarding for a command.
• dcg log <all|console|devcommands|god|debugmode|fly|spawn|tp> <all|admin|disabled> — Set game chat log visibility for a guarded command.
• dcg tagcolor <color> — Update and broadcast the tag color.
• dcg tagformat <format> — Update and broadcast the tag format (e.g., dcg tagformat [CHEATER] {name}).

Building & Packaging for Thunderstore

1. Build the project with .NET SDK (net48):

   dotnet build -c Release

1. Copy bin/Release/net48/Valheim_DevCommandsGuard.dll into Thunderstore/plugins/.
2. Ensure 256x256 icon.png is in Thunderstore/.
3. Zip the contents of Thunderstore/ (manifest.json, README.md, icon.png, plugins/Valheim_DevCommandsGuard.dll).