[NoelStephensUnity]

Purpose of this PR

Prevents the visual issues NGO users currently see with Rigidbodies in hybrid sessions, under either N4E NetcodeConfig physics mode, by applying two temporary workarounds automatically.

Always Run: Non-hybrid NGO prefabs that use a NetworkRigidbody jitter or ghost, because the Rigidbody's own interpolation no longer lines up with when physics steps. When a session has hybrid prefabs, these instances now use Extrapolate on the transform authority and None on every other peer. The setting follows authority across ownership changes and kinematic updates, and the authored value is restored on despawn.

User Controlled: On the host, full tick smoothing holds hybrid prefabs with a NetworkRigidbody in place, so they don't move. Full tick smoothing is now disabled on those prefabs when they are registered, and a developer-level log says so.

Both are temporary. The User Controlled workaround will be removed once unity/unity#135166 ships in the next N4E update.

PR Scope:

• NetworkRigidbodyBase: the Always Run interpolation override for non-hybrid 3D Rigidbodies, applied only when the session has hybrid prefabs (N4E defaults to Always Run, so plain NGO sessions must not be affected).
• NetworkPrefab.Validate: the User Controlled full tick smoothing change for hybrid prefabs with a NetworkRigidbody.
• ghostobjects.md: documents both behaviors.

Out of scope:

• 2D Rigidbodies (N4E does not support Rigidbody2D yet).
• In-scene placed hybrid objects (not supported yet).
• Tests (the workarounds are temporary and will be adjusted after release).

Jira ticket

NA

Changelog

NA

Documentation

• Includes documentation updates: a "Mixed mode objects and physics" section in ghostobjects.md.

Testing & QA (How your changes can be verified during release Playtest)

Functional Testing

Manual testing :

• Manual testing done: in NGO examples under both physics modes, including an owner-authoritative non-hybrid prefab with a Rigidbody.

Automated tests:

• Covered by existing automated tests
• Covered by new automated tests

Does the change require QA team to:

• Review automated tests?
• Execute manual tests?
• Provide feedback about the PR?

If any boxes above are checked the QA team will be automatically added as a PR reviewer.

Up-port

No up-port

Backports

No back-port

[u-pr]

💡 Harness Review

The change adds automatic physics configuration, but its interaction with initialization and later lifecycle callbacks needs attention.

_{Reviewed commit 5985d07}

_{🤖 Helpful? 👍/👎}

[codecov-github-com]

Codecov Report

Attention: Patch coverage is 36.36364% with 14 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...objects/Runtime/Components/NetworkRigidBodyBase.cs	37.50%	10 Missing ⚠️
...gameobjects/Runtime/Configuration/NetworkPrefab.cs	33.33%	4 Missing ⚠️

@@                Coverage Diff                @@
##           develop-3.x.x    #4229      +/-   ##
=================================================
- Coverage          76.20%   76.16%   -0.04%     
=================================================
  Files                159      159              
  Lines              27576    27598      +22     
=================================================
+ Hits               21013    21021       +8     
- Misses              6563     6577      +14     

Flag	Coverage Δ
NGOv2_project_testproject_ubuntu	75.25% <36.36%> (-0.04%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...gameobjects/Runtime/Configuration/NetworkPrefab.cs	62.01% <33.33%> (-1.40%)	⬇️
...objects/Runtime/Components/NetworkRigidBodyBase.cs	62.19% <37.50%> (-0.76%)	⬇️

Components	Coverage Δ
com.unity.netcode.gameobjects	76.16% <36.36%> (-0.04%)	⬇️

ℹ️ Need help interpreting these results?

[jabbacakes]

Suggested change

	To avoid visual anomalies, NGO automatically adjusts some Rigidbody settings based on the **Physics Run Mode** of the `NetcodeConfig` asset:
	To avoid visual anomalies, Netcode for GameObjects automatically adjusts some Rigidbody settings based on the **Physics Run Mode** of the `NetcodeConfig` asset:

[jabbacakes]

Suggested change

	- **Always Run**: In a session that has hybrid prefabs, non-hybrid NGO prefabs with a NetworkRigidbody and a 3D Rigidbody have the Rigidbody's **Interpolate** value set to **Extrapolate** on the authority instance and to **None** on all non-authority instances. The authority instance is the server or host for a server-authoritative NetworkTransform, or the owner for an owner-authoritative one. The value follows authority when ownership changes, and the original value is restored when the instance despawns.
	- **User Controlled**: Hybrid NGO prefabs with a NetworkRigidbody have **Full Tick Smoothing** set to **Disabled**.
	- **Always Run**: In a session that has hybrid prefabs, non-hybrid Netcode for GameObjects prefabs with a NetworkRigidbody and a 3D Rigidbody have the Rigidbody's **Interpolate** value set to **Extrapolate** on the authority instance and to **None** on all non-authority instances. The authority instance is the server or host for a server-authoritative NetworkTransform, or the owner for an owner-authoritative one. The value follows authority when ownership changes, and the original value is restored when the instance despawns.
	- **User Controlled**: Hybrid Netcode for GameObjects prefabs with a NetworkRigidbody have **Full Tick Smoothing** set to **Disabled**.