MapPinDeclutter
Declutters the world map by hiding pin names in clustered areas and scaling down pin icons as you zoom out.
About this mod Author’s original text
MapPinDeclutter
This Valheim mod declutters the world map by hiding pin names in clustered areas and scaling down pin icons as you zoom out.
Version 0.2.2 tested working with Valheim 1.0, 0.2.3 is built against BepInEx 5.4.2350 and Jotunn 2.30.0.
Configuration
This mod uses BepInEx configuration that can be changed via its configuration file or in-game via ConfigurationManager. The following settings are currently provided:
Hiding names
- HideNamesEnabled (default: true): enable hiding of pin names on the map. When enabled, pin names will be hidden based on zoom level or proximity to other pins
- HideNamesThreshold (default: 0.02): the map zoom level above which pin names are hidden. Higher values mean names are hidden at a greater zoom-out distance. Ranges from 0.015 to 1.0
- HideNamesByDistanceEnabled (default: true): when enabled, pin names are hidden only for pins that are crowded together, rather than hiding all names at once. Requires HideNamesEnabled to be enabled
- HideNamesByDistanceThreshold (default: 1000): the world-unit radius used to detect crowded pins. A pin's name will be hidden if any other pin falls within this distance, scaled to the current zoom level. Increase to hide names in more sparse areas. Ranges from 100 to 3000
Zooming icons
- ZoomIconsEnabled (default: true): enable scaling down of pin icons when zooming out. When enabled, icons will shrink as the map is zoomed out to reduce visual clutter
- ZoomIconsThreshold (default: 0.3): the map zoom level at which pin icons begin to shrink. Above this threshold, icons scale down proportionally until they reach ZoomIconsMinimumSize. Ranges from 0.015 to 1.0
- ZoomIconsMinimumSize (default: 0.3): the smallest size pin icons can be scaled to when zooming out, as a fraction of their original size (e.g. 0.3 = 30% of full size). Prevents icons from becoming too small to see. Ranges from 0.1 to 1.0
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: