Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351README
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
- Walk up to a portal and press E.
- Click Add portals to map. All portals now show on the map.
- Want to travel? Click Open World Map in the same window, then click the portal you want.
- 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.