You are viewing a potentially older version of this package. View all versions.
Saymonn-PortalMapMarkers-1.0.0 icon

PortalMapMarkers

Marks all your portals on the world map and lets you teleport to any of them by clicking its marker. Works with vanilla portals and XPortal.

By Saymonn
Date uploaded a week ago
Version 1.0.0
Download link Saymonn-PortalMapMarkers-1.0.0.zip
Downloads 47
Dependency string Saymonn-PortalMapMarkers-1.0.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

PortalMapMarkers

Never lose a portal again. One click puts a marker on the world map for every portal you have built, and a special click-to-teleport map lets you jump to any of them.

Features

  • All your portals on the map. Open any portal (press E) and click Add portals to map. Every portal in your world gets a marker with its name.
  • Safe to click again. The button only adds what is missing, fixes renamed or moved portals, and drops markers of destroyed ones. Clicking it ten times never stacks duplicate markers.
  • Remove them any time. Remove portal markers deletes only the markers made by this mod. Your own pins are never touched.
  • Click-to-teleport map. Open World Map opens the map in teleport mode. Hover a portal marker (the cursor turns into a dagger and the marker lights up), click it, and you step out of that portal. The normal map (M) is left exactly as it is.
  • Looks like it belongs. Markers use a hand-drawn wooden portal ring, and the names are shown in a maplewood brown so they stand out from your own pins. Marker picture and both colours are configurable.
  • Works with portal mods. Buttons appear in the vanilla portal window and in the XPortal window. Portal names are read from the portal itself, so long XPortal names work too.
  • Leaves no trace. Markers are not saved into your map, so removing the mod removes them.

How to use

  1. Walk up to a portal and press E.
  2. Click Add portals to map. All portals now show on the map.
  3. Want to travel? Click Open World Map in the same window, then click the portal you want.
  4. Click Remove portal markers whenever you want a clean map.

Prefer fewer clicks? Set AutoAddOnWorldLoad to add the markers automatically a few seconds after you enter the world, or bind optional hotkeys for add and remove.

Teleport rules

Teleporting from the map follows the normal portal rules. It is blocked while you carry items that portals do not allow (ore, metal bars and so on), unless that portal type allows everything. You arrive at the same spot where you would step out of the portal.

Configuration

Edit BepInEx/config/saymonn.PortalMapMarkers.cfg or use a configuration manager in game. Changes to colours apply live.

Section Setting Default Description
General Enabled true Master switch. When off, the buttons disappear.
Hotkeys AddAllPortals None Optional hotkey that adds or refreshes all markers.
Hotkeys RemoveAllMarkers None Optional hotkey that removes all markers made by this mod.
Markers AutoAddOnWorldLoad false Add the markers automatically a few seconds after you enter the world.
Markers IconStyle CustomRing CustomRing (the wooden portal ring), PortalBuildIcon (the portal's own build-menu icon) or StandardPin.
Markers MarkerColor white Tint of the marker picture. White shows the picture as drawn.
Markers LabelColor maplewood brown Colour of the portal name on the map.
Markers PinIcon Icon3 Standard pin icon, used by StandardPin. It also decides which map filter hides the markers.
Markers ShowUnnamedPortals true Also mark portals that have no name.
Markers UnnamedLabel Portal Label shown for portals without a name.

Compatibility and notes

  • Requires BepInExPack for Valheim. Made for Valheim 1.0 (Deep North).
  • Made for single player: the game must know every portal in your world.
  • Compatible with XPortal (optional). Works alongside teleport-related mods such as TeleportEverything and QuickTeleport, which only change how the trip itself behaves.
  • Client-side only. Not needed on a server.

Credits

Made by Saymonn. Portal marker ring and dagger cursor artwork were created for this mod.

CHANGELOG

Changelog

1.3.0

  • New setting ShowShips (default on): the location of every ship in the world (moored or sailing, vanilla and modded) on the map, with the ship's name and icon. Updates as ships move.
  • New setting ShowStructures (default off): one marker per base you built, with the number of pieces. Handy for houses without a portal. Tuning: MinPiecesPerBase, BaseRadius.
  • Both work the same on the normal map and on the custom map.
  • Colour settings are now plain RGB hex codes (no alpha). MarkerColor is hidden in the config window while IconStyle is CustomRing.

1.2.0

  • New setting ShowOnNormalMap (default on): portal markers also stay on the normal world map (M). Teleporting still works only from the Open World Map in the portal window.
  • Markers refresh on events (world load, portal built, destroyed or renamed) and on every Open World Map click, with no timer.

1.1.0

  • Portal markers are rebuilt every time you click "Open World Map" (new, renamed, moved and destroyed portals are picked up) and exist only while that custom map is open, so the normal map (M) is never touched.
  • Removed the "Add portals to map" and "Remove portal markers" buttons, the AddAllPortals/RemoveAllMarkers hotkeys and the AutoAddOnWorldLoad setting. The Enabled setting now switches the markers on and off.

1.0.0 - Initial release

  • Map markers for all your portals (custom wooden ring icon, configurable marker and label colour), added/removed with buttons in the portal window (vanilla and XPortal).
  • Open World Map button: click-to-teleport map with a dagger cursor and hover highlight.