Turn your Valheim server into a guided experience. Write a YAML file on your server and players receive quest objectives, NPC dialogues, lore popups, and rewards — triggered automatically as they play, using only Valheim's own UI.
No custom assets. No custom UI skins. Just your words, delivered through Hugin, the chat, and dramatic cinematic screens.
Guides players through your content. When a player crafts their first weapon, enters a dangerous biome, discovers the trader, or kills a boss — show them a message. Give them a quest. Give them a reward.
Runs entirely from the server. You write one YAML file. Every player connected to your server receives it automatically. Update it and save — all players get the new version instantly without restarting.
Uses vanilla Valheim UI. Messages appear as Hugin (the raven) popups, system toasts, chat lines, rune-tablet screens, or the dramatic intro cinematic style. Nothing looks out of place.
BepInEx/config/ValheimServerGuide/guidance.yaml automatically.The mod works in single-player and host & play as well — the host acts as the server.
Triggered messages — Show a Hugin raven popup, a toast, or a dramatic full-screen text when a player does something specific:
Multi-step quests — Chain triggers into a quest with steps. "Gather 10 wood → craft a workbench → build a wall." Each step has its own trigger. Progress shows in the on-screen tracker.
NPC conversations — Hold E near Haldor, Hildir, or BogWitch to open a dialogue panel. Give them choices. Fire quests. Grant rewards.
Item turn-ins — Have players bring a specific item to a trader NPC to complete a quest step.
Rewards — Grant items, skill experience, or status-effect buffs when an entry or quest completes.
World events — Mark an entry as scope: global and the first player to trigger it fires the display for every connected player simultaneously. Perfect for boss kills and world milestones.
Discord announcements — Post to a Discord channel when something happens (server-side only; your webhook URL is never exposed to players).
A raven popup when a player crafts their first bronze sword:
- id: first_bronze_sword
trigger:
type: craft
item: SwordBronze
display:
mode: raven
topic: "Bronze Edge"
text: "Forged in fire, this blade cleaves the Black Forest's beasts."
once: true
A world event when the first boss falls:
- id: world_eikthyr_fell
scope: global
trigger:
type: kill
creature: Eikthyr
display:
mode: intro
topic: "The Stag-King Falls"
text: "Eikthyr is slain. The realm trembles. Your trial begins, traveler."
once: true
announce:
discord: "⚔️ **{playerName}** has slain **Eikthyr** — the first boss has fallen!"
Full configuration guides, all trigger types, display mode options, quest chains, NPC conversation setup, reward configuration, and admin commands are covered in the Wiki.
This mod was built for the TaegukGaming community server running the Hearthbound modpack. If you want to see it in action:
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 to 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: 0.5.0 Source / issues / wiki: https://github.com/yesu0725/Valheim-ServerGuide