Portaler

Every portal connects to every portal. Step into any portal and the map opens with a list of all portals on the server. Pick a name or click a pin and you're there. There's no pairing and no tag matching, and by default no item restrictions.

Built for servers that play together: favorites can be personal or shared with everyone, the newest portals show up for all players, and new portals name themselves after their biome (BF-007, MO-012). Find any portal in seconds with search, sorting and foldable biome groups, rename portals right from the list, and get home with the Back button.

Everything is synced through the server and kept with the world save, so it survives restarts and mod updates.

Source code, issues and ideas: github.com/nfp007/portaler

Features

Every feature says what is 🌐 shared (the same for everybody on the server) and what is 👤 personal (only for you).

1. Travel from any portal to any portal

• Walk into a portal: the big map opens with the portal list on the left.
• Click a name in the list, or a portal pin on the map, to travel.
• Vanilla name pairing is switched off, so every portal is always active.
• The portal you stand in stays in the list, marked in red with "you are here", and cannot be selected.
• 🌐 Shared: the list of portals (everybody sees every portal).

2. Map preview

• Rest the mouse on a name: the map glides to that portal, its pin gets bigger, and a soft fiery line flows from your portal to it.
• The map stays there 5 seconds after the mouse leaves the list, then glides back. Move or zoom the map yourself and it stays where you put it.
• 👤 Personal: only your own map moves. Timing, zoom and the line can be changed in your config.

3. Favorites

• Right click a name: mine (silver star), then shared (bigger glowing gold star), then off.
• Drag favorites by their handle into any order. New favorites go to the end.
• 🌐 Shared: gold stars. Everybody sees them, and anyone can add or remove them.
• 👤 Personal: silver stars and the order of your favorites (per character, saved on the server).

4. Categories & filter

• Hover a name and press T to choose a category: Base, Mine, Farm, Trader, Boss, Danger, Dungeon or Explore.
• The icon shows in the list and inside the portal's ring on the map.
• One click on an icon in the Show: row lists only that category. Click it again (or All) to see everything.
• 🌐 Shared: the category of each portal (anyone can change it).
• 👤 Personal: which category you are filtering by.

5. Search

• Click the search box and type: only portals whose name contains the text are shown (any case), matching letters in gold.
• While typing, the game ignores your keys (no walking, the map stays open). Esc or x clears the search.
• 👤 Personal: your search (cleared each time you enter a portal).

6. Sorting & foldable groups

• Biome (default): grouped by biome, Deep North first. Click again for Meadows first.
• Name: one list A to Z, or Z to A.
• Distance: nearest first (or farthest first), with the distance shown next to each name.
• Click a group title (a biome, Favorites, Last built) to fold or unfold it.
• 👤 Personal: sort choice (per PC) and folded groups (per character).

7. "Back to"

• The portal you last travelled from, at the top of the list. One click takes you back.
• 👤 Personal: per character, saved on your PC.

8. "Last built"

• The 3 newest portals built by anyone on the server.
• 🌐 Shared: the same list for everybody.

9. Automatic names & rename from the list

• New portals are named after their biome plus a number, for example BF-007 or MO-012. Numbers keep counting up per biome and are never reused.
• Portals you name yourself, and existing portals, keep their names.
• Hover a name in the list and press E to rename that portal from anywhere in the world (up to 25 characters).
• 🌐 Shared: portal names (anyone can rename any portal).

10. Map pins

• Every portal gets a fiery ring pin with its name, and its category icon in a round badge at the lower right.
• The previewed portal's pin is drawn bigger and stays big as long as the fiery line is shown; a pin under the mouse grows a little, so icon and name are easy to read.
• Pins from other mods (for example automatic pin mods) that sit on a portal are hidden, so each portal shows just one icon.
• While you choose a destination, portal pins, their names and the fiery line are drawn above all other pins and labels, at full brightness.
• 🌐 Shared: everybody sees the same pins, names and icons.

11. Optional vanilla restrictions

• By default every item can travel, metals included.
• Prefer the game's own rules? Switch on VanillaRestrictions on the server (see Configuration).
• 🌐 Shared: the server decides for everybody.

All shared data is stored on the server, next to the world save, and survives restarts and mod updates.

Changelog

2.0.0

One-way links

• Link a portal to one destination: walk into it and you travel straight there, without the list, like the game's own portal pairs. Perfect for a direct road between two bases.
• Right click a name or a portal pin → Link… (or press L). A window in the middle of the screen shows From and To: walking into "From" takes you to "To". Change… picks another portal for either end, Swap turns the direction, and you choose both ways (default) or one way.
• Looking at a portal in the world: L links it, or removes its link (press twice).
• Linked portals show their destination's name floating above them, "Leads to: …" in their hover text, and "Name → Destination" in the list. From any other portal you can still travel to a linked portal. If a destination is destroyed, the link is dropped.

Portal colours

• Give any portal one of 8 colours (Ice, Green, Gold, Red, Purple, Teal, White, Pink) or keep the vanilla look: press C on a name, a pin or a portal in the world, or right click → Colour.
• The runes and the fire around the portal burn in its colour, the swirl in the middle takes a darker shade. The map pin gets a ring and the list row a mark in the same colour.

Right-click menu

• On every name and portal pin: travel, link, remove link, colour, favorite, category, rename. The title shows where the portal leads and where you are. Favorites are toggled with the star (or the menu).
• Link, colour, category and players windows open in the middle of the screen.

Other

• New settings: [Controls] LinkKey (L), ColorKey (C), [World] FloatingNames, FloatingNameDistance.
• The server must be updated too: links and colours are stored and shared by the server.

1.0.13

• Quick arrival (new, on by default, [Travel] QuickArrival): trips through Portaler skip the game's fixed waits (2 s before moving, at least 8 s in total). You are moved as soon as the screen is dark and arrive as soon as the target area is loaded. Measured: 4-6 s instead of 8.6-10.5 s. Vanilla portals and dungeons are not changed; off automatically when Fast Teleport is installed.
• Smoother list: no freeze the first time the map opens (it was up to 2 s; fonts, styles and the big panel are now prepared right after you spawn, the wooden boards are drawn on a background thread).
• No more short freezes from the board-image cache (it threw everything away when it was full; now only the oldest unused images go).
• The list sorts and groups once and reuses it, instead of several times every frame.
• New default block order for new characters: Back to, Players' last trips, Favorites, Last built, All portals.
• New setting [Debug] PerfLog (off): writes Portaler's own time and memory use and the timing of every trip to the BepInEx log, for troubleshooting.
• Nothing changed on the server side (updating it too keeps every machine on the same version).

1.0.11

• New screenshots: one large overview, and a small picture with every feature in the description.

1.0.10

• Updated mod description and README introduction to cover all current features.

1.0.9

• "Back to" can be dragged too, and so can the whole portal list (new title "All portals"): any block can go above or below all portals.
• While dragging, the lifted title says where it will land ("drop: before Favorites", "drop: at the end").

1.0.8

• "You are here" is now greyed out instead of red; "Back to" is golden and the newest one glows.
• "Back to" keeps your last 3 departure portals: show 1 2 3 in its title chooses how many are listed.
• "Last built": show 1-5 in its title (default 3).
• New group Players' last trips: the last portal each other player travelled to, shared through the server. Players: n of m opens a window to choose whom you follow (personal).
• Favorites, Players' last trips and Last built can be dragged by the handle left of their title into any order (per character).
• The server DLL must be updated too.

1.0.7

• Map preview reworked: close portals (up to 2 km) are framed together with extra room around the target; far targets are shown directly instead of a fast flight across the map.
• Calm glide (1 s, soft start and stop) to the preview and back.
• The preview stays 10 s after the mouse leaves the list.
• New settings HoverMaxFitMeters, HoverMoveSeconds; HoverReturnDelay replaced by HoverStaySeconds.

1.0.6

• Colours match Valheim's own panels: warm medium-brown wood instead of almost black. (A colour correction made everything far too dark; it is removed.)

1.0.5

• New screenshots on the mod page: the map with the fiery line and big category badges, and the category filter.

1.0.4

• While choosing a destination, portal pins, their names and the fiery line are drawn above all other pins and labels (they were covered by other mods' pins and names).
• Portal pins always at full brightness.

1.0.3

• Category badge on the map pin 20% bigger.
• Fixed: the previewed pin got small again right away. It now stays big as long as the fiery line is shown.
• Pin sizes are applied every frame, so hovering a pin on the map reacts smoothly.

1.0.2

• Category icon back in the lower right corner of the map pin, as a big round badge.
• Steady pin sizes: no more pulsing. The previewed portal's pin is bigger and stays big; a pin under the mouse grows a little.
• New settings: PinSizePreview, PinSizeHover.

1.0.1

• Category icon now sits big inside the portal ring on the map (was too small to see).
• Map preview: a soft fiery line flows from your portal to the previewed one.
• Map preview stays 5 seconds (was 0.25) before gliding back, and does not glide back at all if you move or zoom the map yourself.
• New settings: HoverReturnDelay, HoverLine.
• README: every feature says what is shared with everybody and what is personal.

1.0.0

• First stable release.
• Hover a name: the map glides to that portal and its pin glows (delay, zoom and return configurable).
• Categories: press T over a name to choose Base, Mine, Farm, Trader, Boss, Danger, Dungeon or Explore. Icon in the list and as a badge on the map pin, shared with everybody.
• Category filter: one click on an icon shows only that category.
• Favorites: drag them into your own order (per character); new favorites go to the end.
• Configurable keys: RenameKey (E) and CategoryKey (T).

0.5.3

• Mod page: three smaller screenshots (search, distance sorting, biome sorting) under the main one.

0.5.2

• Fixed: the "Back to" row did not show the portal name.
• Mod page links to the GitHub repository; new screenshots.

0.5.1

• New mod description and README: clearer intro, features in order of importance.

0.5.0

• Search box: click and type to filter the list by name; matches shown in gold. Esc or x clears it.
• "Back to" row: one click returns you to the portal you last travelled from (per character).

0.4.1

• Click a group title (biome, Favorites, Last built) to fold or unfold it. Saved per character, only on your PC.

0.4.0

• New server setting VanillaRestrictions (default off): use the game's own portal rules (item restrictions, "no portals" world modifiers).
• Fixed: the mouse wheel over the list also zoomed the map for a moment.
• Fixed: dragging the list's scrollbar also dragged the map underneath.

0.3.2

• Clearer help text in the list: right click a name to favorite it.
• New README with feature list, controls, configuration and installation.

0.3.1

• Fixed: portal names changed from the list were lost after restarting the world.

0.3.0

• Shared favorites: right click once = mine (silver star), twice = shared with everybody (bigger glowing gold star), third time = off.
• Shared favorites are listed first.

0.2.3

• Fixed: typing in the rename box did not work.

0.2.2

• Rename portals from the list: hover a name and press E.

0.2.1

• No more double icons: other mods' pins on a portal are hidden.

0.2.0

• Favorites, "Last built" and sorting are kept across restarts and mod updates.
• Server data is stored next to the world save.
• Released by nfp007.

0.1.3

• Fixed washed-out colours in game.
• Sorting by Biome, Name or Distance, each reversible. Distance shown in Distance mode.

0.1.2

• Wooden Valheim-style panel and name boards.
• New mod icon and fiery ring map pin with see-through centre.
• The portal you stand in stays in the list, marked "you are here".

0.1.1

• Bigger text, solid panel wide enough for 25-character names.
• Favorites (right click) and "Last built" group.
• Scrolling the list no longer zooms the map.

0.1.0

• First version: portal list when entering a portal, click a name or map pin to travel, automatic biome names, server sync.