PinAssistant Radius Detection Patch

Introduction

This is a patch to add additional functionality to the PinAssistant mod by WxAaRoNxW.

PinAssistant provides a user interface to select in-game objects to track. When a player directly looks at a tracked object, a pin is automatically applied to the map.

This patch builds on that functionality by adding automatic detection of tracked objects within a configurable radius around the player. When a tracked object is detected within the specified radius, a pin is automatically applied to the map. The patch respects PinAssistant's redundancy distance settings to prevent duplicate pins.

Features

• Automatic pinning of tracked objects within a configurable radius.
• Respects PinAssistant's existing redundancy distance settings.
• Configurable detection radius for flexible tracking.

Fixes

• With this patch installed, PinAssistant will be compatible with PlanBuild -- PlanBuild no longer 'blocks' PinAssistant's UI from activating.
• Modifying the colors of existing pins will now update immeditely when changed via PinAssistant's UI.

Installation

You can install this patch in one of two ways:

Mod Manager (recommended)

• Use r2modman or another Thunderstore-compatible mod manager.
• Search for PinAssistant Radius Detection Patch in the Valheim section and install it.
• Make sure PinAssistant is also installed.

Manual

1. Ensure you have PinAssistant installed.
2. Download this patch from Thunderstore.
3. Place the files in your Valheim BepInEx/plugins folder.
4. Launch Valheim.

Configuration

• RadiusDetectionEnabled: Turns the radius detection functionality on or off. When off, returns to the default behavior of PinAssistant.
• RadiusDetectionInterval: Time (in seconds) between automatic radius detection scans.
• UsePlayerExploreRadius: true/false. Radius detection scans will detect objects within the player's current line-of-sight/map exploration radius. This would be adjusted by certain mods.
• DetectionRadius: If not using the player's current map exploration radius, this sets the radius (in meters) around the player within which tracked objects are automatically detected and pinned.
• RadiusDetectionToggleKey: A keyboard shortcut to enable/disable the radius detection patch for PinAssistant.
• The patch uses PinAssistant's redundancy distance settings to avoid creating duplicate pins.

Acknowledgements

• Original mod by WxAaRoNxW

License

This patch is released under the MIT License. You are free to use, modify, and distribute it in any way, but please retain this notice.

Support / Contact

If you encounter any issues with the Radius Detection Patch for PinAssistant, feel free to reach out to me:

• On Discord: Mervil#2137
• Or ping me in the Valheim Discord server: @Mervil

Please include the version of the patch and PinAssistant you’re using, as well as a short description of the problem — that helps me troubleshoot faster!

Changelog

[Version 1.5.0] - 12-27-2025

Major Improvements

• BlackListing Support - The mod now respects PinAssistant's blacklist words for tracked objects. Objects matching blacklisted words will be filtered out and won't receive pins. When an object's blacklist settings are changed, the mod automatically updates existing pins accordingly.
• Comma-Separated Blacklist Values - Multiple blacklist words can be specified in a single blacklist entry by separating them with commas, making it easier to filter out multiple object variants at once.
• Completely Rewritten Pin Archiving System - The system that saves and restores pins when objects are untracked/tracked has been completely rebuilt for better reliability. Pins are now identified more accurately, especially when multiple tracked objects share the same custom name, eliminating confusion about which pins belong to which tracked object.
• Smarter Pin Restoration - When an object type is re-tracked, archived pins are now restored correctly. The system checks current blacklist and exact match settings to ensure only appropriate pins are restored, and pins won't immediately disappear again after being restored.
• Automatic Re-pinning for Clustered Objects - When a pinned object is destroyed (mined, chopped, etc.) and there are other objects of the same type nearby that weren't pinned due to clustering, the mod will immediately create a pin for one of those nearby objects. This ensures there's always a pin marking objects in a clustered group, even after destroying some of them (as long as one still exists).

Bug Fixes

• Fixed pin restoration issues - Pins that were saved when objects were untracked are now properly restored when those objects are re-tracked. Previously, restored pins could disappear immediately or not restore at all.
• Fixed pins with blank names not cleaning up - Pins with blank or space-only custom names are now properly removed when their objects are destroyed or moved. Previously, these pins could remain on the map even after the objects were gone.
• Fixed ambiguous pin archiving - When archiving pins, the system now correctly identifies which tracked object each pin belongs to, even when custom names are similar or identical. This prevents pins from being archived under the wrong tracked object.

Performance Improvements

• Faster pin processing - Improved the efficiency of pin archiving operations, resulting in better performance when managing many pins at once.

[Version 1.4.0] - 12-13-2025

New Features

• Respects Exact Match Settings - The mod now respects PinAssistant's "ExactMatch" toggle for tracked objects. When disabled, tracked objects will match all objects containing that name (e.g., tracking "Crypt" will also find "Crypt2", "Crypt3", "Crypt4")

Major Improvements

• Enhanced Mobile Object Support - Wagons and ships now have their pins automatically updated as they move, just like animals and other mobile objects
• Location Object Tracking - The mod now properly tracks location-based objects such as crypts, caves, and other dungeon entrances that use LocationProxy components

Bug Fixes

• Fixed damaged resource node pinning - Partially broken resource nodes (partially harvested rocks/ores) are now properly recognized and pinned by PinAssistant

[Version 1.3.0] - 10/19/2025

New Features

• Damaged Resource Node Support - Pins now stay on partially broken rocks and ores instead of disappearing when you start harvesting them

Major Improvements

• No More Manual Pin Interference - The mod now only manages pins it creates automatically, and won't touch or remove any pins placed manually
• Better Multiplayer Experience - Shared pins from other players are completely ignored and won't interfere with automatic pin placement
• Smart Pin Management - When objects are untracked in PinAssistant, their pins are immediately archived and can be restored if retracked during the same play session.

Bug Fixes

• Fixed pins disappearing from damaged resources - Harvesting rocks/ore no longer makes their pins vanish
• Fixed manual pins being removed - Game-placed and manually placed pins are now safe from automatic cleanup
• Fixed multiplayer pin conflicts - Other players' shared pins no longer prevent automatic pins from being created nearby

Technical Notes

• Compatibility Update - Updated to work with the latest version of PinAssistant (requires PinAssistant 1.8.2)

[Version 1.2.0] - 10-05-2025

New Features

• PlanBuild Compatibility Fix - With this patch enabled, PinAssistant UI now works correctly when PlanBuild mod is active

Improvements

• Enhanced Mobile Object Detection - Improved handling of mobile objects, especially flying creatures

Bug Fixes

• Persistence Across Sessions - The patch no longer errors out when logging out of a world and logging back in

Technical Improvements

• Load Order Resilience - With this patch enabled, PinAssistant now works regardless of mod load order with other mods like PlanBuild
• Improved Error Recovery - Better handling of reflection failures and system initialization

[Version 1.1.0] - 09-28-2025

Major Fixes

• Fixed duplicate mobile pins on game reload - Mobile objects (animals) no longer create duplicate pins when the game world is reloaded
• Fixed killed animal pins persisting - Pins for destroyed animals are now properly removed from the map
• Fixed pin flickering during scanning - Eliminated pin removal/recreation cycles that caused visual flickering
• Dynamic exploration radius detection - Now properly reads actual exploration radius from other mods

Performance Improvements

• Improved scanning efficiency - Objects previously marked as "not pinnable" are now properly skipped to reduce redundant processing
• Optimized pin cleanup logic - More efficient removal of destroyed object pins
• Enhanced mobile object tracking - Better position update handling for moving animals

Enhanced Features

• Smart pin correlation system - Existing pins are intelligently matched to detected objects on game reload
• Improved orphan pin cleanup - Better detection and removal of stale pins from previous game sessions
• Real-time pin color updates - Added functionality to PinAssistant so that pin colors now update immediately when changed via PinAssistant's UI

Bug Fixes

• Fixed clustered object pin issues - Clustered objects can now be re-evaluated for pinning when nearby pinned objects are destroyed
• Fixed mobile object position updates - Pins for moving animals now update their map positions correctly
• Fixed pin restoration for re-tracked objects - Pins are properly restored when object types are re-enabled in PinAssistant

Technical Improvements

• Enhanced reflection-based integration - More robust interaction with PinAssistant's internal systems
• Improved error handling - Better debugging information and graceful fallbacks
• Optimized batch processing - More efficient object scanning with better frame rate preservation

[Version 1.0.0] - 09-21-2025

• Uploaded mod patch to Thunderstore