HUD Compass

Heads-Up Compass with Dynamic Map Markers for Ships, Carts & Portals

Dude, where's my boat? Never lose track of your boats, carts or portals again. A heads-up compass that includes standard pins and dynamic map markers for ships, carts, active and inactive portals on the compass and the map.

HUD Compass combines and enhances the functionality of Immersive Compass and Automatic Map Markers to bring a complete experience to location aids. (see credits below)

• The scaleable compass appears across the top of your screen.
• Toggle the compass on and off in-game.
• Dynamic pins (ships, carts, portals) are shown on the compass and the map, with or without labels.
• Active and inactive portals can have different colors.
• Portal pins will automatically have the name you give them.
• Ship labels can specify the type of ship (Karve, Longship, Raft)
• Pin types to include/exclude are configurable.
• Pin size is relative to distance with configurable limits.

New

• 1.0.0 Initial release

Configuration

A - HUD Compass

• Show Compass: Show or Hide the HUD compass. Use the Toggle Compass key to change in-game.
• Toggle Compass Key: Key used in-game to toggle the compass visibility.

B - Compass Display

• Use Player Direction: Orient the compass based on the direction the player is facing, rather than the middle of the screen.
• Compass Scale: Sets the overall scale of the compass on the screen
• Offset (Y): Offset from the top of the screen in pixels.
• Distance (Minimum): Minimum distance from pin to show on compass.@
• Distance (Maximum): Maximum distance from pin to show on compass.@
• Show Player Pins: Show player pins on the compass.@
• Pins Scale: Sets the overall scale of the pins on the on the screen
• Minimum Pin Size: Enlarge or shrink the scale of the pins at their furthest visible distance.
• Show Center Mark: (Optional) Show center mark graphic.

C - Ignore

• Pin Names: Ignore location pins with these names (comma separated, no spaces). End a string with asterix @ to denote a prefix.@
• Pin Types: Ignore location pins of these types (comma separated, no spaces). Types include: Icon0,Icon1,Icon2,Icon3,Icon4,Death,Bed,Shout,None,Boss,Player,RandomEvent,Ping,EventArea.@

E - Compass Colors

• Compass Color: (Optional) Adjust the main color of the compass.
• Pin Color: (Optional) Adjust the color of the location pins on the compass.
• Center Mark Color: (Optional) Adjust the color of the center mark graphic.

F - Dynamic Pins

• Show dynamic pins on map: Display pins for ships, carts and portals on the main and minimap. Controlled individually below.@
• Show dynamic pins on compass: Display pins for ships, carts and portals on the compass. Controlled individually below.@
• Player pin refresh pin interval: Interval in seconds between refresh of player pins on map and compass. Decrease for 'smoother' updates of player pins. Zero refreshes every frame. NOTE: Valheim default for Player pin refresh is 2 seconds. Decreasing can reduce multiplayer performance.@

G - Dynamic Types

• Show Ships: Show ships on the map and compass.@
• Show Carts: Show carts on the map and compass.@
• Show Portals: Show portals on the map and compass.@

H - Dynamic Names

• Show dynamic types on minimap: Show boat and cart types (i.e., Raft, Karve, Longship) on the Minimap.
• Show portal names on minimap: Show portal names on the Minimap.

I - Dynamic Map Colors

• Active portal color on map: Color of portal icons with active connections.
• Portal color: Color of portal icons on map.
• Ship color: Color of ship icons on map.
• Cart color: Color of cart icons on map.
• Use colors on compass: Use colors for dynamic pins on the compass

J - Visibility

• Always Visible: Always display pins of these types or names (comma separated, no spaces) at full size regardless of distance.@

Z - Utility

• LogLevel: Controls the level of information contained in the log

Configuration items with descriptions ending with "@" are server authoritative.

In-game reconfiguration

You can use Configuration Manager (or similar) mod to change the configuration without exiting the game. The configuration will reload if you make changes to the config file.

Credits

First and foremost, credit goes to gdragon for convincing me to pick up development of Immersive Compass, and for extensive suggestions, testing and feedback. Without this help I would have only had half the functionality.

HUD Compass incorporates the excellent functionality of Immersive Compass by GuyDeYoYo (aka Fragnarok, with permission), which credits the original code to Aedenthorn.

The dynamic markers extensively uses code from Automatic Map Markers - Ship & Cart from Schlangguru, who I made several attempts to contact for explicit permissions but the mod is not maintained.

I will remove this mod if either author objects. Use of the code is within the license requirements of the above mods and is included in the distribution.

Compatibility issues & defects

• If you find a compatibility issue you can post it on NexusMods. Be sure to include the mod name and version you think may be incompatible.
• If you have a bug please report it on NexusMods. If you do post a bug report, please make sure to include the following:
  • Your version of this mod
  • What you were doing, or attempting to do when it happened
  • If it's repeatable - i.e., can you duplicate it?
  • The exact behavior you observed (or didn't observe)
  • If possible, post a capture of the log file with errors (errors always begin with this mod's name) on Discord

You can find all Neobotics released mods on:

• Thunderstore: https://tinyurl.com/NeoboticsOnThunderstore
• Nexus Mods: https://tinyurl.com/NeoboticsOnNexus

Your comments and feedback are always welcome. Post on NexusMods or Discord: https://discord.gg/hRfqDapR

Changelog

1.0.12

• Added beginning of string wildcard match for pin names to support AutoMapPins pin names with "counts", e.g. "*Raspberry" matches "5 Raspberry"
• Fixed issue with wildcard at end of string
• Added missing "Hammer" alias for excluding pin types
• Fixed colors on compass pins for 'other' player pins

1.0.11

• Fixed rare issue showing/hiding compass

1.0.10

• Fixed compass position issue reported by some users

1.0.9

• Added stone portal

1.0.8

• Performance tweak

1.0.7

• Changed dynamic pin names map configuration and fixed issue with viewing dynamic pin names. See Documentation.

1.0.6

• Fixed overwriting custom images

1.0.5

• Moved external images to mod root folder for compatibility with R2Modman installation
• Added configuration to use embedded (default) or external images

1.0.4

• Added ability to show/hide player pins in configuration for NoMap play
• Added server config to force player pins on, off, or let the player decide
• Changed to use images in Resources folder to allow custom compass images

1.0.3

• Fixed rare issue with dynamic pins on minimap.
• Fixed show/hide compass being overridden by server setting
• Added separate server authoritative HUD enable/disable

1.0.2

• Fixed player loading issue on some systems.

1.0.1

• Added support for custom ships & carts
• Fixed dynamic pin colors changing when faded (another player's markers)
• Fixed newly created object's pin displaying as another player's marker (i.e. faded and wrong color)

1.0.0

• Initial release