Truncated-DiscoverySync icon

DiscoverySync

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

Last updated a week ago
Total downloads 60
Total rating 0 
Categories Gear Misc Crafting Server-side Client-side Utility AI Generated
Dependency string Truncated-DiscoverySync-1.0.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

ValheimModding-Jotunn-2.30.2 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.30.2
denikson-BepInExPack_Valheim-5.4.2351 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.2351

README

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.