PortalGhostFix
Fixes stale player ghosts left behind at portals after long-distance teleporting in multiplayer. Server-side only; no client install needed.
模組介紹 作者原文
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.
- Stop the server.
- Install through your server mod manager, or copy the included plugins/PortalGhostFix folder into BepInEx/plugins.
- 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.
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時，主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝，否則該模組不會生效：