Portal Configuration UI

Network Selection Window

Destination Network Selection

What's New in XPortal Networks Teams Pins

XPortal Networks Teams Pins builds upon the solid foundation of the original XPortal mod by SpikeHimself, expanding it into a dedicated networking framework with extensive multiplayer features and numerous bug fixes:

• Portal Networks: Group portals into distinct networks:
  • Global / Public Network: Accessible to all players on the server.
  • Player Networks & Private Portals: Portals tied to individual players. Toggle the Private setting so unauthorized players cannot view or teleport through your personal portals.
  • Custom Named Networks: Define up to 15 server-wide custom networks (such as Trade Hub, Clan Base, Mining Outposts, or Admin Only) via configuration, complete with real-time hot-reloading.
• Server Admin & Permission Controls: Configurable permissions allowing server admins to manage networks and prevent non-owners from deconstructing portals.
• Portal Pins on Your Map: Every portal you are allowed to use is pinned on your own map - the feature the XPortal Shared Map Pins companion mod inspired, built in as this mod's own re-implementation (an inspiration only - no code from that project is used here). Other players' private portals and restricted networks stay hidden.
• Bug Fixes & Modernization:
  • Upgraded for the latest Valheim versions and .NET Framework 4.8.
  • Resolved controller UI legend and navigation issues.
  • Fixed dedicated server admin destruction and permission edge-cases.
  • Enhanced ZDO network synchronization and reconnection reliability.

Features

🌐 Destination Selection Menu

When interacting with a portal, a clean UI opens allowing you to select your target destination from a dropdown menu. The list displays:

• The destination portal name
• Distance to the destination (in meters)
• Portal light color indicator (when paired with mods like Advanced Portals or Stone Portal)

🔒 Public, Private & Custom Networks

Organize your world’s transportation:

• Global Network: The shared network open to everyone.
• Personal Network: Portals automatically grouped under your character.
• Private Portals: Mark sensitive portals as private so other players cannot use or retarget them.
• Custom Named Networks: Admin-defined channels defined in xportal_networks.json that organize portals by faction, region, or purpose.

⭐ Default Portal Destination

You can set a portal as your Default Portal. Newly constructed portals will immediately link to your default portal automatically, saving you time when setting up forward operating bases.

🏷️ Uncapped Portal Name Length

XPortal Networks Teams Pins removes the vanilla character limit on portal tags, allowing you to give your portals descriptive and memorable names.

📍 Ping Portal on Map

Forgot where a portal leads? Click the Ping button to highlight the destination portal directly on your map and alert your fellow adventurers with a map ping.

🗺️ Portal Pins on Your Map

Every portal you are allowed to use is pinned on your own map automatically - this is the feature the standalone XPortal Shared Map Pins mod by buldosik inspired, built right in as this mod's own re-implementation. buldosik's mod is credited as an inspiration only: no code from that project is used here.

• Portals on the Global network, on tribe networks you are a member of, and your own private portals are pinned.
• Other players' private portals and restricted networks are never pinned, so the map cannot reveal portals you have no access to.
• The pins are local map data: nothing is written to the world, nothing is sent to other players, and vanilla player pins are untouched.
• Pins follow renamed, moved and destroyed portals, and come back if you delete one on the map.
• Disable them with Show Portal Map Pins, or use Show Network In Pin Name to prefix each pin with its network (for example [Trade Hub] North Base).

🎮 Full Gamepad & Controller Support

Fully navigable using controllers with integrated on-screen key hints:

Mod Compatibility & Integration

• Jötunn, the Valheim Library (Required)
• AdventureBackpacks: Fully Supported (Teleportation restrictions in equipped backpacks are strictly enforced).
• Fast Item Transfer: Fully Supported.
• Advanced Portals: Fully integrated—displays matching colored light icons in dropdowns.
• Stone Portal: Supported with distinctive portal coloring.
• VHVR - Valheim VR: Compatible.
• Nexus Update Check: Compatible.
• XPortal Shared Map Pins: Inspiration for this mod's portal map pins (no code from that project is used here), built in as of v2.6.0 — remove the standalone mod, or you will see duplicate map pins.

Note: Incompatible with AnyPortal (XPortal Networks Teams Pins replaces and supersedes AnyPortal functionality).

How to Use

1. Build a Portal: Place a portal as normal.
2. Access the Configuration UI: Walk up to the portal and press your interact key (E / A).
3. Configure Your Portal:
   • Portal Name: Enter a name for the current portal.
   • Network: Choose whether this portal belongs to the Global network, your Personal network, or a Custom Named Network.
   • Destination: Select the destination portal from the dropdown list.
   • Make Private: (Optional) Check to restrict access so only you (and admins) can use or alter the portal.
   • Set as Default: (Optional) Check to make this portal the automatic destination for newly built portals.
4. Confirm: Click OK to save and activate the connection.

Configuration

General & Server Settings

The main configuration file is located at BepInEx/config/ghostwheel.mods.xportalnetworkstribespins.cfg. Server-owned settings (PingMapDisabled, DoublePortalCosts, HidePortalDistance, RestrictPortalRemoval, AdminsSeeAllNetworks and the Portal Networks entries) are synchronized from the server to every connected client via Jotunn's ServerSync, and can only be changed by server admins (or the host) - including from within the game client through the ConfigurationManager window.

Custom Named Networks (config)

Servers define custom networks (ids 1-15) in per-network sections of BepInEx/config/ghostwheel.mods.xportalnetworkstribespins.cfg:

[Portal Network 1]
Name = Admin Network

[Portal Network 2]
Name = Trade Hub
Permitted = Steam_12345678901234567, Steam_76543210987654321

[Portal Network 3]
Name = North Outposts

Leave a name empty to keep that slot unused, and leave the allow list empty to let everyone use the network. These entries are server-owned and synchronized by Jotunn's ServerSync, so server admins can add, rename and restrict networks from inside the game (ConfigurationManager -> XPortalNetworks -> Portal Networks) without touching any server files. Networks previously lived in xportal_networks.json; that file is imported once on upgrade, after which it is ignored and can be deleted.

Installation & Server Setup

Prerequisites

• BepInExPack Valheim (v5.4.2200+)
• Jötunn (ValheimLib) (v2.20.0+)

Automatic (Recommended)

Use a mod manager like Gale or Thunderstore Mod Manager to download and install XPortal Networks Teams Pins with one click.

Manual Installation

1. Download the latest release .zip from Thunderstore or GitHub Releases.
2. Extract the archive contents into your Valheim/BepInEx/plugins/ directory.
3. Ensure both client and dedicated server have XPortal Networks Teams Pinss installed for multiplayer synchronization.

Bugs, Feature Requests & Community

• Bug Reports: Please submit an issue on the GitHub Issues page using the Bug report template. Please include your LogOutput.log file.
• Feature Requests: Open an issue on GitHub selecting the Feature request template.
• Translations: Contributions for new languages or localization updates are welcome via GitHub pull requests or on Discord.

Credits & Acknowledgements

• Vapok: Author of the the expanded XPortalNetworks - the base this project is built upon and continues.
• SpikeHimself: Creator of the original XPortal mod, upon which XPortal Networks is built and expanded.
• sweetgiorni: Creator of the original AnyPortal concept.
• buldosik: Author of XPortalSharedMapPins - the standalone companion mod that inspired this mod's portal map pins (built in as of v2.6.0). Credited as an inspiration only: this mod contains no code from that project.
• Translations & Community: Thanks to kaiqueknup, makou, Smok3y97, MexExe, hanawa07, bonesbro, VasariRulez, Felix, and cawa-93 for original translations and community contributions.

🔒 Privacy

This mod collects and sends nothing. As of 3.0.0 the Vapok.Valheim.Common splash screen, its anonymous usage telemetry (mod_launch, mod_heartbeat, world_session_start) and its error reporting are no longer used at all: the mod never contacts that telemetry endpoint, never registers itself with it, and neither reads nor writes its opt-in preferences. There is no telemetry toggle to configure, and no setting in this mod's config file causes anything to leave your machine.

• What this mod stores locally: your own configuration file (see below), and the portal map pins, which are local map data - nothing is written to the world, sent over the network, or saved into your map file.
• Third-party telemetry: Unity's and the game's own analytics are untouched by this mod, and nothing here changes them either.
• Configuration Files: Settings can be managed through the BepInEx Configuration Manager, or by editing [General] and [Local Config] in BepInEx/config/ghostwheel.mods.xportalnetworkstribespins.cfg.