The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Additional documentation and release notes are available at [Multiplayer Documentation](https://docs-multiplayer.unity3d.com). ## [2.0.0] - 2024-09-12 ### Added - Added tooltips for all of the `NetworkObject` component's properties. (#3052) - Added message size validation to named and unnamed message sending functions for better error messages. (#3049) - Added "Check for NetworkObject Component" property to the Multiplayer->Netcode for GameObjects project settings. When disabled, this will bypass the in-editor `NetworkObject` check on `NetworkBehaviour` components. (#3031) - Added `NetworkTransform.SwitchTransformSpaceWhenParented` property that, when enabled, will handle the world to local, local to world, and local to local transform space transitions when interpolation is enabled. (#3013) - Added `NetworkTransform.TickSyncChildren` that, when enabled, will tick synchronize nested and/or child `NetworkTransform` components to eliminate any potential visual jittering that could occur if the `NetworkTransform` instances get into a state where their state updates are landing on different network ticks. (#3013) - Added `NetworkObject.AllowOwnerToParent` property to provide the ability to allow clients to parent owned objects when running in a client-server network topology. (#3013) - Added `NetworkObject.SyncOwnerTransformWhenParented` property to provide a way to disable applying the server's transform information in the parenting message on the client owner instance which can be useful for owner authoritative motion models. (#3013) - Added `NetcodeEditorBase` editor helper class to provide easier modification and extension of the SDK's components. (#3013) ### Fixed - Fixed issue where `NetworkAnimator` would send updates to non-observer clients. (#3057) - Fixed issue where an exception could occur when receiving a universal RPC for a `NetworkObject` that has been despawned. (#3052) - Fixed issue where a NetworkObject hidden from a client that is then promoted to be session owner was not being synchronized with newly joining clients.(#3051) - Fixed issue where clients could have a wrong time delta on `NetworkVariableBase` which could prevent from sending delta state updates. (#3045) - Fixed issue where setting a prefab hash value during connection approval but not having a player prefab assigned could cause an exception when spawning a player. (#3042) - Fixed issue where the `NetworkSpawnManager.HandleNetworkObjectShow` could throw an exception if one of the `NetworkObject` components to show was destroyed during the same frame. (#3030) - Fixed issue where the `NetworkManagerHelper` was continuing to check for hierarchy changes when in play mode. (#3026) - Fixed issue with newly/late joined clients and `NetworkTransform` synchronization of parented `NetworkObject` instances. (#3013) - Fixed issue with smooth transitions between transform spaces when interpolation is enabled (requires `NetworkTransform.SwitchTransformSpaceWhenParented` to be enabled). (#3013) ### Changed - Changed `NetworkTransformEditor` now uses `NetworkTransform` as the base type class to assure it doesn't display a foldout group when using the base `NetworkTransform` component class. (#3052) - Changed `NetworkAnimator.Awake` is now a protected virtual method. (#3052) - Changed when invoking `NetworkManager.ConnectionManager.DisconnectClient` during a distributed authority session a more appropriate message is logged. (#3052) - Changed `NetworkTransformEditor` so it now derives from `NetcodeEditorBase`. (#3013) - Changed `NetworkRigidbodyBaseEditor` so it now derives from `NetcodeEditorBase`. (#3013) - Changed `NetworkManagerEditor` so it now derives from `NetcodeEditorBase`. (#3013)
205 lines
11 KiB
C#
205 lines
11 KiB
C#
using Unity.Netcode.Components;
|
|
using UnityEditor;
|
|
using UnityEngine;
|
|
|
|
namespace Unity.Netcode.Editor
|
|
{
|
|
/// <summary>
|
|
/// The <see cref="CustomEditor"/> for <see cref="NetworkTransform"/>
|
|
/// </summary>
|
|
[CustomEditor(typeof(NetworkTransform), true)]
|
|
[CanEditMultipleObjects]
|
|
public class NetworkTransformEditor : NetcodeEditorBase<NetworkTransform>
|
|
{
|
|
private SerializedProperty m_SwitchTransformSpaceWhenParented;
|
|
private SerializedProperty m_TickSyncChildren;
|
|
private SerializedProperty m_UseUnreliableDeltas;
|
|
private SerializedProperty m_SyncPositionXProperty;
|
|
private SerializedProperty m_SyncPositionYProperty;
|
|
private SerializedProperty m_SyncPositionZProperty;
|
|
private SerializedProperty m_SyncRotationXProperty;
|
|
private SerializedProperty m_SyncRotationYProperty;
|
|
private SerializedProperty m_SyncRotationZProperty;
|
|
private SerializedProperty m_SyncScaleXProperty;
|
|
private SerializedProperty m_SyncScaleYProperty;
|
|
private SerializedProperty m_SyncScaleZProperty;
|
|
private SerializedProperty m_PositionThresholdProperty;
|
|
private SerializedProperty m_RotAngleThresholdProperty;
|
|
private SerializedProperty m_ScaleThresholdProperty;
|
|
private SerializedProperty m_InLocalSpaceProperty;
|
|
private SerializedProperty m_InterpolateProperty;
|
|
|
|
private SerializedProperty m_UseQuaternionSynchronization;
|
|
private SerializedProperty m_UseQuaternionCompression;
|
|
private SerializedProperty m_UseHalfFloatPrecision;
|
|
private SerializedProperty m_SlerpPosition;
|
|
private SerializedProperty m_AuthorityMode;
|
|
|
|
private static int s_ToggleOffset = 45;
|
|
private static float s_MaxRowWidth = EditorGUIUtility.labelWidth + EditorGUIUtility.fieldWidth + 5;
|
|
private static GUIContent s_PositionLabel = EditorGUIUtility.TrTextContent("Position");
|
|
private static GUIContent s_RotationLabel = EditorGUIUtility.TrTextContent("Rotation");
|
|
private static GUIContent s_ScaleLabel = EditorGUIUtility.TrTextContent("Scale");
|
|
|
|
/// <inheritdoc/>
|
|
public override void OnEnable()
|
|
{
|
|
m_SwitchTransformSpaceWhenParented = serializedObject.FindProperty(nameof(NetworkTransform.SwitchTransformSpaceWhenParented));
|
|
m_TickSyncChildren = serializedObject.FindProperty(nameof(NetworkTransform.TickSyncChildren));
|
|
m_UseUnreliableDeltas = serializedObject.FindProperty(nameof(NetworkTransform.UseUnreliableDeltas));
|
|
m_SyncPositionXProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncPositionX));
|
|
m_SyncPositionYProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncPositionY));
|
|
m_SyncPositionZProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncPositionZ));
|
|
m_SyncRotationXProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncRotAngleX));
|
|
m_SyncRotationYProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncRotAngleY));
|
|
m_SyncRotationZProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncRotAngleZ));
|
|
m_SyncScaleXProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncScaleX));
|
|
m_SyncScaleYProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncScaleY));
|
|
m_SyncScaleZProperty = serializedObject.FindProperty(nameof(NetworkTransform.SyncScaleZ));
|
|
m_PositionThresholdProperty = serializedObject.FindProperty(nameof(NetworkTransform.PositionThreshold));
|
|
m_RotAngleThresholdProperty = serializedObject.FindProperty(nameof(NetworkTransform.RotAngleThreshold));
|
|
m_ScaleThresholdProperty = serializedObject.FindProperty(nameof(NetworkTransform.ScaleThreshold));
|
|
m_InLocalSpaceProperty = serializedObject.FindProperty(nameof(NetworkTransform.InLocalSpace));
|
|
m_InterpolateProperty = serializedObject.FindProperty(nameof(NetworkTransform.Interpolate));
|
|
m_UseQuaternionSynchronization = serializedObject.FindProperty(nameof(NetworkTransform.UseQuaternionSynchronization));
|
|
m_UseQuaternionCompression = serializedObject.FindProperty(nameof(NetworkTransform.UseQuaternionCompression));
|
|
m_UseHalfFloatPrecision = serializedObject.FindProperty(nameof(NetworkTransform.UseHalfFloatPrecision));
|
|
m_SlerpPosition = serializedObject.FindProperty(nameof(NetworkTransform.SlerpPosition));
|
|
m_AuthorityMode = serializedObject.FindProperty(nameof(NetworkTransform.AuthorityMode));
|
|
base.OnEnable();
|
|
}
|
|
|
|
private void DisplayNetworkTransformProperties()
|
|
{
|
|
var networkTransform = target as NetworkTransform;
|
|
EditorGUILayout.LabelField("Axis to Synchronize", EditorStyles.boldLabel);
|
|
{
|
|
GUILayout.BeginHorizontal();
|
|
|
|
var rect = GUILayoutUtility.GetRect(EditorGUIUtility.fieldWidth, s_MaxRowWidth, EditorGUIUtility.singleLineHeight, EditorGUIUtility.singleLineHeight, EditorStyles.numberField);
|
|
var ctid = GUIUtility.GetControlID(7231, FocusType.Keyboard, rect);
|
|
|
|
rect = EditorGUI.PrefixLabel(rect, ctid, s_PositionLabel);
|
|
rect.width = s_ToggleOffset;
|
|
|
|
m_SyncPositionXProperty.boolValue = EditorGUI.ToggleLeft(rect, "X", m_SyncPositionXProperty.boolValue);
|
|
rect.x += s_ToggleOffset;
|
|
m_SyncPositionYProperty.boolValue = EditorGUI.ToggleLeft(rect, "Y", m_SyncPositionYProperty.boolValue);
|
|
rect.x += s_ToggleOffset;
|
|
m_SyncPositionZProperty.boolValue = EditorGUI.ToggleLeft(rect, "Z", m_SyncPositionZProperty.boolValue);
|
|
|
|
GUILayout.EndHorizontal();
|
|
}
|
|
|
|
if (!m_UseQuaternionSynchronization.boolValue)
|
|
{
|
|
GUILayout.BeginHorizontal();
|
|
|
|
var rect = GUILayoutUtility.GetRect(EditorGUIUtility.fieldWidth, s_MaxRowWidth, EditorGUIUtility.singleLineHeight, EditorGUIUtility.singleLineHeight, EditorStyles.numberField);
|
|
var ctid = GUIUtility.GetControlID(7231, FocusType.Keyboard, rect);
|
|
|
|
rect = EditorGUI.PrefixLabel(rect, ctid, s_RotationLabel);
|
|
rect.width = s_ToggleOffset;
|
|
|
|
m_SyncRotationXProperty.boolValue = EditorGUI.ToggleLeft(rect, "X", m_SyncRotationXProperty.boolValue);
|
|
rect.x += s_ToggleOffset;
|
|
m_SyncRotationYProperty.boolValue = EditorGUI.ToggleLeft(rect, "Y", m_SyncRotationYProperty.boolValue);
|
|
rect.x += s_ToggleOffset;
|
|
m_SyncRotationZProperty.boolValue = EditorGUI.ToggleLeft(rect, "Z", m_SyncRotationZProperty.boolValue);
|
|
|
|
GUILayout.EndHorizontal();
|
|
}
|
|
else
|
|
{
|
|
m_SyncRotationXProperty.boolValue = true;
|
|
m_SyncRotationYProperty.boolValue = true;
|
|
m_SyncRotationZProperty.boolValue = true;
|
|
}
|
|
|
|
{
|
|
GUILayout.BeginHorizontal();
|
|
|
|
var rect = GUILayoutUtility.GetRect(EditorGUIUtility.fieldWidth, s_MaxRowWidth, EditorGUIUtility.singleLineHeight, EditorGUIUtility.singleLineHeight, EditorStyles.numberField);
|
|
var ctid = GUIUtility.GetControlID(7231, FocusType.Keyboard, rect);
|
|
|
|
rect = EditorGUI.PrefixLabel(rect, ctid, s_ScaleLabel);
|
|
rect.width = s_ToggleOffset;
|
|
|
|
m_SyncScaleXProperty.boolValue = EditorGUI.ToggleLeft(rect, "X", m_SyncScaleXProperty.boolValue);
|
|
rect.x += s_ToggleOffset;
|
|
m_SyncScaleYProperty.boolValue = EditorGUI.ToggleLeft(rect, "Y", m_SyncScaleYProperty.boolValue);
|
|
rect.x += s_ToggleOffset;
|
|
m_SyncScaleZProperty.boolValue = EditorGUI.ToggleLeft(rect, "Z", m_SyncScaleZProperty.boolValue);
|
|
|
|
GUILayout.EndHorizontal();
|
|
}
|
|
|
|
EditorGUILayout.Space();
|
|
EditorGUILayout.LabelField("Authority", EditorStyles.boldLabel);
|
|
{
|
|
EditorGUILayout.PropertyField(m_AuthorityMode);
|
|
}
|
|
EditorGUILayout.Space();
|
|
EditorGUILayout.LabelField("Thresholds", EditorStyles.boldLabel);
|
|
EditorGUILayout.PropertyField(m_PositionThresholdProperty);
|
|
EditorGUILayout.PropertyField(m_RotAngleThresholdProperty);
|
|
EditorGUILayout.PropertyField(m_ScaleThresholdProperty);
|
|
EditorGUILayout.Space();
|
|
EditorGUILayout.LabelField("Delivery", EditorStyles.boldLabel);
|
|
EditorGUILayout.PropertyField(m_TickSyncChildren);
|
|
EditorGUILayout.PropertyField(m_UseUnreliableDeltas);
|
|
EditorGUILayout.Space();
|
|
EditorGUILayout.LabelField("Configurations", EditorStyles.boldLabel);
|
|
EditorGUILayout.PropertyField(m_SwitchTransformSpaceWhenParented);
|
|
if (m_SwitchTransformSpaceWhenParented.boolValue)
|
|
{
|
|
m_TickSyncChildren.boolValue = true;
|
|
}
|
|
EditorGUILayout.PropertyField(m_InLocalSpaceProperty);
|
|
if (!networkTransform.HideInterpolateValue)
|
|
{
|
|
EditorGUILayout.PropertyField(m_InterpolateProperty);
|
|
}
|
|
EditorGUILayout.PropertyField(m_SlerpPosition);
|
|
EditorGUILayout.PropertyField(m_UseQuaternionSynchronization);
|
|
if (m_UseQuaternionSynchronization.boolValue)
|
|
{
|
|
EditorGUILayout.PropertyField(m_UseQuaternionCompression);
|
|
}
|
|
else
|
|
{
|
|
m_UseQuaternionCompression.boolValue = false;
|
|
}
|
|
EditorGUILayout.PropertyField(m_UseHalfFloatPrecision);
|
|
|
|
#if COM_UNITY_MODULES_PHYSICS
|
|
// if rigidbody is present but network rigidbody is not present
|
|
if (networkTransform.TryGetComponent<Rigidbody>(out _) && networkTransform.TryGetComponent<NetworkRigidbody>(out _) == false)
|
|
{
|
|
EditorGUILayout.HelpBox("This GameObject contains a Rigidbody but no NetworkRigidbody.\n" +
|
|
"Add a NetworkRigidbody component to improve Rigidbody synchronization.", MessageType.Warning);
|
|
}
|
|
#endif // COM_UNITY_MODULES_PHYSICS
|
|
|
|
#if COM_UNITY_MODULES_PHYSICS2D
|
|
if (networkTransform.TryGetComponent<Rigidbody2D>(out _) && networkTransform.TryGetComponent<NetworkRigidbody2D>(out _) == false)
|
|
{
|
|
EditorGUILayout.HelpBox("This GameObject contains a Rigidbody2D but no NetworkRigidbody2D.\n" +
|
|
"Add a NetworkRigidbody2D component to improve Rigidbody2D synchronization.", MessageType.Warning);
|
|
}
|
|
#endif // COM_UNITY_MODULES_PHYSICS2D
|
|
}
|
|
|
|
|
|
|
|
/// <inheritdoc/>
|
|
public override void OnInspectorGUI()
|
|
{
|
|
var networkTransform = target as NetworkTransform;
|
|
void SetExpanded(bool expanded) { networkTransform.NetworkTransformExpanded = expanded; };
|
|
DrawFoldOutGroup<NetworkTransform>(networkTransform.GetType(), DisplayNetworkTransformProperties, networkTransform.NetworkTransformExpanded, SetExpanded);
|
|
base.OnInspectorGUI();
|
|
}
|
|
}
|
|
}
|