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 (once: true entries)
[fired N/max] This entry uses max_fires; shows current count vs cap (these never appear in the Fired list above)
[global] This is a global-scope entry
[discord] This entry has an announce.discord configured
[Complete ✓ (vN)] Chain entry — all steps done, at version N

vsg_reset

Clears the fired state for one or all entries.

Reset all player-scope entries

vsg_reset all

Clears all player-scope state for the current character:

  • Every once-fired ID (VSG.fired)
  • Every max_fires counter (VSG.fc.*) — required so capped entries like player_death tips can fire again
  • All chain progress, NPC item-submit counts, and item-acquired goal state
  • All in-memory cooldowns
  • The raven display queue and dungeon-deferred raven queue
  • Stale vanilla raven temp-texts for all VSG entries (so raven re-show isn't blocked by a leftover Raven.m_tempTexts entry)
  • Vanilla Player.m_shownTutorials flags for all VSG raven entries

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.

For a single-id reset, the following are also cleared for that entry:

  • The max_fires counter (VSG.fc.<id>)
  • Any pending raven queue entry or dungeon-deferred entry
  • Any stale RavenText in the vanilla Raven.m_tempTexts list (so the raven can re-show without being blocked by a leftover from before the reset)
  • The vanilla Player.m_shownTutorials seen-flag (for raven entries)

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