com.unity.netcode@1.10.0

## [1.10.0] - 2025-11-09

### Added

* World state save can now correctly save zero sized components.
* Netcode Profiler - added a context menu in the Ghost Snapshot View's TreeView Labels to quickly access and inspect Ghost Prefabs and Components.

### Changed

* Dependent version of com.unity.entities is updated to 1.4.2.
* Source generators will now only run as part of compilation within Unity, and not in IDEs (tested with Rider and Visual Studio, please report a bug if you use another IDE where they are not disabled). This will disable generated sources from showing up in your IDE, but will significantly speed up Roslyn processes in IDEs.

### Removed

* Usage of obsolete entities method `GetRefRWOptional`

### Fixed

* Erroneous Assert in the `PredictedGhostSpawnSystem` incorrectly stating that the `InitJob` does not support enableable components, despite the fact that the query itself polls for disabled entities.
* Removed warning that spams console when `ClientServerTickRate.TargetFrameRateMode` is set to `Sleep`.
* Rare issue where an exception would happen in the first run of the prediction loop, only happens when `PredictionUpdateLoopMode` is set to `AlwaysRun`
* You can again add multiple `Entity` types to your ghost components and commands.
* Shorts are now properly supported in components and commands.
* Missing Physics-related API docs have been re-added.

Author: Unity Technologies

.attestation.p7m

@@ -1 +1 @@
-{"timestamp":1762944007,"signature":"E5UI6KZ0qU5v8Qg70uNIUglJEwbkRp6kPtL62BbX53M0hSjj1kl19yOs4etoAIAc5g2W/JTfd7eG8+uR3q3reQZBmQg+6Qe8IbhNo0V2GuErbrKjmddkYlc6PzUtErXWFGWtthKn/Rmi24G91IOP5l1cfX3xO3SpNnHEqH7rTX3GIFMCtddjcM0kbw85Y/qr+1+5NNLubk/BZssyNjdEosXQvp5WqpmxZ/VJvMZ51LB+Pp0bf6dVE1E+aF0V6yOuOAFSV534jxX8A+QCOnASiekeC+udA25IZKcqaztJPzhNmRce4Art0/f9CfE0bfWoTUyNTfz/cuefMcfK5E9owxT7xMqU1Vp+ga4rxB7UELxCgvAQ7nb1Vc9Jmd8DgzqoM1FeAh2jJXzc3BdxcY+4JsWzFaSa6/u2FwK2mKH0rzEKmrIXH/r1PXaYZ3E78MzmUCvLZ0oGi1fIChv5ORhZnqLCOHXKhLeAj55rYDbd4Kd/eoZdDwqiFN2DnWBfE3Z2","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}
+{"timestamp":1763565376,"signature":"gjfzyCpyeFwn7eVrPrSwc17RJFFFkGFkkrcdiAwNQdvKmqcyFGyUAGQEQdGnWBAwzZTRBp/81w6W4WYcR21F0KlhM5JITXktlpGWncZyNdTuoOE/mss8BMoK49OkDxzHwlaikl0z64Rf3ZY/8Nam5mL6CrL7PtaPOBbr7Bja2IISDSkGqk5HFJd8HyHgcFL6w6GIVKnyO3cDrGTLs236fMsNgeYx1eFmMeOqy6R+A/M1Ho5xX4gg5mlzdx7q6MFR2HINY0KIuGy/fp/2/VNuXyL28wh9t9ua+UfWENeVMK8fbIuXIwPTLCf9+CC55gC2hnEvaSbgmbjNwGnewCzCawSkpda6jQ9Qrhiiw3nHR/5XwivnJ8EWNLA4iBrM/MLqYNbT9lM9R2ywjqpHEBrF+W7m0DH74LMCDhPsYs867KgYOViFvBUdAnZ9Go7VIwfmMcs+yR+LoeqHfTbG/KK91BHiAAPR3CI5aAjFknMxTQ4CpF90PFwUzprN/yEw4aPy","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}

.signature

@@ -2,20 +2,31 @@
 uid: changelog
 ---
 
-## [1.9.3] - 2025-11-06
+## [1.10.0] - 2025-11-09
 
-### Fixed
+### Added
 
-* You can again add multiple `Entity` types to your ghost components and commands.
-* Shorts are now properly supported in components and commands.
-* Missing Physics-related API docs have been re-added.
+* World state save can now correctly save zero sized components.
+* Netcode Profiler - added a context menu in the Ghost Snapshot View's TreeView Labels to quickly access and inspect Ghost Prefabs and Components.
 
+### Changed
 
-## [1.9.2] - 2025-10-31
+* Dependent version of com.unity.entities is updated to 1.4.2.
+* Source generators will now only run as part of compilation within Unity, and not in IDEs (tested with Rider and Visual Studio, please report a bug if you use another IDE where they are not disabled). This will disable generated sources from showing up in your IDE, but will significantly speed up Roslyn processes in IDEs.
+
+### Removed
+
+* Usage of obsolete entities method `GetRefRWOptional`
 
 ### Fixed
 
+* Erroneous Assert in the `PredictedGhostSpawnSystem` incorrectly stating that the `InitJob` does not support enableable components, despite the fact that the query itself polls for disabled entities.
 * Removed warning that spams console when `ClientServerTickRate.TargetFrameRateMode` is set to `Sleep`.
+* Rare issue where an exception would happen in the first run of the prediction loop, only happens when `PredictionUpdateLoopMode` is set to `AlwaysRun`
+* You can again add multiple `Entity` types to your ghost components and commands.
+* Shorts are now properly supported in components and commands.
+* Missing Physics-related API docs have been re-added.
+
 
 
 ## [1.9.1] - 2025-10-11

CHANGELOG.md

@@ -87,13 +87,7 @@ By default, systems are created and updated in the [`SimulationSystemGroup`](htt
 
 When you specify a system group that your system belongs in, Unity automatically filters out your system in worlds where this system group isn't present. This means that systems in a system group inherit the world filter of said system group. For example:
 
-```csharp
-[UpdateInGroup(typeof(GhostInputSystemGroup))]
-public class MyInputSystem : SystemBase
-{
-  ...
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/client-server-worlds.cs#SystemGroup)]
 
 If you examine the `WorldSystemFilter` attribute on [`GhostInputSystemGroup`](https://docs.unity3d.com/Packages/com.unity.netcode@latest?subfolder=/api/Unity.NetCode.GhostInputSystemGroup.html), you will find that this system group only exists for client, thin client, and local simulation (offline) worlds. It also has a `childDefaultFlags` argument which specifies the flags that child systems, such as the example `MyInputSystem`, inherit (and this argument doesn't contain thin client worlds). Therefore, `MyInputSystem` will be present on full client and local simulation worlds exclusively (unless a `WorldSystemFilter` is added to `MyInputSystem` overriding this default).
 
@@ -115,27 +109,11 @@ Use `WorldSystemFilter` to declare (at compile time) which of the following worl
 
 In the following example, `MySystem` is defined such that it's only present for worlds that can be used to run the client simulation (any world that has the `WorldFlags.GameClient` set). `WorldSystemFilterFlags.Default` is used when this attribute isn't present and automatically inherits its filtering rules from its parent system group (in this case, that's the `SimulationSystemGroup`, because no `UpdateInGroup` attribute is specified).
 
-```csharp
-[WorldSystemFilter(WorldSystemFilterFlags.ClientSimulation)]
-public class MySystem : SystemBase
-{
-  ...
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/client-server-worlds.cs#WorldSystemFilter)]
 
 ## Creating client and server worlds with bootstrapping
 
-When you add Netcode for Entities to your project, the default [`ClientServerBootstrap` class](https://docs.unity3d.com/Packages/com.unity.netcode@latest/index.html?subfolder=/api/Unity.NetCode.ClientServerBootstrap.html) is added to the project. This bootstrapping class configures and creates the server and client worlds at runtime when your game starts (or when entering Play mode in the Unity Editor).
-
-The default bootstrap creates the client and server worlds automatically at startup:
-
-```c#
-        public virtual bool Initialize(string defaultWorldName)
-        {
-            CreateDefaultClientServerWorlds();
-            return true;
-        }
-```
+When you add Netcode for Entities to your project, the default [`ClientServerBootstrap` class](https://docs.unity3d.com/Packages/com.unity.netcode@latest/index.html?subfolder=/api/Unity.NetCode.ClientServerBootstrap.html) is added to the project. This bootstrapping class configures and creates the server and client worlds at runtime when your game starts (or when entering Play mode in the Unity Editor). The default bootstrap creates the client and server worlds automatically at startup.
 
 `ClientServerBootstrap` uses the same bootstrapping flows as defined by [Entities](https://docs.unity3d.com/Packages/com.unity.entities@latest?subfolder=/manual/index.html), which means that new worlds are populated using all the systems defined by the relevant world filtering set (such as `[WorldSystemFilter(...)]` attributes you have defined, `WorldSystemFilterFlags` rules your systems inherit, and other attributes like `DisableAutoCreation`). Netcode for Entities also injects many systems (and groups) automatically.
 
@@ -149,39 +127,11 @@ You can create your own bootstrap class and customize your game flow by creating
 
 The following code example shows how to override the default bootstrap to prevent automatic creation of the client and server worlds:
 
-```c#
-public class MyGameSpecificBootstrap : ClientServerBootstrap
-{
-    public override bool Initialize(string defaultWorldName)
-    {
-        //Create only a local simulation world without any multiplayer and netcode system in it.
-        CreateLocalWorld(defaultWorldName);
-        return true;
-    }
-
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/client-server-worlds.cs#CustomBootstrap)]
 
 Then, when you're ready to create the various Netcode worlds, call:
 
-```c#
-void OnPlayButtonClicked()
-{
-    // Typically this:
-    var clientWorld = ClientServerBootstrap.CreateClientWorld();
-    // And/Or this:
-    var serverWorld = ClientServerBootstrap.CreateServerWorld();
-
-    // And/Or something like this, for soak testing:
-    AutomaticThinClientWorldsUtility.NumThinClientsRequested = 10;
-    AutomaticThinClientWorldsUtility.BootstrapThinClientWorlds();
-
-    // Or the following, which creates worlds smartly based on:
-    // - The Playmode Tool setting specified in the editor.
-    // - The current build type, if used in a player.
-    ClientServerBootstrap.CreateDefaultClientServerWorlds();
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/client-server-worlds.cs#UsingCustomBootstrap)]
 
 There are [Netcode samples](https://github.com/Unity-Technologies/EntityComponentSystemSamples/blob/master/NetcodeSamples/README.md) showcasing how to manage scene and subscene loading with this world creation setup, as well as proper Netcode world disposal (when leaving the gameplay loop).
 
@@ -233,28 +183,7 @@ The `ClientServerTickRate` configuration is sent (by the server, to the client)
 
 If you want to destroy the world you're in and spin up another world without losing the connection state, you can use `DriverMigrationSystem`, which allows you to store and load transport-related information so a smooth world transition can be made.
 
-```
-public World MigrateWorld(World sourceWorld)
-{
-    DriverMigrationSystem migrationSystem = default;
-    foreach (var world in World.All)
-    {
-        if ((migrationSystem = world.GetExistingSystem<DriverMigrationSystem>()) != null)
-            break;
-    }
-
-    var ticket = migrationSystem.StoreWorld(sourceWorld);
-    sourceWorld.Dispose();
-
-    var newWorld = migrationSystem.LoadWorld(ticket);
-
-    // NOTE: LoadWorld must be executed before you populate your world with the systems it needs!
-    // This is because LoadWorld creates a `MigrationTicket` Component that the NetworkStreamReceiveSystem needs in order to be able to Load
-    // the correct Driver.
-
-    return ClientServerBootstrap.CreateServerWorld(DefaultWorld, newWorld.Name, newWorld);
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/client-server-worlds.cs#WorldMigration)]
 
 ## Additional resources
 

Documentation~/client-server-worlds.md

@@ -57,76 +57,15 @@ The first and last steps are the same (as with the single-player input handling)
 
 Simple input values for character movement (with jumping):
 
-```c#
-using Unity.Entities;
-using Unity.NetCode;
-
-[GenerateAuthoringComponent]
-public struct PlayerInput : IInputComponentData
-{
-    public int Horizontal;
-    public int Vertical;
-    public InputEvent Jump;
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/command-stream.cs#InputEvents)]
 
 The input gathering system, which takes current inputs and applies them to the input component data on the local player's entity.
 
-```c#
-[UpdateInGroup(typeof(GhostInputSystemGroup))]
-[AlwaysSynchronizeSystem]
-public partial class GatherInputs : SystemBase
-{
-    protected override void OnCreate()
-    {
-        RequireForUpdate<PlayerInput>();
-    }
-
-    protected override void OnUpdate()
-    {
-        bool jump = UnityEngine.Input.GetKeyDown("space");
-        bool left = UnityEngine.Input.GetKey("left");
-        //...
-
-        var networkId = GetSingleton<NetworkId>().Value;
-        Entities.WithName("GatherInput").WithAll<GhostOwnerIsLocal>().ForEach((ref PlayerInput inputData) =>
-            {
-                inputData = default;
-
-                if (jump)
-                    inputData.Jump.Set();
-                if (left)
-                    inputData.Horizontal -= 1;
-                //...
-            }).ScheduleParallel();
-    }
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/command-stream.cs#GatherInput)]
 
 The processing input system, which takes the current input values stored on the player's input component and applies the equivalent movement actions.
 
-```c#
-    [UpdateInGroup(typeof(PredictedSimulationSystemGroup))]
-    public partial class ProcessInputs : SystemBase
-    {
-        protected override void OnCreate()
-        {
-            RequireForUpdate<PlayerInput>();
-        }
-        protected override void OnUpdate()
-        {
-            var movementSpeed = Time.DeltaTime * 3;
-            Entities.WithAll<Simulate>().WithName("ProcessInputForTick").ForEach(
-                (ref PlayerInput input, ref Translation trans, ref PlayerMovement movement) =>
-                {
-                    if (input.Jump.IsSet)
-                        movement.JumpVelocity = 10; // start jump routine
-
-                    // handle jump event logic, movement logic etc
-                }).ScheduleParallel();
-        }
-    }
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/command-stream.cs#ProcessInput)]
 
 ## Creating commands
 
@@ -232,67 +171,12 @@ Entities
 
 To manually serialize commands:
 1. Add the [`[NetCodeDisableCommandCodeGen]`](https://docs.unity3d.com/Packages/com.unity.netcode@latest?subfolder=/api/Unity.NetCode.NetCodeDisableCommandCodeGenAttribute.html) attribute to the struct that impliments the `ICommandData` interface.
-2. Create a struct that implements [`ICommandDataSerializer<T>`](https://docs.unity3d.com/Packages/com.unity.netcode@latest?subfolder=/api/Unity.NetCode.ICommandDataSerializer-1.html), where `<T>` is your `ICommandData` struct.
+2. Create a struct that implements [`ICommandDataSerializer<T>`](https://docs.unity3d.com/Packages/com.unity.netcode@latest?subfolder=/api/Unity.NetCode.ICommandDataSerializer-1.html), where `<T>` is your `ICommandData` struct. Note that you can implement this on the same struct that implements `ICommandData` for convenience.
 
 [`ICommandDataSerializer`](https://docs.unity3d.com/Packages/com.unity.netcode@latest?subfolder=/api/Unity.NetCode.ICommandDataSerializer-1.html) has two `Serialize` and two `Deserialize` methods: one pair for raw values, and one pair for delta compressed values. The system sends multiple inputs in each command packet. The first packet contains raw data but the rest are compressed using delta compression. Delta compression compresses inputs well because the rate of change is low.
 
 As well as creating a struct, you also need to create specific instances of the generic systems `CommandSendSystem` and `CommandReceiveSystem`. To do this, extend the base system, for example with:
 
-```c#
-[UpdateInGroup(typeof(CommandSendSystemGroup))]
-[BurstCompile]
-public partial struct MyCommandSendCommandSystem : ISystem
-{
-    CommandSendSystem<MyCommandSerializer, MyCommand> m_CommandSend;
-    [BurstCompile]
-    struct SendJob : IJobChunk
-    {
-        public CommandSendSystem<MyCommandSerializer, MyCommand>.SendJobData data;
-        public void Execute(in ArchetypeChunk chunk, int unfilteredChunkIndex,
-            bool useEnabledMask, in v128 chunkEnabledMask)
-        {
-            data.Execute(chunk, unfilteredChunkIndex);
-        }
-    }
-    [BurstCompile]
-    public void OnCreate(ref SystemState state)
-    {
-        m_CommandSend.OnCreate(ref state);
-    }
-    [BurstCompile]
-    public void OnUpdate(ref SystemState state)
-    {
-        if (!m_CommandSend.ShouldRunCommandJob(ref state))
-            return;
-        var sendJob = new SendJob{data = m_CommandSend.InitJobData(ref state)};
-        state.Dependency = sendJob.Schedule(m_CommandSend.Query, state.Dependency);
-    }
-}
-[UpdateInGroup(typeof(CommandReceiveSystemGroup))]
-[BurstCompile]
-public partial struct MyCommandReceiveCommandSystem : ISystem
-{
-    CommandReceiveSystem<MyCommandSerializer, MyCommand> m_CommandRecv;
-    [BurstCompile]
-    struct ReceiveJob : IJobChunk
-    {
-        public CommandReceiveSystem<MyCommandSerializer, MyCommand>.ReceiveJobData data;
-        public void Execute(in ArchetypeChunk chunk, int unfilteredChunkIndex,
-            bool useEnabledMask, in v128 chunkEnabledMask)
-        {
-            data.Execute(chunk, unfilteredChunkIndex);
-        }
-    }
-    [BurstCompile]
-    public void OnCreate(ref SystemState state)
-    {
-        m_CommandRecv.OnCreate(ref state);
-    }
-    [BurstCompile]
-    public void OnUpdate(ref SystemState state)
-    {
-        var recvJob = new ReceiveJob{data = m_CommandRecv.InitJobData(ref state)};
-        state.Dependency = recvJob.Schedule(m_CommandRecv.Query, state.Dependency);
-    }
-}
-```
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/command-stream.cs#ManualSerialization)]
+
+[!code-cs[blobs](../Tests/Editor/DocCodeSamples/command-stream.cs#TestWrongAnchor)]

Documentation~/command-stream.md

@@ -32,6 +32,9 @@ apiRules:
   - exclude:
       uidRegex: ^Generated.*
       type: Namespace
+  - exclude:
+      uidRegex: ^DocumentationCodeSamples.*
+      type: Namespace
   - exclude:
       uidRegex: \.ToString$
       type: Method