You are viewing a potentially older version of this package. View all versions.
SpikeHimself-XPortal-1.0.1 icon

XPortal

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.

Date uploaded a year ago
Version 1.0.1
Download link SpikeHimself-XPortal-1.0.1.zip
Downloads 747
Dependency string SpikeHimself-XPortal-1.0.1

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2200 icon
denikson-BepInExPack_Valheim

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

Preferred version: 5.4.2200
ValheimModding-Jotunn-2.20.0 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.0

README

XPortal

An AnyPortal revamp.

Description

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

No more tag pairing, and no more portal hubs!

Features

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.

The "edit tag" window has been replaced by XPortal's own configuration window. You can now enter a Name and choose a Destination. Portal connections can now be one-way. In other words, you can go from portal A to portal B, all while portal B might be connected to portal C, or not even connected at all!

For your convenience, the list also shows you how far away the portals are.

Ping a portal location

Forgot where you put your portal? You don't need to go through it to find out. Just press 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.

Multiplayer

XPortal has been built with multiplayer support at its core. This does require all players on the server to run the same version of XPortal. This server itself also needs to have XPortal installed and that too has to be same version.

Bugs, Issues, Feature Requests

To report problems or provide feedback, please use the project's GitHub Issues page. If you are experiencing a bug, please include the BepinEx output log and provide as many details as possible.

Improvements over AnyPortal

As mentioned earlier, XPortal is a rewrite of the popular AnyPortal mod. Most players won't necessarily notice much difference, bar a few bugfixes. Under the hood, though, XPortal takes a completely different approach to portal updates. Also, the UI was completely overhauled.

Here are the most prominent changes:

  • New UI: AnyPortal built its UI incorporating the existing "edit tag" window. XPortal doesn't use the original "edit tag" window at all.

  • Robust network synchronisation: AnyPortal updates the information on your screen when you interact with a portal. XPortal updates all portal information at the very moment that any portal is changed, even when someone else does it.

  • Smaller file: XPortal uses Jötunn's UI elements, so it no longer needs its own Unity assets.

  • Code optimisation: The way AnyPortal dealt with portal tags and targets has been overhauled. XPortal keeps its own list and keeps that updated when any portal changes name or destination. Because of this, it will not have to query game data every time you interact with a portal.

  • Scalability: You won't notice this in your game, but the way XPortal's code is organised should make it much easier to maintain. So when a Valheim update breaks everything, it shouldn't be too hard for me to get things up and running again. XPortal is also ready to deal with any feature requests that you might have. If you are interested in XPortal's code, you are welcome to visit the project's GitHub page!

Changelog

  • v1.0.0 (2023-02-01)

    • Initial release
  • v1.0.1 (2023-02-01)

    • Improvements for dedicated servers

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

Credits


CHANGELOG

v1.2.21 (2024-05-19)

  • Update Jotunn 2.20.0
  • Minor translation fixes
  • Add translation to Chinese
Click to view previous versions
  • v1.2.20 (2023-12-15)

    • Update Jotunn 2.15.2
  • v1.2.19 (2023-11-07)

    • Fix bug where a client's portals would not connect to their Default Portal

    • Fix bug where Portal Configuration Panel would not open after latest game update

    • Update Jotunn v2.14.6

  • v1.2.18 (2023-10-13)

    • Completely skip vanilla portal connection behaviour

    • Fix bug that causes world not to load after Valheim update 0.217.22

    • Update Jotunn v2.14.4, BepInEx v5.4.2200

  • 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)

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