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.
• 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. On each physical dungeon entry, including loading a character already inside, RavenMap takes two matching snapshots of Valheim's exact generator volume and assigns every object to one dungeon. Actual room OBBs protect against overlapping or expanded modded interiors. Zero objects do not block a completed snapshot; one object requires one when its percentage is non-zero; larger percentage requirements are rounded down to whole objects. Respawning CreatureSpawner and SpawnArea components are detected separately from one-shot spawners, and a new live generation replaces the current enemy snapshot. Moving or overlapping enemies remain tied to that snapshot by their live ZDOID. Several players may enter the same dungeon at different times without replacing one another's live kill/open events; simultaneous visits to different dungeons remain isolated by source and exact volume. Opening a natural dungeon chest writes a persistent RavenMap inspection flag because vanilla does not store historical opening of a non-empty chest. Exact automatic progress and its crossed marker survive restart; a later physical entry replaces that saved snapshot before the dungeon is evaluated again. Legacy radius-based automatic data is not trusted, while manual overrides remain persistent.

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

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