Portal Ghost Fix

Character still standing at the old portal after teleporting? Friends see your player model left behind even though you have arrived?

Portal Ghost Fix addresses stale player ghosts after long-distance portal travel in Valheim multiplayer. It helps clients receive the player's updated position instead of retaining a character at the departure portal.

The problem this fixes

• A player model remains at the departure portal after teleporting away.
• Friends see a frozen or ghost character at the old location.
• The ghost disappears only after a delay or after nearby players move far enough away to unload the area.

These symptoms can appear as portal desync, teleport ghosting, or a character stuck at the old portal. This fix targets the case where the server has the correct position but observers retain an outdated copy.

Requirements and installation

Requires BepInExPack Valheim 5.4.2350 or later.

Install on the server only. Players do not need to install it on their clients.

1. Stop the server.
2. Install through your server mod manager, or copy the included plugins/PortalGhostFix folder into BepInEx/plugins/.
3. Restart the server.

No configuration or commands are required.

If you used the earlier Portal Observer Fix test package, remove its BepInEx/plugins/PortalObserverFix folder before installing this release. Do not keep both copies installed.

How it works

The server checks player positions every 0.25 seconds. When it detects a jump of at least 64 metres, it queues the player's existing network record for connected clients, helping observers receive the new position after the player leaves their area.

It does not move players, change ownership, delete characters, alter combat, or edit saves. It does not require a particular portal menu.

Scope

Verified in a multiplayer session against Valheim 1.0.12, where server and observer logs confirmed stale character positions after teleporting and the fix cleared the reported ghost.

This addresses long-distance teleport ghosts. It is not a general server-lag fix, and has not been verified to fix infinite portal loading, logout ghosts, or every form of multiplayer desync. Moves shorter than 64 metres are outside its detection threshold.

Removal

Stop the server, remove BepInEx/plugins/PortalGhostFix, and restart.

Created by Sfantul.