Skald

The skald remembers every deed. And every death.

Skald keeps the story of your server: who reached the Mistlands first, who has died to trolls eleven times, who has gone twenty days without dying, and whether the server itself is going to make it to Fader.

Quick start

1. Install Skald on the server and on every player's game. The server does the remembering; each player's game reports what happened to them and displays Skald's messages. A player without it sees nothing and reports nothing.
2. Everyone must run the same version — mismatched clients are turned away at the handshake, with the reason in the log.
3. In game, press F10.

Nothing else is required. Discord is optional and off until you add a webhook.

The panel

Press F10. Skald's own window opens on its own, with a tab for each page:

• Achievements — what you've earned, and what you're closest to, with progress bars
• Leaderboards — who leads on achievements, hours, deaths and streaks
• Deaths — how you've died, to what, your grudges, and the server's recent deaths
• The World — what the world is made of, and how the server is holding up

Progress is drawn as proper bars that fill in as the page opens, with the numbers counting up beside them. On the World tab, memory and world size are shown as gauges that turn from green to amber to red as the server fills up.

Escape or Close shuts it again. Rebind the key with PanelKey.

The same pages also appear in the game's own Texts screen (inventory, then the compendium icon), so nothing is lost if the window can't be built.

There is also an experimental rune icon for the inventory's row of icons, off by default. That row is prefab data and mods rearrange it, so the rune often lands badly. PanelIcon turns it on, with PanelButtonExtendPanel and PanelButtonOffsetX / PanelButtonOffsetY to place it.

In chat

Achievements appear in big text in the middle of the screen, with the detail in chat:

Timothy earned "Into the Mist" Timothy is the first on the server to set foot in the Mistlands.

Deaths get a line, and Skald has opinions:

Skald: Daniel came apart in Troll's grip like wet bread. Skald: Fulda was crushed by the very tree they were chopping. Skald: A Deathsquito killed Timothy. Two grams of pure malice.

Grudges form when the same thing keeps killing you:

Skald: A grudge is born: Troll has killed Daniel 3 times. Skald: Vengeance: Daniel has cut down Troll at last.

Streaks, returns, bosses and raids:

Skald: Astrid has survived 20 days without dying. Something out there is taking notes. Skald: Bjorn returns after 6 days away. Things died in the meantime. Skald: Moder fell after a 6-minute fight. Casualties: 2 (Daniel, Fulda x2). Skald: The ground is shaking near Daniel's base. Trolls.

Arriving after a break gets you a private summary:

While you were away (2 days): Boss down: Bonemass. Timothy earned Woodsman. 3 deaths while you were gone (Troll took 3). Your 9 days without dying still stands.

Chat commands

Type these in chat. Nobody else sees the command or the answer.

What Skald tracks

• 39 achievements: 7 bosses, 6 biomes, 2 playtime tiers, 19 for combat, work, travel, taming, eating and dying, and 5 hidden ones. Progress counts from when Skald first sees you, so veterans don't unlock everything on day one.
• Death announcements: 326 lines across all 25 ways Valheim can kill you, with their own lines for a dozen notable creatures. Dealt rather than rolled, so you see every one before any repeats.
• Nemesis system: three deaths to the same kind of creature (or the same player) and it holds a grudge. Killing one settles it.
• Survival streaks: in-game days survived without dying, counted only while you're online. When a long streak ends, the death message says so.
• First to reach: the first player into each biome is named.
• Return messages for players back after a long absence, and a private "while you were away" summary of what they missed.
• Boss fight summaries: how long the fight took, and who died in it.
• Raid announcements: everyone hears whose base is under attack, and the casualties when it ends.
• Performance watchdog: frame time, memory, save stalls and world size, alerting Discord when things degrade.
• World census: what your world is actually made of, so growth can be blamed on something specific rather than just noticed.
• Busiest areas: where on the map the objects pile up, and whose build it is, e.g. "Timothy's build, 1.2 km north-east of the world centre: 41,200 objects, mostly building pieces".
• Live Discord status: one message kept up to date with who's online and how the server is doing.
• Weekly Discord recap: hours, deaths, achievements, bosses, server health, and how fast the world is growing.

Achievements are awarded once per character per world, ever, and survive restarts and crashes. A new world starts fresh.

Server setup

Installing on a dedicated server. Most hosts can install Thunderstore mods directly. If yours can't, put Skald.dll in BepInEx/plugins/Skald/ on the server and restart it. The server needs BepInEx, same as the clients.

Discord does nothing until you give it a webhook:

[Discord]
WebhookUrl = https://discord.com/api/webhooks/...

Nothing is sent anywhere until you do. Once set you get performance alerts, the weekly recap (Sundays at 18:00 server time by default) and a live status message; deaths, achievements and raids can be posted too.

The live status message is posted once and then edited every two minutes: who's online, the in-game day, uptime, frame time, memory, world objects, the last save and the busiest area, under a green, yellow or red light. Pin it. It shows when it was last updated, so if the server dies it visibly goes stale, and a clean shutdown marks it offline. To put it in its own channel (a #server-status, say), give that channel's webhook to StatusWebhookUrl. If the message is deleted, Skald posts a new one.

Achievements are a file you can edit. BepInEx/config/Skald/achievements.json is written on first run with all the built-ins in it. Change a threshold, add your own, or mark one "hidden": true so it only shows once earned:

{ "id": "trees_500", "title": "Woodsman", "description": "500 trees felled.",
  "type": "stat", "stat": "TreeChops", "target": 500, "unit": "trees" }

Types are stat (any of the game's per-character counters), playtime, biome and key (a world flag such as defeated_bonemass). A broken file is never overwritten: Skald logs what's wrong with it, line by line, and uses the built-in catalog until you fix it.

Where the data lives, beside the world save:

worlds_local/<World>.skald.tsv          player profiles, achievements, deaths
worlds_local/<World>.skald.tsv.bak      the previous save, for recovery
worlds_local/<World>.skald-health.tsv   performance history and world censuses

Deleting them resets that world's records. They're tab-separated and safe to read.

Testing raid announcements: with devcommands on, run event army_eikthyr.

Settings

BepInEx/config/com.dks.skald.cfg, created on first run. "Where" says which side reads it — client settings can differ per player.

General

Achievements

Deaths

Social

Events

Watchdog

Tuned for a 4 GB server with around 5 players. Adjust the memory thresholds for other sizes.

Discord

Compatibility

• Valheim 1.0 (Unity 6), BepInExPack_Valheim 5.4.2350
• Dedicated and listen servers
• Doesn't touch gameplay, items or balance, so it should sit alongside other mods

Privacy

Skald keeps, on the server, beside the world save: each character's name and the game's own ID for that character, playtime, the game's per-character counters (trees felled, enemies killed and so on), biomes visited, deaths (cause, killer and time), grudges, streaks, achievements, and when they were last seen. It does not store Steam or other platform IDs, IP addresses, or locations. A refused !recap logs the requester's platform ID to the server log so admins can fix adminlist.txt.

Nothing leaves the server unless the admin sets a Discord webhook. With one set, performance alerts and the weekly recap (player names, hours, deaths, achievements) are posted there, and deaths, achievements and raids too if enabled.

If you run a server with Skald, tell your players. To erase a player's record, stop the server and delete their lines from <World>.skald.tsv; deleting the whole file resets everyone. Keep your webhook URL private: anyone who has it can post to your channel.

Known limits

• Players without Skald see none of its messages, and don't report their own deaths or stats.
• The inventory button may not appear if another mod has rearranged that screen. The key bind always works.
• Raid names come from the game's data rather than its code, so a few raids get a generic "something is coming" line.
• Stats and deaths are reported by each player's own game. Skald checks who sent them and limits how often, but it can't tell whether the numbers are true: a player with a modified game can claim achievements they didn't earn. The same player could just as easily cheat in the game itself.
• Installing on a world already in progress: the first person to reach each biome after installation is the one called first.

License

MIT - see LICENSE. Provided as is, without warranty of any kind. Back up your worlds; the author is not liable for lost data or anything else arising from its use.

Skald is a fan-made mod, not affiliated with or endorsed by Iron Gate or Coffee Stain. Valheim is a trademark of its respective owners.