Skip to main content

About Multiplayer Play Mode (MPPM)

You can use Multiplayer Play Mode (MPPM) to test multiplayer functionality within the Unity Editor. You can simulate up to four users (the main Editor Player and three Virtual Players) simultaneously on the same development device while using the same source assets on disk. MPPM can help you create multiplayer development workflows that reduce project build times, run it locally, and test the server-client relationship.

MPPM Terminology

The following have specific meaning in relation to MPPM:

Main Editor Player: The original instance of the project in the Unity Editor. This is the only instance with full authoring capabilities. Virtual Players: Simulated Players created with MPPM. These Players open in a separate window with limited authoring capabilities when you enter Play mode. Players: All Player instances, including the main Editor Player and all Virtual Players.

Limitations

MPPM has some inherent technical limitations, specifically around scale and authoring.

Scale

The Unity Editor and Virtual Players require a lot of system resources, so you shouldn't use Multiplayer Play Mode (MPPM) at scale. MPPM is designed for small-scale, local testing environments that can only support up to 4 total Players (the main Editor Player and three Virtual Players).

Authoring

Virtual Players have restricted authoring capabilities because they're intended as a vehicle to open multiple project runtimes, not provide a multi-editor authoring workflow. You should use the main Editor Player to make changes and the Virtual Players to test multiplayer functionality.

note

You can't access any main Editor Player functionality from Virtual Players.

Performance impact

To reduce the demand on system resources caused by each Virtual Player instance, MPPM shares specific resources, such as the artifact database and imports between the main Editor Player and each Virtual Player.