Confirm with your password

InterServerPortal

Portal to your own local world from a dedicated server and back — no logout/relog. Plus same-world portal networks: mesh all your portals so you can hop between any of them. Entry codes, vanilla assets only.

· 💗 Donate

Stars
0
Downloads
20
Version
0.12.0
Updated
Author
TaegukGaming
Virus scan
✓ Scan successful
Runs on
Client (& Server)
Required by
1 mods

Compatibility

Required 1

Install these too — Gale pulls them in for you.
  • Jotunn ValheimModding ·2.30.0

Description

InterServerPortal

Step through a portal on a dedicated server and land in your own local single-player world — and step back to return to the server. No logout → main menu → pick world → reload → reconnect. One portal, one loading screen. The same mod also adds same-world portal networks that mesh all of your portals so you can hop between any of them. Vanilla assets only.

What it does (in plain English)

  • Turns a portal into a door to your own world. Flag a portal as inter-server; walk through it on the server and you're switched to your local world. The portal is shared — everyone who uses it goes to their own world.
  • Remembers the way back. A portal in your local world offers Return to origin server and reconnects you to where you came from.
  • Meshes all your portals into a network. Set a portal to Network mode and it links with every other network portal you built — walk through one and pick any of the others from a nearest-first menu (a normal in-world teleport, no world switch).
  • Colours every portal by what it does. Vanilla tag portals glow their normal blue, network portals glow violet, inter-server portals glow cyan — and, like vanilla, they only light up when they're actually connected/usable.
  • Locks portals with an entry code. Optionally require a code before a portal will travel (salted + hashed — the raw code is never stored).
  • Keeps vanilla portals vanilla. Unflagged portals still pair 1:1 by tag exactly as before. Wood portals still block ore; stone portals still carry it.
  • Optional: carry ore through a wood portal, for a price. Wood portals get a 3×2 storage box. Enable the carry toll and you can bring ores, metals, dragon eggs and Mistlands/Ashlands machinery through a wood portal — as long as you've beaten the boss of the biome that cargo comes from and the box holds the fee (1 Surtling core per metal, 1 Crystal per dragon egg, and so on). Off by default, fully configurable, and server authoritative so nobody can edit their own config to skip it.
  • Optional Discord ping. Set a webhook and get a message whenever you cross from a server into your local world.

Requirements

  • Valheim 1.0.7 or later. Version 0.11.0+ of this mod is built for the 1.0 release; if you are still on a pre-1.0 game build, use 0.10.1.
  • The dedicated server must NOT run with -crossplay. Crossplay servers are not supported: an inter-server portal on one refuses to travel and tells you why. Crossplay routes the connection through PlayFab instead of a Steam socket, and the reconnect the return trip depends on is unreliable there. Start the server without the -crossplay flag (Steam-only) and everything works.
  • BepInExPack_Valheim 5.4.2350+ and Jotunn 2.30.0+ — pulled in automatically by a mod manager. If you are upgrading an existing setup from a pre-1.0 game, update both of them too: an older Jotunn fails to load on 1.0.7 and takes this mod down with it.

Quick setup

  1. Install this mod on every player's machine. Installing it on the dedicated server is optional (0.12.0+): the mod works on a vanilla server, but the server install buys three things — same-world network menus and glow that see every zone (not just the ones loaded near you), and a carry toll that players can't edit out of their own config. It no-ops on a headless server otherwise. Without it you'll see a one-time "Server has no InterServerPortal" notice on joining.
  2. Make sure you have at least one local single-player world to travel to.
  3. In-game, build a normal portal. Hold L.Shift + Use on it to open the config panel.
  4. Tick inter-server, add a destination (label, local world name), and close the panel.
  5. Walk through the portal — you're switched to your local world. In that world, a portal offers Return to origin server to come back.

For same-world networks instead: open the same panel, set Link mode → Network on two or more portals you built, then walk through one to pick another.

That's the minimum. Everything else is optional.

The one hard rule

Valheim binds you to one world per session — there is no way to be in two worlds at once or to switch without a loading screen. This mod does not fight that; it removes the menu navigation, not the load. Every transition costs exactly one loading screen.

Documentation

Full guides — portal modes & colours, inter-server travel, same-world networks, entry codes, item policy, Discord notifications, and configuration — are on the GitHub Wiki.

Try it out

This mod was built for the TaegukGaming community server running the Hearthbound modpack. If you want to see it in action, check out the modpack:

🏰 Hearthbound Valheim Modpack

Disclaimer

This mod is created using AI. No other mods were copied during the process. All feature ideas come from the uploader and are mainly to cater the needs of the TaegukGaming community server. If any features or ideas look similar to other mods, these are not intentional.

This mod is free to use as is. Voluntary support is appreciated.


Version: 0.12.0 Source / issues / wiki: https://github.com/yesu0725/InterServerPortal

Changelog

0.12.0 Latest
  • Crossplay servers are not supported. On a dedicated server started with -crossplay, an inter-server portal now refuses to travel with the message "This server runs crossplay — InterServerPortal doesn't support crossplay servers." Crossplay servers are reached through PlayFab rather than a Steam socket, and the reconnect the return trip needs proved unreliable — rather than strand you in your local world with a flaky way back, the trip is refused up front. Run the server without -crossplay to use the mod. (Before this release the mod tried anyway and the return failed with "Could not capture current server address".)
  • Fixed: returning to the origin server also failed when you had joined it from the Steam friends list (the game keeps the server's Steam id instead of an IP). The mod now remembers whichever of the two the game used.
  • New: the mod no longer needs to be installed on the dedicated server. On a server without it, inter-server travel, the return trip, portal config, entry codes, the item restriction and the glow colours all work as before. What changes: the same-world network menu and network glow only see portals in zones loaded near you, and the carry toll uses each player's own config (so it is no longer cheat-proof). You get a one-time notice on joining. Keep the server install to have all of that — it's still recommended.
  • New: client and server tell each other their version on connect; a mismatch is logged on both sides.
  • Fixed: RememberServerPassword never actually remembered the password, so the return trip always asked for it. It now remembers the one you typed into the game's password dialog (and only auto-fills it for the return trip, not for servers you join by hand later).
  • New: if the return trip fails with "failed to connect" straight after leaving the server, the mod retries the connection a few times before showing that error.
  • Same requirements as 0.11.x — Valheim 1.0.7+, BepInExPack_Valheim 5.4.2350, Jotunn 2.30.0.
0.11.1

Recommended for everyone on 0.11.0.

  • Fixed: on Valheim 1.0, alt-using a portal opened the config panel but the player inventory and the toll storage never came up with it, so there was no way to drag a fee into the box (and the "Open portal storage" button did nothing). 1.0 renamed the container's open message and the mod was still sending the old name, which the game silently ignored. Only affects wood portals with the carry toll; nothing else in 0.11.0 was impacted.
  • Same requirements as 0.11.0 — Valheim 1.0.7+, BepInExPack_Valheim 5.4.2350, Jotunn 2.30.0.
0.11.0

Requires Valheim 1.0.7 or later. Stay on 0.10.1 if you are still on a pre-1.0 game build — 1.0 changed the APIs this mod hooks, so a single build cannot serve both.

  • Updated for the Valheim 1.0.7 API. Two game changes needed handling: the teleport-restriction check now takes the portal's allow-all-items flag as an argument, and the portal list is now grouped by world sector instead of arriving as one flat list.
  • Update your dependencies too — this release needs BepInExPack_Valheim 5.4.2350 and Jotunn 2.30.0 (the first Jotunn built for Valheim 1.0.7). A mod manager will pull these in for you.
  • No gameplay or config changes. Portals, networks, entry codes, the carry toll and the log-in guard all behave exactly as in 0.10.1.

13 older entries, full version history & downloads →

Files

5 files · 157 KB download

Loading files…

Manual download
Just this mod One .zip — InterServerPortal 0.12.0
Files you'll get 2
  • InterServerPortal 0.12.0 TaegukGaming this mod Get
  • Jotunn 2.30.0 ValheimModding Get

Your browser may ask permission to download several files at once. How to install these manually

Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2360 · View mod page

Check out the mod page for detailed installation instructions.

2

Install InterServerPortal

This mod must be installed on the client. Installing it on the server is optional (e.g., for config syncing).

Download InterServerPortal 0.12.0

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.