com.unity.physics@1.4.3

## [1.4.3] - 2025-10-17

### Added

* The Force Unique Collider companion component can now be disabled in the Inspector. When disabled it will no longer cause its associated baked Unity Physics Colliders to be unique.

### Changed

* Updated the Burst dependency to version 1.8.25

### Deprecated

### Removed

### Fixed

* Baked Unity Physics Colliders that are forced to be unique will now produce stable collider blob hashes. This ensures that associated artifact IDs in your project will no longer change each time the project is re-imported. Note that baked colliders can be forced to be unique either via the "Force Unique" option in the custom Physics Shape authoring component, or via the Force Unique Collider companion component for built-in Colliders. Both approaches now support stable collider blob hashes.

### Security

Author: Unity Technologies

.attestation.p7m

@@ -1 +1 @@
-{"timestamp":1759420299,"signature":"av9aJH2yh9avsNL71KJXu8w5CeNLQ4hCfJyW5TcSErto8B1Q/Z8bm7f7c64Hk+B9c+rCtE9LW6Tx7R20QH+a4b2QBOR2438pGaMPQMovvnHOpzMZNHkYqMS5Fx7Oz7jrHFHQHU8fFDK8TYl4P30wxBQ9DHpGNla0a0QC+YBVPen1UmYaNrqdrcDzKiArElHsBY8fxGAB6PWV89MFG/AxB6TTCeuaXx2F5fQYLTM53Q6eKadHsExFlKjje4zygJWaQKmlWj2ZtuBdQnv6V6HUN/Ser9CkJcAyrfWCpAHjdHJvWuaJSEm/EQz3XFK2aQoJLl46BI0bldzQ1HNRr678GTSnMgaSrAtyG9ExKZeY8j9e1/OPn/KY9xyP0alZhdU4miW1hBeqTqG1fQL7umXN1+GRHP3xp/oJAR5GfHOkAskwP9F1eeASqGEZ2DKOFELL1tuXWwG6Vf6pk1qg4kgm43Y88OSuYePhmP4MA1wODbym9f0/wxHEh47mOqoDrv3d","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}
+{"timestamp":1761776372,"signature":"krQqtAByNOQwGNdhLhAFmIecxXOjoelhyIxH4tz0QujVIkhzbTIv2YI/o4C+C6iS+WXOjR9y2jdyHBQfdZISz3IdXyrRtCuXxrGuwh6W26rHOLPQJJrXITUiHrE6tif7GGm0w/fg5nj3y2BNQEGPvlWnc3bs8JTg52lj0fYu59772jlHxuDDyXvl8KS81dezP2jG19ZML1o47lopPDQcEh0VSv5Xrp5SMB2EpyQVo7wQkTQSQ2dScMSyaRVh9hgGVavVgxPXZnX6vYTcyOSaIOP3jZl0xafqIQHAF+OQDRP7d+k4xxE8/AxbBnO/RQPH3orfrUqheMkuO21Xw0gj+vCB4It1yIbLpf0iyeDWuy+TlUik25U+z0l+52Ye8h08WJTNqTHv0bF8VQayF28/qsLqcbqyZ+znTUmQigxca4HoepT0A+UsEhZjwzONeCdFdObpwKMIDoyouRPLcv5VMIvyB6JNl29Iu0Bo/KX/OjbCEGXYOdfuUfEgNGFsfPKz","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}

.signature

@@ -4,6 +4,29 @@ uid: unity-physics-changelog
 
 # Changelog
 
+## [1.4.3] - 2025-10-17
+
+### Added
+
+* The Force Unique Collider companion component can now be disabled in the Inspector. When disabled it will no longer cause its associated baked Unity Physics Colliders to be unique.
+
+### Changed
+
+* Updated the Burst dependency to version 1.8.25
+
+### Deprecated
+
+
+### Removed
+
+
+### Fixed
+
+* Baked Unity Physics Colliders that are forced to be unique will now produce stable collider blob hashes. This ensures that associated artifact IDs in your project will no longer change each time the project is re-imported. Note that baked colliders can be forced to be unique either via the "Force Unique" option in the custom Physics Shape authoring component, or via the Force Unique Collider companion component for built-in Colliders. Both approaches now support stable collider blob hashes.
+
+### Security
+
+
 ## [1.4.2] - 2025-09-05
 
 ### Added
@@ -43,6 +66,7 @@ uid: unity-physics-changelog
 ### Security
 
 
+
 ## [1.4.0-pre.3] - 2025-06-06
 
 

ApiUpdater~/ValidationWhiteList.txt

@@ -12,9 +12,11 @@ This component allows configuring various aspects of the simulation via the foll
 | Solver Iteration Count              | Specify the number of solver iterations the physics system performs to correct contact penetrations and joint errors. Higher values provide higher accuracy and stability, but can reduce simulation performance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | Multi Threaded                      | Enable multi-threading.<br>If enabled, the physics system maximizes the number of threads used for calculating the simulation results. If disabled, the physics system reduces the number of utilized threads to a minimum, performing most operations in a single thread.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | Collision Tolerance                 | Set the collision tolerance.<br> The collision tolerance specifies the minimum distance required for contacts between rigid bodies to be created. This value can be increased if undesired collision tunneling is observed in the simulation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| Max Dynamic Depenetration Velocity  | Set the maximum relative velocity that can be produced when separating intersecting dynamic rigid bodies. This can be useful in cases where contacts lead to deep intersections between colliders, consequently causing too aggressive, ejecting motions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| Max Static Depenetration Velocity   | Set the maximum relative velocity that can be produced when separating dynamic rigid bodies intersecting with static rigid bodies. This can be useful in cases where contacts lead to deep intersections between colliders, consequently causing too aggressive, ejecting motions.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | Incremental Dynamic Broadphase      | Enable the incremental dynamic broadphase.<br>Enabling this option will update the dynamic broadphase incrementally whenever changes between simulation steps occur, potentially leading to time savings for cases with many dynamic rigid bodies that don't move or otherwise change.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Incremental Static Broadphase       | Enable the incremental static broadphase.<br> Enabling this option will update the static broadphase incrementally whenever changes between simulation steps occur, potentially leading to time savings for cases with many static rigid bodies that don't move or otherwise change.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | Synchronize Collision World         | Specify whether to update the collision world after the step for more precise raycast, collider and distance query results.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| Enable Contact Solver Stabilization Heuristic | Enabling the contact solver stabilization heuristic results in better simulation stability when stacking objects with low solver iteration counts, by preventing undesired sliding artifacts. However, it can reduce simulation performance and produce unplausible results in certain physical interactions involving friction forces.                                                                                                                                                                                                                                                                                                                                                                                             |
+| Enable Contact Solver Stabilization Heuristic | Enabling the contact solver stabilization heuristic results in better simulation stability when stacking objects with low solver iteration counts, by preventing undesired sliding artifacts. However, it can reduce simulation performance and produce unplausible results in certain physical interactions involving friction forces.                                                                                                                                                                                                                                                                                                                                                                                   |
 
 ![collider_cast](images/physics-step.png)<br/>_The Physics Step authoring component provides access to various simulation configuration settings._

CHANGELOG.md

@@ -0,0 +1,17 @@
+using UnityEditor;
+
+#if UNITY_EDITOR
+
+namespace Unity.Physics.Editor
+{
+    static class CustomComponentVersionUpgrader
+    {
+        [MenuItem("Tools/Unity Physics/Upgrade Physics Shape Versions")]
+        static void UpgradeAssetsWithPhysicsShape()
+        {
+            ComponentVersionUpgrader.UpgradeAssets<Authoring.PhysicsShapeAuthoring>("Physics Shape");
+        }
+    }
+}
+
+#endif

Documentation~/component-step.md

@@ -81,7 +81,7 @@ ShapeComputationDataBaking GetInputDataFromAuthoringComponent(PhysicsShapeAuthor
             };
 
             ForceUniqueColliderAuthoring forceUniqueComponent = body.GetComponent<ForceUniqueColliderAuthoring>();
-            bool isForceUniqueComponentPresent = forceUniqueComponent != null;
+            bool isForceUniqueComponentPresent = forceUniqueComponent != null && forceUniqueComponent.enabled;
 
             var data = GenerateComputationData(shape, bodyTransform, instance, colliderEntity, isForceUniqueComponentPresent);
 
@@ -261,7 +261,7 @@ private ShapeComputationDataBaking GenerateComputationData(PhysicsShapeAuthoring
                 Instance = colliderInstance,
                 Material = ProduceMaterial(shape),
                 CollisionFilter = ProduceCollisionFilter(shape),
-                ForceUniqueIdentifier = isUnique ? (uint)shape.GetInstanceID() : 0u
+                ForceUniqueIdentifier = isUnique ? shape.ForceUniqueID : 0u
             };
 
             var shapeTransform = shape.transform;

Documentation~/images/physics-step.png

@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using System.ComponentModel;
 using System.Diagnostics;
 using Unity.Burst;
 using Unity.Collections;
@@ -10,6 +9,10 @@
 using UnityEngine;
 using UnityEngine.Rendering;
 
+#if UNITY_EDITOR
+using UnityEditor;
+#endif
+
 namespace Unity.Physics.Authoring
 {
     public sealed class UnimplementedShapeException : NotImplementedException
@@ -22,12 +25,16 @@ public UnimplementedShapeException(ShapeType shapeType)
     [Icon(k_IconPath)]
 #endif
     [AddComponentMenu("Entities/Physics/Physics Shape")]
-    public sealed class PhysicsShapeAuthoring : MonoBehaviour, IInheritPhysicsMaterialProperties, ISerializationCallbackReceiver
+    public sealed class PhysicsShapeAuthoring : MonoBehaviour, IInheritPhysicsMaterialProperties
     {
         const string k_IconPath = "Packages/com.unity.physics/Unity.Physics.Editor/Editor Default Resources/Icons/d_BoxCollider@64.png";
 
         PhysicsShapeAuthoring() {}
 
+        internal uint ForceUniqueID => m_ForceUniqueID;
+        [SerializeField]
+        uint m_ForceUniqueID = 0;
+
         [Serializable]
         struct CylindricalProperties
         {
@@ -734,28 +741,50 @@ void OnEnable()
             // included so tick box appears in Editor
         }
 
-        const int k_LatestVersion = 1;
-
-        [SerializeField]
-        int m_SerializedVersion = 0;
+        const int k_VersionAddedForceUniqueID = 2; // added ForceUniqueID for stable artifact IDs
+        const int k_LatestVersion = k_VersionAddedForceUniqueID;
 
-        void ISerializationCallbackReceiver.OnBeforeSerialize() {}
+        [SerializeField, HideInInspector]
+        int m_SerializedVersion = k_LatestVersion;
 
-        void ISerializationCallbackReceiver.OnAfterDeserialize() => UpgradeVersionIfNecessary();
+#if UNITY_EDITOR
+        static string s_LastWarnedPath;
+        static double s_NextWarningTime;
+#endif
 
-#pragma warning disable 618
         void UpgradeVersionIfNecessary()
         {
             if (m_SerializedVersion < k_LatestVersion)
             {
-                // old data from version < 1 have been removed
-                if (m_SerializedVersion < 1)
-                    m_SerializedVersion = 1;
+                m_SerializedVersion = k_LatestVersion;
+
+#if UNITY_EDITOR
+                if (PrefabUtility.IsPartOfAnyPrefab(this) || gameObject.scene.IsValid())
+                {
+                    // Inform user that scene needs to be saved:
+
+                    var scenePath = gameObject.scene.path;
+
+                    if (string.IsNullOrEmpty(scenePath))
+                    {
+                        var gameObjectPath = UnityEditor.Search.SearchUtils.GetHierarchyPath(gameObject);
+                        UnityEngine.Debug.LogWarning("A Physics Shape component in game object '" + gameObjectPath + "' needs to be upgraded. "
+                            + "To apply the upgrade, open and re-save the containing asset, " +
+                            "or use the automatic version upgrade tool under 'Tools -> Unity Physics -> Upgrade Physics Shape Versions'.", gameObject);
+                    }
+                    else if (scenePath != s_LastWarnedPath || EditorApplication.timeSinceStartup > s_NextWarningTime)
+                    {
+                        UnityEngine.Debug.LogWarning("A Physics Shape component in a scene needs to be upgraded. To apply the upgrade, open and re-save the scene '" + scenePath + "', " +
+                            "or use the automatic version upgrade tool under 'Tools -> Unity Physics -> Upgrade Physics Shape Versions'.");
+
+                        s_LastWarnedPath = scenePath;
+                        s_NextWarningTime = EditorApplication.timeSinceStartup + 5f;
+                    }
+                }
+#endif
             }
         }
 
-#pragma warning restore 618
-
         static void Validate(ref CylindricalProperties props)
         {
             props.Height = math.max(0f, props.Height);
@@ -764,7 +793,10 @@ static void Validate(ref CylindricalProperties props)
 
         void OnValidate()
         {
-            UpgradeVersionIfNecessary();
+            if (m_ForceUniqueID == 0)
+            {
+                m_ForceUniqueID = (uint)UnityEngine.Random.Range(1, Int32.MaxValue);
+            }
 
             m_PrimitiveSize = math.max(m_PrimitiveSize, new float3());
             Validate(ref m_Capsule);
@@ -801,6 +833,8 @@ void OnValidate()
             m_ConvexHullGenerationParameters.OnValidate();
 
             PhysicsMaterialProperties.OnValidate(ref m_Material, true);
+
+            UpgradeVersionIfNecessary();
         }
 
         // matrix to transform point from shape space into world space