TrailLedger

Version 0.4.0

TrailLedger is a client-side Valheim exploration and map utility that automatically records useful resources and locations you discover, keeps renewable-resource availability information, and provides a configurable live creature radar.

It records what your client encounters nearby in personally explored terrain. It does not scan unexplored world data or reveal distant, unloaded creatures.

Features

Automatic Discovery

Explore normally to record supported nearby resources and useful locations. Discoveries persist per world, with duplicate prevention and configurable encounter distance. Preview the discovery radius on the full map, group nearby matching resources, and choose which markers to show. Hiding a marker never deletes its discovery.

Category	Supported discoveries
Ores	Copper, Tin, Silver, Flametal
Foraging	Raspberries, Blueberries, Cloudberries, Mushrooms, Yellow Mushrooms, Thistle, Jotun Puffs, Magecaps
Seeds	Carrot seeds, Turnip seeds
Dungeons	Burial Chambers, Sunken Crypts, Frost Caves, Infested Mines
Other	Leviathans, Surtling spawners, Greydwarf nests

Resource Map Filters

Use category filters, individual resource checkboxes, Show All, Hide All and category-only presets on the full map. Saved preferences apply to both the full map and minimap.

Raspberries ×5 means five individually recorded nearby Raspberry locations represented by one marker. Each discovery keeps its own position and availability state. Group labels can also show how many members are confirmed available. Toggle Tools → Group Nearby Resources to switch between grouped and individual markers. Dungeon entrances always remain separate.

Renewable Resource Tracking

When TrailLedger observes a known renewable resource being harvested, its location remains recorded. A radial cooldown indicator surrounds its normal full-colour icon when a reliable runtime respawn duration is available. Select the marker on the full map to see remaining known active time and availability details.

TrailLedger only counts respawn time it knows was active while you were playing in that world. Logout, offline time and paused gameplay do not advance its estimate. This intentionally avoids telling you a resource is ready simply because you were offline for several hours. If a resource has already returned when you revisit it, TrailLedger corrects itself immediately.

Expired estimates remain unconfirmed until the resource is observed. An empty resource first encountered without a known harvest time has unknown remaining time rather than a fabricated countdown. Actual nearby game state overrides the estimate. Grouped resources retain individual timers; Details shows the next known countdown.

Creature Radar

Enable Creatures → Settings → Show Creature Radar to display nearby loaded creatures on the full map and minimap. Radar is OFF by default.

• Runtime Valheim trophy icons where available, with original category symbols as fallbacks.
• Animals/friendly, Enemies, Tamed and Bosses visibility controls.
• Individual creature-type filters, including meaningful modded types encountered nearby.
• Separate star badges and Minimum Stars: Any / 1★+ / 2★+ filtering.
• An independently configurable radar radius and preview.
• Subtle status borders that preserve recognisable, full-colour creature icons.

To search for Boars, first encounter a nearby Boar, choose Hide All Creature Types, then enable Boar in its type list. Keep its applicable category enabled and optionally require a minimum star level. Newly encountered types remain hidden after Hide All, keeping the search focused. Show All Creatures restores all type defaults and broad category switches.

Type lists are organised by runtime family under Animals, Enemies and Bosses, with scrolling and family bulk controls. Category placement follows game faction data, so a creature you think of as wildlife may appear under Enemies. A tamed creature uses its normal type filter plus the separate Show Tamed switch. Type, current category/state and minimum-star filters must all pass.

Creature positions are live only and are never saved in the persistent discovery database. Dead, unloaded or out-of-range creatures disappear from radar. TrailLedger uses local loaded characters in personally explored terrain and the same interior as the player; it does not search distant or unloaded entities.

Silver and Wishbone

New Silver discoveries require an active Wishbone finder effect as well as normal distance and exploration eligibility. Previously discovered Silver remains remembered after the Wishbone is unequipped.

Dungeons

Dungeon entrances are persistently recorded and individually tracked. Dungeons → Track Resources Inside Dungeons is OFF by default. This prevents places such as Burial Chambers from filling the map with Yellow Mushroom discoveries unless you explicitly want that information.

The preference suppresses new ordinary resource discoveries inside vanilla-classified interiors. It does not hide entrances or erase resources already recorded. Overworld resources beside entrances remain eligible. Custom interiors outside Valheim's native interior classification may not be recognised.

Completed Dungeons

Left-click a TrailLedger dungeon marker on the full map to open Details, then choose Mark Completed. The normal dungeon icon gains a distinct checkmark badge and Completed label. Choose Mark Uncompleted to reverse it.

Alternatively, open Dungeons → Browse Discovered Dungeons… and select an entrance. The map centres on it and opens the same Details controls. The list includes older discoveries and entrances hidden by visibility filters, so rediscovery is unnecessary.

Show Completed and Show Uncompleted are independent filters, both ON by default. Completion persists between sessions. It is personal TrailLedger metadata only and never changes the actual dungeon or Valheim world save.

Discovery Radius

Open Settings → Discovery Radius and use − 5m / + 5m. The setting saves immediately. Its minimum is 5m, default 20m, and maximum 50m.

Changing a radius, or choosing Preview, displays a temporary gold circle centred on your player on the full map. It follows map zoom and movement, lasts eight seconds, and closes with the settings panel or map. The circle shows the horizontal footprint of the 3D encounter distance; vertical separation still matters.

Settings → Creature Radar Radius uses the same controls and preview, with a minimum of 10m, default 80m, and maximum of 150m.

Client-side Mod

TrailLedger runs on your client. No TrailLedger installation is required on a dedicated server, and other players do not need it installed. It stores its own discovery metadata and does not directly modify Valheim world saves or synchronise your discoveries to other players.

Installation

Thunderstore / r2modman

Install Racidon-TrailLedger through Thunderstore or r2modman. A Thunderstore-compatible manager installs the declared dependencies automatically. Launch Valheim from that modded profile.

Manual Installation

1. Install BepInExPack Valheim 5.4.2350 and Jötunn 2.30.0.
2. With Valheim closed, copy plugins/TrailLedger.dll from the ZIP into BepInEx/plugins/TrailLedger/ under your Valheim installation.
3. Keep the included licence and third-party notices with your local copy. Remove duplicate older TrailLedger DLLs, then launch through BepInEx.

The exact tested manifest dependencies are:

• denikson-BepInExPack_Valheim-5.4.2350
• ValheimModding-Jotunn-2.30.0

Dependency DLLs are not bundled in TrailLedger's package.

Usage

1. Launch Valheim with TrailLedger installed and explore normally.
2. Open the full map, normally M.
3. Open TrailLedger · Discoveries.
4. Choose resource categories and visibility, or enable radar under Creatures → Settings.
5. Select markers for Details, including resource countdowns and dungeon completion.
6. Use Settings for discovery/radar radii and Tools for grouping and marker maintenance.

Tools → Rebuild TL Markers recreates TrailLedger's persistent marker layer while retaining discoveries, dungeon completion, timers and preferences. Live radar reconciles separately. Ordinary manual pins are left alone.

Tools → Advanced… → Clear TrailLedger Discoveries for This World… deletes only the current world's TrailLedger records after confirmation and a backup. Discovery then pauses until Resume Discovery or the next session. Other worlds and filter preferences remain intact.

Data and Configuration

Paths are relative to the active Valheim installation or mod-manager profile:

File or folder	Purpose
BepInEx/config/au.astra.trailledger.cfg	BepInEx settings, including discovery/radar radii and grouping
BepInEx/config/TrailLedger/world-<UID>.json	Per-world discoveries, renewable state and dungeon completion
BepInEx/config/TrailLedger/filters.json	Resource/creature visibility choices, encountered creature-type names and UI preferences

Back up the entire BepInEx/config/TrailLedger/ directory to preserve personal discoveries and filters, plus the .cfg file for configuration. Data is per world, shared by characters using the same installation/profile. Creature type names and choices can be saved; creature positions cannot.

Older schema-1 discoveries migrate automatically, preserving the original in a .pre-0.4.bak file. Pending changes save periodically and on normal exit; a crash can lose the newest unsaved changes. Review discovery files before sharing, since they contain locations and world identifiers.

For diagnostics, use trailledger stats in the console or enable Logging.Verbose. The dungeon list also offers Diagnose clicks (2 minutes) for temporary interaction logging.

Compatibility

TrailLedger uses BepInEx and Jötunn and has been tested in-game with Valheim 1.0.12, BepInEx 5.4.23.5 (pack 5.4.2350) and Jötunn 2.30.0. The 0.4.0 resource timers, full-colour icons, trophy radar, creature filters/stars and dungeon completion workflow have been confirmed in-game.

It is designed to coexist with ordinary vanilla/manual map pins. Another mod independently adding resource or creature pins may produce duplicate visual information, and map UI mods may overlap controls. Compatibility with every map mod is not guaranteed.

Discovery requires loaded objects and personal exploration, with no line-of-sight test. Nonrenewable resources, spawners and Leviathans can remain recorded after depletion or disappearance. Group centres are approximate, and the rendered-marker limit may hide some distant records without deleting them. Controller navigation and localisation are not implemented.

Bugs and Suggestions

Bugs and suggestions: message racidon on Discord.

Include your game/mod versions, relevant log messages and reproduction steps. Remove personal information before sharing logs or data.

AI-Assisted Development

TrailLedger was substantially developed with AI-assisted coding and testing. Its package icon was also AI-generated; the Thunderstore listing uses the AI Generated category.

Credits

TrailLedger: Astra / TrailLedger contributors. Source and original geometric category artwork are released under the MIT License.

Thanks to BepInEx, Jötunn, HarmonyX and Json.NET contributors. Valheim and its runtime artwork belong to Iron Gate and their respective rights holders. Game inventory and trophy sprites are borrowed at runtime, never extracted or bundled. See THIRD-PARTY-NOTICES.md for dependency notices and artwork provenance.