Skip to main content

MultiplayerService

The MultiplayerService class provides the central runtime logic for managing multiplayer game sessions using Photon Fusion in Unity. It handles player connections, scene loading, control scheme integration, and reward or item transactions through Firebase-backed orchestrators.

🧩 Overview​

public class MultiplayerService : SimulationBehaviour, INetworkRunnerCallbacks, IDependencyProvider, IInjectorReceivable

This class is injectable and globally accessible via GameServiceFactory, and orchestrates network runners, player connection management, and Fusion lifecycle hooks.

🧪 Key Components​

Properties​

  • GameServiceFactory Factory – Injected orchestrator service hub.
  • InputProvider ActiveInputProvider – Current input routing object.
  • ServerScene ActiveScene – Scene currently bound to the multiplayer session.
  • Dictionary<PlayerRef, PlayerConnectionHost> playerConnections – Player mapping.

🎮 Multiplayer Session Flow​

StartLocalPlayer(...)​

Starts a local multiplayer session.

public async Task<bool> StartLocalPlayer(ServerScene scene, string sessionName, ControlScheme controls)
  • Spawns NetworkRunner and loads addressable scenes
  • Injects input providers and state callbacks
  • Joins or creates session using Fusion.Runner.StartGame

EndCurrentSession()​

Cleans up all multiplayer session state.

  • Shuts down runner
  • Unloads scenes
  • Releases assets
  • Clears input and connection references

🕹 Input Scheme Handling​

ChangeControlScheme(...)​

Switches the active input mapping at runtime:

public bool ChangeControlScheme(ControlScheme newScheme)

Also triggers icon updates via InputIconProvider.

Input Propagation​

All input actions are piped through:

Action<InputAction, bool> InputCallback

To allow binding external systems (e.g., UI or gameplay modules) to global input.

👥 Player Management​

On Player Join/Leave​

When a player joins:

public async void OnPlayerJoined(...)
  • Instantiates a PlayerConnectionHost prefab
  • Tracks via playerConnections

On player leave:

public async void OnPlayerLeft(...)
  • Despawns player host
  • Removes from tracking

Manual registration via:

public void RegisterPlayerConnection(PlayerConnectionHost host)
public void UnregisterPlayerConnection(PlayerConnectionHost host)

🛍 Transactions and Rewards​

PurchaseItem(...)​

Purchases an in-game item through orchestrator:

public async Task<bool> PurchaseItem(TransactionalItemData_Base_SO item)

Currently supports BuildItemData.

GrantRewardsToPlayer(...)​

Grants multiple item rewards via orchestrator service:

public async Task<bool> GrantRewardsToPlayer(List<Reward> rewards)

🔐 Logout & Cleanup​

Logout()​

Cleans up network session and logs the user out of Firebase:

public async void Logout()

🔌 Dependency Injection​

Implements IInjectorReceivable and IDependencyProvider. Injected members:

  • GameServiceFactory _factory
  • InputIconProvider _iconProvider

Provides:

[Provide]
public MultiplayerService GetMultiplayerService()

🔄 Fusion Callbacks Implemented​

This class implements all INetworkRunnerCallbacks, mostly as no-ops unless specifically overridden (e.g., OnPlayerJoined).

🧠 Summary​

MultiplayerService is a comprehensive multiplayer session controller for m00m’s Unity game. It seamlessly integrates network setup, input schema, dependency injection, and Firebase-based item transactions into a single, orchestrated runtime layer.