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 an unknown server.
• Remembers problematic GameServer IPs for the player's current network and skips known bad addresses immediately on later connections.
• The first connections may take noticeably longer while PEAK Pathfinder learns which Photon servers are stable through the player's ISP/network.
• As the local history grows, this mode can become significantly faster — and in some cases connections can become practically instant, because already-known bad servers are rejected without waiting for another timeout.
• A whole /24 range is only promoted to BAD after 4 distinct currently-BAD IPs in that range and no currently-GOOD IP there.

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.

This solution helps in most cases of this kind, 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.

How to use

UDP Server Selection

1. Select UDP Server Selection in PEAK Pathfinder.
2. Start an online game normally.
3. Then simply wait while PEAK Pathfinder checks the assigned Photon GameServers.

During the first connections, a game session may successfully start and then disconnect a few seconds later. PEAK Pathfinder can then automatically return and begin another connection attempt with a different GameServer.

This is normal behavior. Do not restart PEAK and do not keep starting the connection manually — just wait. The game itself is not being restarted; only the current online session/connection attempt may end and a new attempt may begin automatically.

An unknown server is checked for up to 60 seconds. If it proves unstable, Pathfinder remembers it and continues with another attempt. Once the current server passes the stability check, continue playing normally.

The first search for a stable server may take a while and may require several attempts. This is normal.

Over time PEAK Pathfinder learns the problematic servers for your network and rejects them immediately. Later connections can become significantly faster — and in some cases practically instant.

Secure WSS/443

1. Select Secure WSS/443.
2. Start an online game normally.
3. PEAK Pathfinder will use Photon over secure WSS/TCP/TLS port 443 instead of the normal UDP GameServer path.

This mode does not scan UDP GameServers or build the UDP BAD-server history, so you do not need to wait for several UDP retry attempts.

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 для вашей сети и при следующих подключениях сразу пропускает уже известные плохие адреса.
• Первые подключения могут занимать заметно больше времени, пока PEAK Pathfinder определяет, какие Photon-серверы стабильно работают именно через вашего провайдера/сеть.
• По мере накопления результатов работа режима может значительно ускориться — а в некоторых случаях подключение станет практически мгновенным, потому что уже известные проблемные серверы будут отбрасываться сразу, без повторного ожидания таймаута.
• Вся подсеть /24 помечается BAD только после 4 разных IP с актуальным статусом BAD и при отсутствии актуального GOOD-IP в этой подсети.

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

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

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

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

Как пользоваться

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

1. Выберите режим «Подбор UDP-серверов».
2. Запустите сетевую игру как обычно.
3. После этого просто ждите, пока PEAK Pathfinder проверяет назначаемые Photon GameServer.

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

Это нормальная работа режима. Не перезапускайте PEAK и не запускайте подключение заново вручную — просто ждите. Сама игра PEAK не перезапускается: завершиться может только текущая сетевая сессия/попытка подключения, после чего новая попытка начнётся автоматически.

Неизвестный сервер проверяется до 60 секунд. Если он окажется нестабильным, Pathfinder запомнит его и перейдёт к следующей попытке. Когда текущий сервер успешно пройдёт проверку стабильности, можно продолжать играть как обычно.

Первый поиск стабильного сервера может занять заметное время и потребовать нескольких попыток. Это нормально.

Со временем PEAK Pathfinder накопит информацию о проблемных серверах вашей сети и будет отбрасывать их сразу. Благодаря этому последующие подключения могут происходить значительно быстрее — а в некоторых случаях практически мгновенно.

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

1. Выберите режим «Защищённое соединение (WSS/443)».
2. Запустите сетевую игру как обычно.
3. PEAK Pathfinder будет использовать защищённое соединение Photon через WSS/TCP/TLS порт 443 вместо обычного UDP-маршрута GameServer.

В этом режиме UDP GameServer не перебираются и база проблемных UDP-серверов не обучается, поэтому ждать нескольких попыток UDP-подключения не требуется.

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

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

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.