Merge develop into main (#1274)

Co-authored-by: Amy Reeve <[email protected]>
Co-authored-by: Dominick <[email protected]>
Co-authored-by: Rémi MACH <[email protected]>
Co-authored-by: LagowiecDev <[email protected]>
Co-authored-by: amanda-butler-unity <[email protected]>
Co-authored-by: Noel Stephens <[email protected]>
Co-authored-by: Griffin of Innatical <[email protected]>
Co-authored-by: Christopher Pope <[email protected]>
Co-authored-by: Steve Diniro <[email protected]>
Co-authored-by: s-omeilia-unity <[email protected]>
Co-authored-by: Alex Martin <[email protected]>
Co-authored-by: Monaxys <[email protected]>
Co-authored-by: Flap27 <[email protected]>
Co-authored-by: NRTnarathip <[email protected]>
Co-authored-by: Elfi0Kuhndorf <[email protected]>

Author: 16 people

docs/learn/bitesize/bitesize-clientdriven.md

@@ -17,10 +17,10 @@ Making movements feel responsive while staying consistent over multiple game exe
 ## Sample:
 
 ClientDriven's aim is to create a quick sample to show responsive character movements that don't feel sluggish, even under bad network conditions.
-It uses the ClientNetworkTransform sample and moves your own player's position client side, [client authoritatively](../dealing-with-latency.md#allow-low-impact-client-authority). Movement is leveraged through the use of Unity's Starter Assets, the [Third Person Character Controller](https://assetstore.unity.com/packages/essentials/starter-assets-third-person-character-controller-196526).
+It uses the ClientNetworkTransform component and moves your own player's position client side, [client authoritatively](../dealing-with-latency.md#allow-low-impact-client-authority). Movement is leveraged through the use of Unity's Starter Assets, the [Third Person Character Controller](https://assetstore.unity.com/packages/essentials/starter-assets-third-person-character-controller-196526).
 
 ```csharp reference
-https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/blob/v1.2.1/Basic/ClientDriven/Assets/StarterAssets/ThirdPersonController/Scripts/ThirdPersonController.cs#L274-L276
+https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/blob/v1.2.1/Basic/ClientDriven/Assets/StarterAssets/ThirdPersonController/Scripts/ThirdPersonController.cs#L155-L162
 ```
 
 ### Client side object detection for pickup with server side pickup validation
@@ -40,7 +40,7 @@ https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/blo
 Notice how we're checking whether that object can be picked up or not (since another player can have picked it up at the same time, creating a conflict).
 
 ```csharp reference
-https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/blob/v1.2.1/Basic/ClientDriven/Assets/Scripts/ServerPlayerMove.cs#L50
+https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/blob/v1.2.1/Basic/ClientDriven/Assets/Scripts/ServerPlayerMove.cs#L50-L58
 ```
 If the object is already picked up, we're not doing anything. Your client side animations should take this into account and cancel any animations "carrying" something.
 

docusaurus.config.js

@@ -369,9 +369,13 @@ module.exports = {
         lastVersion: "current",
         versions: {
           current: {
-            label: "1.0.0",
+            label: "1.1.0",
             path: "current",
           },
+          "1.0.0": {
+            label: "1.0.0",
+            path: "1.0.0",
+          },
           "0.6.0": {
             label: "0.6.0",
             path: "0.6.0",

mppm/dedicated-server/multiplayer-role.md

@@ -6,6 +6,10 @@ description: Learn how to use the dedicated server package to assign virtual pla
 
 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:

mppm/install.md

@@ -9,12 +9,9 @@ To begin testing your multiplayer functionality, you must first install the Mult
 1. Open Unity Hub.
 2. Select a Project.
 3. In the Editor's menu bar, navigate to **Window** > **Package Manager**.
-4. Click the plus sign ![plus sign](/img/add.png) in the Package Manager status bar.
-5. Select **Install package by name...**.
-6. Enter `com.unity.multiplayer.playmode` in the pop-up window.
-7. Select **Add**.
-8. After the download is complete, **Multiplayer Play Mode** appears under **Unity Technologies** in the **Package Manager** window.
-9. To open the Multiplayer Play Mode window, navigate to **Window** > **Multiplayer Play Mode**.
+4. Select **Unity Registry**.
+5. Select the **Multiplayer Play Mode** package. 
+6. Select **Install**.
 
 ## Next steps
 

mppm/release-notes/release-notes.md

@@ -4,6 +4,25 @@ title: Release notes
 description: Release notes for Multiplayer Play Mode including new features, updates, bug fixes, and known issues.
 ---
 
+## [1.1.0] - 2024-04-24
+
+### Added
+- Added a new layout option to each Multiplayer Play Mode clone in projects that include the Netcode For Entities package.
+- Updated the **Close** button to display a warning dialog prompt that deactivates a virtual player.
+- Added the mute setting to mute specific users.
+- Added a setting that changes the Asset Database refresh timeout.
+- Updated the focus shortcut behavior to focus on other individual virtual player windows from inside an individual player.
+- Updated the message that appears when a Symlink failure (on FAT32) happens because it isn't supported.
+
+### Fixed
+- The local clone cache clears automatically when you update the Multiplayer Play Mode package.
+- Fixed a crash caused by devices set to certain regions.
+- Changed the default multiplayer role of player clones to Client and Server.
+- Added a minimum width for the main view of the Multiplayer Play Mode window.
+- The escape key no longer closes virtual player windows on Windows devices.
+- Fixed issues with heartbeat timeout.
+- Removed the forward slash **/** character from tags because it's for drop-down behavior only.
+  
 ## [1.0.0] - 2024-03-12
 
 ### Added

mppm_versioned_docs/version-1.0.0/about.md

@@ -0,0 +1,33 @@
+---
+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 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.
+
+## Multiplayer Play Mode terminology
+
+The following have specific meaning in relation to Multiplayer Play Mode:
+
+* Main Editor: 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 and three Virtual Players).
+
+### Authoring
+You can't create or change the properties of GameObjects in a Virtual Player. Instead, use the Main Editor to make changes and a Virtual Player to test multiplayer functionality. Any changes you make in Play Mode in the Main Editor reset when you exit Play Mode. 
+:::note
+You can't access any Main Editor 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 and each Virtual Player.

mppm_versioned_docs/version-1.0.0/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 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.0.0/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.0.0/install.md

@@ -0,0 +1,18 @@
+---
+id: install
+title: Install Multiplayer Play Mode
+description: How to install Multiplayer Play Mode
+---
+
+To begin testing your multiplayer functionality, you must first install the Multiplayer Play Mode package.
+
+1. Open Unity Hub.
+2. Select a Project.
+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 [Player Tags](../player-tags).

mppm_versioned_docs/version-1.0.0/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/>