Develop into main (#1395)

Co-authored-by: Amy Reeve <[email protected]>

docusaurus.config.js

@@ -385,9 +385,13 @@ module.exports = {
         lastVersion: "current",
         versions: {
           current: {
-            label: "1.3.2",
+            label: "1.4.0-pre",
             path: "current",
           },
+          "1.3.2": {
+            label: "1.3.2",
+            path: "1.3.2",
+          },
           "1.2.0": {
             label: "1.2.0",
             path: "1.2.0",

mppm_versioned_docs/version-1.3.2/about.md

@@ -0,0 +1,37 @@
+---
+id: about
+title: About Multiplayer Play Mode
+description: Overview of Multiplayer Play Mode
+---
+
+Use Multiplayer Play Mode to test multiplayer functionality within the Unity Editor. You can simulate up to four Players (the main Editor Player and three Virtual Players) simultaneously on the same development device while using the same source assets on disk. Multiplayer Play Mode can help you create multiplayer development workflows that reduce project build times, run it locally, and test the server-client relationship.
+
+## Compatibility
+
+Multiplayer Play Mode version 1.3.0 is compatible with Unity Editor versions 6000.0.22f1 or later.
+
+## Multiplayer Play Mode terminology
+
+The following have specific meaning in relation to Multiplayer Play Mode:
+
+* 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 Multiplayer Play Mode. These Players open in a separate window with limited authoring capabilities when you enter [Play mode](https://docs.unity3d.com/Manual/GameView.html).
+* Players: All Player instances, including the main Editor Player and all Virtual Players.
+
+## Limitations
+
+Multiplayer Play Mode has some inherent technical limitations, specifically around [scale](#scale) and [authoring](#authoring).
+
+### Scale
+
+The Unity Editor and Virtual Players require a lot of system resources, so you shouldn't use Multiplayer Play Mode at scale. Multiplayer Play Mode is designed for small-scale, local testing environments that can only support up to four total Players (the main Editor Player and three Virtual Players).
+
+### Authoring
+You can't create or change the properties of GameObjects in a Virtual Player. Instead, use the main Editor Player to make changes and a Virtual Player to test multiplayer functionality. Any changes you make in Play Mode in the main Editor Player reset when you exit Play Mode.
+:::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, Multiplayer Play Mode shares specific resources, such as the artifact database and imports between the main Editor Player and each Virtual Player.

mppm_versioned_docs/version-1.3.2/dedicated-server/multiplayer-role.md

@@ -0,0 +1,27 @@
+---
+id: multiplayer-role
+title: Assign Virtual Players to a Multiplayer Role
+description: Learn how to use the dedicated server package to assign Virtual Players to a Multiplayer Role.
+---
+
+Install the [Dedicated Server package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) with Multiplayer Play Mode to switch Players between the server and client role without a script.
+
+::: Important
+To avoid errors, install the Dedicated Server package version that is the same as the Multiplayer Play mode version that exists in your project.
+:::
+
+## Set the main Editor Player Multiplayer Role
+
+To set the role of a the main Editor Player, do the following:
+
+1. Open the Multiplayer Play Mode inspector (**Multiplayer** > **Multiplayer Play Mode**).
+2. In the **main Editor Player** section, expand the **Multiplayer Role** dropdown.
+3. Select the [Multiplayer Role](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) you want the main Editor Player to use.
+
+## Set the Multiplayer Role of a Virtual Player
+
+To set the role of a [Virtual Player](../../virtual-players), do the following:
+
+ 1. Open the Multiplayer Play Mode inspector (**Multiplayer** > **Multiplayer Play Mode**).
+ 2. In the **Virtual Players** section, expand a Virtual Player's **Multiplayer Role** dropdown.
+ 3. Select the [Multiplayer Role](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) you want this Player to use.

mppm_versioned_docs/version-1.3.2/dedicated-server/play-mode-dedicated-server.md

@@ -0,0 +1,17 @@
+---
+id: play-mode-dedicated-server
+title: Use Multiplayer Play mode with a Dedicated Server
+description: Use the dedicated server package with multiplayer play mode.
+---
+
+The [Dedicated Server package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) adds [Multiplayer Roles](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) to the [Dedicated Server build platform](https://docs.unity3d.com/Manual/dedicated-server-introduction.html). You can use Multiplayer Roles to assign virtual players to a client, server, or client and server Multiplayer Role.
+
+<!--
+<div className="table-columns-plain" >
+| Page | Description |
+</div>
+-->
+
+|**Page** |**Description**|
+|-|-|
+|[Debug Multiplayer Play Mode](debug-mppm.md)| Learn how to use Unity Test Framework to test a project with Multiplayer Play Mode. |

mppm_versioned_docs/version-1.3.2/install.md

@@ -0,0 +1,19 @@
+---
+id: install
+title: Install Multiplayer Play Mode
+description: How to install Multiplayer Play Mode
+---
+
+You can use Multiplayer Play Mode version 1.1.0 in Unity Editor versions 6000.0.3f1 or later. Multiplayer Play mode versions 1.0.0 and earlier are compatible with Unity version 2023.1 or later.
+To install the Multiplayer Play Mode package, follow these steps:
+
+1. Open Unity Hub.
+2. Select a Project to open it.
+3. In the Editor's menu bar, navigate to **Window** > **Package Manager**.
+4. Select **Unity Registry**.
+5. Select the **Multiplayer Play Mode** package. 
+6. Select **Install**.
+
+## Next steps
+
+You can now access and configure your [Virtual Players](../virtual-players) and their [tags](../player-tags).

mppm_versioned_docs/version-1.3.2/mppm-reference/mppm-reference-lp.md

@@ -0,0 +1,19 @@
+---
+id: mppm-reference-lp
+title: Property refererence
+description: Information about Multiplayer Play Mode properties.
+---
+
+This section explains the behavior of properties that relate to Multiplayer Play Mode. 
+
+|**Page title**|**Description**|
+|-|-|
+|[Instances status dropdown reference](play-mode-scenario-dropdown-reference.md)| Describes the meaning of each status icon in the Play Mode Scenarios dropdown.|
+|[Play Mode Scenarios window reference](play-mode-scenario-window-reference.md)| Describes the behavior of the properties in the Play Mode Scenarios window.|
+|[Play Mode status window reference](play-mode-status-window-reference.md)| Describes the behavior of the properties in the Play Mode status window. |
+|[Play Mode scenario instances status reference](play-mode-scenario-instances-status-reference.md)|Describes the meaning of each status icon in the instances status dropdown.|
+
+## Additional resources
+- [Multiplayer Roles reference](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles-reference.html)
+- [Create a Play Mode scenario](play-mode-scenario/play-mode-scenario-create.md)
+- [Troubleshoot a test build](troubleshoot/play-mode-scenario-troubleshoot.md)

mppm_versioned_docs/version-1.3.2/mppm-reference/play-mode-scenario-dropdown-reference.md

@@ -0,0 +1,15 @@
+---
+id: play-mode-scenario-dropdown-reference
+title: Play Mode scenario dropdown reference
+description: Descriptions of the status icons in the Play Mode scenario dropdown.
+---
+This table explains the meaning of each status icon in the Play Mode Scenarios dropdown that appears next to the Play Mode buttons.
+
+|**Property**|**Description**|
+|-|-|
+|![Warning icon](/img/Warning-32.png) Warning|You need to change some settings in the Play Mode Scenarios window for this Play Mode scenario to function correctly. For more information, refer to the error box that appears in the Play Mode Scenarios window. |
+|![Scenario icon](/img/d_PlaymodeScenario-32.png) Scenario| A Play Mode scenario that contains Play Mode settings.|
+
+## Additional resources
+* [Test live instances locally and remotely](play-mode-scenario/play-mode-scenario-about.md)
+* [Create a Play Mode scenario](play-mode-scenario/play-mode-scenario-create.md)

mppm_versioned_docs/version-1.3.2/mppm-reference/play-mode-scenario-instances-status-reference.md

@@ -0,0 +1,22 @@
+---
+id: play-mode-scenario-instances-status-reference
+title: Play Mode scenario instances status reference
+description: Descriptions of the status icons in the instances status dropdown.
+---
+This table explains the meaning of each status symbol in the instances status dropdown that appears next to the Play Mode Scenarios dropdown.
+
+|**Property**|**Description**|
+|-|-|
+|![Warning icon](/img/Warning-32.png) Warning|This Play Mode scenario is not configured correctly. For more information, refer to the error box that appears in the Play Mode Scenarios window. |
+|![Error icon](/img/Error-32.png) Error|This Play Mode scenario does not function correctly. For more information, refer to the error that appears in the console window. |
+|![Loading icon](/img/d_Loading-32.png) Loading|Unity is currently performing a building or loading step.|
+|![Connected and Running icon](/img/CompletedTask-32.png) Connected and Running|This Play Mode scenario is active with no errors.|
+|![Idling icon](/img/d_IdleState-2x.png) Idling|This Play Mode scenario is not yet active. To activate it, enter Play Mode.|
+|![Go to dashboard icon](/img/go-to-dashboard-32.png) Go to dashboard|Select this icon to open the Services dashboard in your web browser.|
+|![Open status window icon](/img/d_WindowInstance-32.png) Open status window|Select this icon to open the Play Mode Status window to see more information for each instance.|
+
+## Additional resources
+* [Play Mode Scenarios requirements and limitations](play-mode-scenario/play-mode-scenario-req.md)
+* [Unity Gaming Services (UGS) Multiplay Hosting](https://docs.unity.com/ugs/en-us/manual/game-server-hosting/manual/welcome-to-multiplay)
+* [Play Mode scenario window reference](/mppm-reference/play-mode-scenario-window-reference.md)
+* [Create a Play Mode scenario](play-mode-scenario/play-mode-scenario-create.md)

mppm_versioned_docs/version-1.3.2/mppm-reference/play-mode-scenario-window-reference.md

@@ -0,0 +1,46 @@
+---
+id: play-mode-scenario-window-reference
+title: Play Mode scenario window reference
+description: Descriptions of the properties in the Play Mode Scenario window.
+---
+
+This table explains the behavior of each property in the Play Mode Scenarios window.
+
+|**Property**|||**Description**|
+|-|-|-|-|
+|Description|||Enter a description for this instance. This description exists as a tooltip for this Play Mode Scenario in the [Play Mode scenario dropdown](play-mode-scenario-dropdown-reference.md). |
+|Editor|||The instance that exists in the main Unity Editor.|
+||Multiplayer Role||The [Multiplayer Role](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) that this local instance uses. Unity uses this Multiplayer Role and ignores the Multiplayer Role you assign in the Project Settings window. This property appears when the [Dedicated Server package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) exists in your project.
+|||Tag||One or more reference words that you can use in a script to assign the main Editor Player to a certain behavior. To control whether a player exists on the client or server, use the **Multiplayer Role** property. 
+You can change the Multiplayer Role in the **File** > **Build Profiles** window.|
+||Initial Scene||The scene that all instances display when you initialize them.|
+|Additional Editor Instances|||A [virtual player](https://docs-multiplayer.unity3d.com/mppm/current/virtual-players/) that exists in the Unity Editor.|
+||Name||The name for this additional Editor instance that appears in the [Play Mode status window](play-mode-scenario-window-reference.md). |
+||Multiplayer Role||The [Multiplayer Role](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) that this instance uses. Unity uses this Multiplayer Role and ignores the Multiplayer Role you assign in the Project Settings window. This property appears when the [Dedicated Server package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) exists in your project|
+||Tag||One or more reference words that you can use in a script to assign the main Editor Player to a certain behavior.<br/>To control whether a player exists on the client or server, use the **Multiplayer Role** property.|
+|Local Instances|||Instances of this project that run on your local machine.|
+||Name||The name of this instance that appears in the [Play Mode status window](play-mode-scenario-window-reference.md).|
+||Build Profile||The [Build Profile](https://docs.unity3d.com/6000.0/Documentation/Manual/build-profiles.html) that this instance uses. When you build on a Windows device, select the Windows platform. When you build on a MacOS device, select the MacOS platform.|
+||Multiplayer Role||The [Multiplayer Role](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) that this local instance uses. Unity uses this Multiplayer Role and ignores the Multiplayer Role you assign in the Project Settings window. This property appears when the [Dedicated Server package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) exists in your project|
+||Advanced Configuration||Optional properties that you can use to debug and control this local instance. |
+|||Stream Logs To Main Editor|Select the checkbox to display logs from this instance in the Unity Editor Console.|
+|||Logs Color|The color this instance uses to display logs in the Unity Editor.|
+|||Arguments|The [UGS launch parameters](https://docs.unity.com/ugs/manual/game-server-hosting/manual/concepts/launch-parameters) that modify this instance.|
+|Remote Instances|||Instances that exist in the [Unity Cloud](https://docs.unity.com/cloud/en-us) and use [Unity Gaming Services (UGS) Multiplay Hosting](https://docs.unity.com/ugs/en-us/manual/game-server-hosting/manual/welcome-to-multiplay).|
+||Name||The name of this instance that appears in the [Play Mode status window](play-mode-scenario-window-reference.md).|
+||Identifier||The label, in a string, that determines the name of the Multiplay build, fleet, and server. This string field uses the format `CreatedFromTheUnityEditor-[identifier]-[username]`. Don't use any special characters.|
+||Multiplayer Role||The [Multiplayer Role](https://docs.unity3d.com/Packages/[email protected]/manual/multiplayer-roles.html) that this remote instance uses. Unity uses this Multiplayer Role and ignores the Multiplayer Role you assign in the Project Settings window. This property appears when the [Dedicated Server package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html) exists in your project|
+||Advanced Configuration|||Optional properties that you can use to debug and control this remote instance. |
+|||Fleet Name|The name of the server fleet to display in the Multiplayer Hosting environment. |
+|||Fleet Region|The server region this instance runs from.|
+|||Instance Amount of Cores|The amount of CPU cores this remote instance requests from the server.|
+|||Instance Memory|The amount of memory, in megabytes, that this instance requests from the server. To learn how much memory your project uses, use the [memory profiler package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html).|
+|||Instance CPU Clockspeed|The amount of CPU time, in megahertz, that this instance requests from the server.|
+|||Stream Logs To Main Editor|Select the checkbox to display logs from this instance in the Unity Editor Console.|
+|||Logs Color|The color of text that displays in the Unity Editor for logs that relate to this instance.|
+|||Arguments|The [UGS launch parameters](https://docs.unity.com/ugs/manual/game-server-hosting/manual/concepts/launch-parameters) that modify this instance.|
+
+## Additional resources
+* [Create a Play Mode scenario](play-mode-scenario/play-mode-scenario-create.md)
+* [Test live instances locally and remotely](play-mode-scenario/play-mode-scenario-about.md)
+* [Play Mode Scenarios requirements and limitations](play-mode-scenario/play-mode-scenario-req.md)

mppm_versioned_docs/version-1.3.2/mppm-reference/play-mode-status-window-reference.md

@@ -0,0 +1,15 @@
+---
+id: play-mode-status-window-reference
+title: Play Mode status window reference
+description: Descriptions of the properties in the Play Mode status window.
+---
+This table explains the behavior of each property in the Play Mode status window. The properties that appear in this window change depending on the Playmode Scenarios that exist for your project.
+
+|**Property**|**Description**|
+|-|-|
+|Tags|Displays the tags that you assign to this instance in the **Play Mode Configuration** window. |
+|Disconnect|Disconnect this Play Mode instance from the local or remote server.|
+
+## Additional resources
+* [Test live instances locally and remotely](play-mode-scenario/play-mode-scenario-about.md)
+* [Create a Play Mode scenario](play-mode-scenario/play-mode-scenario-create.md)

mppm_versioned_docs/version-1.3.2/mutliplayer-terms.md

@@ -0,0 +1,10 @@
+---
+id: mtt-terms
+title: Multiplayer Networking Terminology
+---
+
+The following are essential, high-level terms used in multiplayer networking and Netcode for GameObjects:
+
+import MTTterms from '/static/shared/_terminology.md';
+
+<MTTterms/>

mppm_versioned_docs/version-1.3.2/play-mode-scenario/play-mode-scenario-about.md

@@ -0,0 +1,13 @@
+---
+id: play-mode-scenario-about
+title: Test live instances locally and remotely
+description: Learn how to use the Play Mode Scenarios window to test a multiplayer project
+---
+
+To test one or more instances of a multiplayer project on a local machine or a remote server, use the Play Mode Scenarios window. This window replicates the circumstances of a project that multiple users access from different environments that have different limitations.
+
+## Additional resources
+* [Play Mode Scenarios requirements and limitations](play-mode-scenario-req.md)
+* [Play Mode scenario window reference](mppm-reference/play-mode-scenario-window-reference.md)
+* [Unity Gaming Services (UGS) Multiplay Hosting](https://docs.unity.com/ugs/en-us/manual/game-server-hosting/manual/welcome-to-multiplay)
+* [Dedicated Server](https://docs.unity3d.com/Manual/dedicated-server.html)