Editor instances
Multiplayer Play Mode streamlines local multiplayer testing by using a Editor instance alongside one or more additional Editor instances.
The Editor is the standard, fully-featured Unity Editor where you develop, launch, and manage your multiplayer game. It also serves as a central point of control for starting and stopping the orchestration of a Play Mode Scenario. Starting a Play Mode Scenario from the Editor automatically launches the configured number of additional Editors. Each additional Editor is a separate child process, distinct from the Editor, that acts as additional game clients.
In your project, an additional Editor instance is represented by its own folder within the project's /Library/VP/
directory, which stores unique configuration settings and data. Any asset or code changes made in the Editor are
automatically reflected in additional Editors, as they share the Editor's Library folder. This folder also
contains a SystemData.json file that defines an additional Editor's unique configuration, such as its role (client or
server) and other runtime parameters.
Scenarios with additional Editors enable rapid testing of complex multiplayer interactions, such as a client connecting to a host or server, all directly on your development machine. It eliminates the need to create and manage separate standalone builds, significantly accelerating the development and debugging workflow for your multiplayer project.
Configure an instance
You can configure Editor and additional Editor instances from the Play Mode Scenarios window:
- If you haven't done so already, create your Play Mode Scenario.
- Select the scenario that you've created, or one that already exists.
- Editor and additional Editor instances are displayed on the right-hand side of the window.
- If none are showing, ensure that the checkbox next to Editor is selected.
- To add more additional Editor instances, click the + button under Additional Editor Instances.

Activating and deactivating Editor instances
Note
This functionality is available in Unity 6.5 and Unity 6.6 or later.
You can manually activate or deactivate Editor instances from the Active Scenario window. This gives you control over which instances are running without starting a full scenario.
To activate or deactivate an Editor instance:
- Open the Active Scenario window (Window > Play Mode > Active Scenario).
- Locate the Editor instance you want to activate or deactivate.
- Click the Activate or Deactivate button for that instance.
Note
You can only activate or deactivate Editor instances when a scenario is not actively launching.

Keep Active checkbox
Note
This functionality is available in Unity 6.5 and Unity 6.6 or later.
The keep alive checkbox controls whether an Editor instance process remains active after a scenario or Play mode ends.
- When checked: The Editor instance process stays alive even after the scenario or Play mode ends. This allows for faster iteration as the instance doesn't need to restart.
- When unchecked: The Editor instance deactivates automatically when the scenario or Play mode ends.
You can find the Keep Active checkbox in the Active Scenario window next to each Editor instance.
Refresh Virtual Project Folder
Note
This functionality is available in Unity 6.6 or later.
The Refresh Virtual Project Folder option deletes and recreates the project's Library/VP folder. This is a common debugging step when you encounter synchronization issues or unexpected behavior with additional Editor instances.
Because this option removes the whole Library/VP folder, it also removes the SystemData.json file that stores each instance's configuration, such as its tags and role. Unity regenerates this data the next time you launch a scenario or activate an instance.
To refresh the Virtual Project folder:
- Open the Active Scenario window (Window > Play Mode > Active Scenario).
- Click the three-dot menu in the Active Scenario window.
- Select Refresh Virtual Project Folder.
Note
Unity disables this option while any additional Editor instance is active or launching. Stop all additional Editor instances before you use this option. You don't need to close the main Editor.

Focusing on additional editors
Additional Editor instances within a Play Mode Scenario can be started as game clients (Players), each with its own window that can be minimized or hidden. As such, you can focus on to these instances in two ways:
- Select the Focus on Player icon in the Active Scenario window pertaining to that instance.
- Use the focus player keyboard shortcuts.
Focusing on an additional Editor through the Active Scenario window
- Open the Active Scenario window.
- Navigate to the Editor instance you wish to focus on.
- Click on the Focus icon
. - The corresponding Editor window should be displayed.
Focus on an additional Editor with keyboard shortcuts
Use the following keyboard shortcuts to switch focus to a specific window:
| Shortcut | Description |
|---|---|
| Ctrl+F9 (macOS: Cmd+F9) | Focus on Player 1. |
| Ctrl+F10 (macOS: Cmd+F10) | Focus on Player 2. |
| Ctrl+F11 (macOS: Cmd+F11) | Focus on Player 3. |
| Ctrl+F12 (macOS: Cmd+F12) | Focus on Player 4. |
Configuring the layout for additional Editors
You can customize the layout of each Editor instance to help you monitor and debug your game more effectively. The window of these Editors is composed of several panels that you can toggle to configure the layout according to your needs. This allows you to focus on different aspects of your game for each player, such as viewing a specific Editor's console logs or monitoring rendering statistics, for example.
- Console
- Game
- Hierarchy
- Inspector
- Scene
- PlayMode Tools. This window only appears in projects that use Netcode for Entities.
- Profiler
Note
You can only use the Hierarchy, Inspector, and Scene windows while in Play mode.
To display or hide layout panels in additional Editors, perform the following actions:
- Focus on the Editor you want to configure from within the Active Scenario window.
- In the additional Editor, select the Layout dropdown on the top right.
- Select the box next to the specific panel(s) you want to view within this instance.
- Select Apply.

Tags
You can use tags to configure behavior for Players in both the Editor and any additional Editor instances you may have. For example, you can use tags to:
- Automatically assign a Player to a specific team you have in your game.
- Have Players move faster or slower to simulate real-world network connections.
Note
You can assign only one tag to a Player in the Play Mode Scenario window
Create a tag
- Open the Player Tags window, navigate to Edit > Project Settings > Multiplayer > PlayMode > Player Tags.
- Select the plus sign
to create a tag. - Name the tag.
- Select Save. The new tag is automatically added to the local project directory in
...\[example-project-name]\ProjectSettings\VirtualProjectsConfig.json. - The new tag appears in the Tag section of the Play Mode Scenarios window for your currently selected scenario.

Attach a tag to a Player in the Play Mode Scenarios window
- After creating a tag, open the Play Mode Scenarios window (Window > Play Mode > Scenarios).
- Expand the Tags dropdown for the Editor Player or additional Editor instances.
- Select the tag you just created.
Use tags in a player script
Tags don't do anything until you configure them. To configure a tag:
- Use
CurrentPlayer.Tagsto target the tag in a script. - Attach the script to a NetworkObject, such as the Player.
Use the following tag examples as guides for your own scripts:
Examples
Use tags to simulate network conditions
CurrentPlayer.Tags returns every tag assigned to the current player, so the following example uses Contains to check whether a specific tag is present. This check is an exact, case-sensitive match on each tag name.
This example script uses the Network Simulator tool and its network configuration presets to automatically simulate a fast or slow network based on the tag. A Player with the FastNetwork tag simulates a common home broadband connection, and a Player with the SlowNetwork tag simulates a mobile 2.5G connection.
using System.Linq;
using UnityEngine;
using Unity.Multiplayer.PlayMode;
using Unity.Multiplayer.Tools.NetworkSimulator.Runtime;
public class NetworkSimulation : MonoBehaviour
{
void Start()
{
var networkSimulator = GetComponent<NetworkSimulator>() ??
gameObject.AddComponent<NetworkSimulator>();
var connectionPreset = NetworkSimulatorPresets.None;
if (CurrentPlayer.Tags.Contains("FastNetwork"))
{
connectionPreset = NetworkSimulatorPresets.HomeBroadband;
}
else if (CurrentPlayer.Tags.Contains("SlowNetwork"))
{
connectionPreset = NetworkSimulatorPresets.Mobile2_5G;
}
networkSimulator.ConnectionPreset = connectionPreset;
}
}
Use tags to assign a player to a team
The following example uses Contains to check whether the current player has a specific tag.
Important
Contains is case-sensitive by default. To match tags without regard to case, pass a comparer, for example CurrentPlayer.Tags.Contains("Blue", System.StringComparer.CurrentCultureIgnoreCase).
The following script automatically sets a NetworkVariable called Team based on the tag.
A Player with a Red tag automatically sets the Team NetworkVariable to Red. A Player with a Blue tag automatically sets the Team NetworkVariable to Blue.
using System.Linq;
using Unity.Netcode;
using UnityEngine;
using Unity.Multiplayer.PlayMode;
public enum Team { Blue, Red, }
/// A player with a team that is automatically assigned
/// based on the tag of the client that owns them
public class Player : NetworkBehaviour
{
public NetworkVariable<Team> team = new (writePerm: NetworkVariableWritePermission.Owner);
void Start()
{
var localClientId = NetworkManager.Singleton.LocalClientId;
if (!team.CanClientWrite(localClientId))
{
return;
}
var mppmTags = CurrentPlayer.Tags;
if (mppmTags.Contains("Blue"))
{
team.Value = Team.Blue;
}
if (mppmTags.Contains("Red"))
{
team.Value = Team.Red;
}
}
}