Does Photon PUN OfflineMode accurately simulate live matchmaking callbacks?

Answer to the core question

Photon Unity Networking’s PhotonNetwork.OfflineMode does not fully reproduce the callback sequence that you would see when connected to a real Photon Cloud instance. It simulates only the basic connection and room‑joining callbacks that are driven locally by the client, but it skips the server‑side matchmaking logic that generates OnMatchList, OnJoinRandomFailed, and OnJoinRandomSuccess events.

Confirmed facts

• When OfflineMode is enabled, OnConnectedToMaster and OnJoinedRoom are invoked just as they would be in a live session.
• Matchmaking‑specific callbacks are never fired while OfflineMode is active because the client never contacts a Photon server.
• Region selection logic is bypassed; the client uses the local machine’s network stack and does not query region servers.
• Event ordering for callbacks that are locally generated remains deterministic, but any latency or packet‑loss simulation that exists in a real network is absent.

Likely explanation for observed behavior

The OfflineMode flag instructs the Photon runtime to skip all network I/O. Room creation and join operations are handled internally by the client’s local lobby manager, which immediately triggers the relevant callbacks. Because matchmaking is a server‑side operation that requires querying a matchmaking queue or a lobby service, the client cannot generate those callbacks without an active connection.

Practical steps for unit tests that rely on matchmaking callbacks

1. Set PhotonNetwork.OfflineMode = true before calling PhotonNetwork.ConnectUsingSettings().
2. Register listeners for OnConnectedToMaster and OnJoinedRoom as usual.
3. Call PhotonNetwork.CreateRoom("TestRoom") or PhotonNetwork.JoinRoom("TestRoom") – the callbacks will fire immediately.
4. If your test needs to verify matchmaking logic, run the same test with OfflineMode = false and a valid AppId. Observe that OnMatchList, OnJoinRandomFailed, and OnJoinRandomSuccess are now invoked.
5. Use the results from the live run to assert the expected sequence and data in your unit test.

What to ask next

To refine this recommendation for your project, could you confirm which Photon PUN version you are targeting? Different minor releases may contain subtle changes to the OfflineMode implementation.

Common pitfalls

• Assuming that OnMatchList will fire in OfflineMode – it never will.
• Expecting region‑based latency simulation while OfflineMode is on – there is none.
• Using OfflineMode to test security rules such as room password enforcement – those checks are performed server‑side and will not be exercised.