NetworkTransform: half-float base update dropped as out of order when UseUnreliableDeltas is on, so later deltas decode ~2 m off

オープン
#4,248 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 3 日以内に返信

@NoelStephensUnity がすでに取り組んでいます。

2026年11月13日 から。

  • #4252 @NoelStephensUnity による — オープン

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
57/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
csharp, unity
領域
networking

調査の方向性

Start in NetworkTransform.cs at the out-of-order check in OnNetworkStateChanged (around line 3326 in 2.13.3) and the serialization logic around lines 739–747 that marks half-float base updates reliable. Trace how SynchronizeBaseHalfFloat updates NetworkDeltaPosition when a late state arrives. Done when a late base is retained or applied so subsequent deltas decode against it; verify with the described jitter and packet-loss reproduction.

索引モデルが issue の本文から書いたものです。

説明

port:3.x-completed priority:medium stat:imported type:bug
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 MaxDeltaBeforeAdjustment step) until the next unreliable frame sync, up to a second later.

How it happens (line numbers from 2.13.3; the same code is in develop-3.x.x today):

  1. 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).
  2. The deltas that follow go unreliably. Under jitter or a lost packet, a newer unreliable delta can arrive before the reliable base update.
  3. When the base update then arrives, it has an older tick than the state already applied. OnNetworkStateChanged drops it (NetworkTransform.cs:3326):
    if (UseUnreliableDeltas && oldState.NetworkTick > newState.NetworkTick && !newState.FlagStates.IsTeleportingNextFrame && !newState.FlagStates.UnreliableFrameSync)
    {
        return;
    }
    
    Teleports and frame syncs are exempt, but a base sync isn't.
  4. 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.
Reproduce Steps
  1. A player prefab with an owner-authoritative NetworkTransform: UseHalfFloatPrecision on, UseUnreliableDeltas on, position synced on all axes, interpolation on.
  2. 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).
  3. The client walks in a straight line at about 4.5 m/s for 20–30 s.
  4. On the host, compare its copy of the client's player with the client's real position (log both every frame).
Actual Outcome

The 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).

Expected Outcome

A late base update is still applied (at least its base), so later deltas decode against the right base. Two possible fixes:

  • exempt SynchronizeBaseHalfFloat states from the out-of-order rule, as teleports and frame syncs are;
  • or apply the base of a dropped state to NetworkDeltaPosition even when its position is ignored.
Screenshots

None. The numbers above come from per-frame logs.

Environment
  • OS: Windows 11 Pro
  • Unity Version: 6000.3.27f1
  • 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)
  • Netcode Commit: the v2.13.3 release
  • Netcode Topology: Client-Server (host)
Additional Context
  • Unity Transport 2.7.4.
  • 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.
  • Our workaround: never combine half floats with unreliable deltas on a NetworkTransform.
  • Earlier half-float fixes (#2791, #2922) don't cover this ordering case, as far as we can tell.
主要言語
C#
スター
2.3k
フォーク
465
平均マージ
3日 12時間
マージ済み PR(30日)
39

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Unity-Technologies/com.unity.netcode.gameobjects のほかの issue

Unity-Technologies/com.unity.netcode.gameobjects の issue をすべて見る

似ている issue

C# の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。