PortalAtlas
Personal portal atlas for Valheim. Record gates as you find them; admins can Refresh the full world list. Dedicated Refresh needs Server Devcommands. Optional Auto-pin. Vanilla pairing stays.
About this mod Author’s original text
Portal Atlas
Personal portal journal and map panel for Valheim. Record gates as you find them, sort and search them on the large map, and optionally Refresh world for a full server-wide list if you are an admin. Vanilla tag pairing is unchanged.
| | |
| --- | --- |
| Version | 1.2.6 |
| GUID | sonicdm.valheimportallist |
| Dependencies | BepInExPack Valheim, Jötunn, Server Devcommands (dedicated Refresh only) |
Requirements
| What you want | Game client | Dedicated server |
| --- | --- | --- |
| Journal + panel only | Portal Atlas + Jötunn | Not required |
| Refresh world on a dedicated server | Portal Atlas + Jötunn + Server Devcommands, and your id in the server adminlist.txt | Portal Atlas + Jötunn + Server Devcommands |
| Offline / listen host (you host the world) | Portal Atlas + Jötunn | — (you are the host; Refresh works locally) |
Notes:
- Gale / r2modman install Jötunn and Server Devcommands from manifest.json on the client.
- The dedicated server must also have Portal Atlas and Jötunn (same as other Jötunn mods). Put Server Devcommands on the server if you use admin Refresh.
- You do not need to turn on vanilla devcommands / cheats. Server Devcommands already confirms admin via adminlist.txt.
How to use
- Approach, use, or travel through a portal — it is saved to your local journal (per world + character).
- Open the large map (M) → Portals, or run portals.
- Filter by tag; sort by Name, To me, or Map click.
- Select a row → Pin, Ping, or Ping exit.
- If Refresh is available: Refresh world loads a live server list (session only). Use Add to journal on rows you want to keep. Show known returns to the journal.
Approach range (journal + optional auto-pin): config Pins.ApproachRangeMeters (default 8).
Clear saved only removes pins this mod created. Manually placed map pins are never touched.
Refresh world
Never runs automatically when the panel opens. Never writes your journal by itself.
On a dedicated server, after you join, the client handshakes with the host (PortalAtlas_Hello / HelloAck). Refresh is enabled only when:
- The host has Portal Atlas (handshake succeeds), and
- Server Devcommands reports you as admin.
The panel shows a status line under the Refresh button, for example:
| Status | Meaning |
| --- | --- |
| Refresh: ready (admin) / ready (server x.y.z, admin) | Handshake OK and you are admin — button works |
| Refresh: ready (you are host) | Offline / listen host — local scan |
| Refresh: checking server… | Waiting for the host handshake |
| Refresh: server incompatible (no Portal Atlas) | Host did not answer — install Portal Atlas (+ Jötunn) on the dedicated server |
| Refresh: Server Devcommands missing | Install Server Devcommands on this client (and the server) |
| Refresh: not an admin | Handshake OK, but you are not on adminlist.txt / not authorized yet |
| Refresh: scanning… | Host is building the world list |
When Refresh is unavailable, the button stays visible but greyed out.
Install
Client: install with Gale / r2modman (SonicDM-PortalAtlas).
Dedicated server: install the same package (or drop PortalAtlas.dll) and Jötunn. Add Server Devcommands if admins should use Refresh. Restart the server after installing.
Both client and server should run the same Portal Atlas version when using Refresh.
Commands
| Command | Purpose |
| --- | --- |
| portals | Toggle the Portals panel (opens the large map if needed) |
| portallist | Export every portal to CSV under BepInEx/cache/PortalAtlas/ (host, or dedicated admin) |
Files
Under BepInEx/cache/PortalAtlas/ (not config):
- Journal JSON per world + character
- Host CSV / tag summary / text report (startup dump and portallist)
Troubleshooting
| Problem | Check |
| --- | --- |
| No Portals button / panel | Jötunn installed on the client; look for Portal Atlas … loaded in BepInEx/LogOutput.log |
| server incompatible | Portal Atlas + Jötunn on the dedicated server; matching version; server log shows the mod loaded |
| n
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: