VikingStoryteller
Records Valheim adventures with combat contributions, player stats, activity summaries and F8 leaderboards. Includes searchable logs, bounded retention and optional Epic Loot gear reporting.
About this mod Author’s original text
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
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: