RavenMap

A lightweight shared map for Valheim with useful automatic pins and local filters for every player.

RavenMap is currently in beta testing, so errors may still occur.

Install

RavenMap must be installed on the server and every client.

1. Install BepInExPack Valheim 5.4.2333.
2. Create BepInEx/plugins/RavenMap and extract all five archive files into it.
3. Start the game once to create BepInEx/config/dragonmotion.ravenmap.cfg.

RavenMap is not compatible with other shared-map or automatic-pin mods, including Huginn Map and One Map To Rule Them All.

Features

• Shared normal fog of war and automatic pins.
• Unified colorful map icons with dark outlines for vanilla markers, Valheim locations, RavenMap pins, and supported More World Locations traders and ports. Six local size controls match the six filter groups: Valheim, deposits, pickables, dungeons, other RavenMap marks, and supported world locations.
• Real mineable resource detection for vanilla, Balrond Amazing Nature, and compatible modded deposits.
• Ancient Roots are tracked as renewable Mistlands resources with their own map icon and highlight; temporary sap depletion never removes their pin.
• Separate pins and biome filters for wild berries, mushrooms, herbs, and plants. Renewable sources are crossed after harvest and restored by the game's real respawn event; one-shot or physically destroyed sources are removed.
• Vanilla and supported modded dungeon pins, automatic cleared crosses, and a shared manual override (Left Alt + left-click; change ManualToggleModifier).
• Configurable removal of depleted resource pins.
• Named portals, ships, and carts.
• Duplicate protection for RavenMap, vanilla, and cartography-table pins.
• Optional Upgrade World integration prevents zones_generate from discovering or revealing any unvisited automatic pins, removes every RavenMap automatic source from successfully reset zones, and cleans stale location pins. It activates only when the upgrade_world plugin GUID is present.
• Removed content mods no longer leave ghost pins or raw localization tags. The server safely retires exact missing sources, while clients with different mod lists hide unsupported shared pins locally.
• Draggable and scrollable local filters, saved separately for each player and world.
• Russian or English UI, matching the game's language.

Highlights and X-ray

Pulse smoothly highlights a complete vein. Sweep sends a soft scanning wave that enters before one mesh edge and leaves beyond the other. Pulse and Sweep have separate color, intensity, interval, and timing settings; Sweep also has configurable speed, width, and softness.

HighlightPickables optionally applies the selected Pulse or Sweep to nearby available berries, mushrooms, and plants. It respects cutout and transparent foliage, handles nearby groups fairly, and uses the same controls as ore. The setting is local and disabled by default.

XrayEnabled is the local master switch and is disabled by default. While it is enabled, F4 only shows or hides X-ray temporarily and does not change the config. Change or disable the key with XrayToggleKey. X-ray reveals only already discovered, loaded veins inside its radius.

Reset and diagnostics

The host or a server administrator can remove shared automatic pins for rediscovery with:

ravenmap resetpins confirm

This keeps shared fog, vanilla pins, and character map data. If a resource or dungeon state looks wrong, enable ShowStateOnMap in [10 - Diagnostics]. While that setting is enabled, dungeon diagnostics include a bounded trace# chain and write the same lifecycle steps as [DungeonTrace] entries in Player.log; turning it off immediately stops both. DetailedLogging controls other classification, deduplication, and network details, but does not enable the dungeon lifecycle trace.

Only loaded objects can be discovered or updated. The first stable visit records the enemy and chest baseline for that generated dungeon or cave. It remains fixed across exits, restarts, and different players; only a real full dungeon regeneration replaces it. RavenMap observes Valheim's generator epoch, CLLC regeneration data when present, and the saved room layout as a fallback. Actual room OBBs protect against overlapping or expanded modded interiors. Moving or overlapping enemies remain tied to the baseline by their live ZDOID. Creature respawn is separate from dungeon regeneration: an unfinished dungeon keeps its original denominator, while an already cleared respawn-capable dungeon may reopen for a new enemy wave according to the server settings. Opening a natural dungeon chest writes a persistent RavenMap inspection flag because vanilla does not store historical opening of a non-empty chest. Legacy radius-based automatic data is not trusted, while manual overrides remain persistent until the dungeon regenerates.

Visual effects use the bundled Windows shader; if it is unavailable, map features continue without them.

RavenMap 1.9.15 targets Valheim 0.221.12, Steam build 21981559, Unity 6000.0.61f1, and BepInEx 5.4.23.3.