Class CatalogPosition
An archetype's position on the wire (W15, W16): what an enter record starts with and what a motion segment carries. Absent when the archetype is not spatial.
public sealed class CatalogPosition
- Inheritance
-
CatalogPosition
- Inherited Members
Remarks
It carries only what a client decodes. The extrapolation tolerance and the teleport speed are server policy no client reads; hashing them would re-send
the catalog to every client on every tuning change. A segment always carries t0 (tickLo) and epoch (u8): they are protocol
constants, not catalog entries.
Constructors
CatalogPosition()
public CatalogPosition()
Fields
LinearModel
The model for linear extrapolation: a segment carries a velocity.
public const string LinearModel = "linear"
Field Value
MotionKind
The kind for an archetype that moves: segments are replicated.
public const string MotionKind = "motion"
Field Value
NoneModel
The model without extrapolation: a segment carries a position only, and the client interpolates between samples.
public const string NoneModel = "none"
Field Value
StaticKind
The kind for an archetype that never moves: its position is sent once, on enter.
public const string StaticKind = "static"
Field Value
Properties
Ground
A ground-clamped mover (#1616, pos3 motion only): every segment starts with a u8, 1 when the entity is on the ground, 0 when it is not.
A grounded segment omits the Up axis of p0 and of the velocity: the client derives the height from the terrain it holds, and a
decoder reports it as NaN with a vertical velocity of 0. An airborne one is a full pos3 segment.
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool Ground { get; init; }
Property Value
Kind
MotionKind or StaticKind.
public string Kind { get; init; }
Property Value
Model
LinearModel or NoneModel, for a moving archetype only.
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public string Model { get; init; }
Property Value
Pos
public CatalogCodec Pos { get; init; }
Property Value
Up
For a Ground position, the vertical axis a grounded segment omits: 0, 1 or 2 (x, y, z).
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public int Up { get; init; }
Property Value
Vel
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public CatalogCodec Vel { get; init; }