VikingStoryteller

Viking Storyteller

AI-generated software.

Built and tested against Valheim 1.0.16. Keep a factual record of your Vikings' adventures: kills, deaths, damage contributions, assists, skills, building, crafting, gathering, AFK estimates, biome crossings and exact-creature revenge.

Press F8 in game to open your own server statistics. The package also includes optional tools for a searchable local HTML overview and structured logs for humans and analysis tools.

Storyteller is read-only: it records gameplay without changing it or providing admin commands. It does not send automatic chat messages.

For players and server operators

Use Storyteller with your own world and mod list. It discovers the active world and connected players through Valheim; no server address, player allowlist, world seed, private admin plugin, or hosted account is required. Records stay on the collector host. Clients send gameplay reports only to the game server they joined.

Install it on a dedicated server and participating clients, or use a player-hosted game as the collector. Each world has separate records. Preferences belong in BepInEx configuration; the package contains no preconfigured server settings. Existing configuration is preserved on upgrades. Server operators control collection, shared leaderboards and retention; clients control reporting, snapshots, optional Epic Loot metadata and the F8 hotkey.

Epic Loot is optional, and the reporting tools are optional. You do not need the author's other mods or server-management setup. Automatic updates, restarts and administrator chat/teleport commands are not part of this package.

Tested environment: Windows dedicated-server Valheim 1.0.16. Player-hosted and Linux installations are intended use cases but have not received equivalent native smoke testing. The included Python tools take explicit paths and work independently of the game process. Report game version, mod version, hosting platform and relevant errors when seeking help; remove account identifiers and private gameplay data before posting logs.

Compare players in F8

The Leaderboard tab compares collected world totals for creature killing blows, deaths, assists, creature damage, trees felled, mining hits, placement actions, crafts, doors opened/closed/combined and active minutes. Placements include terrain and plants; mining hits are not ore quantities. The server setting Enable leaderboards controls availability. Ties share ranks; views show the top 50 plus your own rank. Unknown metric coverage is omitted. Choose Today, Last 7 days (including today), or All time. Daily boundaries use the server timezone recorded when compact history begins. Rankings use available observations, not equal-duration contests. Totals follow the reporting account and display its latest character name. Deaths rank highest counts first. Native gathering counters are distinct from kills and are not added across overlapping tiers. Detailed player stats remain your own; shared rankings include character names and aggregate values.

Optional Epic Loot support

Epic Loot is detected automatically when installed, with no hard dependency. Equipped items report rarity, quality and enchantment identifiers/values when gear changes; ordinary snapshots do not repeat the full gear payload. F8 Skills & condition shows the last reported equipped gear. Missing, disabled or incompatible Epic Loot leaves ordinary reporting working. Optional Epic Loot equipment controls this integration. Gear is sampled at the snapshot interval; temporary changes between samples can be missed. World loot and supported item movements are recorded separately as described below. Socket-specific effects and inferred damage bonuses are not tracked.

Loot and item movements

Viking Crafting & Quick Deposit

Automatically supports Viking Crafting & Quick Deposit 0.0.1 through 0.0.5, when present. Install Storyteller 0.4.9 on participating clients and the collector. No storage-mod update or private server API is required. The optional observer records completed quick deposits, restocks, crafting material pulls and building material pulls with the player, item quantities, chest identity/location and Epic Loot rarity/effects when available. Native boat and cart cargo are supported, including containers that use the vehicle's network identity.

Fuel gathering from supported storage versions is labeled refuel_pull or auto_refuel_pull; these describe movement into the player inventory, not confirmed burning.

Material pulls are labeled crafting_pull or building_pull: they mean supplies reached the player's inventory, not that an item was crafted or a piece was placed. Normal crafting/building consumption is recorded separately. Plans, rejected batches and transfers needing recovery do not produce a confirmed movement. Recovery resolved later is not backfilled by this adapter. Reports describe observed inventory changes, not a guarantee that separate character and world saves reached disk together. Existing gathering, combat and other storage integrations continue independently.

Collector status.json exposes craftingStorageLedger (active, absent, or unsupported). The 0.0.1 storage mod's older startup message may still say its planned Storyteller API needs an update; this observer does not use that API. Use Storyteller's adapter status to check this integration. Unknown future storage versions are left unpatched until their interface is checked.