File Format

.dtr Format and Compatibility

The canonical byte-level contract is docs/FORMAT.md.

Current Gates

Contract	Value
Magic	CSDTRREC
Writer / reader	v8 / v3-v8
Endianness	Little-endian
Manifest ABI	17
BotController ABI	16, minor 33+, capabilities 0x41ff
BotHider API	1
DemoTracer companion API	6

v1.0.3 reads existing v3-v8 replays. Do not reconvert solely for an upgrade; replace the complete Playback Bundle.

Versions

Version	Change
v3	Baseline readable format
v4	Projectile events and compensated sample timing
v5	Playback start index and freeze-time context
v6	High-fidelity metadata JSON
v7	Section container, command frames, movement extras
v8	Bit-exact columnar delta-varint snapshot and command-frame payloads

manifest.json groups player/side/round .dtr files and carries map, roster, chat, avatar, cosmetic, and compatibility metadata. Normal playback targets the manifest, not an isolated .dtr.

Compatibility Rules

• Manifest ABI or BotController major mismatch: hard error.
• BotController minor below 33 or missing required capabilities: replace bundle.
• Unknown optional v7+ sections may be skipped by declared size.
• Duplicate required sections, unsafe lengths, count mismatches, and unsupported versions must be rejected.
• Missing old-version evidence stays missing; do not infer it.