Confirm with your password

DiscoverySync

Munin shares item and material discoveries between opted-in characters in a Valheim world. Each character chooses whether to receive updates.

Changelog & versions

· Art - All Rights Reserved; Code - MIT license · Website

Stars
0
Downloads
47
Version
1.0.2
Updated
Author
Truncated
Virus scan
✓ Scan successful
Runs on
Client & Server

Compatibility

Required 1

Install these too — Gale pulls them in for you.
  • Jotunn ValheimModding ·2.30.2

Description

Discovery Sync

From the beach, the Watcher stood unmoving, his eye gazing over the storm-tossed waters. Munin landed upon his shoulder, dipping his head in greeting. In his ear, the raven murmured, "Allfather, your warriors are assembling and I have yet to complete my flight. You called for me?"

A soft grunt was all that was given in response. His hand slowly stroked the raven's feathers at his neck slowly as he considered. The waves lapped the sands at his feet for long moments before he spoke.

"A boon is in order for those from Midgard, I think." Hesitance fled from the words as clarity and resolve wove through his voice. "I want you to offer all that you learn of this world to all who honor me. Knowledge is power, after all, and they will need much of that to reach Valhalla from Valheim."

The raven rose its head high and cawed, the sound rippling through the air, across the 10th world.

"So you will it, Allfather, so it shall be".


Accepting Munin's offer persists and shares item and material discoveries between opted-in characters in a Valheim world. When one player picks up something new, other characters who accepted updates learn it too, and Valheim unlocks the matching recipes for them as usual. Players who were offline catch up when they next join. For worlds already in progress, admins can add everything their character already knows, and can let every player do the same.

Features

  • No need to throw new things at each other: a new item or material is sent to the server, saved with the world, and passed to everyone online straight away.
  • Late joiners catch up: players who join later receive everything the world has learned.
  • Character choice: new characters start with shared updates off. Munin greets them and offers the choice; the server remembers it. Use /ds_changemind to call Munin back and choose again.
  • Vanilla unlock rules: Valheim still decides which recipes unlock. Nothing is forced, and a station's recipes still need that station to have been used.
  • Simple to start with an existing world: /ds_sharealliknow adds everything a character already knows.
  • No pop-up floods: a big catch-up shows one summary at login, then one pop-up per crafting station or tool when you next use it.
  • Admin overview: an in-game list of every recipe, build piece and item the world shares.
  • Per-world saves: each world keeps its own discoveries on the server.
  • Localized UI and messages: available in English, French, German, Italian, Spanish, Russian, Turkish, Polish, Ukrainian, Brazilian Portuguese, Simplified and Traditional Chinese, Japanese, and Korean.

Choosing whether to receive updates

When a new character joins, Munin greets them outside as the ravens prefer. Interact with him to open the consent prompt. Choosing Yes enables normal catch-up and live updates. Choosing No keeps the character out of shared updates while normal gameplay and discoveries continue as usual. The server saves the choice per character and world. Until a choice is made, that character does not receive shared updates.

To change the choice later, type /ds_changemind in chat (or ds_changemind in the F5 console). Munin returns and asks whether you will reconsider Odin's boon. Interact with him to open the same prompt. If you walk away without answering, your current choice stays as it is.

Joining a world with many shared discoveries

When a player receives a large batch of discoveries at once (usually the first time they join a world that has been caught up), the items are learned quietly instead of with hundreds of unlock pop-ups:

  • At login: one pop-up, "Shared discoveries: 281 learned from this world", plus a line in chat. Other mods' unlock pop-ups for those items, such as Armoire's "Appearance Unlocked", are skipped too.
  • At each crafting station: the first time you open it afterwards, one pop-up such as "Forge: 23 new recipes". Recipes you craft by hand are shown the next time you open your inventory.
  • For each build tool: the next time you equip the Hammer, Cultivator and so on, one pop-up such as "Hammer: 40 new build pieces".

Using or placing a station for the first time, or at a new level, also shows one pop-up for that station instead of one per recipe. Discoveries made during normal play keep their usual pop-up.

Shared items that a player's game doesn't have (for example from a mod they don't use) are skipped.

Viewing what the world shares

Server admins can type this in chat while playing:

/ds_listknown

(or ds_listknown in the F5 console). It opens a window with three tabs:

  • Recipes: crafting recipes the shared materials unlock, grouped by crafting station.
  • Build pieces: pieces the shared materials unlock, grouped by tool.
  • Items: the shared items themselves, grouped by type (materials, food, weapons, armor...).

The Items tab shows who discovered each item in a second column. Anything your character hasn't learned yet is shown grayed out, with an "Unknown to you" tooltip on hover, so players who chose manual discoveries can see what the world would teach them. The search box also matches discoverer names.

There is a search box, expandable categories, and Expand All / Collapse All controls. The panel is draggable. Press Esc or the configurable List Known Hotkey (F8 by default; the server may set it for everyone) to close it; the same hotkey opens it. Turn off Restrict List Known Command to Admins on the server to let everyone use it, or turn off List Known Command Enabled to switch it off for everyone.

Installation and configuration

See the FAQ for installation, configuration settings, catching up an existing world, and managing saved discoveries. It is on the mod's Hexium page, and in the faq folder of the download.

Notes and Compatibility

  • Required mods: BepInExPack_Valheim, Jotunn.

  • Multiplayer: install on the server and on every client. Jotunn checks that versions match to the minor version.

  • Player-based raids: on worlds where raids depend on each player's progress, Valheim also looks at the items a player knows. Characters who accept shared discoveries know everything the world has found, so they can get raids that another player unlocked. Characters who decline aren't affected.

  • Known Compatibility: This mod was made to work seamlessly with any other mod's custom discoveries, recipe, item, or other functionality triggered by discovery, however compatibility is not guaranteed. The following have been explicitly tested.

    • Armoire v1.2.3 supported. Its "Appearance Unlocked" pop-ups are grouped with the catch-up summary.
  • Known conflicts:

    • Other discovery-sharing mods: Don't use this together with another mod that shares discoveries or recipes, such as RecipeSync. Both would send the same unlocks.

Credits

  • Mod Icon drawn by hand by Truncated; all rights reserved.
  • Derived from mod released by Lorenzo Baroni as SharedDiscovery. This was made to correct errors and integration with other mods using discovery; All code beyond his I release with an MIT license.
  • Built using ClaudeCode with Jotunn and BepInEx.

Changelog

All notable changes to this mod are listed here. Versions follow Semantic Versioning.

1.0.2 Latest
  • Alignment to best practices from Valheim-Modding at https://github.com/Valheim-Modding/Wiki/wiki/Best-Practices
    • Translation files are now named by language code, such as DiscoverySync-fr.json and DiscoverySync-pt-BR.json, in one Translations folder.
    • Only English and the player's language are loaded. Choosing another language in Settings loads it then. Dedicated servers load none.
    • Changes to the config file now apply without restarting. On the server, changed synced settings are sent to every client.
    • Munin's detailed visit logging now only appears while debug logging is on.
    • Fixed a few spots that could throw an error if a recipe, item or sprite had been removed by the game.
1.0.1
  • Semantic cleanups.
1.0.0
  • New mod ID: the mod's ID is now Truncated.DiscoverySync (was com.Truncated.discoverysync), so its config file is BepInEx\config\Truncated.DiscoverySync.cfg. The new file starts with default settings.
  • Settings reorganized: the config is now split into four sections (Overall, Administration, Server Settings, Client) and every setting has a readable name with spaces, such as "Mod Enabled".
  • New setting: List Known Command Enabled turns /ds_listknown and its hotkey off for everyone, admins included.
  • Admins only by default: Restrict Share Known Items Command to Admins is now on by default, so only admins can run /ds_sharealliknow unless you turn it off.
  • Debug logging: Enable Server Debug Logging now always controls the server's own debug logging. Debug Logging in the Client section only affects clients.
  • The list hotkey settings are now named List Known Hotkey, Server Sets List Known Hotkey and Server List Known Hotkey, to match the /ds_listknown command.

21 older entries, full version history & downloads →

Files

30 files · 214 KB download

Loading files…

FAQ

Configuration

Installation

Troubleshooting

Manual download
Just this mod One .zip — DiscoverySync 1.0.2
Files you'll get 2
  • DiscoverySync 1.0.2 Truncated this mod Get
  • Jotunn 2.30.2 ValheimModding Get

Your browser may ask permission to download several files at once. How to install these manually

Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2360 · View mod page

Check out the mod page for detailed installation instructions.

2

Install DiscoverySync

This mod must be installed on both the client and the server.

Download DiscoverySync 1.0.2

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.