CDEV PortalPins

PortalPins

Every portal in the world gets a map pin — for every player, everywhere, from the moment it is built.

No more "where did we put the portal to the swamp?". The server knows every portal in the world, so the pins

are complete: portals you have never visited, portals a friend built while you were offline, and portals that

existed long before you installed the mod.

What you get

• A pin on every portal, named after the portal's tag (Portal when it has none). It appears a few

seconds after the portal is built, follows a rename and disappears together with the portal.

• **Pin names start with *, so portal pins are easy to tell apart from the ones you placed yourself.

Set NamePrefix to an empty value if you would rather not have it.

• The pins behave like the game's own spawn pin: they are not written into your character file, a left

click does not cross them out, a right click does not delete them, and if another mod wipes them they are

back within two seconds. The map's icon filter still hides them if you want quiet.

The portal list, inside the naming window

Interact with a portal and the usual tag window opens — with the list of every portal of the world

right under the name field:

• the portal you are standing at comes first, then the ones that have no partner yet;
• the icon on the right says whether a portal is linked: white when it has a partner, red while it

stands alone. Point at it and it tells you which portal it is paired with;

• two linked portals are drawn as one block, with a bar down the left side, so a pair reads as one thing

instead of two rows with the same name;

• click a row to write that name into the field — which is how the game pairs two portals;
• type in the field to search the list. A world with fifty portals is one word away;
• every row has a map button: it opens the map on that portal, zoomed in, and makes its pin pulse for a

few seconds. Close the map and the naming window comes back, with the text you had typed;

• the list follows the server while the window is open, so a portal someone else builds or renames turns up

in it by itself.

While the window is open the background is dimmed and the mouse wheel scrolls the list instead of zooming

the camera. ShowPortalList = false turns the whole list off.

Removing a pin (for everybody)

Off by default. With the server setting AllowRemoving on, a right click on a portal pin removes that

pin for every player on the server — the portal itself stays, and so does its entry in the portal list.

• AdminsOnly (on by default) leaves that to admins from adminlist.txt and to whoever hosts the world.
• ConfirmRemoval (client, on by default) asks first and says what is about to happen.
• The server remembers it next to the world, in.mod.portalpins.hidden, so it survives a restart.

To bring every removed pin back, delete that file while the server is stopped.

Installation

The mod belongs on the server and on every client. Only the server sees every portal in the world; a

client only receives what is near it. A server that has the mod refuses clients that do not

(Jötunn ClientMustHaveMod), so everyone playing there needs it.

• Install BepInExPack Valheim and

Jötunn.

• Drop CDEV.PortalPins.dll into BepInEx/plugins/CDEV.PortalPins/ on the server and in every player's

game folder. A mod manager does this for you.

• Single player needs nothing extra: your own world is the server.

Settings — BepInEx/config/cdev.portalpins.cfg

| Section | Key | Default | What it does |

|---|---|---|---|

| Pins | AllowRemoving | false | Server, admin only, synced: a right click removes a portal pin for every player. |

| Pins | AdminsOnly | true | Server, admin only, synced:** only admins and the host may remove pins. |

| Pins | ConfirmRemoval | true | Client: ask before removing a pin. |

| Pins | NamePrefix | * | Client: the mark in front of every pin name of this mod. |

| Portals | ShowPortalList | true | Client: the portal list inside the naming window. |

The