DiscoveryJournal

By Dedryx · Version 0.1.0

A journal for everything your character has learned how to craft or build.

Learned something new but missed the popup? Open your journal to find the recipe, see its materials, and check where to craft or build it.

Features

• Shows only recipes and build pieces your character knows.
• Displays localized names, icons, material requirements, crafting stations and levels, and build tools/categories.
• Tracks new entries with a yellow NEW badge and a count on the New tab.
• Includes New, All, Crafting, and Building filters and title-only search.
• Keeps a selected new entry visible until you select another entry, change search/filter, or close the journal.
• Provides Mark All Read for all currently known entries.
• Uses vanilla-styled panels, mouse-wheel scrolling, and a small pool of reusable rows for large journals.
• Baselines existing characters without hundreds of false new-entry notifications.

Using the journal

Open inventory with Tab and click Journal on the crafting panel, below the repair hammer. Use Back to Inventory to return. The underlying inventory panels fade while the journal is open.

Search matches recipe and build-piece titles, with a short delay after typing. It does not search materials or reveal unknown recipes. Requirements show base amounts; ordinary upgrade costs and crafting bonuses are not simulated. Special enhancement requirements appear separately after the character discovers the corresponding station.

Optional: learn from nearby storage

Disabled by default. Enable this if you want materials brought home by friends to count as discoveries for your character without having to pick them up yourself.

The mod checks loaded, accessible player-built containers within the configured radius every seven seconds. World-generated loot chests and inaccessible storage do not qualify. Items are never moved or consumed. Vanilla still decides which recipes and build pieces become known, including its station and build-tool requirements.

Discoveries produce one vanilla-style notification per batch. Other players do not receive your discoveries or journal state.

Installation

Requires BepInExPack_Valheim (BepInEx 5). Built against Valheim 1.0.12.

• Mod manager: install DiscoveryJournal and its BepInEx dependency.
• Manual: extract the archive's BepInEx folder into your game installation or active mod-manager profile.

Install on the client only. The server and other players do not need this mod.

Configuration

Launch once to create BepInEx/config/Dedryx.DiscoveryJournal.cfg.

Saves and compatibility

Read/unread state is saved per character in BepInEx/config/DiscoveryJournal/<character-ID>.xml. It follows the character across worlds on the same installation. Copy that file when moving the character to another installation; it is not cloud-synchronized by this mod.

The journal uses live game data and narrow UI additions. Compatibility with every content/UI mod is not guaranteed. Mouse and keyboard are the primary controls; controller navigation has not been fully validated. Server-only custom storage permissions cannot be verified locally, so leave storage discovery disabled with those systems unless tested.

DiscoveryJournal does not add custom networking or modify global progression keys. Optional storage learning changes your character's normal item knowledge; ordinary vanilla gameplay may subsequently use that knowledge for progression checks.

Changelog

0.2.1

• Added a generated TSV report containing every live recipe/build-piece biome assignment, its required materials, and whether an override changed it.
• Added a persistent TSV override file for explicit per-entry biome corrections, with validation and safe fallback to inference.
• Corrected biome filtering to assign each entry one material-progression tier rather than every biome represented by its ingredients.

0.2.0

• Added journal controls for nearby-storage discovery and reviewable nearby-only or legacy whole-biome recipe resets.
• Added filters for biome, required material, crafting/build location, and item/build category without exposing unknown entries.
• Biome filters now assign one inferred progression tier from the earliest source of each material and the latest requirement needed to unlock the recipe.
• Added localized item/build descriptions and an Inspect view using Valheim's live quality-one item stats.
• Added a configurable J hotkey and blocked character movement/actions while typing in journal fields.
• Improved discovery notifications, unread-selection behavior, title-only debounced search, and large-list virtualization.
• Reworked the journal to match vanilla inventory styling, including the crafting-side launcher, tab underline, NEW badges, wheel scrolling, faded inactive panels, and adaptive vertical sizing.
• Separated enhancement resources from normal requirements and reveal them only after their station is discovered.

0.1.0

• Initial release by Dedryx for Valheim 1.0.
• Inventory-integrated journal for known crafting recipes and build pieces, with localized names, icons, requirements, stations, tools, and categories.
• New, All, Crafting, and Building filters; title search with a short typing delay.
• Character-specific read/unread tracking; existing knowledge starts acknowledged.
• Selected new entries stay visible until you leave them; Mark All Read acknowledges the complete known list.
• Vanilla-styled panels, a crafting-side journal button, mouse-wheel scrolling, and reusable visible rows for large journals.
• Optional nearby accessible player-built storage discovery, disabled by default, with batched unlock notifications.
• Enhancement resources separated from ordinary requirements and hidden until the enhancement station is discovered.
• Fully client-side; no server plugin or custom networking required.