You are viewing a potentially older version of this package. View all versions.
DigitalVikings-XpandedPortal-1.1.2 icon

XpandedPortal

Lots of portal configuration options: targeted destination UI (inspired by XPortal), an energy & recharge system, travel restrictions, and server sync.

Date uploaded 2 weeks ago
Version 1.1.2
Download link DigitalVikings-XpandedPortal-1.1.2.zip
Downloads 126
Dependency string DigitalVikings-XpandedPortal-1.1.2

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202
ValheimModding-Jotunn-2.20.1 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.20.1

README

XpandedPortal

A comprehensive portal overhaul for Valheim introducing targeted destination selection, an energy & recharge system, customizable travel restrictions, and dedicated server synchronization.


🌟 Features

  • 🎯 Targeted Destination UI: Interacting with any portal opens a clean dropdown list showing all available destinations with distances in meters, sorted nearest-to-furthest.
  • ⚡ Portal Energy System: Portals can accumulate energy reserves over time and spend them to power teleports, with optional carry-weight and distance cost scaling.
  • ⏱️ Configurable Transition Time: Adjust the portal loading screen / transition duration from instant to cinematic (0 to 30 seconds, vanilla default: 8.0s).
  • 🤢 Teleportation Sickness: Optional debuff scaling with jump distance, temporarily reducing carry weight, movement speed, and regeneration rates.
  • ⚖️ Travel Restrictions: Optional limits for maximum inventory weight, travel distances (minimum and maximum), and progressive item restriction tiers.
  • 🪨 Ashlands Stone Portal Support: Independent limits and recharge tuning for vanilla Wood Portals vs. Ashlands Stone Portals.
  • 🔒 Password Protection: Optional password authentication to secure private or faction portals.
  • 🌐 Dedicated Server Synchronization: In multiplayer, server hosts enforce gameplay rules across all connected clients, while players retain control over their personal HUD options.
  • ⚙️ Safe Defaults: All restriction systems and energy costs are disabled by default. Only the targeted destination UI and helpful HUD hints are active out of the box, preserving vanilla gameplay until you choose to configure them.

📦 Installation

Automatic (Recommended)

Install using r2modman or the Thunderstore Mod Manager with one click.

Manual

  1. Ensure both BepInExPack Valheim and Jötunn, the Valheim Library are installed.
  2. Download and extract XpandedPortal.dll into your Valheim/BepInEx/plugins/ folder.

⚙️ How It Works & Configuration

  • Upon launching the game, a configuration file is generated in BepInEx/config/.
  • Settings can be tweaked directly in the configuration file or in real-time in-game using the BepInEx Configuration Manager (F1).
  • Singleplayer: Customize every aspect of portal mechanics, UI, and restrictions to match your preferred playstyle.
  • Multiplayer: When connecting to a dedicated server or co-op host, gameplay rules and restrictions automatically synchronize from the server. Connected players cannot bypass server rules.

🧩 Compatibility

XpandedPortal is designed to work smoothly alongside most Valheim mods. However, other mods that modify the portal system may cause unintended consequences or conflicts. If using other portal mods, ensure overlapping features are disabled in their respective configs.


👏 Credits & Acknowledgments

  • Special thanks and credit to SpikeHimself for the original XPortal mod, which served as the foundation and inspiration for our targeted destination selection UI.
  • Built with BepInEx, HarmonyX, and Jötunn.

CHANGELOG

Changelog

All notable changes to XpandedPortal will be documented in this file.

[1.1.2] - 2026-11-03

Changed

  • Energy System Tuning: Synchronized energy system default enablement and balanced wood and stone base teleport costs.

Fixed

  • Teleport Sickness Duration: Consecutive portal jumps or overdraft transit now properly refresh and extend the active sickness duration.

[1.1.1] - 2026-10-29

Changed

  • Canonical GUID & Namespace Migration: Formally updated plugin GUID to com.digitalvikings.xpandedportal and namespaces to DigitalVikings.XpandedPortal.
  • Automatic Configuration Migration: Seamlessly preserves and migrates player settings from previous configuration files on first launch.

Fixed

  • Teleport Sickness Duration Refresh: Consecutive portal jumps or overdraft transit now properly refresh and extend the active sickness duration rather than retaining the original timer.

[1.1.0] - 2026-10-25

Added

  • Gear Energy Exemption: Equipped weapons, armor, and tools no longer penalize portal teleport energy.
  • Multiplayer Group Conduit: Traveling through an active portal opens a 30-second discount window for following party members with glowing rune visual cues.
  • Categorized Weight Accounting: Granular configuration toggles for food, consumable, and ammunition portal energy costs.

[1.0.0] - 2026-10-25

Added

  • Targeted Destination UI: Interactive dropdown dial-a-destination portal selection menu (inspired by XPortal).
  • Portal Energy & Recharge System: Configurable portal energy consumption scaling with carry weight and distance, with automatic equipment weight exemption.
  • Multiplayer Group Conduit: Traveling through an active portal opens a 30-second discount window for following party members with glowing rune visuals.
  • Travel Restrictions & Safety: Configurable item transport tiers, weight thresholds, transition speeds, and optional Teleportation Sickness debuff.
  • Ashlands Stone Portal & Server Sync: Native Stone Portal integration and server-enforced configuration synchronization via Jötunn.