Pinnacle

Pinnacle perpetually provides premium pin performance.

New Features

Quick Map Pins

• When the Minimap is open you can now use a keyboard-shortcut to create a pin at your current position.
• See the QuickMapPin config-options to set the shortcut and default pin-name and pin-type.

Command: add-map-pin

add-map-pin [--position=<x,y,z>] [--pin-name=<string>] [--pin-type=<pin-type>] [--log]
add-map-pin [--pos=<x,y,z>] [--name=<string>] [--type=<pin-type>] [--log]

<pin-type> must be one of the following values:

  Icon0    None      Shout          Hildir1
  Icon1    Death     Ping           Hildir2
  Icon2    Bed       RandomEvent    Hildir3
  Icon3    Player    EventArea
  Icon4    Boss

• Adds a new Minimap pin using the specified position, pin-name and pin-type.
• If --position is not specified, position will be set to your current player position.
• If --pin-name is not specified, pin-name will be set to empty.
• If --pin-type is not specified, pin-type will be set to Icon3.
• If --log is specified, confirmation message will be sent to chat-window and console.

Pin Icon Tags

• You can now use tags at the end of the pin name to customize the pin icon!

  

• Icon customizations will be visible to those with Pinnacle enabled.
• Vanilla players will see the vanilla pin icon without customization.
• Tags will be stripped from the displayed pin name underneath the icon.

Colorizing Icon

• Add a hex-code to the end of a pin-name in the format of: [#F9F9F9]
  • For example: Home Base [#ff0000]
  • The hex-code must start with #, then exactly 6 hexadecimal characters (lower-case or upper-case).
• Colorizing icons changes the icon sprite's shader color from the default #ffffff value.
  • Colorizing non black-white sprites may not work as intended.

Scaling Icon Size

• Add a percentage to the end of a pin-name in the format of : [150%] (note the percent at the end)
  • For example: Home Base [80%]
  • Only two and three-digit values are accepted
  • All values are clamped to a min/max range of 50% to 200%.

Changing Icon Sprite

• Add a sprite-name to the end of a pin-name in the format of: [:sprite_name] (note the colon at the front)
  • For example: Home Base [:egg]
  • The full list of sprite names are here: https://valheim-modding.github.io/Jotunn/data/gui/sprite-list.html
  • The sprite name must match exactly (case-sensitive) and be at least 3 characters long.

Combining Icon Tags

• You can combine all tags in any order as long as the pin name ends with a ].
  • For example: Home Base [:egg] [#00ff00] [125%]
  • Another example: Away Base: [#990099] [80%]

Tags Configuration

• Config-options for icon tags are under the Pinicon.Tags section.

Features

PinEditPanel

• Edit existing pins and add new pins with more icon types!

  

• Edit an existing pin
  • Left-click on an existing pin on the map.
  • The PinEditPanel will toggle on with the default pin data.
  • You can modify the pin name, icon and position.
  • You can toggle the pin checked state and shared state.

• Add a new pin
  • Left-double-click on the target point on the map to add a new pin.
  • The PinEditPanel will toggle on with default pin data.

• Click anywhere on the map without a pin to toggle off the PinEditPanel.

PinListPanel

• Lists all your pins or filter them by pin name!

  

• Show/hide the PinListPanel
  • Press Tab (configurable) to toggle the PinlistPanel on and off.
  • All pins will initially be listed and pin count shown on the bottom.

• Filter pins by name
  • Enter text in the input field at the top of the panel.
  • Pins will by filtered by matching text in their name.

• Center map on pin
  • Left-click on the target pin row and the map will center onto that pin
  • Scrolling animation can be disabled by setting CenterMap.lerpDuration config to 0.

• Reposition the PinListPanel
  • Left-click on an open space on the panel and drag to reposition.

• Resize the PinListPanel
  • Hover near the bottom-right corner to show the resize button.
  • Left-click and drag on this button to resize the panel.

PinFilterPanel

• Filter pins on the map by any icon type (replaces vanilla panel).

  

Add Pin Shortcut

• You can now use a keyboard-shortcut for adding a Pin!
• Set the shortcut in ConfigurationManager under Minimap.Actions > addPinAtMouseShortcut.

Map Teleporting

• Requirements!
  • devcommands must be enabled via console.
  • You must be in single-player mode or the local server-host.

• Teleport to map point
  • Hold LeftShift and click on the target point on the map.
  • Note: this will use the vanilla GetClosestPin() logic to check if a pin-position can be used instead.

• Teleport to pin position
  • Hold LeftShift and click on the target row in the PinListPanel.

Configuration

• Important/critical configuration options are available (more to come later).

  

• Changing the Minimap.Pin font/font-size
  • These two options are available once you are logged into any world.

Notes

• See source at: GitHub
• Looking for a chill Valheim server? Comfy Valheim Discord
• Pinnacle icon created by @jenniely (jenniely.com)

Changelog

1.14.0

• Added new feature QuickMapPin.
• Added new command add-map-pin.
• Modified map-teleporting to use GetClosestPin() logic for the target position to teleport to.

1.13.0

• Updated for the v0.220.5 patch.
• Added new feature pin-icon-tags.
• Code clean-up and refactoring for performance improvement.

1.12.0

• Fixed for the v0.220.3 patch.

1.11.0

• Fixed for the v0.219.14 patch.
• Bumped up <LangVersion> to C# 12.
• Added a "Refresh" button to the PinListPanel.
• Modified PinListPanel scrolling behaviour from elastic to clamped.
• Added config-option PinListPanel.ScrollRect > movementType to allow switching between scrolling behaviour.
• Adding new pins will now try to calculate the position Y value from the Heightmap.
• Code clean-up and refactoring.

1.10.0

• Removed custom Player pin creation added in v1.2.1 as vanilla game no longer orphans Player pins.

1.9.0

• Updated for the v0.217.46 patch.
• Bumped up <LangVersion> to C# 10.
• Code clean-up and refactoring.

1.8.0

• Extracted changelog into CHANGELOG.md.
• Added config option PinListPanelShowPinPosition to toggle the Pin.Position columnns in the PinListPanel.
• Added config option PinListPanelEditPinOnRowClick to show the PinEditPanel when clicking on a row in the PinlistPanel.
• Adjusted PinListPanel to be a bit more compact.

1.7.0

• Added a new feature to add a Minimap.Pin using keyboard shortcut.

1.6.0

• Updated for v0.217.31 patch.
• Fixed a bug where Pin.Font and Pin.FontSize was not correctly applied to the PinMarker.PinName prefab.
• Converted all Terminal commands to ComfyCommand format.
• Removed temporary debugging pinnacle-namepindata-clearall Terminal command.
• Pin Import/Export commands now read and write the new PinData.m_author field.

1.5.3

• Fixed a bug in PinListPanel.SetTargetPins() where it was not fetching Heightmap info for pins with Y values == 0.
• Modified Pinnacle.TeleportTo to fetch Heightmap info when targetPosition.y == 0.

1.5.2

• Removed the targetPosition.y override in the TeleportTo() helper method as this is now handled by vanilla code.

1.5.1

• Fixed a bug where you could not add a new pin if the 'Death' pin icon was selected.
• Changed permission level for resetmap command to be useable without cheats.
• Minor code refactoring.

1.5.0

• Fixed for the v0.217.22 patch.

1.4.1

• Added Game.UpdateNoMap() transpiler patch to fix for a vanilla bug where the minimap will close whenever global keys are received.
• Refactored logging methods to also log to chat.

1.4.0

• Fixed for v0.217.14 patch.
• Migrated all UI.Text usage to new TMP_Text.
• PinListPanel: pin names for pins with no name will be italicized.
• PinListPanel: pin names starting with '$' will be localized for display.
• Fixed Pin name font and font-size wiring for TMP_Text, limited to built-in TMP_FontAssets only (for now).

1.3.0

• Fixed build errors for v0.216.9 PTB update.
• Added new project reference to ui_lib_publicized.dll.
• Converted Minimap.ShowPinNameInput() from postfix-patch to prefix-patch due to signature/behaviour change.

1.2.4

• Re-wrote the entire Minimap.UpdatePlayerPins() prefix patch again to better update player pins.

1.2.3

• Hot-fix for the hot-fix because I forgot to specify gameObject for destroy.

1.2.2

• Hot-fix for orphaned player pin names: rewrote entire Minimap.UpdatePlayerPins() with prefix patch.

1.2.1

• Fixed a bug where pin name text was not removed when pins were removed.
• Temporary hot-fix for player pin names not updating/moving until you zoomed all the way out.
• Updated BepInEx dependency to denikson-BepInExPack_Valheim-5.4.2100.

1.2.0

• Updated for the v0.214.2 patch.
• Added new prototype UIBuilder.CreateSuperellipse() for more rounded panels.
• Updated mod icon to a new one created by @jenniely.

1.1.0

• Added new commands for exporting pins to a file in binary or text format.
• Added new command for import pins from a binary file.
• Refactored plugin configuration code.

1.0.3

• Fixed a bug where the PinEditPanel would not default the Pin.Icon to the last selected one.

1.0.2

• Fixed label for the Z-value in VectorCell incorrectly showing 'X'.
• Removed code in UIBuilder.CreateRoundedCornerSprite() that saved the sprite to disk, was used for debugging.

1.0.1

• Fixed a bug where the PinEditPanel was blocking map-movement when toggled off.

1.0.0

• Initial release.