You are viewing a potentially older version of this package. View all versions.
ADERiGMS-DiscoveryJournal-1.1.0 icon

DiscoveryJournal

Vanilla-friendly, character-specific discovery journal for Valheim. Track recipes, build pieces, items and materials with search, sorting, recent discoveries and unread filters.

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-5.4.2360 icon
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.2360

README

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

Discovery Journal v1.1.0 — 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: NEW badges, 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 Journal — Build Pieces

Discovery Search — Filter by Name

Discovery Journal — Search

Recently Discovered — Latest 10 Entries

Discovery Journal — Recently Discovered

Unread Discoveries — NEW Badges

Discovery Journal — Unread Filter

Sorting — Ascending (A–Z)

Discovery Journal — Ascending Sort

UI Settings — Scale and About

Discovery Journal — UI Settings

Items — Character Discovery Journal

Discovery Journal — Items


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

  1. Install BepInEx 5 for Valheim and verify that it loads correctly.

  2. Close Valheim.

  3. Copy DiscoveryJournal.dll into the BepInEx plugins directory:

    Valheim/BepInEx/plugins/
    
  4. Launch Valheim, load a character, and press J.

Do not install multiple copies of DiscoveryJournal.dll in different plugin folders.


Updating

  1. Close Valheim.
  2. Back up your character data and existing mod configuration as a precaution.
  3. Replace the previous DiscoveryJournal.dll with the 1.1.0 DLL.
  4. Keep your existing configuration and character discovery data.
  5. 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

  1. Close Valheim.
  2. Remove DiscoveryJournal.dll from your BepInEx plugins directory.
  3. 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 Clear control 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 All and Unread filters.
  • 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/Unread filtering, 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 NEW indicators.
  • 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 NEW badges.
  • 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.