Skaldsong

Skaldsong

Skaldsong replaces Valheim's plain center-screen "Skill increased" text with a

native-style toast that slides in near the bottom of the screen whenever any

skill levels up. It shows the skill's icon, name, and level with an animated

fill bar, while leaving vanilla's own level-up sound and golden halo effect

untouched.

Features

• Native-styled toast notification for every skill level-up, replacing only

the vanilla center/top-left text message (the sound and halo VFX still play).

• Animated 0% → 100% fill bar on each level-up.
• Slides in, holds, and fades out automatically — no input required.
• Queues level-ups so a burst of skill gains (e.g. after fresh-spawn XP or a

console-triggered batch) plays back one at a time instead of overlapping.

• Background can use a real Valheim UI panel sprite (parchment/wood panel) or

a flat tinted color, your choice.

• Thin outline border around the toast panel.
• Colors, timing, and text are all configurable via the BepInEx config file.
• Per-skill disable list if you want to silence specific skills.
• Client-side only — safe to use on servers where other players don't have it.

Install

With a mod manager (r2modman, Mod Manager, etc.): install

normally — the manager will pull in the required BepInEx pack automatically.

Manual install: copy Skaldsong.dll into

BepInEx/plugins/Skaldsong/Skaldsong.dll in your Valheim install folder.

Requires BepInEx (BepInExPack_Valheim) to already be installed.

Configuration

A config file is generated at

BepInEx/config/com.TwoStubbornStudios.skaldsong.cfg after the first run.

All values below are the defaults.

| Key | Default | Purpose |

|---|---|---|

| Enabled | true | Enables the skill level-up toast and sound. |

| SuppressVanillaMessage | true | Suppresses vanilla's own "Skill increased" center/top-left message so only the Skaldsong toast is shown. Vanilla's level-up sound and particle effect are unaffected. |

| VerticalOffset | 0.25 | Vertical position of the toast, as a fraction (0-1) of the HUD canvas height measured from the bottom edge. |

| HoldDuration | 2 | How long, in seconds, the toast stays fully visible before fading out. |

| BarFillDuration | 1.0 | Seconds for the fill bar to sweep from 0% to 100%. |

| BarFillStartDelay | 0.1 | Pause, in seconds, after the toast finishes sliding in before the fill bar begins filling. |

| UseParchment | true | When true, renders the toast background using a native Valheim parchment/panel sprite found at runtime. When false, always uses the flat tinted panel. |

| PanelSpriteName | (empty) | Optional: exact (case-insensitive) sprite name to pin the toast background to, overriding the automatic scorer. Leave empty for automatic selection. |

| PanelColor | #FFFFFF | Hex tint color applied to the toast background (parchment sprite, or the flat panel when UseParchment is false / no sprite is found). |

| PanelOpacity | 1.0 | Opacity of the toast background panel (0-1). |

| BarTrackColor | #000000 | Hex color of the fill bar's background track. |

| BarFillColor | #5FC9E8 | Hex color of the fill bar itself, used for all skills (no per-skill palette). |

| TextColor | #F2E8D5 | Hex color of the toast's skill name and level text. |

| TextOutlineOpacity | 0.35 | Opacity of the black text outline (0-1). Currently has no visible effect — the outline is disabled in this version. |

| LevelSeparator | LVL | Text shown between the skill name and the level number, e.g. "Wood Cutting LVL 68". |

| ShowPanelBorder | true | When true, draws a thin dark outline framing the entire toast panel. |

| PanelBorderColor | #000000 | Hex color of the thin outline drawn around the toast panel. |

| PanelBorderThickness | 2.5 | Thickness, in pixels, of the outline band shown around the toast panel. |

| SoundVolume | 1 | Volume of the level-up sound (0-1). |

| PlayOwnSound | false | When true, Skaldsong plays its own copy of the level-up sound (using SoundVolume). When false (default), it relies on vanilla's own level-up