Skip to content

Admin Commands

Jump to bottom
Taeguk edited this page Jun 9, 2026 · 4 revisions

Admin Commands

ValheimServerGuide adds two console commands for testing and moderation. Open the F5 console to use them.

Requirement: You must have devcommands enabled and be an admin. In single-player or as the host, you always qualify. On a dedicated server, you must be listed in adminlist.txt.

vsg_list

Lists all guidance IDs — which are configured, which have fired, and their scope and features.

vsg_list

Output example:

[VSG] Configured guidance IDs (3 total):
  first_bronze_sword   [fired] [player]
  world_eikthyr_fell   [global]
  swamp_tip            [discord] [cooldown]

Each ID is tagged with:

Tag Meaning
[fired] This entry has already fired for the current character (player scope)
[global] This is a global-scope entry
[discord] This entry has an announce.discord configured
[cooldown] This entry uses a cooldown instead of once

vsg_reset

Clears the fired state for one or all entries.

Reset all player-scope entries

vsg_reset all

Clears every player-scope fired ID and cooldown for the current character. Also empties the raven display queue and the dungeon-deferred raven queue, so no pending raven messages carry over. Global-scope state is untouched.

Reset a specific entry

vsg_reset first_bronze_sword

Clears the fired state and cooldown for a single entry. The command auto-detects scope:

  • Player-scope ID — cleared from the local character's m_customData. Only affects the admin running the command.
  • Global-scope ID — must be run on the server/host. Removes the VSG.<id> global key from ZoneSystem. The entry can fire again for the entire world.

If the entry is currently waiting in the raven queue (or the dungeon-deferred queue), it is also removed from there so the stale popup never appears.

Tab completion

Tab-complete on vsg_reset suggests all and all known guidance IDs from the current config.

Use Cases

Testing a new entry: After adding an entry to guidance.yaml, save the file (it hot-reloads), then run vsg_reset <id> to clear any old fired state so you can trigger it again.

Resetting a player's quest: If a player needs to restart a chain, run vsg_reset <chain_id> to clear the chain state. The player can then re-trigger step 1.

World event reset (testing): On the server/host, run vsg_reset world_eikthyr_fell to allow the global boss event to fire again.

Fresh start for testing: Run vsg_reset all to clear all your own fired states and replay guidance from the beginning.

Clone this wiki locally