You are viewing a potentially older version of this package. View all versions.
Rombusz-PhotonJoinFix-1.2.0 icon

PhotonJoinFix

Fixes multiple errors that would otherwise result in infinite loading times when trying to join lobbies.

Date uploaded 5 days ago
Version 1.2.0
Download link Rombusz-PhotonJoinFix-1.2.0.zip
Downloads 288
Dependency string Rombusz-PhotonJoinFix-1.2.0

This mod requires the following mods to function

BepInEx-BepInExPack_PEAK-5.4.75301 icon
BepInEx-BepInExPack_PEAK

BepInEx pack for PEAK. Preconfigured and ready to use.

Preferred version: 5.4.75301

README

PhotonJoinFix

Host and client side protections against late join failures caused by conflicting Photon IDs or an expedition map bundle that has not been loaded on the joining client.

The mod can be used both host and client side, however host sidedly it only fixes half of the problems. Sadly the expedition map bundle loading can only be fixed locally, so for full protection I recommend you download the mod yourself, instead of relying on the host having it.

These protections target the specific cases I mentioned. I do not guarantee that this mod will fix unrelated loading, connection, or late join problems.

What it does

As host:

  • Before leaving the airport for an expedition, PhotonJoinFix removes eligible, runtime spawned room items from the airport and Photon’s room cache. Reloading the airport recreates its normal props.

As client:

  • PhotonJoinFix rejects a runtime instantiation event if its Photon IDs would replace a local static scene object. It also protects that exact scene object from subsequent network destroy events until the scene unloads.
  • PhotonJoinFix ensures that the correct map bundle is loaded in upon joining a game, in order to load in the required expedition scene.

Bug reports and support

https://rombusz.dev/contacts/bug-report/

CHANGELOG

Changelog

[1.3.0] - 2026.11.02

  • Fixed room code joins bypassing map bundle preparation while Photon is still joining the room. (Bug report: Kiki)
  • Required map bundles are now always requested before loading an expedition scene.
  • Added verification to check whether the loaded bundle contains the requested scene.

[1.2.0] - 2026.10.30

  • Fixed a method naming collision preventing the new asset bundle loading fix to work.

[1.1.0] - 2026.10.28

  • Fixed a new, previously unknown issue, which caused players infinite loading screens when they attempted joining lobbies.
    (This was caused by clients being unable to load scenes that are outside of their currently loaded asset bundles. This mod forces the client to load in the requested expedition map's asset bundle first, before Photon attempts to load its scene.)

[1.0.0] - 2026.10.26

  • Initial release.