t2-demo-parser 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,261 @@
+import type { ParsedData } from "./ClassRegistry.js";
+export declare const MaxGhostCount = 1024;
+export declare const GhostIdBitSize = 10;
+export declare const NetStringTableMaxStrings = 4096;
+export declare const StringIdBitSize = 12;
+export declare const NetEventClassBitSize = 6;
+export declare const NetEventClassFirst = 255;
+export declare const NetObjectClassBitSize = 7;
+export declare const NetObjectClassFirst = 0;
+export declare const MaxPacketDataSize = 1500;
+export declare const MaxTriggerKeys = 6;
+export declare const MoveCountBits = 5;
+export declare const MaxMoveCount = 30;
+export declare const GhostMsgGhostAlwaysDone = 0;
+export declare const GhostMsgGhostAlwaysAck = 1;
+export declare const GhostMsgEndGhosting = 2;
+export declare const GhostMsgGhostingActive = 3;
+export declare const DataBlockObjectIdFirst = 3;
+export declare const DataBlockObjectIdBitSize = 10;
+export declare const DataBlockObjectIdLast: number;
+export declare const DataBlockClassFirst = 128;
+export declare const DataBlockClassBitSize = 7;
+export declare const SimDBEventObjectIdBits = 11;
+export declare const SimDBEventClassIdBits = 7;
+export declare const SimDBEventIndexBits = 11;
+export declare const SimDBEventTotalBits = 12;
+export declare const DataBlockClassNames: readonly string[];
+export declare const NetObjectClassNames: readonly string[];
+export declare const NetEventClassNames: readonly string[];
+export declare const BlockTypePacket = 0;
+export declare const BlockTypeSendPacket = 1;
+export declare const BlockTypeMove = 2;
+export declare const BlockTypeInfo = 3;
+export declare const DataPacket = 0;
+export declare const PingPacket = 1;
+export declare const AckPacket = 2;
+export interface Move {
+    px: number;
+    py: number;
+    pz: number;
+    pyaw: number;
+    ppitch: number;
+    proll: number;
+    x: number;
+    y: number;
+    z: number;
+    yaw: number;
+    pitch: number;
+    roll: number;
+    id: number;
+    sendCount: number;
+    freeLook: boolean;
+    trigger: boolean[];
+}
+export interface InfoBlock {
+    value1: number;
+    value2: number;
+}
+export interface DataBlockHeader {
+    objectId: number;
+    classId: number;
+    index: number;
+    total: number;
+    dataBitsStart: number;
+}
+export interface DnetHeader {
+    gameFlag: boolean;
+    connectSeqBit: number;
+    seqNumber: number;
+    highestAck: number;
+    packetType: number;
+    ackByteCount: number;
+    ackMask: number;
+}
+export interface RateInfo {
+    updateDelay?: number;
+    packetSize?: number;
+    maxUpdateDelay?: number;
+    maxPacketSize?: number;
+}
+export interface GhostUpdate {
+    index: number;
+    type: "create" | "update" | "delete";
+    classId?: number;
+    updateBitsStart: number;
+    updateBitsEnd: number;
+    parsedData?: ParsedData;
+}
+export interface NetEventInfo {
+    classId: number;
+    guaranteed: boolean;
+    sequenceNumber?: number;
+    absoluteSequenceNumber?: number;
+    dataBitsStart: number;
+    dataBitsEnd: number;
+    parsedData?: ParsedData;
+}
+export interface PacketData {
+    dnetHeader: DnetHeader;
+    rateInfo: RateInfo;
+    gameState: GameState;
+    events: NetEventInfo[];
+    ghosts: GhostUpdate[];
+    /** Bit position where ghost section starts (readGhosts call). */
+    ghostSectionStart?: number;
+}
+export interface GameState {
+    lastMoveAck: number;
+    damageFlash?: number;
+    whiteOut?: number;
+    selfLocked?: boolean;
+    selfHomed?: boolean;
+    seekerTracking?: boolean;
+    seekerTrackingPos?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    seekerMode?: number;
+    seekerObjectGhostIndex?: number;
+    targetPos?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    pinged: boolean;
+    jammed: boolean;
+    controlObjectGhostIndex?: number;
+    controlObjectDataStart?: number;
+    controlObjectDataEnd?: number;
+    controlObjectData?: ParsedData;
+    compressionPoint?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    targetVisibility?: {
+        index: number;
+        mask: number;
+    }[];
+    cameraFov?: number;
+}
+export interface DemoBlock {
+    index: number;
+    type: number;
+    size: number;
+    data: Uint8Array;
+    parsed?: PacketData | Move | InfoBlock;
+}
+export interface ConnectionProtocolState {
+    lastSeqRecvdAtSend: number[];
+    lastSeqRecvd: number;
+    highestAckedSeq: number;
+    lastSendSeq: number;
+    ackMask: number;
+    connectSequence: number;
+    lastRecvAckAck: number;
+    connectionEstablished: boolean;
+}
+export interface StringTableEntry {
+    id: number;
+    value: string;
+}
+export interface ParsedDataBlock {
+    classId: number;
+    className: string;
+    objectId: number;
+    data: ParsedData;
+}
+export interface ScoreEntry {
+    clientId: number;
+    teamId: number;
+    score: number;
+    field0: number;
+    field1: number;
+    field2: number;
+    isBot: boolean;
+    triggerFlags: boolean[];
+}
+/**
+ * IFF (Identification Friend or Foe) color for one sensor group pairing.
+ * sensorGroupColors[myGroup][theirGroup] determines how `theirGroup` appears
+ * to `myGroup` (e.g., red for enemy, green for friendly).
+ */
+export interface SensorGroupColor {
+    group: number;
+    targetGroup: number;
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface TargetEntry {
+    targetId: number;
+    sensorData?: number;
+    voiceMapData?: number;
+    name?: string;
+    skin?: string;
+    skinPref?: string;
+    voice?: string;
+    typeDescription?: string;
+    sensorGroup: number;
+    targetData: number;
+    dataBlockRef?: number;
+    damageLevel: number;
+}
+export interface PathManagerEntry {
+    entryId: number;
+    records: {
+        field0: number;
+        field1: number;
+        field2: number;
+        auxField: number;
+    }[];
+}
+export interface InitialBlockData {
+    taggedStrings: Map<number, string>;
+    dataBlockHeaders: DataBlockHeader[];
+    dataBlockCount: number;
+    dataBlocks: Map<number, ParsedDataBlock>;
+    /** Initial $firstPerson state from GameConnection::writeDemoStartBlock. */
+    firstPerson: boolean;
+    connectionFields: number[];
+    stateArray: number[];
+    scoreEntries: ScoreEntry[];
+    demoValues: string[];
+    sensorGroupColors: SensorGroupColor[];
+    targetEntries: TargetEntry[];
+    connectionState: ConnectionProtocolState;
+    roundTripTime: number;
+    packetLoss: number;
+    pathManager: PathManagerEntry[];
+    notifyCount: number;
+    nextRecvEventSeq: number;
+    ghostingSequence: number;
+    initialGhosts: GhostUpdate[];
+    initialEvents: NetEventInfo[];
+    controlObjectGhostIndex: number;
+    controlObjectData?: ParsedData;
+    missionName: string;
+    missionCRC: number;
+    phase2TrailingBits?: number;
+    phase2Valid?: boolean;
+    phase2Error?: string;
+}
+export interface DemoHeader {
+    identString: string;
+    protocolVersion: number;
+    demoLengthMs: number;
+    initialBlockSize: number;
+}
+export interface DemoFile {
+    header: DemoHeader;
+    initialBlock: InitialBlockData;
+    blocks: DemoBlock[];
+}
+export interface LoadResult {
+    header: DemoHeader;
+    initialBlock: InitialBlockData;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,204 @@
+// Key constants from the V12 engine source
+export const MaxGhostCount = 1024;
+export const GhostIdBitSize = 10;
+export const NetStringTableMaxStrings = 4096;
+export const StringIdBitSize = 12;
+export const NetEventClassBitSize = 6;
+export const NetEventClassFirst = 255;
+export const NetObjectClassBitSize = 7;
+export const NetObjectClassFirst = 0;
+export const MaxPacketDataSize = 1500;
+export const MaxTriggerKeys = 6;
+export const MoveCountBits = 5;
+export const MaxMoveCount = 30;
+// GhostingMessageEvent message types (NetConnection::GhostMSG enum).
+export const GhostMsgGhostAlwaysDone = 0;
+export const GhostMsgGhostAlwaysAck = 1;
+export const GhostMsgEndGhosting = 2;
+export const GhostMsgGhostingActive = 3;
+// DataBlock constants.
+// For SimDataBlockEvent header (initial block + events), the binary uses:
+//   readInt(11) objectId, readInt(7) classId, readInt(11) index, readInt(12) total.
+// For DataBlock references in payloads (readDataBlockRef), V12 source uses:
+//   readRangedU32(DataBlockObjectIdFirst, DataBlockObjectIdLast).
+export const DataBlockObjectIdFirst = 3;
+export const DataBlockObjectIdBitSize = 10;
+export const DataBlockObjectIdLast = DataBlockObjectIdFirst + (1 << DataBlockObjectIdBitSize) - 1; // 1026
+export const DataBlockClassFirst = 128;
+export const DataBlockClassBitSize = 7;
+// SimDataBlockEvent header bit sizes (from decompiled binary).
+// These are the HEADER field sizes, which differ from the payload reference sizes.
+// readClassInfo uses getNextPow2(0x800=2048) → getBitCount(2048)=11 for objectId.
+// The classId, index, and total are read with literal values 7, 11, 12 (from 0x80, 0xb, 0xc).
+export const SimDBEventObjectIdBits = 11;
+export const SimDBEventClassIdBits = 7; // same as DataBlockClassBitSize
+export const SimDBEventIndexBits = 11;
+export const SimDBEventTotalBits = 12;
+// Deterministic DataBlock class name mapping, derived from machine code
+// analysis of the Tribes 2 binary (build 25034). All 54 DataBlock classes
+// with mClassIdBase=0x80 are sorted by C strcmp (ASCII byte order), which
+// is how AbstractClassRep::initialize assigns sequential classIds.
+// Index N in this array corresponds to classId N (group-local) or
+// classId N+128 (V12 global format).
+export const DataBlockClassNames = [
+    "AudioDescription", // 0 / 128
+    "AudioEnvironment", // 1 / 129
+    "AudioProfile", // 2 / 130
+    "AudioSampleEnvironment", // 3 / 131
+    "BombProjectileData", // 4 / 132
+    "CameraData", // 5 / 133
+    "CannedChatItem", // 6 / 134
+    "CommanderIconData", // 7 / 135
+    "DebrisData", // 8 / 136
+    "DecalData", // 9 / 137
+    "ELFProjectileData", // 10 / 138
+    "EffectProfile", // 11 / 139
+    "EnergyProjectileData", // 12 / 140
+    "ExplosionData", // 13 / 141
+    "FireballAtmosphereData", // 14 / 142
+    "FlareProjectileData", // 15 / 143
+    "FlyingVehicleData", // 16 / 144
+    "ForceFieldBareData", // 17 / 145
+    "GameBaseData", // 18 / 146
+    "GrenadeProjectileData", // 19 / 147
+    "HoverVehicleData", // 20 / 148
+    "ItemData", // 21 / 149
+    "JetEffectData", // 22 / 150
+    "LightningData", // 23 / 151
+    "LinearFlareProjectileData", // 24 / 152
+    "LinearProjectileData", // 25 / 153
+    "MissionMarkerData", // 26 / 154
+    "ParticleData", // 27 / 155
+    "ParticleEmissionDummyData", // 28 / 156
+    "ParticleEmitterData", // 29 / 157
+    "PlayerData", // 30 / 158
+    "PrecipitationData", // 31 / 159
+    "ProjectileData", // 32 / 160
+    "RepairProjectileData", // 33 / 161
+    "RunningLightData", // 34 / 162
+    "SeekerProjectileData", // 35 / 163
+    "SensorData", // 36 / 164
+    "ShapeBaseData", // 37 / 165
+    "ShapeBaseImageData", // 38 / 166
+    "ShockLanceProjectileData", // 39 / 167
+    "ShockwaveData", // 40 / 168
+    "SimDataBlock", // 41 / 169
+    "SniperProjectileData", // 42 / 170
+    "SplashData", // 43 / 171
+    "StaticShapeData", // 44 / 172
+    "StationFXPersonalData", // 45 / 173
+    "StationFXVehicleData", // 46 / 174
+    "TSShapeConstructor", // 47 / 175
+    "TargetProjectileData", // 48 / 176
+    "TracerProjectileData", // 49 / 177
+    "TriggerData", // 50 / 178
+    "TurretData", // 51 / 179
+    "TurretImageData", // 52 / 180
+    "WheeledVehicleData", // 53 / 181
+];
+// Deterministic NetObject (ghost) class name mapping, derived from machine code
+// analysis of the Tribes 2 binary (build 25034). All 53 NetObject classes
+// with mClassIdBase=0 are sorted by C strcmp (ASCII byte order), which
+// is how AbstractClassRep::initialize assigns sequential classIds.
+// Index N in this array corresponds to classId N (NetObjectClassFirst + N).
+// Verified against decompiled FUN_00423cb0 class table initialization.
+// Vehicle is NOT a ghost class (classGroup=0xFFFFFFFF in binary).
+export const NetObjectClassNames = [
+    "AIObjective", // 0
+    "AudioEmitter", // 1
+    "BeaconObject", // 2
+    "BombProjectile", // 3
+    "Camera", // 4
+    "Debris", // 5
+    "ELFProjectile", // 6
+    "EnergyProjectile", // 7
+    "FireballAtmosphere", // 8
+    "FlareProjectile", // 9
+    "FlyingVehicle", // 10
+    "ForceFieldBare", // 11
+    "GameBase", // 12
+    "GrenadeProjectile", // 13
+    "HoverVehicle", // 14
+    "InteriorInstance", // 15
+    "Item", // 16
+    "Lightning", // 17
+    "LinearFlareProjectile", // 18
+    "LinearProjectile", // 19
+    "Marker", // 20
+    "MissionArea", // 21
+    "MissionMarker", // 22
+    "ParticleEmissionDummy", // 23
+    "PhysicalZone", // 24
+    "Player", // 25
+    "Precipitation", // 26
+    "Projectile", // 27
+    "RepairProjectile", // 28
+    "ScopeAlwaysShape", // 29
+    "SeekerProjectile", // 30
+    "ShapeBase", // 31
+    "ShockLanceProjectile", // 32
+    "Shockwave", // 33
+    "SimpleNetObject", // 34
+    "Sky", // 35
+    "SniperProjectile", // 36
+    "SpawnSphere", // 37
+    "Splash", // 38
+    "StaticShape", // 39
+    "StationFXPersonal", // 40
+    "StationFXVehicle", // 41
+    "Sun", // 42
+    "TSStatic", // 43
+    "TargetProjectile", // 44
+    "TerrainBlock", // 45
+    "TracerProjectile", // 46
+    "Trigger", // 47
+    "Turret", // 48
+    "VehicleBlocker", // 49
+    "WaterBlock", // 50
+    "WayPoint", // 51
+    "WheeledVehicle", // 52
+];
+// Deterministic NetEvent class name mapping, derived from machine code
+// analysis of the Tribes 2 binary (build 25034). All 26 NetEvent classes
+// with mClassIdBase=0xFF are sorted by C strcmp (ASCII byte order), which
+// is how AbstractClassRep::initialize assigns sequential classIds.
+// Index N in this array corresponds to classId NetEventClassFirst + N (255 + N).
+export const NetEventClassNames = [
+    "CRCChallengeEvent", // 0 / 255
+    "CRCChallengeResponseEvent", // 1 / 256
+    "FogChallengeEvent", // 2 / 257
+    "GhostAlwaysObjectEvent", // 3 / 258
+    "GhostingMessageEvent", // 4 / 259
+    "GravityEvent", // 5 / 260
+    "LightningStrikeEvent", // 6 / 261
+    "NetStringEvent", // 7 / 262
+    "PathManagerEvent", // 8 / 263
+    "RemoteCommandEvent", // 9 / 264
+    "RemoveClientTargetTypeEvent", // 10 / 265
+    "ResetClientTargetsEvent", // 11 / 266
+    "SensorGroupColorEvent", // 12 / 267
+    "SetMissionCRCEvent", // 13 / 268
+    "SetObjectActiveImageEvent", // 14 / 269
+    "SetSensorGroupEvent", // 15 / 270
+    "SetServerTargetEvent", // 16 / 271
+    "Sim2DAudioEvent", // 17 / 272
+    "Sim3DAudioEvent", // 18 / 273
+    "SimDataBlockEvent", // 19 / 274
+    "SimTargetAudioEvent", // 20 / 275
+    "SimVoiceStreamEvent", // 21 / 276
+    "SimpleMessageEvent", // 22 / 277
+    "TargetFreeEvent", // 23 / 278
+    "TargetInfoEvent", // 24 / 279
+    "TargetToEvent", // 25 / 280
+];
+// Block types in the U16 packed format (type = typeSize >> 12)
+// These are from TorqueSDK-style recordBlock/handleRecordedBlock
+export const BlockTypePacket = 0; // Received network packet (dnet data)
+export const BlockTypeSendPacket = 1; // SendPacket trigger (size=0, no data)
+export const BlockTypeMove = 2; // Raw Move struct (64 bytes)
+export const BlockTypeInfo = 3; // Info block (8 bytes: U32 + F32)
+// Packet types from dnet
+export const DataPacket = 0;
+export const PingPacket = 1;
+export const AckPacket = 2;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "t2-demo-parser",
+  "version": "1.0.0",
+  "author": "Brian Beck <exogen@gmail.com>",
+  "description": "Parser for Tribes 2 demo recordings (.rec files)",
+  "keywords": [
+    "tribes2",
+    "tribes-2",
+    "torque",
+    "demo",
+    "replay",
+    "parser"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "t2-demo-parser": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "debug": "^4.4.3",
+    "fflate": "^0.8.2"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.12",
+    "@types/node": "^25.2.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}