Skip to content

Reward System

Jump to bottom
Taeguk edited this page Jun 7, 2026 · 1 revision

Reward System

Guidance entries and NPC conversation choices can grant rewards when they fire. Rewards are declared in a rewards list and processed in order.

After all rewards are granted, a summary notification appears in the center of the screen:

"Received: Bronze Sword (Q2), +500 Swords XP, Rested buff (10 min)"

Adding Rewards to an Entry

- id: forge_bronze
  title: "The Bronze Age"
  steps:
    - trigger: { type: craft, item: Bronze }
      message: "Smelt bronze."
    - trigger: { type: craft, item: SwordBronze }
      message: "Forge a bronze sword."
  rewards:
    - type: item
      item: SwordBronze
      amount: 1
      quality: 2
    - type: skill_exp
      skill: Swords
      amount: 500

For a chain entry, rewards fire when the final step completes. For a single entry (no steps), rewards fire when the entry fires.

Reward Types

item

Adds items directly to the player's inventory.

rewards:
  - type: item
    item: SwordBronze       # internal prefab name
    amount: 1               # stack count (default 1)
    quality: 2              # upgrade level (default 1, clamped to item max)

If the inventory is full, the item is dropped on the ground in front of the player instead of being silently lost.

Finding prefab names: Use the Valheim Item Database to look up internal prefab names. Examples: SwordBronze, Wood, Coins, TrollHide, ArrowIron.

skill_exp

Adds raw experience points to a skill.

rewards:
  - type: skill_exp
    skill: Swords           # skill name
    amount: 500             # experience points to add

Experience is added directly, bypassing the normal XP-per-action gain. The skill levels up naturally as the accumulated experience crosses each level threshold.

Valid skill names: Swords, Knives, Clubs, Polearms, Spears, Blocking, Axes, Bows, Crossbows, Unarmed, Pickaxes, WoodCutting, Jump, Sneak, Run, Swim, ElementalMagic, BloodMagic

skill_level

Sets a skill to a target level. Only raises — never lowers a skill that is already higher.

rewards:
  - type: skill_level
    skill: Run
    level: 30               # target level (1–100)

If the player's Run skill is already 35, this reward has no effect.

buff

Applies a status effect to the player.

rewards:
  - type: buff
    effect: SE_Rested           # status effect name
    duration_override: 600      # seconds (optional; omit for default duration)

duration_override overrides how long the buff lasts. If omitted, the effect runs for its normal duration.

Common status effect names:

Name Effect
SE_Rested Rested buff (HP/stamina regen bonus)
SE_Wet Wet debuff
SE_Burning Burning damage over time
SE_Frozen Frost debuff
Potion_stamina_medium Stamina mead effect
Potion_health_medium Health mead effect

Note: Status effects use their ScriptableObject asset name, not the display name. If an effect name is unrecognised, the reward is skipped and a warning is logged. The rest of the rewards list still executes.

Rewards on Conversation Choices

Conversation choices can also grant rewards when selected:

conversation:
  choices:
    - text: "I'll take the sword."
      rewards:
        - type: item
          item: SwordBronze
          amount: 1
          quality: 2
    - text: "Train me instead."
      rewards:
        - type: skill_exp
          skill: Swords
          amount: 1000
    - text: "Not now."

The player picks one choice — only that choice's rewards are granted.

Multiple Rewards

Any number of rewards can be listed. They are all granted in order:

rewards:
  - type: item
    item: SwordBronze
    amount: 1
    quality: 2
  - type: skill_exp
    skill: Swords
    amount: 500
  - type: skill_level
    skill: Run
    level: 20
  - type: buff
    effect: SE_Rested
    duration_override: 300

If one reward fails (e.g. unknown item prefab), the error is logged and the remaining rewards still execute.

Reward Notification

After rewards are granted, a centered toast message summarises what the player received:

"Received: Bronze Sword (Q2), +500 Swords XP, Run → Lv 20, Rested buff (5 min)"

This notification is suppressed if the rewards list is empty.

Clone this wiki locally