Skip to content

chore: Small GhostObject docs updates #4230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
EmandM merged 2 commits into from
Oct 29, 2026
Merged

chore: Small GhostObject docs updates #4230

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fc2eb70
chore: Small GhostObject docs updates
EmandM Oct 28, 2026
51309aa
Merge branch 'develop-3.x.x' into chore/small-docs-updates
EmandM Oct 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions com.unity.netcode.gameobjects/Documentation~/ghostobjects.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,8 @@ When the network prefabs list contains a hybrid object, Unity Netcode drives the

For more information about tick rates in Netcode for GameObjects, refer to [Ticks and update rates](learn/ticks-and-update-rates.md).

The change in physics simulation rate is used to enable user prediction. If the change in physics simulation rate causes issues for your game, you can disable Unity Netcode driving the physics simulation by setting the **Physics Run Mode** on the `NetcodeConfig` asset to **User Controlled**. Note that under this configuration, client-side prediction will not work.

## Parent replication

The **Parent Replication** setting on the **GhostObject** component controls which package synchronizes the parent GameObject of a hybrid object.
Expand All @@ -71,6 +73,9 @@ Hybrid objects have the following limitations:
- Object pooling: Hybrid objects aren't compatible with `INetworkPrefabInstanceHandler`, so you can't use [object pooling](advanced-topics/object-pooling.md) with hybrid objects.
- Client authority: Unity Netcode doesn't support the client authoritative motion model. You can convert a NetworkObject that uses an owner-authoritative NetworkTransform into a hybrid object, but the owner no longer controls its transform, because the NetworkTransform component stops synchronizing data. To move the converted object, use server-authoritative motion or prediction instead. `NetworkVariable`s on hybrid objects can still use owner write permissions.

> [!NOTE]
> Client-side prediction is not compatible with client authoritative physics. Unity Netcode leverages the physics simulation to minimize mis-predictions. This will result in faster than expected physics solving for all GameObjects whenever any GhostObject is being predicted.

## Create and remove hybrid objects

To create a hybrid object, add the missing component to an existing network prefab:
Expand Down
Loading