OneMapToRuleThemAll

Important! V2 is a design refactor with only a partial migration path. I recommend only installing for new worlds but migration info is provided at the bottom of this README.

Most Important! V2.2.0 was a necessary design refactor for pin identity and it will turn all your existing auto pins into the default dot...but they won't be deleted. There is no way to avoid this. Additionally all abbreviations for new pins and radar now default to the in-game display name. You can modify the catalog file as needed or use the om_setabbr command (ex. "om_setabbr Raspberry RB") to change these to whatever you want them to be.

Make a copy of all config files and the config\OneMapToRuleThemAll folder and save them outside of your game directory before installing.

Additional flexibility options were implemented to help reduce map clutter. Optionally, the catalog also now exposes other prefabs players may want to make visible (like Wood Houses, Black Forest Towers etc.). They are commented out by default. I also added functionality to produce and utilize an icon for modded items that don't have one. To get the most out of the new features I suggest deleting the drummercraig.one_map_to_rule_them_all.cfg file along with the BepInEx/config/OneMapToRuleThemAll folder. This will reset all options and install the latest catalogs but lose your previous work.

V2.2.0 - Some of the features and settings:

• Pin Identity Refactor Pin identity was completely redesigned.
• PinLabelPreserveCase ([Client], default on) — pin labels display in mixed case (e.g. ObsidianDeposit) instead of Valheim's default all-caps.
• Pin abbreviations Have now defaulted to the object's display name with spaces removed (e.g. Copper Vein → CopperVein).
• Vanilla Hide-If-Icon Four new toggles — auto-pin and radar text/count ([Client]) — now default on, so recognizeable Vanilla objects with sprites get their text and counts hidden while still showing modded items text/counts. This helps reduce map clutter.
• PinDensity ([Server._Global]) now defaults to FewestPins (most merging, least map clutter).
• RadarPinText ([Client]) now defaults on.
• Fresh installs now ship a curated default catalog (vanilla objects pre-named, categorized, and biome-sorted) instead of generating one from keyword guesses on first run.

V2.0.0 - Some of the features and settings: -- Overhaul of the object universe, where vanilla and additional mod objects live in their own catalog files, giving you complete customization of visiblity, naming, abbreviations and icons for prefabs. -- Improved (and consolidated) Configuration Manager section -- Enforce player visibility option -- Prevention pins that keep auto pins and radar clear around your base -- Admins can right-click auto pins on the map to delete (command not necessary) -- Improved flexibility and options with om_ commands for managing pins

This mod was developed for my own use but I figured why not share it for others interested. I want to thank all who enjoy using it and especially those who have provided feedback, requests and identified bugs to resolve.

It comes with no support or guarantees.

For Players

Main Features. OneMapToRuleThemAll provides 3 main features, all optional.

Shared map. Everyone on a server shares one map. Fog-of-war is merged in real time so all players experience the same uncovered map areas. Player-placed pins are synced too, so the whole server sees the same markers.

Automatic pins. Walk within range of a tracked object (ore, pickable, location) and a permanent shared pin is placed for everyone. Pins use short labels (e.g. Cu, Rb) and add a count when several of the same type cluster together (e.g. Cu 3).

Radar. Nearby objects and creatures show as temporary pins that fade as you move away, with creatures tracked live. Radar is client only, never sent to anyone else. Nearby objects of the same type within a defined radius merge into a single counted pin.

Prevention pins — @ (optional). Name any map pin starting with @ (e.g. @Home) to keep a base quiet: within a set radius of an @ pin, auto-discovery and radar pins are suppressed for everyone, so farms and bases stay uncluttered. Non-admins may keep one @ pin per biome — naming a new one demotes the old (its @ is stripped). Admins and the host are unlimited.

Your personal options

Open ConfigManager in-game (default F1) to customize options in your own map.

• Show/hide other players pins.
• Auto pins: item-sprite icon vs. plain pin, and label on/off. When a pin shows a real item sprite you can also hide the abbreviation, the count, or both — so a recognisable icon does not need text beside it. Pins with no sprite keep their full label so they never become anonymous dots.
• Radar: label on/off, and the cluster radius that merges nearby pins into one count (0 = no merging). As with auto pins, when a radar pin shows a real item sprite you can hide the abbreviation, the count, or both.
• Per-keyword visibility: toggle any tracked object on or off. Hiding something only affects your map — it stays on the server for everyone else.

For Server Admins (and Solo Players)

What gets tracked. The trackable object universe is now implemented using catalog.txt files inside the BepInEx/config/OneMapToRuleThemAll subfolder. Files are automatically generated, one for vanilla, named OneMapToRuleThemAll.catalog.txt and one for each mod installed that contains trackable objects, an example being RtDMythics.catalog.txt for RTDMythics mod. Once generated these files are not touched by the mod again unless the file is completely deleted. Each row is Biome | Type | Keyword | Display | Abbr | Icon. Edit, comment out or delete rows to change what is tracked, then run om_reloadcatalog to apply live and re-push to clients. You have full control over what objects are available to track through these files.You can also just disable the object in configuration manager. While connected to a server, clients display the server's catalogs; when solo, they revert to their own local catalog files.

All feature switches and detection ranges are server-authoritative: the server pushes its configuration to each client on connect, so everyone plays by the server's rules. Settings live in the combined drummercraig.one_map_to_rule_them_all.cfg under [Server.*] and can be edited live (no restart).

Master switches & global ranges ([Server._Global] / [Server._Radius]):

• Feature masters: Shared Map, Auto-Pin (discovery), Radar, Force Player Visibility, and the @-prevention toggles — all default on.
• Simplified one detection radius per type (applied in every biome): pickable/ore/location discovery and radar ranges, creature radar range, and the two prevention radii (default 50 m). Auto-pin clustering is now a single global multiplier.
• ResetToDefaults resets every server setting and clears itself.

Console commands. Run in the in-game console. Pin/catalog changes are server-authoritative (must be a server admin; on a dedicated server they forward to the server automatically). The inspect/scan/export commands are local diagnostics.

• om_clearpins all | type <name> | abbr <abbr> [radius] — removes auto pins only (never player pins); optional radius limits to your vicinity. Ex. "om_clearpins type obsidian 75" clears all Obsidian pins within 75m of your location.
• om_reloadcatalog — reload catalog files, relabel pins, and push to all clients.
• om_scanmods — re-scan loaded mods for trackable prefabs and refresh the catalog (a newly installed mod needs a game restart first to load its DLL).
• om_setabbr <display|keyword> <abbr> — set an object's pin abbreviation and push it live.
• om_seticon <display|keyword> <itemId> — set an object's pin icon (ObjectDB item id; none clears).
• om_refreshicons — re-apply discovery pin icons if they get out of sync.
• om_pincounts — breakdown of auto-discovery pin counts by abbreviation.
• om_checkduplicatepins — report duplicate auto-pins without removing them.
• om_removeduplicatepins — remove duplicate auto-pins (keeps one per cluster) and report what was removed.
• om_inspect [radius] — print the prefab name and components of the object under your crosshair (or nearby within radius) and how the mod classifies it. Use it to find the keyword for something you want to track.
• om_exportcatalog — dump every trackable prefab to prefab_index.txt for catalog curation.

A huge thanks to Mydayyy and their excellent mod, ServerSideMap, and to Kitz_Bitz and their mod UnderTheRadar. Their excellent work and permission to utilize their code for reference helped the development of this mod.

Migration information from V1.2.14 Handled automatically on first 2.0 launch

*.customprefabs.txt → <Mod>.catalog.txt — each legacy per-mod file is converted (enabled entries only) to the new catalog format; the original is renamed *.customprefabs.txt.migrated.bak and never re-read (ConfigMigration.MigrateCustomPrefabsToCatalog).

Server radius 1. CritterRadar → 1. CreatureRadar — a customized legacy value is carried over once (ServerGlobalConfig.MigrateLegacyCreatureRadar).

Catalog Critter type token → Creature — the parser still accepts the legacy Critter token; a lower on-disk catalog schema version triggers a backup + clean regenerate (ObjectCatalog.cs:56-58).

Combined-config / Client.* prefixing (ConfigMigration.MigrateIfNeeded) — already satisfied by 1.2.14, so it's effectively a no-op for you.

Not carried over — expect to reconfigure these

creatures.txt customizations. The file is retired; creature definitions are now seeded into the catalog. An existing creatures.txt is moved to the subfolder but then ignored — any custom creature edits there are not imported. Re-do them as Creature rows in the catalog.

Per-biome server radii and tracked-keyword lists. 1.2.14's [Server.Pickables.<Biome>] / [Server.Ores] / [Server.Locations] sections (per-biome DiscoveryRadius/RadarRadius, TrackedDiscovery/TrackedRadar) are replaced by global [Server._Global] / [Server._Radius] (one radius per type) plus the catalog. Only CritterRadar migrates — other customized radii and tracked-keyword edits are not converted; they revert to the new global defaults and the old sections are orphaned. Re-apply radii as global values and tracking via catalog rows/toggles.

v2.3.0 - Pin Identification Refactor

• Copy cfg and OneMapToRuleThemAll folder to location outside game directory
• Numerous Map declutter features
• Automatic image generator for target modded items without a sprite
• Bug Fixes

v2.0.3

• Previous stutter fix didn't make it in the build
• Relaxed restriction so client can run mod on a server without the mod or Vanilla. Shared Map is automatically disabled. Auto Pin and Radar are available

v2.0.2

• Fixed a regression potentially causing stutter with large object counts
• Changed 'Incompatible Version' to a more helpful message

v2.0.0 - Refactor

• Complete redesign of object universe
• Several new features and enhanced console commands
• Bug fixes

v1.2.14 - Bug Fixes

• Fixed Fish not receiving trackers: all credit to BROHEIM_CYBRP. https://thunderstore.io/c/valheim/p/BROHEIM_CYBRP/
• Fixed Beehive not displaying on radar. Add Beehive to the server location comma delimited lists and enable in the desired client locations (discovery and/or radar).

v1.2.10 - Bug Fix

• Fixed Fog Of War not updating properly on clients.

v1.2.8 - Performance and Bug Fixes

• Fixed a large duplicate pin bug (thank you roggz)...auto deduplicates existing explore files.
• Chunked initial message where enough pins would kick clients trying to connect.
• Added Server.Map option to disable Map sharing (requested).
• Numerous performance improvements.

v1.2.2 - Bug Fix

• Fixed duplicate pins being placed in some clusters.

v1.2.1 - Performance Tuning

• Additional performance tuning and options, not that it needed any but just to minimize FPS impact.

v1.2.0 - Radar & Map Improvements

• Fixed ghost pin text labels remaining on other clients after a pin is removed
• Critter radar pins now track and follow creature movement
• Added client-side critter cluster radius setting (0 = one pin per critter)
• Changing radar cluster settings now takes effect immediately without reconnecting
• Custom prefab files and creatures.txt moved to BepInEx/config/OneMapToRuleThemAll/ subfolder (auto-migrated)
• Fixed vanilla Valheim prefabs being incorrectly detected as mod prefabs

v1.1.0 - Various Updates

• Numerous optimizations and performance improvements with large pin count
• Bug fixes
• Configs consolidated into one config
• BETA feature for implementing other mod prefabs

v1.0.3 - Added Discord Link

v1.0.2 - Added CHANGELOG.md

• Second attempt at adding a CHANGELOG.md file

v1.0.1 - Bug Fixes

• Fixed an issue with save path on dedicated servers vs steam virtual path
• .explored file was not being created