WxAaRoNxW-PinAssistant icon


An assistant to pin the objects you'd like to see on the map either quickly or automatically'

Last updated 5 days ago
Total downloads 255
Total rating 2 
Categories Utility Hildir's Request Update Tools Client-side
Dependency string WxAaRoNxW-PinAssistant-1.0.1
Dependants 1 other mod depends on this mod

This mod requires the following mods to function

Tekla-JsonDotNet-13.0.1 icon

Redistribution of Json.Net from Newtonsoft under MIT license.

Preferred version: 13.0.1
denikson-BepInExPack_Valheim-5.4.2105 icon

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2105
ValheimModding-Jotunn-2.12.6 icon

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.12.6



Mod Preview

Mod Introduction

Tired of having to manually pin objects and would rather just want to solve it with a click of a button? Maybe you'd rather automaticaly pin the objects you look at. You found an object of interest and you plan to retrieve it later, but got lazy pinning them and lost them? Need a Dandelion or Thistle for your brews but became unfindable cause you're now searching for it? Perhaps you forgot where you mined that chunk of copper and you can't find it anymore cause it blends in with the environment.

Pin Assistant is the game-changing mod you've been waiting for. It's the ultimate solution for all adventurers, explorers, crafters, gatherers, and farmers who want to stay organized without the hassle of manual object pinning.

Ensuring you stay focused on what matters most to you. Whether it's rare herbs for your magical brews or valuable resources for crafting, your Pin Assistant will do the tracking for you.

User Friendly Design

Tailored to both casual and technical players who wants to modify their pins to exactly do what you want. Not sure what to do? just look at an object press Y and it will automatically fill the values for you, then click Track.

Customizable Pinning

Tailor your Pin Assistant to your specific needs. Customize the entry to how you want the pin to appear, a boss icon? a fire? is the pin crossed off? To easily determine which is which so you won't have a hard time figuring out what pin are you exactly looking at.

Customizable Behavior

Customise your entries to choose what it wants. Only search a specific object, pin multiple objects on just one entry, delete on pins associated with entry on log out, and many more! Many configuration combinations for you to think about!



A Valheim style UI for you to easily manage your tracked objects


Auto Pinning

Too lazy to create pins by yourself? No problem! Just create an entry for an object and this mod will do everything for you.

Manual Mode/Fast Pin

Don't like the auto pin feature? That's ok! You can disable it and use the 'Pin Object' keybind. Although, be sure to track the object first before you can use the pin key!

ID Filter

You can also set the entry to only find objects that are named exactly to what you've set, this means you'll be able to choose which specific type of object variation you want to be pinned, Crypt1? Crypt2? or if you want all the variations, just set the ID to Crypt.



However this means Sunken Crypts would also be included in the detection, that's where the Blacklist feature is needed. Add 'sunken' to the entry with crypt ID, and this would only allow non-Sunken Crypts to be pinned on that entry.


Redundancy Feature

If you think your pin might clutter cause the objects are grouped together, you can change the redundancy setting to avoid pinning similar objects at a certain distance based on the pinned object.


Shareable Entries!

If you have Configuration Manager Installed you can open up the menu, copy the very last field in this mod's section and send that entire text to your friend and press the reload key. Both you and your friend has the same entries you have!. Although, it won't copy the pins you've already made.

Lightweight Plugin

Efficient auto pin and tracking system Even though you might think that this is a pretty heavy system with the complex logic it has. It wouldn't, except for Valheim's pin system, that's not on me anymore. If you worry about performance you can increase the tick rate in the settings. Default is every second, Pin Assistant will detect what you're looking at.

Technical stuff: Most of the system uses dictionaries especially the tracked entry system which uses TrieNode Dictionary, which means it won't harm the performance when the mod has an object that needs to be ran through the list of entries to check, (imagine those auto complete systems in searching on your computer)

I recommend using Pinnacle by ComfyMods

You can check it out here


How to use

Let's say you want to track Copper deposits,

  • press the GUI key, (default: Ctrl + T) while looking to prefill the proper values,

  • Copper deposits' ID is called MineRock_Copper(Clone),

  • you can just leave it as is and press Track or if you want to track all mineable objects,

  • set the ID to MineRock to track Tin, Meteorite, Iron, Obsidian, and Stone, but you don't want to include stone, no problem!

  • go to the Blacklist field and type 'stone', with this, objects that has the name MineRock will be pinned but if it has Stone in their name, it will be excluded.

  • if you want the naming conventions for all those objects to not be the same name, then you have to have a different entry for each of them, but if you're too lazy, just wait for the object you want to appear, press the GUI Key while looking at it and press track or enter!

Installation (manual)

Same as any other mods I assume, extract contents to Bepinex's Plugins folder

Dev Introduction

My first ever game mod that involves coding, I made this mod as an automatic pinning feature like Locator, but after at the release, I thought, "hey this plugin doesn't seem like Auto Pin is the only main feature. Because you can also use the Tracked Object as an object configuration to pin objects easily by pressing a keybind without having to change the icon and naming it and such, so I named it from Auto Pin to Pin Assistant just before release.

I've learned quite a lot with modding valheim and got a lot of experience from using certain libraries and such. A very fruitful journey to program this mod, I hope you enjoy! I started working on this around September 2 midnight, so this mod took around 2 and a half weeks with some days taking a break cause I got lazy trying to understand new apis to make my mod work cough gui sucks cough.

I made this mod due to auto pin mods like HotPin or Locator having troubles with their plugin, Locator had a problem with their console commands and HotPin just won't let you open the console. I found Locator from Purps to be pretty good, but it wasn't that user friendly with tracking custom objects, it lacked a few features but was really decent, so I thought about my own ideas.

If not for the many source codes out there like Locator, Pinnacle, PressurePlate and other plugins, I would have had a hard time making this as it referenced a lot of valheim codes from them Locator mostly, but the logics like dictionary is mostly from Google :v

Also, thank you to the mod developers who helped me setup to start on this project or gave me info with things i had trouble with.


Have a suggestion?

You can contact me on Discord, 'WxAaRoNxW', make a post on Nexus or add a 'New Issue' on Github.


v1.0.0 - Initial release

Known issues

  • you tell me!

If you have a problem you can find the github here and add an issue

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2023-9-20 1.0.1 215 Version 1.0.1 Install
2023-9-19 1.0.0 40 Version 1.0.0 Install