Wayfarer Recall

Controls

Wayfarer Recall keeps the keyboard controls simple:

• O — Open the Port to Player menu.
• Left Alt — Temporarily free the mouse cursor so you can click the gold compass rose beside the minimap.

The Port to Player menu also provides dedicated recall buttons:

• House — Return to Spawn
• Target — Last Location
• Boat — Last Boat
• Maltese Cross — Last Death

Last Location cycles through your two most recently saved non-boat departure locations when both are available.

The O player-menu hotkey can be changed in MaddCatter.WayfarerRecall.cfg.

Carried metals, ore, and other inventory contents do not prevent recall.

Player Travel

Press O to open the Port to Player menu, or hold Left Alt to free the cursor and click the gold compass rose beside the minimap. The menu uses Valheim's own panel, button, and font styles. The drop-down lists every other character currently connected to the server and refreshes while it is open. When nobody else is connected, the menu still opens with an empty player list.

Valheim's public-position choice is respected. A player who is sharing their map position can be selected as a destination. A player who has hidden their position remains visible in the list as location hidden, but cannot be used as a destination.

Player travel arrives beside the selected character's latest shared position with a small amount of vertical clearance. The departure point is added to the two locations used by Last Location, unless the traveler leaves from a boat.

Pressing Escape while the Port to Player menu is open closes Wayfarer Recall first. Press Escape again to open Valheim's normal pause menu.

Installation

Install with r2modman/Thunderstore Mod Manager, or place WayfarerRecall.dll in BepInEx/plugins/WayfarerRecall/.

The normal settings are written to BepInEx/config/MaddCatter.WayfarerRecall.cfg. Saved destinations are kept separately in MaddCatter.WayfarerRecall.state.cfg and are isolated by character and world.

Notifications

The default notification mode is ErrorsOnly. Successful recalls remain unobtrusive, while missing destinations, cooldowns, unavailable boats, and unexpected failures appear as high-luminance warm text with a thick black outline. The contrast remains readable without relying on color differentiation.

Notifications.Mode can be changed to All or Off in the configuration file. Display time is configurable with Notifications.DurationSeconds.

Boat Behavior

The most recent boat occupied by the local player is remembered. If the boat is loaded, recall selects a position above its main hull collider near the vessel's center and slightly to one side of the mast. If it is unloaded, recall uses its live ZDO position and places the player above it while the area loads.

Using Return to Spawn or Port to Player while aboard a boat remembers the vessel but does not replace the ordinary locations used by Last Location.

Compatibility

Wayfarer Recall 1.2.0 has been built and tested with Valheim 1.0.16 and BepInExPack Valheim 5.4.2351.

The mod is built against the current Valheim managed assemblies used during development and testing. Multiplayer testing has also been performed with another player connected.

Wayfarer Recall is a client-side mod. Each player who wants to use its features should install it locally; the server does not need a separate Wayfarer Recall installation. Future Valheim updates may require compatibility testing before they can be considered supported.

Things Being Tested

A rare multiplayer boat-state anomaly is still being watched. During testing, Valheim has occasionally reported an unexpected extra player aboard a vessel even though only two real players were connected. A visible duplicate-player effect was observed during an earlier raft test, but it has not been consistently reproducible.

If you encounter a duplicate player, unusual boat recall, or another repeatable multiplayer issue, please report what happened and include your BepInEx log if possible.

Independent Implementation

Wayfarer Recall is an independently written, clean-room implementation based on desired behavior and in-game observation. It contains no code, assets, identifiers, or configuration from PersonalTeleports.

The original PersonalTeleports mod by DeadMoroz inspired the familiar recall workflow: https://thunderstore.io/c/valheim/p/DeadMoroz/PersonalTeleports/

Support

For questions, bug reports, or compatibility feedback, visit the MaddCatter mod-support channel.

License

Wayfarer Recall is released under the MaddCatter Noncommercial Mod License. See LICENSE.md for the full terms.

Changelog

1.2.0

• Moved the gold Port to Player compass from the inventory interface to beside the minimap.
• Added Left Alt cursor access for clicking the minimap compass without opening another menu.
• Redesigned the Port to Player panel with Valheim-style UI elements and dedicated Spawn, Last Location, Last Boat, and Last Death recall buttons.
• Removed the separate P, L, K, and B recall hotkeys; those recall actions are now accessed through the Port to Player menu.
• Added native-style tooltips to the new recall controls.
• Improved menu input handling so gameplay clicks do not pass through while using the Port to Player interface.
• Made Escape close the Wayfarer Recall player menu before opening Valheim's normal pause menu.
• Improved persistent Last Boat identification and recovery after boats move or the game is restarted.
• Adjusted Port to Player arrivals so travelers appear beside the selected player instead of directly on top of them.
• Improved native font handling and cleaned up generated UI resources.

1.1.2

• Moved the inventory player-travel control off the Craft/Upgrade panel.
• Added a compact gold compass-rose button beside Valheim's PvP crossed-swords control in the upper Skills/Trophies window.
• Added a native Port to Player tooltip when Valheim's corresponding tooltip component is available.
• Updated Player Travel.InterfaceVersion to 3 for installation verification.

1.1.1

• Rebuilt the player-travel interface from Valheim's native inventory panel, button, and font styles.
• Attached the Port button to the Craft/Upgrade header instead of drawing a floating screen overlay.
• Made the O hotkey open the player menu even when no other players are connected.
• Added an explicit empty-player-list state.
• Added Player Travel.InterfaceVersion = 2 as a configuration marker for the native interface.
• Added unmistakable BepInEx startup and UI-attachment log lines for version verification.

1.1.0

• Added a configurable O hotkey that opens the Port to Player menu.
• Added an optional Port to Player button while the inventory is open.
• Added a drop-down list of every other connected character.
• Added travel to players who are sharing their Valheim map position.
• Kept hidden player positions private and visibly marked them as unavailable.
• Added player-travel departures to the existing L return-location cycle unless leaving a boat.

1.0.2

• Added the MaddCatter Discord support channel to the package metadata and documentation.
• No gameplay behavior changed in this release.

1.0.1

• Changed the default notification mode to errors only.
• Replaced ordinary center-screen messages with a high-contrast notification renderer.
• Added pale high-luminance text with a thick black outline for color-accessible readability.
• Added configurable ErrorsOnly, All, and Off notification modes.
• Added a configurable notification duration.

1.0.0

• Initial clean-room release.
• Added configurable P/L/K/B recall controls.
• Added two persistent return locations per character and world.
• Added last-death recall using Valheim's saved character data.
• Added persistent last-boat tracking with live ZDO resolution.
• Added safer above-deck boat arrival behavior.
• Allowed recall while carrying all inventory item types.