PortalAtlas

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