Viking Codex

Ever feel like you're missing something in Valheim, but can't quite figure out what it is or where to start looking? Or wish you had an in-game codex with a bestiary, crafting reference, and a way to track your discoveries?

Viking Codex brings it all together. Browse the items, creatures, recipes, and building pieces you've learned about, track your progress by biome, and spot the gaps in your knowledge without revealing every undiscovered name. Playing with friends? Share eligible material discoveries so your fellow Vikings can learn alongside you.

Features

Your own Viking encyclopedia

Browse items, creatures, crafting recipes, building pieces, and crafting stations from one native-styled panel.

• Filter by biome, category, and discovery status.
• Search known entries and sort by progression or alphabetically.
• Track each biome's checklist with a percentage and a count of discoveries still left. Search and category filters do not change the biome's completion total.
• See discovered entries first when viewing All.
• Get discovery clues for hidden entries instead of an indistinguishable list of question marks. For example, a clue might suggest looking for red fruit on low bushes. Names and recipe details stay hidden until discovered; unknown icons remain silhouettes.
• Browse base-game content only. Older configs that enabled modded content no longer add modded entries to the checklist or material registry.
• Spot new discoveries with a NEW marker until you view them during that session.
• View an item and its recipes together without duplicate recipe rows.

Crafting information at a glance

Select an entry to review its description, materials, crafting station, and known recipe relationships. Details distinguish discovered content, known recipes, and whether normal crafting requirements are currently met. Missing materials and station requirements are highlighted to help you see what you still need.

Optional Wiki buttons open more information when you choose to use them.

Discover together

When a player learns an eligible material, Viking Codex shares that knowledge with other players on the same server. Their characters use Valheim's normal knowledge registration and recipe-unlock logic.

Players who reconnect can catch up on eligible discoveries recorded while they were away. Learned material knowledge belongs to each character, and shared history is stored separately for each world.

You still need the normal resources, crafting stations, station levels, and other requirements to craft or build. The mod does not grant items or reduce crafting costs.

Dependencies

Both dependencies are required:

• BepInExPack Valheim by denikson - 5.4.2351.
• Jotunn by ValheimModding - 2.30.2 or newer compatible version.

Thunderstore Mod Manager and r2modman use the package's dependency declarations to install the required packages.

Installation

Mod manager

Install Viking Codex and its dependencies through Thunderstore Mod Manager or r2modman, then launch the modded game.

Manual

With BepInEx and Jotunn installed, copy the VikingCodex folder from the manual package into BepInEx/plugins/.

Multiplayer and dedicated servers

Install the same Viking Codex version and its dependencies on the server and every connecting player's client. This version requires matching plugin versions even when sharing is disabled.

Restart the game or server after installation or an update.

How to use

1. Enter a world and press F8, or open your inventory and click Codex.
2. Pick a biome or category to narrow the list. Choose Discovered to browse known entries, or All to include unknown placeholders.
3. Type in the search box to find known content. Hidden names are excluded from searches.
4. Select an entry to read its details and crafting requirements.
5. Click Clear filters to reset the view. Press Escape or click Close to return to the game.

Material sharing is enabled by default and works automatically for eligible new discoveries. Existing eligible material knowledge is added to shared history automatically when characters connect. This is enabled by default; administrators can disable ImportExistingDiscoveries to share only new discoveries.

Configuration

The first plugin launch creates:

BepInEx/config/com.vikingcodex.cfg

You can enable or disable the Codex and shared discovery independently. Other options include the keyboard shortcut, unknown-entry visibility, Wiki links, inventory-button placement, and offline catch-up. Server settings control discovery sharing. The legacy modded-content setting is retained for config compatibility but cannot add modded entries.

Restart the server and reconnect clients after changing server policy.

Compatibility and feedback

I have tested Viking Codex on my own dedicated server, and it is working in that setup. It has not been tested with every mod combination, so there may be compatibility issues with other mods.

Join JustQOL | Valheim Mods on Discord for Viking Codex and Viking Revival support, announcements, bug reports, and suggestions. This invite does not expire and has no usage limit. Use viking-codex-support for Codex help. Include your mod and Valheim versions, other installed mods, reproduction steps, and relevant BepInEx errors with private information removed.

This is a checklist of registered base-game catalog entries, not a claim that every playable discovery has been mapped perfectly. Some entries remain Unclassified; use that biome filter to find them. A biome's 100% means all entries currently assigned to that biome have been discovered. Complete catalog coverage and biome accuracy are still being reviewed. Extra crafting restrictions added by other mods may not appear in the Codex; actual crafting remains controlled by the game and installed mods.

Powered by Astra

Code and documentation were created with assistance from OpenAI Codex, under the project owner's direction.

Main-menu access (1.0.5)

Viking Codex appears in the upper-left corner above Viking Revival and Viking Meals when installed. Click it for the controls and discovery guide. Load a world to browse your character's Codex. The native button matches the other JustQOL Viking menus.

Server and clients must all use Viking Codex 1.0.5; restart after updating.