SpikeHimself-XPortal icon


Select portal destination from a list of existing portals. No more tag pairing, and no more portal hubs! XPortal is a complete rewrite of the popular mod AnyPortal.

Last updated 2 weeks ago
Total downloads 63076
Total rating 16 
Categories Misc Mistlands Update Utility Hildir's Request Update Mods Language
Dependency string SpikeHimself-XPortal-1.2.17
Dependants 147 other mods depend on this mod

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2105 icon

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

Preferred version: 5.4.2105
ValheimModding-Jotunn-2.12.7 icon

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.12.7



An AnyPortal revamp.


XPortal lets you select a portal destination from a list of existing portals.

No more tag pairing, and no more portal hubs!


Select a destination

When interacting with a portal, instead of entering a tag which has to match another portal's, XPortal lets you choose the portal's destination from a list. For your convenience, this list also shows you how far away the portals are.

Default destination

A Portal can be marked as the "Default Portal". When a Default Portal has been set, all newly built portals will immediately connect with that portal, without you having to go into the portal configuration panel.

Longer names

XPortal completely removes the character length restriction on portal names, so that you can give your portals clear and descriptive titles.

Ping a portal location

Forgot where you put your portal? You don't need to teleport to it to find out. Just click the Ping button next to the list, and XPortal will show the selected portal on your map, while also pinging its location to all players on the server.

If you prefer to play without a map, this button can be hidden, either by using the nomap global key, or by setting PingMapDisabled to True.


XPortal has been built with multiplayer support at its core. All players must run the same version of XPortal. If you play on a dedicated server, that too needs to have same version of XPortal installed.

Gamepad support

The XPortal UI will respond to gamepad input when configuring your portal. As of v1.2.10 it even shows you the gamepad keyhints!

The controls are as follows:

  • A / Cross - Submit (i.e. press the OK button)
  • B/ Circle - Cancel
  • Y / Triangle - Ping the selected portal
  • X / Square - Show/hide the contents of the dropdown
  • D-Pad Up / D-Pad Down - Select the previous / next item in the dropdown

Mod compatibility and integration

XPortal has been made fully compatible with the following mods:

Furthermore, XPortal has a configuration option to fully integrate with Advanced Portals. If you set DisplayPortalColour to True, each portal in XPortal's dropdown list will be prepended by a ">>" tag that has the same colour as the light that the portal emits. As of v1.2.10, Stone Portals also get their own colour!

XPortal is known to be fully incompatible with:


XPortal's config file, which can be found at Valheim\BepInEx\config\yay.spikehimself.xportal.cfg, contains the following settings:


Disable the Ping Map button completely. For players who wish to play without a map. This setting is enforced (but not overwritten) by the server.


Show a coloured ">>" tag in the list of portals to indicate the portal type (integration with Advanced Portals and Stone Portal).


Since XPortal is essentially a cheat, in that you only need half the amount of portals now, this setting allows you to compensate for that by doubling portal costs. This setting is enforced (but not overwritten) by the server.


If you don't want to see how far away the portals in the list are, you can use this option to remove that. This setting is enforced (but not overwritten) by the server.


This configuration option exists to save your personal Default Portal. Its value will be set by checking the Default Portal checkbox on the portal configuration panel. This value should not be manually edited in the file.

Installation instructions

XPortal is a BepInEx plugin. As such, you must have BepInEx installed. Most other Valheim mods are also BepInEx plugins, so chances are you already have this.

XPortal makes use of the Jotunn library, so you must install that before installing XPortal. If you do not install Jotunn, XPortal will simply not be loaded by your game and it will not work.

I very strongly recommend using a mod manager such as Vortex or r2modman. They will take care of everything for you and you don't have to worry about which files go where. I recommend against manual installation.

  1. Make sure you have BepInEx installed.
  2. Install Jotunn.
  3. On Nexus Mods click 'Mod manager download', or on Thunderstore click 'Install with Mod Manager'.

To install XPortal on a dedicated server, copy all of the contents of the plugins\ directory found inside the .zip file download to the Valheim\BepInEx\plugins\ directory on your server.

Bugs, Feature Requests and Translations

First of all, before you report a bug, please make sure that the problem you are experiencing is actually caused by XPortal. If you are running other mods, disable those, and see if the problem goes away. Or the other way around: disable XPortal, and see if that makes the problem go away. If you discover that XPortal is incompatible with another mod, please do report that, because I might be able to create work-arounds for that. If you are not sure, or you are struggling with these steps, then just report the problem, and we'll go from there.

It is important to me that I can make XPortal as bug-free as possible, but please bear in mind that without your LogOutput.log, I will not be able to debug your issue at all. Just showing me a screenshot of an error is not enough for me to discover the cause of that error.

To report a bug, please navigate to the Issues page, click New issue, choose Bug report, and fill out the template.

For feature requests, choose Feature request on the New issue page.

To add a translation to XPortal, choose Translation when submitting a New issue.


  • sweetgiorni for creating AnyPortal
  • kaiqueknup for translating to Brazillian Portuguese
  • makou for translating to French, Spanish
  • Smok3y97 for translating to German
  • MexExe for translating to Polish, Russian
  • hanawa07 for translating to Korean
  • bonesbro for adding a colour for Stone Portals (#39)
  • VasariRulez for translating to Italian

I did more too!

Please have a look at my other mod too! XStorage lets you open multiple chests at once, rename them, and move items/stacks to the most suitable chest.


v1.2.17 (2023-09-12)

  • v1.2.17 is a hotfix to v1.2.16

  • Fix a bug where the world file would fail to load (v1.2.17)

  • Add Default Portal checkbox on the portal configuration panel (v1.2.16)

  • Add config option HidePortalDistance which can be used to remove the distance indicator from the list of portals (v1.2.16)

  • Fix bug where sometimes portals would (still) not reconnect (v1.2.16)

  • Fix Dutch translation (v1.2.16)

Click to view previous versions
  • v1.2.16 (2023-09-11)

    • Add Default Portal checkbox on the portal configuration panel

    • Add config option HidePortalDistance which can be used to remove the distance indicator from the list of portals

    • Fix bug where sometimes portals would (still) not reconnect

    • Fix Dutch translation

  • v1.2.15 (2023-09-01)

    • Block game input when configuring portal

    • Restore portal connections between sessions (for real this time)

    • Update Jotunn 2.12.7

  • v1.2.14 (2023-08-26)

    • Update Jotun 2.12.6
  • v1.2.13 (2023-06-17)

    • v1.2.13 is a hotfix to v1.2.12

    • Remember portal connections between sessions (v1.2.12)

    • Fix a crash related to placing items or using the hoe (v1.2.12)

    • Jotunn update 2.12.1 (v1.2.12)

    • Revert MonoMod dependencies (hotfixed in v1.2.13)

  • v1.2.11 (2023-06-13)

    • Add translation to Italian

    • Update Jotun 2.12.0, BepInEx 5.4.2105

    • Fix portals not connecting after game update 0.216.9

  • v1.2.10 (2023-04-02)

    • Improved gamepad support: the XPortal configuration panel now shows gamepad keyhints!

    • Give Stone Portals their own colour (thanks bonesbro!)

    • Fix path separators in XPortal release archive

    • Show portal colour tag on hover

    • Fix crash when destroying a portal that XPortal doesn't know of

    • Jotunn update 2.11.2, BepInEx update 5.4.2102

    • Some portal sync optimisations

    • Improved logging

  • v1.2.9 (2023-03-23)

    • Fix Ping button not working (attempt #2)
  • v1.2.8 (2023-03-22)

    • Add config option DoublePortalCosts which doubles the costs of a portal when enabled

    • Fix Ping button not working after a recent Valheim update

    • Add server installation instructions to documentation

    • Add Configuration section to documentation

  • v1.2.7 (2023-03-14)

    • Dependency updates: BepInEx 5.4.21, Jotunn 2.11.0

    • Some fixes towards further Advanced Portals compatibility

    • Fix a HarmonyX warning that occurs when loading XPortal

    • Fix error that sometimes appears when logging out or quitting the game

  • v1.2.6 (2023-03-05)

    • XPortal is now marked as incompatible with AnyPortal: if you have AnyPortal installed, XPortal will not work

    • Config option added: DisplayPortalColour. Enabling this will display a coloured tag in portal list (integration with Advanced Portals by Randy Knapp)

    • Documentation overhaul (readmes are now fully modular -- if you're a mod author, check this out on GitHub!)

    • Improved logging

  • v1.2.5 (2023-02-15)

    • Hide the Ping Map button when the nomap global key is set (you can do this by typing nomap in the console).

    • The PingMapDisabled config option is now enforced by the server. If the server has this set to true, the Ping Map button will be hidden, regardless of your own settings.

    • Add sync support for the stone portal object. This fixes a compatibility issue with the mod Stone Portal.

  • v1.2.4 (2023-02-13)

    • Add translation to Korean.

    • Items in the dropdown no longer overlap each other.

    • Items in the dropdown are now highlighted when you hover over them.

    • Added configuration option PingMapDisabled which disables the ability to ping portals in the list. By default the Ping Map button remains enabled.

    • Various code optimisations.

  • v1.2.3 (2023-02-09)

    • Add support for Nexus Update Check

    • Minor UI modifications to accomodate longer translations.

    • Added translations for Polish and Russian.

    • Updated description/readme.

    • Code cleanup and minor bugfixes.

  • v1.2.2 (2023-02-06)

    • Fixed "Fetching portal info.." bug.

    • Non-placeable world items (such as wild beehives) can now be destroyed again.

    • It is no longer possible to configure a portal that is being protected by someone else's ward.

  • v1.2.1 (2023-02-05)

    • Translation added for Spanish

    • Added BepInEx dependency, updated Jotunn dependency to 2.10.4.

    • Detect portal placement and destruction.

    • Optimise portal hovering event, UI interaction, and resyncs.

    • Update console log messages.

    • Some bugfixes

  • v1.2.0 (2023-02-03)

    • Fix portals disappearing from the dropdown.

    • Fix portals sometimes duplicating.

  • v1.1.0 (2023-02-03)

    • Controller support!

    • Translations added for French, Portuguese (BR), German.

  • v1.0.1 (2023-02-01)

    • Improvements for dedicated servers.

    • Fix a bug that stopped XPortal showing the UI after destroying a portal.

  • v1.0.0 (2023-02-01)

    • Initial release.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2023-9-11 1.2.17 4355 Version 1.2.17 Install
2023-9-11 1.2.16 352 Version 1.2.16 Install
2023-9-1 1.2.15 3416 Version 1.2.15 Install
2023-8-26 1.2.14 2758 Version 1.2.14 Install
2023-6-17 1.2.13 10802 Version 1.2.13 Install
2023-6-17 1.2.12 142 Version 1.2.12 Install
2023-6-13 1.2.11 1580 Version 1.2.11 Install
2023-4-2 1.2.10 12264 Version 1.2.10 Install
2023-3-23 1.2.9 4745 Version 1.2.9 Install
2023-3-22 1.2.8 939 Version 1.2.8 Install
2023-3-14 1.2.7 3556 Version 1.2.7 Install
2023-3-5 1.2.6 3807 Version 1.2.6 Install
2023-2-15 1.2.5 5122 Version 1.2.5 Install
2023-2-13 1.2.4 1656 Version 1.2.4 Install
2023-2-9 1.2.3 2356 Version 1.2.3 Install
2023-2-6 1.2.2 1740 Version 1.2.2 Install
2023-2-5 1.2.1 825 Version 1.2.1 Install
2023-2-3 1.2.0 1037 Version 1.2.0 Install
2023-2-3 1.1.0 683 Version 1.1.0 Install
2023-2-1 1.0.1 701 Version 1.0.1 Install
2023-1-31 1.0.0 240 Version 1.0.0 Install