Types API

Schema types for packets, channels, and nested structs.

Primitives

string: ByteNet-style alias for string16 (2 + N bytes).
string8: Max length 255 chars (1 + N bytes). Consists of a 1-byte u8 length header followed by N bytes of UTF-8 string data.
string16: Max length 65,535 chars (2 + N bytes). Consists of a 2-byte u16 length header followed by N bytes of UTF-8 string data.

Vector3: Standard IEEE 754 single-precision floating-point format (12 bytes). It writes three 4-byte f32 values (X, Y, Z).
Vector2: Standard IEEE 754 single-precision floating-point format (8 bytes). It writes two 4-byte f32 values (X, Y).
Color3: Compressed RGB (3 bytes). Satset writes R, G, and B as single-byte values (0-255).
CFrame: Compressed using "smallest-three" quaternion compression (18 bytes). Standard uncompressed Roblox CFrames contain a Vector3 position and a 9-element rotation matrix. Satset compresses the rotation into a quaternion, omits the largest component, and transmits only the 3 smallest components alongside the position.

optional(type): Nullable type. Adds a 1-byte header (a u8 boolean flag) to check for nil.
array(type): Array of a specific type. Includes a 2-byte header (a u16 integer) for length (max 65,535 elements) followed by the array elements.
map(keyType, valType): Dictionary mapping. Includes a 2-byte header (a u16 integer) for element count. Keys are sorted alphabetically during serialization to produce deterministic byte order output.
enum(values: {string}): Maps string constants to a single 1-byte u8 index based on array position.

Vector3Quantized(range: number): Compressed Vector3 (6 bytes). Maps a stud range (default 1024) into 16-bit signed integers. Provides about 0.03 stud precision and halves the size of standard f32 vectors.
Vector2Quantized(range: number): Compressed Vector2 (4 bytes). Same quantization approach for 2D coordinates.

Satset keeps ByteNet-style names for compatibility and migration. The shorthand forms (u8, f64, etc.) remain the native names.