## 《极限竞速：地平线》系列 UDP 数据包完整定义

### 基础信息

| 属性 | 值 |
|------|-----|
| **协议** | UDP（单向发送，游戏不接收数据） |
| **包大小** | **324 字节（FH6）/ 约 311 字节（FH5）** |
| **发送频率** | 等于游戏帧率 |
| **字节序** | **Little Endian**（小端序） |
| **数据起始** | 玩家开始驾驶后发送，菜单/暂停/回放时不发送 |

> FH6 和 FH5 的数据包基本兼容，主要差异是 FH6 新增了 `CarGroup`、`SmashableVelDiff`、`SmashableMass` 三个字段。

---

### 类型符号说明

| 符号 | 含义 | 示例 |
|------|------|------|
| `S8` / `S32` | 有符号整数（signed） | S8 范围 -128~127 |
| `U8` / `U16` / `U32` | 无符号整数（unsigned） | U8 范围 0~255 |
| `F32` | 32位浮点数（float） | 小端序 |

---

### 完整数据包结构（按顺序）

#### 第 1 部分：状态和时间（8 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 0 | 4 | S32 | `IsRaceOn` | 1=比赛中，0=菜单/停止 |
| 4 | 4 | U32 | `TimestampMS` | 时间戳（毫秒，会溢出归零） |

#### 第 2 部分：引擎数据（12 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 8 | 4 | F32 | `EngineMaxRpm` | 引擎最大转速 |
| 12 | 4 | F32 | `EngineIdleRpm` | 引擎怠速转速 |
| 16 | 4 | F32 | `CurrentEngineRpm` | 当前引擎转速 |

#### 第 3 部分：加速度与速度（24 字节，车身坐标系 X=右, Y=上, Z=前）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 20 | 4 | F32 | `AccelerationX` |
| 24 | 4 | F32 | `AccelerationY` |
| 28 | 4 | F32 | `AccelerationZ` |
| 32 | 4 | F32 | `VelocityX` |
| 36 | 4 | F32 | `VelocityY` |
| 40 | 4 | F32 | `VelocityZ` |

#### 第 4 部分：角速度与方向（24 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 44 | 4 | F32 | `AngularVelocityX` | 俯仰（rad/s） |
| 48 | 4 | F32 | `AngularVelocityY` | 偏航（rad/s） |
| 52 | 4 | F32 | `AngularVelocityZ` | 侧倾（rad/s） |
| 56 | 4 | F32 | `Yaw` | 偏航角（弧度） |
| 60 | 4 | F32 | `Pitch` | 俯仰角（弧度） |
| 64 | 4 | F32 | `Roll` | 侧倾角（弧度） |

#### 第 5 部分：悬挂行程（16 字节，归一化 0=最大拉伸, 1=最大压缩）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 68 | 4 | F32 | `NormalizedSuspensionTravelFrontLeft` |
| 72 | 4 | F32 | `NormalizedSuspensionTravelFrontRight` |
| 76 | 4 | F32 | `NormalizedSuspensionTravelRearLeft` |
| 80 | 4 | F32 | `NormalizedSuspensionTravelRearRight` |

#### 第 6 部分：轮胎滑移比（16 字节，0=100%抓地力，|ratio|>1=失去抓地力）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 84 | 4 | F32 | `TireSlipRatioFrontLeft` |
| 88 | 4 | F32 | `TireSlipRatioFrontRight` |
| 92 | 4 | F32 | `TireSlipRatioRearLeft` |
| 96 | 4 | F32 | `TireSlipRatioRearRight` |

#### 第 7 部分：车轮转速（16 字节，弧度/秒）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 100 | 4 | F32 | `WheelRotationSpeedFrontLeft` |
| 104 | 4 | F32 | `WheelRotationSpeedFrontRight` |
| 108 | 4 | F32 | `WheelRotationSpeedRearLeft` |
| 112 | 4 | F32 | `WheelRotationSpeedRearRight` |

#### 第 8 部分：车轮状态（16 字节，0/1布尔值）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 116 | 4 | S32 | `WheelOnRumbleStripFrontLeft` |
| 120 | 4 | S32 | `WheelOnRumbleStripFrontRight` |
| 124 | 4 | S32 | `WheelOnRumbleStripRearLeft` |
| 128 | 4 | S32 | `WheelOnRumbleStripRearRight` |

#### 第 9 部分：涉水深度（16 字节，FH5 为深度值，FH6 为 0/1）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 132 | 4 | S32/F32 | `WheelInPuddleFrontLeft` |
| 136 | 4 | S32/F32 | `WheelInPuddleFrontRight` |
| 140 | 4 | S32/F32 | `WheelInPuddleRearLeft` |
| 144 | 4 | S32/F32 | `WheelInPuddleRearRight` |

> ⚠️ FH5 为 F32（水深值），FH6 为 S32（0/1布尔值）

#### 第 10 部分：路面震动反馈（16 字节）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 148 | 4 | F32 | `SurfaceRumbleFrontLeft` |
| 152 | 4 | F32 | `SurfaceRumbleFrontRight` |
| 156 | 4 | F32 | `SurfaceRumbleRearLeft` |
| 160 | 4 | F32 | `SurfaceRumbleRearRight` |

#### 第 11 部分：轮胎滑移角（16 字节）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 164 | 4 | F32 | `TireSlipAngleFrontLeft` |
| 168 | 4 | F32 | `TireSlipAngleFrontRight` |
| 172 | 4 | F32 | `TireSlipAngleRearLeft` |
| 176 | 4 | F32 | `TireSlipAngleRearRight` |

#### 第 12 部分：轮胎复合滑移（16 字节）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 180 | 4 | F32 | `TireCombinedSlipFrontLeft` |
| 184 | 4 | F32 | `TireCombinedSlipFrontRight` |
| 188 | 4 | F32 | `TireCombinedSlipRearLeft` |
| 192 | 4 | F32 | `TireCombinedSlipRearRight` |

#### 第 13 部分：实际悬挂行程（16 字节，单位：米）

| 偏移 | 大小 | 类型 | 字段 |
|------|------|------|------|
| 196 | 4 | F32 | `SuspensionTravelMetersFrontLeft` |
| 200 | 4 | F32 | `SuspensionTravelMetersFrontRight` |
| 204 | 4 | F32 | `SuspensionTravelMetersRearLeft` |
| 208 | 4 | F32 | `SuspensionTravelMetersRearRight` |

#### 第 14 部分：车辆信息（20 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 212 | 4 | S32 | `CarOrdinal` | 车辆唯一ID |
| 216 | 4 | S32 | `CarClass` | 等级 0(D) ~ 7(X) |
| 220 | 4 | S32 | `CarPerformanceIndex` | 性能指数 100~999 |
| 224 | 4 | S32 | `DrivetrainType` | 0=FWD, 1=RWD, 2=AWD |
| 228 | 4 | S32 | `NumCylinders` | 引擎气缸数 |

#### 第 15 部分：FH6 新增字段（12 字节）⚠️

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 232 | 4 | U32 | `CarGroup` | 车辆组标识（FH6新增） |
| 236 | 4 | F32 | `SmashableVelDiff` | 可破坏物体碰撞速度损失(m/s) |
| 240 | 4 | F32 | `SmashableMass` | 碰撞物体质量(kg) |

> ⚠️ **FH5 没有这三个字段**，此位置为 12 字节的占位数据（`HorizonPlaceholder`）

#### 第 16 部分：坐标与速度（16 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 244 | 4 | F32 | `PositionX` | 世界坐标 X（米） |
| 248 | 4 | F32 | `PositionY` | 世界坐标 Y（米） |
| 252 | 4 | F32 | `PositionZ` | 世界坐标 Z（米） |
| 256 | 4 | F32 | `Speed` | 速度（m/s） |

#### 第 17 部分：动力与温度（24 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 260 | 4 | F32 | `Power` | 功率（瓦特） |
| 264 | 4 | F32 | `Torque` | 扭矩（牛·米） |
| 268 | 4 | F32 | `TireTempFrontLeft` | 轮胎温度 |
| 272 | 4 | F32 | `TireTempFrontRight` | 轮胎温度 |
| 276 | 4 | F32 | `TireTempRearLeft` | 轮胎温度 |
| 280 | 4 | F32 | `TireTempRearRight` | 轮胎温度 |

#### 第 18 部分：增压与燃油（8 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 284 | 4 | F32 | `Boost` | 涡轮增压值（PSI，高于大气压） |
| 288 | 4 | F32 | `Fuel` | 燃油量（0.0~1.0） |

#### 第 19 部分：里程与圈时（28 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 292 | 4 | F32 | `DistanceTraveled` | 总行驶距离（米） |
| 296 | 4 | F32 | `BestLap` | 最佳圈时（秒） |
| 300 | 4 | F32 | `LastLap` | 上一圈用时（秒） |
| 304 | 4 | F32 | `CurrentLap` | 当前圈用时（秒） |
| 308 | 4 | F32 | `CurrentRaceTime` | 总比赛时间（秒） |

#### 第 20 部分：比赛信息（6 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 312 | 2 | U16 | `LapNumber` | 已完成圈数 |
| 314 | 1 | U8 | `RacePosition` | 当前排名位置 |

#### 第 21 部分：玩家输入（6 字节，值范围 0~255）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 315 | 1 | U8 | `Accel` | 油门（0~255） |
| 316 | 1 | U8 | `Brake` | 刹车（0~255） |
| 317 | 1 | U8 | `Clutch` | 离合器（0~255） |
| 318 | 1 | U8 | `HandBrake` | 手刹（0~255） |
| 319 | 1 | U8 | `Gear` | 当前档位 |

#### 第 22 部分：转向与AI（3 字节）

| 偏移 | 大小 | 类型 | 字段 | 说明 |
|------|------|------|------|------|
| 320 | 1 | S8 | `Steer` | 转向（-127左 ~ 0中 ~ 127右） |
| 321 | 1 | S8 | `NormalizedDrivingLine` | 归一化赛道线（-127~127） |
| 322 | 1 | S8 | `NormalizedAIBrakeDifference` | AI刹车差异（-127~127） |

---

### 快速参考：字段总数

- **FH6**：约 77 个字段，总计 **324 字节**
- **FH5**：约 74 个字段（比 FH6 少 CarGroup/SmashableVelDiff/SmashableMass），总计 **约 311 字节**
- **FH4**：和 FH5 基本一致