Title: NetworkTransform: half-float base update dropped as out of order when UseUnreliableDeltas is on, so later deltas decode ~2 m off · Issue #4248 · Unity-Technologies/com.unity.netcode.gameobjects · GitHub
Open Graph Title: NetworkTransform: half-float base update dropped as out of order when UseUnreliableDeltas is on, so later deltas decode ~2 m off · Issue #4248 · Unity-Technologies/com.unity.netcode.gameobjects
X Title: NetworkTransform: half-float base update dropped as out of order when UseUnreliableDeltas is on, so later deltas decode ~2 m off · Issue #4248 · Unity-Technologies/com.unity.netcode.gameobjects
Description: Description With UseHalfFloatPrecision and UseUnreliableDeltas both on, a non-authority NetworkTransform can lose a half-float base update and then decode every following delta against the old base. The object is drawn about 2 m off (one...
Open Graph Description: Description With UseHalfFloatPrecision and UseUnreliableDeltas both on, a non-authority NetworkTransform can lose a half-float base update and then decode every following delta against the old base...
X Description: Description With UseHalfFloatPrecision and UseUnreliableDeltas both on, a non-authority NetworkTransform can lose a half-float base update and then decode every following delta against the old base...
Opengraph URL: https://github.com/Unity-Technologies/com.unity.netcode.gameobjects/issues/4248
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"NetworkTransform: half-float base update dropped as out of order when UseUnreliableDeltas is on, so later deltas decode ~2 m off","articleBody":"### Description\n\nWith `UseHalfFloatPrecision` and `UseUnreliableDeltas` both on, a non-authority `NetworkTransform` can lose a half-float base update and then decode every following delta against the old base. The object is drawn about 2 m off (one `MaxDeltaBeforeAdjustment` step) until the next unreliable frame sync, up to a second later.\n\nHow it happens (line numbers from 2.13.3; the same code is in `develop-3.x.x` today):\n\n1. When an axis's delta reaches `NetworkDeltaPosition.MaxDeltaBeforeAdjustment` (2 m), the delta collapses into a new base. That state is flagged `SynchronizeBaseHalfFloat` and sent **reliably** (`NetworkTransformState.NetworkSerialize`, `NetworkTransform.cs:739-747`: `UseHalfFloatPrecision && NetworkDeltaPosition.CollapsedDeltaIntoBase` → `ReliableSequenced = true`).\n2. The deltas that follow go **unreliably**. Under jitter or a lost packet, a newer unreliable delta can arrive before the reliable base update.\n3. When the base update then arrives, it has an older tick than the state already applied. `OnNetworkStateChanged` drops it (`NetworkTransform.cs:3326`):\n ```csharp\n if (UseUnreliableDeltas && oldState.NetworkTick > newState.NetworkTick && !newState.FlagStates.IsTeleportingNextFrame && !newState.FlagStates.UnreliableFrameSync)\n {\n return;\n }\n ```\n Teleports and frame syncs are exempt, but a base sync isn't.\n4. The non-authority's `NetworkDeltaPosition` keeps the old base, so every later half-float delta decodes about 2 m off until a frame sync corrects it.\n\n### Reproduce Steps\n\n1. A player prefab with an owner-authoritative `NetworkTransform`: `UseHalfFloatPrecision` on, `UseUnreliableDeltas` on, position synced on all axes, interpolation on.\n2. Host + 1 client (client-server). Simulate a poor connection on the host: about 75 ms delay with ±20 ms jitter and 2% packet loss (Unity Transport's simulator pipeline, or the Multiplayer Tools network simulator).\n3. The client walks in a straight line at about 4.5 m/s for 20–30 s.\n4. On the host, compare its copy of the client's player with the client's real position (log both every frame).\n\n### Actual Outcome\n\nThe host's copy usually trails by about 0.6 m, but every few seconds it jumps 2 m or more off for up to a second. In our measurements it was 2.5–4.6 m behind during those stretches. Logging `NetworkDeltaPosition` on both sides during one of them: the host's base on the walking axis was 4.17 m while the client's was 6.25 m (one 2 m step plus the delta).\n\n### Expected Outcome\n\nA late base update is still applied (at least its base), so later deltas decode against the right base. Two possible fixes:\n- exempt `SynchronizeBaseHalfFloat` states from the out-of-order rule, as teleports and frame syncs are;\n- or apply the base of a dropped state to `NetworkDeltaPosition` even when its position is ignored.\n\n### Screenshots\n\nNone. The numbers above come from per-frame logs.\n\n### Environment\n\n- OS: Windows 11 Pro\n- Unity Version: 6000.3.27f1\n- Netcode Version: 2.13.3 (also present in `develop-3.x.x` and 3.2.0: the same check is at `NetworkTransform.cs:3345` there)\n- Netcode Commit: the v2.13.3 release\n- Netcode Topology: Client-Server (host)\n\n### Additional Context\n\n- Unity Transport 2.7.4.\n- With full-precision positions (half floats off, unreliable deltas kept) the host's copy stays within 0.82 m over the same walk, so the drops come from the base sync.\n- Our workaround: never combine half floats with unreliable deltas on a `NetworkTransform`.\n- Earlier half-float fixes (#2791, #2922) don't cover this ordering case, as far as we can tell.\n","author":{"url":"https://github.com/zchristensen01","@type":"Person","name":"zchristensen01"},"datePublished":"2026-11-10T22:03:54Z","url":"https://github.com/Unity-Technologies/com.unity.netcode.gameobjects/issues/4248"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:236b287c-5204-2300-8085-02b016c6371e |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D258:B4AA0:518389:71A482:6B00736D |
| html-safe-nonce | ecb1f845a34321a96cea60a160407e64377c2b744d89c91c8ca2cda4cc1aac24 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEMjU4OkI0QUEwOjUxODM4OTo3MUE0ODI6NkIwMDczNkQiLCJ2aXNpdG9yX2lkIjoiNzA1ODQyMDg2MTczNjM1MDU3MyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 497f2a0993c2c547381059a2e85d38e68a38cf0b4137d949ea3c489c3f19c566 |
| hovercard-subject-tag | issue:6316792604 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/Unity-Technologies/com.unity.netcode.gameobjects/4248/issue_layout |
| twitter:image | https://opengraph.githubassets.com/1bf0d811708c7db8d17a440d1eb5bea22e6cbad5e9ed7ce53b10c75bbf5ec769/Unity-Technologies/com.unity.netcode.gameobjects/issues/4248 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/1bf0d811708c7db8d17a440d1eb5bea22e6cbad5e9ed7ce53b10c75bbf5ec769/Unity-Technologies/com.unity.netcode.gameobjects/issues/4248 |
| og:image:alt | Description With UseHalfFloatPrecision and UseUnreliableDeltas both on, a non-authority NetworkTransform can lose a half-float base update and then decode every following delta against the old base... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | zchristensen01 |
| hostname | github.com |
| expected-hostname | github.com |
| None | 75c2b65dd205f26961d0c29afed1a8d0bb7cca9f05780571dfd1ef93eb539d16 |
| turbo-cache-control | no-preview |
| go-import | github.com/Unity-Technologies/com.unity.netcode.gameobjects git https://github.com/Unity-Technologies/com.unity.netcode.gameobjects.git |
| octolytics-dimension-user_id | 426196 |
| octolytics-dimension-user_login | Unity-Technologies |
| octolytics-dimension-repository_id | 116385203 |
| octolytics-dimension-repository_nwo | Unity-Technologies/com.unity.netcode.gameobjects |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 116385203 |
| octolytics-dimension-repository_network_root_nwo | Unity-Technologies/com.unity.netcode.gameobjects |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 84e563eb4b55f8fa102f325f117533cee9e3df4a |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width