Wayfarer Recall

Controls

Wayfarer Recall keeps the keyboard controls simple:

• O — Open the Port to Player menu and can be changed in the config.
• Cursor Key — Temporarily free the mouse cursor so you can click the gold compass rose beside the minimap. Defaults to Left Alt and can be changed in the config.

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 and Cursor Key can be changed in MaddCatter365.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 the configured Cursor Key to free the cursor and click the gold compass rose beside the minimap. The default Cursor Key is Left Alt, and it can be rebound in the configuration.

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.

Arrival Protection

Wayfarer Recall provides temporary arrival protection for teleports successfully initiated by the mod.

Protection begins when Valheim accepts the Wayfarer teleport and remains active through the native teleport and loading period. Once loading has cleared, protection continues for up to 5 additional seconds so the player has a chance to regain control.

A new accepted Block or Dodge ends the post-loading protection early. If Block is already being held during teleport or loading, it does not immediately consume protection; it must first be released and pressed again.

Arrival protection prevents incoming damage to the local player during this vulnerable period. It does not alter enemy AI, aggro, targeting, or normal combat behavior.

A separate 30-second real-time hard failsafe prevents arrival protection from remaining active indefinitely.

Installation

The normal settings are written to BepInEx/config/MaddCatter365.WayfarerRecall.cfg. Saved destinations are kept separately in MaddCatter365.WayfarerRecall.state.cfg and are isolated by character and world. Arrival-protection diagnostics are available through Diagnostics.Enabled. Diagnostics are disabled by default and do not affect arrival-protection behavior.

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.3.0 has been built and tested with Valheim 1.0.21 and BepInExPack Valheim 5.4.2360.

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 MaddCatter365 mod-support channel.

License

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