Pinnacle

This is an unofficial fork of Pinnacle by ComfyMods, containing compatibility fixes for Valheim 1.0.7. It is not an official ComfyMods release.

Pinnacle perpetually provides premium pin performance.

Local compatibility build 1.16.1

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.16.1

• Unofficial compatibility fork of Pinnacle by ComfyMods for Valheim 1.0.7; not an official ComfyMods release.

1.16.0

• Fixed an issue with pinnacle-remove-all-pins command not working.
• Added new config-option [PinEditPanel] pinEditPanelDefaultPosition to configure the PinEditPanel position.
• Code clean-up and refactoring.

1.15.0

• Updated for the v0.221.5 patch.
• Fixed scroll-sensitivity issue with PinListPanel scrollbar.
• Added new config-option [PinListPanel.ScrollRect] scrollSensitivity to configure above scroll-sensitivity.

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.