PinGPS-Ymiron

Turn any map pin into a GPS waypoint. Open the map, hold Ctrl and left-click a pin: from then on the pin's icon floats on screen over the real spot in the world, with its name and the distance, while you travel.

        [icon]
      Troll cave
        245 m

• When the destination is out of view (to the side or behind you), the icon sticks to the edge of the screen with an arrow pointing towards it: just turn until it comes back into view.
• Far away the icon sits on the horizon; once the terrain around the destination is loaded it floats a few meters above the ground at the exact spot.
• The active pin pulses on the map and minimap.
• When you get there (10 m by default) the GPS turns itself off with a sound and a "You have reached your destination" message.
• Ctrl + click the same pin again to turn the GPS off; Ctrl + click another pin to switch destination. Deleting the pin (right click) also turns it off.
• The destination is remembered per character and per world: log out and back in, and the GPS is still on.

Works with every saved pin: your own markers, boss pins from Vegvisirs, tombstones, Hildir's pins...

Configuration

File BepInEx\config\ymiron.valheim.pingps.cfg:

Section	Key	Default	What it does
1 - Controls	SelectModifier	LeftControl	Key to hold while left-clicking a pin on the map.
1 - Controls	TurnOffKey	(none)	Optional key that turns the GPS off without opening the map.
2 - Display	IconSize	40	Size of the on-screen icon (pixels at 1080p, scales with resolution).
2 - Display	ShowName	true	Show the pin name under the icon.
2 - Display	ShowDistance	true	Show the distance under the icon.
2 - Display	TextColor	#FFD966	Color of the text and of the edge arrow.
2 - Display	ShowEdgeArrow	true	Arrow next to the icon when it is stuck to the screen edge.
2 - Display	EdgeMargin	70	Distance kept from the screen edges (pixels at 1080p).
2 - Display	HeightAboveGround	4	Meters above the ground when the destination is close.
2 - Display	PulseOnMap	true	Make the active pin pulse on the map.
3 - Arrival	ArrivalDistance	10	Meters from the pin that count as "arrived".
3 - Arrival	TurnOffOnArrival	true	Turn the GPS off on arrival (otherwise the marker is only hidden).
3 - Arrival	SetSound	sfx_gui_select	Vanilla sound when setting / turning off. Empty = silent.
3 - Arrival	ArrivalSound	sfx_gui_biomefound	Vanilla sound on arrival. Empty = silent.
4 - Messages	DestinationSet, GpsOff, Arrived	English	Texts of the messages (translate them if you like).

The file can be edited while the game is running: the mod reloads it on save. It also works from the Configuration Manager (F1), if installed.

Notes

• The marker is hidden while the map, the inventory, the menu or any text box is open, and when the HUD is hidden.
• Selecting a pin needs mouse and keyboard (Ctrl + click); with a gamepad the GPS still shows, but cannot be set.
• Client side only: the mod applies to whoever installs it. It is not needed on the server.

Installation

• Mod manager (r2modman / Thunderstore Mod Manager): Settings > Import local mod and pick the zip.
• Manual: copy PinGPS.dll into BepInEx\plugins.

Requires BepInExPack_Valheim.