Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
DiscoveryJournal
Vanilla-friendly, character-specific discovery journal for Valheim. Track recipes, build pieces, items and materials with search, sorting, recent discoveries and unread filters.
By ADERiGMS
| Date uploaded | 2 weeks ago |
| Version | 1.1.0 |
| Download link | ADERiGMS-DiscoveryJournal-1.1.0.zip |
| Downloads | 66 |
| Dependency string | ADERiGMS-DiscoveryJournal-1.1.0 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2360README
Discovery Journal
Discovery Journal is a vanilla-friendly quality-of-life mod for Valheim that keeps a persistent, character-specific record of discoveries made during normal gameplay.
Valheim's discovery notifications are temporary. Discovery Journal lets you revisit content your character has already legitimately unlocked, without revealing undiscovered recipes, bypassing progression, or changing crafting requirements.
Current version: 1.1.0
Author: ADERiGMS
Framework: BepInEx 5
Platform: Windows (Valheim PC)
Overview

Features
- Character-specific discovery history that persists across game sessions and worlds played by the same character.
- Four discovery categories: Recipes, Build Pieces, Items, and Materials.
- Search: Find recorded discoveries by name without case sensitivity; clear the search field to return to the full list.
- Sorting: Browse entries in Default, Ascending, or Descending order.
- Recently Discovered: Expand a dedicated list of your character's 10 most recent legitimate discoveries, newest first.
- Read / unread tracking:
NEWbadges, unread counters, and All / Unread filters. - Accurate list counts that follow the active category and filters.
- Valheim icons and localized discovery names where available.
- Duplicate protection: Reacquiring something already recorded does not create another entry.
- Trophy tracking: Supported vanilla trophies are recorded under Items.
- Movable Journal window and HUD launcher with saved positions.
- Adjustable UI scale:
0.75x–1.50x, with responsive layouts and scrollable lists. - Input protection: Journal controls are designed to avoid interference with the map, chat, console, inventory, chests, crafting menus, camera, and cursor.
Screenshots
Build Pieces — Recorded Discoveries

Discovery Search — Filter by Name

Recently Discovered — Latest 10 Entries

Unread Discoveries — NEW Badges

Sorting — Ascending (A–Z)

UI Settings — Scale and About

Items — Character Discovery Journal

How It Works
Discovery Journal records discoveries only when Valheim itself unlocks them for the currently loaded character.
Valheim unlocks new content
↓
Discovery Journal records it
↓
New discoveries are marked as unread
↓
Search, sort, or review recent entries
↓
Read state and discovery history are saved
The mod does not:
- Reveal undiscovered content or act as a complete in-game encyclopedia.
- Unlock recipes, items, or build pieces automatically.
- Change crafting requirements or character progression.
- Reconstruct discoveries made before the mod was installed.
- Share or merge discovery history between characters.
Discovery history belongs to the character, not the world. The same character keeps their records when visiting another world; different characters have separate journals.
Using the Journal
Browse and Filter
Choose Recipes, Build Pieces, Items, or Materials to view discoveries in that category. Use All or Unread to switch between the full recorded list and entries that still have a NEW status.
Search
Type a discovery name into the search field. Search is case-insensitive and works with the recorded discoveries shown by the Journal. Use the clear control to remove the query.
Sort
Choose a sorting mode:
- Default — the Journal's normal entry order.
- Ascending — alphabetical order, A–Z.
- Descending — reverse alphabetical order, Z–A.
Recently Discovered
Expand Recently Discovered to review up to 10 of the character's latest recorded discoveries, with the newest first. This list is based on actual discoveries, not on which category, search query, or sort mode is selected.
UI and Read State
Adjust the Journal's UI scale from 0.75x to 1.50x. The window and HUD launcher can be repositioned and their positions are saved. Newly recorded entries display NEW until marked as read by the Journal's normal read-state behavior.
Controls
| Input | Action |
|---|---|
| J | Open or close Discovery Journal. |
| Shift + J | Enter or exit HUD launcher move mode. |
| Left Mouse Button on the HUD launcher | Open the Journal. |
| Left Mouse Button + drag | Move the Journal window or the launcher when move mode is active. |
| Mouse wheel over a Journal list | Scroll that list. |
Journal hotkeys are suppressed while typing into Valheim text fields, including chat, the F5 console, map pin names, and the Hammer build search.
While the Journal owns UI focus, it also prevents unintended gameplay input and mouse interaction with underlying inventory, chest, and crafting interfaces. Higher-priority Valheim screens, such as the large map, Pause Menu, and Settings, take priority where appropriate.
Requirements and Tested Compatibility
- Valheim (PC)
- BepInEx 5 for Valheim
The 1.1.0 release candidate was tested with:
Valheim: 1.0.21
BepInExPack Valheim: 5.4.2360
BepInEx Core: 5.4.23.6
Platform: Windows x64
No additional mod dependency is required beyond the supported BepInEx installation. Compatibility with other Valheim builds or mods that alter discovery events or UI behavior is not guaranteed.
Installation
-
Install BepInEx 5 for Valheim and verify that it loads correctly.
-
Close Valheim.
-
Copy
DiscoveryJournal.dllinto the BepInEx plugins directory:Valheim/BepInEx/plugins/ -
Launch Valheim, load a character, and press J.
Do not install multiple copies of DiscoveryJournal.dll in different plugin folders.
Updating
- Close Valheim.
- Back up your character data and existing mod configuration as a precaution.
- Replace the previous
DiscoveryJournal.dllwith the1.1.0DLL. - Keep your existing configuration and character discovery data.
- Launch Valheim and verify that your Journal entries are present.
Discovery Journal 1.1.0 retains the existing character-specific discovery data format used by previous 1.0.x versions. Do not delete saved discovery data just to update the mod.
Uninstallation
- Close Valheim.
- Remove
DiscoveryJournal.dllfrom your BepInEx plugins directory. - Optionally remove the mod's BepInEx configuration file if you also want to clear its saved UI settings.
Uninstalling Discovery Journal does not require removing your Valheim character or world.
Compatibility and Limitations
- Discovery Journal is a local, vanilla-friendly quality-of-life mod. It does not intentionally modify server progression, recipes, or crafting rules.
- Discoveries are recorded from the point the mod is installed onward. The mod cannot reconstruct a character's earlier discovery history.
- Journal data is character-specific; it is not a shared database across characters.
- Other mods that change Valheim's unlock events, item identity, localization, or UI input may affect what Discovery Journal records or displays.
- Journal interface labels are in English; discovery names use Valheim's localization when available.
- The Journal is designed primarily for keyboard and mouse. Full controller navigation is not an advertised feature of this release.
Reporting a Bug
Please include:
- Discovery Journal version.
- Valheim version.
- BepInEx / BepInExPack version.
- Steps to reproduce the issue.
- Relevant lines from
BepInEx/LogOutput.log. - Other installed mods that could affect discoveries or user interfaces.
- A screenshot if the issue is visual.
Historical discoveries from before installation are not expected to appear; this is an intentional limitation, not a bug.
Credits
Mod Author: ADERiGMS
Framework: BepInEx 5
Valheim is developed by Iron Gate Studio and published by Coffee Stain Publishing.
Discovery Journal is an unofficial community mod and is not affiliated with or endorsed by Iron Gate Studio or Coffee Stain Publishing.
License
Copyright © 2026 ADERiGMS. All rights reserved.
See the included LICENSE file for the complete license terms.
CHANGELOG
Changelog
Thunderstore release history for Discovery Journal.
[1.1.0] - 2026-11-03
Initial Thunderstore Release
The first public release of Discovery Journal on Thunderstore ships as version 1.1.0, with Search, Sorting, and Recently Discovered, alongside a compact journal layout and improvements to filtering, scrolling, and UI scaling.
The core philosophy remains unchanged: Valheim discovers; Discovery Journal remembers. The mod records discoveries legitimately unlocked by the current character and does not reveal undiscovered content or alter gameplay progression.
Added — Discovery Search
- Added a search field for finding discovered entries by their localized names within the selected category.
- Added case-insensitive matching, so searches work regardless of letter capitalization.
- Added a
Clearcontrol to quickly reset the search field. - Added a dedicated empty-state message when no discoveries match the current search and filter.
- Search works together with the existing
AllandUnreadfilters. - Updated the visible-entry count to reflect entries matching the current category, search, and read-state filter.
Added — Discovery Sorting
- Added three sorting modes for the main discovery list:
- Default — original saved discovery order.
- Ascending — alphabetical order (A–Z) by localized discovery name.
- Descending — reverse alphabetical order (Z–A) by localized discovery name.
- Added a sorting control that cycles through
Default → Ascending → Descending → Default. - Reset list scroll position when the sorting mode changes.
- Sorting affects only the displayed list; it does not reorder or overwrite saved discovery history.
- Sorting remains compatible with category selection,
All/Unreadfiltering, and Search.
Added — Recently Discovered
- Added an expandable Recently Discovered section showing up to 10 of the current character's latest recorded discoveries, newest first.
- Recent discoveries are selected from the character's existing saved discovery history; no separate discovery timeline or cross-character data is introduced.
- Added a dedicated scrollable view for recent entries, using the existing discovery-card presentation and
NEWindicators. - The recent list remains independent of the selected category, search text, and main-list sorting mode.
- The section handles a new character with no discoveries, fewer than 10 discoveries, and a full list of 10.
- Recent discoveries and their order remain available after saving and restarting the game.
- Expanding the recent list switches the content view; collapsing it restores the normal category list and its sorting control.
Improved — Journal Layout and Usability
- Refined the journal's layout with more compact spacing and a clearer visual hierarchy.
- Reduced redundant category-heading information and streamlined the placement of list controls.
- Integrated the Recently Discovered section into the journal's existing interface rather than opening a separate window.
- Preserved the established dark journal theme, bronze/amber accents, discovery icons, category tabs, and
NEWbadges. - Improved readability of the search field by scaling its text with the selected UI scale.
- Improved filtered-list sizing and scroll behavior to match the entries actually displayed.
Fixed — Search, Scrolling, and Input Focus
- Fixed unwanted horizontal scrolling in the Recently Discovered area at smaller UI scales.
- Improved recent-list bounds and scrolling across supported manual UI scales (
0.75x–1.50x). - Prevented the large map from opening while the Journal's Search field has keyboard focus; normal map behavior remains available when Search is not focused.
- Preserved protection against Journal hotkeys activating while typing into Valheim text fields.
- Preserved input isolation between the Journal and underlying inventory, chest, crafting, map, and menu interfaces.
Compatibility and Save Data
- Tested with Valheim 1.0.21 on Windows x64.
- Tested with BepInExPack Valheim 5.4.2360 (BepInEx 5.4.23.6).
- Final regression: 40/40 tests passed (November 2, 2026).
- Existing per-character discovery records remain compatible; no save-format migration is required.
- Discovery records and read/unread state remain character-specific and persistent between sessions.
- No reset feature, undiscovered-content encyclopedia, gameplay cheats, or progression changes have been added.
- No new mod dependencies were introduced.