PEAK Pathfinder

PEAK Pathfinder is a free client-side connection helper for PEAK. It is intended for players who can reach Photon services but have unstable or blocked connections to Photon GameServers.

Other players in the lobby do not need to install the mod.

Connection modes

UDP Server Selection

Keeps the main Photon game connection on UDP for the lowest practical latency.

• Checks the Photon GameServer assigned to the player.
• Uses a 60-second stability check for unknown servers.
• Learns problematic GameServer IPs on this player's own network.
• Skips known bad addresses on later launches.
• A fresh installation starts with an empty blacklist; no player-specific bad IP list is shipped with the mod.
• A whole /24 range is only promoted to BAD after 4 distinct currently-BAD IPs in that range and no currently-GOOD IP there.

The first few sessions can take longer while the local database learns the routes available through the player's ISP/network. Over time, known bad routes can be rejected immediately.

Secure WSS/443

Uses Photon's secure WebSocket connection over TCP/TLS port 443 instead of the normal UDP GameServer path. This mode is intended for networks or ISPs where Photon UDP is blocked, filtered, or unstable.

It often works in situations where UDP does not, but it may noticeably increase ping.

PEAK Pathfinder is not a VPN or proxy: this mode still connects to Photon, only using WSS/443 as the transport.

Local data

PEAK Pathfinder stores its learned server history locally in:

BepInEx/plugins/PeakPathfinder/data/

Files:

• bad_servers.txt — problematic addresses/prefixes.
• udp_server_results.csv — server check history.

The in-game Open data folder button opens this directory directly.

Installation

Thunderstore / r2modman

Install PEAK Pathfinder with a Thunderstore-compatible mod manager. BepInExPack_PEAK is declared as a dependency and will be installed automatically if needed.

Manual

1. Install BepInExPack_PEAK.
2. Open the downloaded PEAK Pathfinder archive.
3. Open the plugins folder inside the archive.
4. Copy the PeakPathfinder folder to:

PEAK/BepInEx/plugins/

The final path should be:

PEAK/BepInEx/plugins/PeakPathfinder/PeakPathfinder.dll

Support

PEAK Pathfinder is completely free. If the mod helped you and you would like to support continued development, tips are optional:

Support PEAK Pathfinder on Boosty

Support is completely voluntary and does not affect how the mod works.

Disclaimer

PEAK Pathfinder is an independent fan-made project and is not an official PEAK mod. The author is not a representative, employee, or partner of the developers of PEAK, Landfall, or Photon.

PEAK Pathfinder — на русском

PEAK Pathfinder — бесплатный клиентский мод для PEAK, помогающий при проблемах подключения к Photon GameServer.

Другим игрокам в лобби не требуется устанавливать мод.

Режимы подключения

Подбор UDP-серверов

Основное соединение Photon остаётся на UDP для минимально возможной задержки.

• Проверяет назначенный Photon GameServer.
• Для неизвестного сервера выполняет проверку стабильности в течение 60 секунд.
• Запоминает проблемные GameServer IP индивидуально для сети этого игрока.
• При следующих запусках известные плохие адреса пропускаются сразу.
• На чистой установке чёрный список пуст — чужая база плохих IP вместе с модом не поставляется.
• Вся подсеть /24 помечается BAD только после 4 разных IP с актуальным статусом BAD и при отсутствии актуального GOOD-IP в этой подсети.

Первые запуски могут занимать больше времени, пока локальная база обучается на маршрутах конкретного провайдера. По мере накопления истории известные плохие маршруты отбрасываются сразу.

Защищённое соединение WSS/443

Использует защищённое WebSocket-соединение Photon через TCP/TLS порт 443 вместо обычного UDP-маршрута GameServer. Режим предназначен для случаев, когда UDP Photon блокируется, фильтруется или работает нестабильно.

Такое решение часто помогает там, где UDP не работает, однако может заметно повысить пинг.

PEAK Pathfinder не является VPN или прокси: соединение по-прежнему идёт к Photon, меняется только транспорт на WSS/443.

Локальные данные

История проверок хранится локально в:

BepInEx/plugins/PeakPathfinder/data/

• bad_servers.txt — проблемные адреса/подсети.
• udp_server_results.csv — история проверок серверов.

Кнопка «Открыть папку с файлами» в моде открывает эту папку напрямую.

Установка

Thunderstore / r2modman

Установите PEAK Pathfinder через совместимый с Thunderstore менеджер модов. BepInExPack_PEAK указан как зависимость и при необходимости установится автоматически.

Вручную

1. Установите BepInExPack_PEAK.
2. Откройте скачанный архив PEAK Pathfinder.
3. Откройте внутри архива папку plugins.
4. Скопируйте папку PeakPathfinder в:

PEAK/BepInEx/plugins/

В итоге файл должен находиться здесь:

PEAK/BepInEx/plugins/PeakPathfinder/PeakPathfinder.dll

Поддержка

PEAK Pathfinder остаётся полностью бесплатным. Если мод вам помог и вы хотите поддержать дальнейшую разработку:

Поддержать PEAK Pathfinder на Boosty

Поддержка полностью добровольная и не влияет на работу мода.

Дисклеймер

PEAK Pathfinder — независимый фанатский проект и не является официальным модом PEAK. Автор не является представителем, сотрудником или партнёром разработчиков PEAK, Landfall или Photon.

Changelog

0.6.10

• Reworked the Photon Voice WSS switch after runtime logs from v0.6.9 showed that changing the Voice peer plus a cloned low-level AppSettings argument still allowed the actual PhotonPeer.Connect to be rebuilt as UDP.
• Pathfinder now prepares Voice WSS earlier at Photon.Voice.Unity.VoiceConnection.ConnectUsingSettings by giving Voice its own private settings clone with Protocol=WebSocketSecure and Port=443.
• Voice transport constructors that expose a ConnectionProtocol argument are also requested as WebSocketSecure, so the Voice peer starts with the intended transport instead of the default UDP transport.
• Immediately before the real Realtime ConnectUsingSettings, Pathfinder temporarily changes the exact AppSettings instance Photon is about to read to WebSocketSecure/443, then restores the temporary values after the call.
• Added explicit Voice peer tracking to diagnostics. Runtime logs now label actual low-level connects as VOICE PhotonPeer.Connect or MAIN/OTHER PhotonPeer.Connect and report an error if a registered Voice peer still reaches PhotonPeer.Connect as UDP.
• The old broad v0.6.6 overrides remain disabled: no Voice ServerPortOverrides, no Voice fallback rewrite, and no manual Master/GameServer address substitution.
• UDP Server Selection is still intended to keep MAIN on UDP while Voice uses WSS/443; Secure mode keeps both MAIN and Voice on WSS/443.
• Multiplayer runtime testing confirmed actual VOICE PhotonPeer.Connect connections over wss://...:443 with TransportProtocol=WebSocketSecure; the Voice chat issue reported in earlier versions is fixed in v0.6.10.
• Multiplayer requirement clarified: Pathfinder must be installed on every player, and all players must select the same connection mode before connecting.
• Special thanks to BlackUFA and Antell13 for reporting the Voice chat problem and helping verify the fix.

0.6.9

• Fixed the v0.6.8 pre-test Voice transport issue: changing only a cloned Voice AppSettings object did not switch the already-created Voice PhotonPeer, so actual Voice connections could remain UDP.
• Photon Voice now sets the existing Voice peer TransportProtocol=WebSocketSecure before ConnectUsingSettings, while still using a cloned Voice settings object with Protocol=WebSocketSecure and Port=443.
• The old aggressive v0.6.6 Voice overrides are still not restored: Pathfinder does not rewrite Voice ServerPortOverrides, EnableProtocolFallback, or manually replace redirected Master/GameServer addresses.
• UDP Server Selection keeps the MAIN game connection on UDP with GOOD/BAD learning/retry while Voice is requested over WSS/443.
• Secure mode keeps both MAIN and Voice on WSS/443.
• Clarified that WSS is per-player. For the supported setup when network restrictions affect Voice, Pathfinder should be installed on each affected player; a host cannot switch another player's Voice transport to WSS.
• Special thanks to BlackUFA for the original voice chat report and testing feedback.

0.6.8

• Restored Photon Voice over WSS/443 using a minimal connection-settings override.
• Voice now receives Protocol=WebSocketSecure and Port=443 on a cloned Voice ConnectUsingSettings settings object, while Photon handles the subsequent server redirects/endpoints.
• The aggressive v0.6.6 Voice overrides are not restored: Pathfinder does not rewrite Voice ServerPortOverrides, EnableProtocolFallback, the Voice client's TransportProtocol, or the existing Voice peer's TransportProtocol.
• UDP Server Selection still keeps the MAIN game connection on UDP with GOOD/BAD GameServer learning, while Voice uses WSS/443.
• Secure mode keeps both the MAIN game connection and Voice on WSS/443.
• Corrected multiplayer documentation: WSS is selected independently by each player. Enabling WSS on the host does not switch the whole Photon room to WSS; every affected player who needs WSS must enable it locally.
• Clarified that MAIN UDP GameServer selection remains host-side; players whose normal connection works can still join without Pathfinder.
• Special thanks to BlackUFA for the original voice chat report and testing feedback.

0.6.7

• Removed PEAK Pathfinder's forced WSS/443 transport override for Photon Voice.
• Voice connections and Voice port selection are now left to PEAK/Photon's default networking behavior.
• Main Photon GameServer UDP selection, retry/learning behavior, and the optional MAIN WSS/443 mode are unchanged.
• Special thanks to BlackUFA for reporting the voice chat issue and helping improve PEAK Pathfinder.

0.6.6

• Added the YouTube video demonstration link to the public README.
• No changes to the UDP retry/learning algorithm or WSS/443 transport behavior.

0.6.5

• Clarified that bad_servers.txt is a manual blacklist, while automatically learned GOOD/BAD GameServer history is stored in udp_server_results.csv.
• Updated the in-game local-data label to match the actual file behavior.
• No changes to the UDP retry/learning algorithm or WSS/443 transport behavior.

0.6.4

• Replaced direct explorer.exe process launch with Unity Application.OpenURL for opening the local data directory.
• Made pre-release data migration non-destructive: legacy data is copied/merged while the original files are left untouched.
• Reduced broad networking claims and documented the limits of the current real-world testing.
• Added explicit generative-AI disclosure.
• Added a testing-status section describing the two affected user setups used for functional testing.
• Clarified that known BAD assignments are rejected immediately, while total connection time still depends on Photon's next GameServer assignment.

0.6.3

• Reworked UDP usage documentation and added player-facing instructions for automatic retries.

0.6.2

• Updated the package icon for better readability at 256x256.

0.6.1

• Clarified manual installation instructions.

0.6.0

• Initial public release candidate.