XpandedPortal
Lots of portal configuration options: targeted destination UI (inspired by XPortal), an energy & recharge system, travel restrictions, and server sync.
About this mod Author’s original text
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 Mod Manager with one click.
Manual
- Ensure both BepInExPack Valheim and Jötunn, the Valheim Library are installed.
- 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.
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: