Tools 2.2.0 release (#1308)

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

Author: Vic-Cooper

docusaurus.config.js

@@ -336,9 +336,13 @@ module.exports = {
         lastVersion: "current",
         versions: {
           current: {
-            label: "2.1.0",
+            label: "2.2.0",
             path: "current",
           },
+          "2.1.0": {
+            label: "2.1.0",
+            path: "2.1.0",
+          },
           "1.1.0": {
             label: "1.1.0",
             path: "1.1.0",

tools/release-notes/release-2.0.0+.md

@@ -5,6 +5,12 @@ title: Multiplayer Tools 2.0.0+
 description: Release notes for Multiplayer Tools including new features, updates, bug fixes, known issues, and information to help you upgrade.
 ---
 
+## [2.2.0] - 2024-07-24
+
+### General
+
+- Increased minimum required version of Unity to 6000.0 and later.
+
 ## [2.1.0] - 2023-11-21
 
 ### General

tools_versioned_docs/version-2.1.0/about.md

@@ -0,0 +1,16 @@
+---
+id: about
+title: About Multiplayer Tools
+description: Overview of the Multiplayer Tools package
+---
+
+The Multiplayer Tools package provides a variety of tools to analyze, debug, and test your multiplayer game.
+
+| Get Started | Tools |
+| --- | --- |
+| [Install](install-tools.md) | [Profiler](profiler.md) |
+|  | [Network Simulator](network-simulator.md) |
+|  | [Runtime Network Stats Monitor](runtime-stats-monitor.md) |
+|  | [Network Scene Visualization](network-scene-vis.md) |
+
+The [Multiplayer Tools Window](tools-window.md) provides convenient access to all the tools mentioned above.

tools_versioned_docs/version-2.1.0/install-tools.md

@@ -0,0 +1,13 @@
+---
+id: install-tools
+title: Install the Multiplayer Tools Package
+sidebar_label: Install Multiplayer Tools
+---
+
+To use Multiplayer Tools, such as the [profiler](profiler.md) or [runtime stats monitor](runtime-stats-monitor.md), you need to install the tools package by name.
+
+1. Open your Unity Hub and select the Project your are presently working on.
+2. In the editor's menu bar, navigate to **Window** > **Package Manager**.
+3. Click the plus sign ![plus sign](/img/add.png) in the Package Manager status bar and select **Add package by name...**.
+4. Enter `com.unity.multiplayer.tools` in the pop-up window and select **Add**.
+5. After downloading, **Multiplayer Tools** appears under **Unity Technologies** in your **Package Manager** window.

tools_versioned_docs/version-2.1.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/>

tools_versioned_docs/version-2.1.0/network-scene-vis.md

@@ -0,0 +1,52 @@
+---
+id: netscenevis
+title: Network Scene Visualization
+---
+
+Network Scene Visualization (NetSceneVis) is a powerful, user-friendly tool included in the Multiplayer Tools package to help you visualize and debug network communication on a per-object basis in the Unity Editor Scene View of your project with visualizations such as mesh shading and text overlay.
+
+The NetSceneVis tool listens to network messages about the game state to visually display bandwidth and ownership on a per-object basis in the Unity Editor. The visualizations are updated in real-time as the network messages are sent and received, showing the game state synchronization across the network.
+
+This tool can help you optimize and debug your network code to ensure that your game runs smoothly for all players.
+
+## Requirements
+- Unity 2023.2.0a11 or higher
+- Multiplayer Tools package 2.0.0-pre.2 or higher, see [Install the Multiplayer Tools Package](./install-tools.md)
+
+## Using Network Scene Visualization
+
+After [installing the Multiplayer Tools package](#requirements), the Network Visualization toolbar is available in the scene view of the Unity Editor. This toolbar includes the options to visualize networking information per-object of your game.
+
+![Screenshot of the Network Scene Visualization toolbar in the scene view of the Unity Editor](/img/tools/netscenevis-1.png)
+
+Hovering over each option under **Bandwidth**, **Ownership**, and **Settings** reveals detailed tooltips for each option.
+
+### Bandwidth
+
+Selecting **Bandwidth Mode** displays the bandwidth usage of each object.
+
+| Option | Description |
+|---|---|
+| *Type* | Filter the bandwidth by type: network variables (**NetVars**), **RPCs**, or **All**. **All** includes spawn, despawn, ownership change, network variables, and RPCs. |
+| *Direction* | Filter bandwith by direction: **Sent**, **Received**, or **Sent and Received**. |
+| *Smoothing* | Smooth the bandwidth data over time. Higher values improve readability by filtering out sudden data changes. This option is disabled when paused. |
+| *Text Overlay* | Visualize the per-object bandwith with text labels. |
+| *Shading* > *Auto Scale* | Automatically scales the mesh shading visualization to the current maximum per-object bandwidth of any object in the scene. The minimum bandwidth will always be 0. |
+| *Shading* > *Min/Max Bandwidth Bar* | When **Auto Scale** is unchecked, you can manually choose the min and max bandwidth values. The color bar can be changed between 4 options. The color bar can be changed when **Auto Scale** is checked or unchecked. |
+
+### Ownership
+
+Selecting **Ownership Mode** displays the ownership of each object, either by the server, host, or by a specific client.
+
+| Option | Description |
+|---|---|
+| *Text Overlay* | Visualize the per-object ownership with text labels. |
+| *Shading* | Visualize the per-object ownership with a colored overlay. |
+
+### Settings
+
+These settings are only available when **MeshShading** is enabled.
+
+You can toggle the **Outline** option to display a black outline around networked objects to improve visibility in the scene and distinguish between overlapping networked objects.
+
+The **Saturation (%)** controls the saturation of non-networked objects so networked objects can stand out more. The scale goes from 0 as grayscale to 100 for full color.