Pin It! - Automatic Map Pins

Automatically pins forageables when you harvest them, and dungeons, caves, ore deposits and points of interest when you come near them, using the game's own item and trophy icons.

Changes (v1.12.2)

• Added sound effects upon discovery (off by default, customizable sound)
• Added a visual effect when discovering a pin
• Added support for selecting icons from the build menu so you can add your portals and other structures to the map automatically (would not recommend adding boats) Add the following to your config under extras to do that (remove quotes): ";=portal_stone:Stone Portal:portal_stone;=portal_wood:Portal:portal_wood"
• Fixed some reported performance issues (if you have 1000+ pins it will lag regardless of this mod installed, so delete pins you don't need like tin)

Features (v1.10.0)

• Pins forageables used in cooking and consumables when you pick them, one pin per cluster (default 8 m) with a count such as 4x.
• Pins dungeons and caves, ore deposits and extras (camps, towers, spawners, etc.) when you come within range.
• Every pin uses the item's inventory icon or a matching trophy icon. No image files are included.
• Ore pins show only the count (1x, 3x) by default, like forageables. Deposits within 20 m share one pin.
• Silver is buried, so by default it's only pinned after you hit the deposit with a pickaxe.
• Pin It! labels only appear while your mouse is over the pin on the large map (can be turned off), and their text size can be changed.
• Every item has its own settings: Pin (stop pinning it), Visible (hide all its pins) and Delete all pins (bulk clean-up).
• A Toggle pin visibility checkbox on the large map hides every pin except boss pins and the spawn point.
• Each category can be hidden or made see-through.
• Client-side only. Works in single-player and on servers, and doesn't need to be installed on the server.

Forageables pinned by default: Raspberries, Blueberries, Cloudberries, Lingonberries, Mushrooms, Magecap, Jotun Puffs, Smoke Puffs, Thistle, Dandelion, Fiddlehead.

Never pinned by default: Wood, Stone, Flint, Flax, Barley, Carrots, Turnips, Onions, Vineberries, Yellow Mushrooms, Blue Mushrooms (don't spawn naturally), Royal Jelly, and all seeds. Muddy scrap piles are never pinned.

Ores pinned by default: Copper, Tin, Silver, Soft Tissue, Flametal.

Dungeons and caves pinned by default:

Pin name	Icon
Burial Chambers	Skeleton Trophy
Sunken Crypt	Draugr Trophy
Troll Cave	Troll Trophy
Bear Cave	Bear Trophy
Frost Cave	Cultist Trophy
Infested Mine	Seeker Trophy
Infested Citadel	Seeker Soldier Trophy
Putrid Hole	Morgen Trophy
Winding Tunnels	Elaking Trophy
Mörkhalla	Jotun Witch Trophy
Smouldering Tomb	Skeleton Trophy
Howling Cavern	Cultist Trophy

Extras pinned by default:

Pin name	Game name	Icon	Default range
Fuling Camp	GoblinCamp1/2	Fuling Trophy	100 m
Black Tower	Hildir_plainsfortress	Fuling Berserker Trophy	150 m
Charred Fortress	CharredFortress	Charred Warrior Trophy	150 m
Greydwarf Spawner	Spawner_GreydwarfNest	Greydwarf Trophy	80 m
Moder Egg	DrakeNest01	Dragon Egg	40 m
Tar Pit	TarPit1/2/3	Tar	80 m
Dvergr Camp	Mistlands_Excavation1/2/3	Dvergr Trophy	100 m
Dvergr Tower	Mistlands_GuardTower1/2/3	Dvergr Trophy	100 m
Dvergr Lighthouse	Mistlands_Lighthouse1	Dvergr Trophy	150 m
Dvergr Dock	Mistlands_Harbour1	Dvergr Trophy	100 m
Leviathan	Leviathan	Chitin	100 m
Surtling Spawner	FireHole	Surtling Core	80 m
Charred Spawner	Spawner_CharredStone, Spawner_CharredCross	Charred Skull	80 m

Requirements

• BepInExPack for Valheim

Install

1. Install BepInExPack for Valheim.
2. Copy PinIt.dll to Valheim\BepInEx\plugins\PinIt\.
3. Start the game.

Configuration

The config file (BepInEx\config\pinit.automaticmappins.cfg) is created after the first launch.

Per-item settings

Every item in the lists gets three settings, in [1b - Forageable Items], [3b - Dungeon Items], [4b - Ore Items] and [5b - Extra Items]:

Setting	Default	Description
<Item> - Pin	true	Untick to stop new pins for this item
<Item> - Visible	true	Untick to make all of this item's pins invisible. Hidden pins can't be clicked, crossed out or removed
<Item> - Delete all pins	false	WARNING: Tick to permanently delete every pin of this item for the current character and world. Can't be undone. Unticks itself

Items you add to the text lists get these settings automatically.

General settings

Setting	Default	Description
Map: ShowPins	true	Shows or hides all map pins (same as the map toggle)
Map: ShowForageablePins / ShowDungeonPins / ShowOrePins / ShowExtraPins	true	Shows or hides each category
Map: ForageablePinOpacity / DungeonPinOpacity / OrePinOpacity / ExtraPinOpacity	1	Opacity of each category, 0.1 to 1
Map: LabelsOnHoverOnly	true	Pin It! labels only show while the mouse is over the pin
Map: LabelTextScale	1	Size of Pin It! label text, 0.5 to 3
Map: ShowMapToggle	true	Adds the toggle to the large map
Map: ToggleText	Toggle pin visibility	Text next to the toggle
Map: ToggleOffsetX / ToggleOffsetUp	0 / 20	Moves the toggle, in pixels
Enabled	true	Turns forageable pins on or off
AllowedItems	(list above)	Item prefab names to pin, separated by commas
ClusterRadius	8	Forageable cluster range in metres
IgnoreCultivatedGround	true	Skips player-planted forageables
UseItemIcons	true	Shows item icons on pins
PinIcon	Icon3	Fallback marker, and the map's pin filter
Dungeons: Enabled / PinRange / DungeonTypes / UseIcons / PinIcon / RepinDeleted		Dungeon and cave settings
Ores: Enabled / PinRange / ClusterRadius / SilverRequiresPickaxeHit / ShowOreName / OreTypes / UseIcons / PinIcon / RepinDeleted		Ore settings. ShowOreName adds the ore name to labels
Extras: Enabled / PinRange / ExtraTypes / UseIcons / PinIcon / RepinDeleted		Extra settings
Extra Ranges: (one per extra)	(table above)	Range in metres for each extra
DebugLogging	false	Logs harvested item names, nearby locations and objects you hit

Pin data

Valheim saves the pins in your character's map as normal. Pin It! also keeps a small file recording which item each of its pins is for: BepInEx\config\PinIt\<Character>_<World>.pins

If you uninstall the mod, your pins stay on the map with the standard marker.