t2-demo-parser 1.0.3 → 2.1.0

package/dist/DataBlockParsers.test.js

@@ -62,6 +62,134 @@ describe("projectile datablock field decoding", () => {
         // disc.cs: reflectOnWaterImpactAngle = 15.0.
         expect(disc.reflectOnWaterImpactAngle).toBe(15);
     });
+    it("decodes retail EnergyBolt (blaster) fields exactly", async () => {
+        const dataBlocks = await loadDataBlocks("exogen_Katabatic_vpad.rec");
+        let bolt;
+        for (const [, db] of dataBlocks) {
+            if (db.className === "EnergyProjectileData") {
+                bolt = db.data;
+                break;
+            }
+        }
+        expect(bolt, "retail EnergyBolt datablock").toBeDefined();
+        // blaster.cs: binary-verified names (initPersistFields FUN_00694b40,
+        // unpackData FUN_00694d80) — these were previously mislabeled with
+        // ELF-style beam field names.
+        expect(bolt.crossViewAng).toBeCloseTo(0.99, 5);
+        expect(bolt.crossSize).toBeCloseTo(0.55, 5);
+        expect(bolt.blurLifetime).toBeCloseTo(0.2, 5);
+        expect(bolt.blurWidth).toBeCloseTo(0.25, 5);
+        expect(bolt.blurColor.r).toBeCloseTo(0.4, 5);
+        expect(bolt.blurColor.g).toBeCloseTo(0, 5);
+        expect(bolt.blurColor.b).toBeCloseTo(0, 5);
+        expect(bolt.texture0).toBe("special/blasterBolt");
+        expect(bolt.texture1).toBe("special/blasterBoltCross");
+        // blaster.cs: scale = "0.25 20.0 1.0" (bolt quad half-width / length).
+        expect(bolt.scale.x).toBeCloseTo(0.25, 5);
+        expect(bolt.scale.y).toBeCloseTo(20, 5);
+    });
+    it("decodes retail BasicSniperShot (laser rifle) fields exactly", async () => {
+        const dataBlocks = await loadDataBlocks("exogen_Katabatic_vpad.rec");
+        let shot;
+        for (const [, db] of dataBlocks) {
+            if (db.className === "SniperProjectileData") {
+                shot = db.data;
+                break;
+            }
+        }
+        expect(shot, "retail BasicSniperShot datablock").toBeDefined();
+        // sniperRifle.cs values.
+        expect(shot.maxRifleRange).toBeCloseTo(1000, 5);
+        expect(shot.beamColor.r).toBeCloseTo(1, 2);
+        expect(shot.beamColor.g).toBeCloseTo(0.1, 2);
+        expect(shot.beamColor.b).toBeCloseTo(0.1, 2);
+        expect(shot.fadeTime).toBeCloseTo(1.0, 5);
+        expect(shot.startBeamWidth).toBeCloseTo(0.145, 5);
+        expect(shot.endBeamWidth).toBeCloseTo(0.25, 5);
+        expect(shot.pulseSpeed).toBeCloseTo(6.0, 5);
+        expect(shot.pulseLength).toBeCloseTo(0.15, 5);
+        expect(shot.textures[0]).toBe("special/flare");
+        expect(shot.textures[1]).toBe("special/nonlingradient");
+        expect(shot.textures[2]).toBe("special/laserrip01");
+        expect(shot.textures[11]).toBe("special/sniper00");
+    });
+    it("decodes both ELF datablocks (gun and turret) exactly", async () => {
+        const dataBlocks = await loadDataBlocks("exogen_Katabatic_vpad.rec");
+        const elfs = [];
+        for (const [, db] of dataBlocks) {
+            if (db.className === "ELFProjectileData") {
+                elfs.push(db.data);
+            }
+        }
+        // Binary-verified names (initPersistFields FUN_0064a860, unpackData
+        // FUN_0064ae00) — previously fabricated beam names. Two datablocks
+        // exist: the handheld BasicELF at beamRange 38 (the z0dd/ZOD server
+        // patch every surviving server lineage runs — "WHAT?? INCREASE ELF
+        // RANGE?!!? was 37"; the stock script says 30) and the stock
+        // ELFTurretBolt at 75 (ELFBarrelLarge.cs).
+        expect(elfs.map((e) => e.beamRange).sort((a, b) => a - b)).toEqual([
+            38, 75,
+        ]);
+        for (const elf of elfs) {
+            expect(elf.mainBeamWidth).toBeCloseTo(0.1, 5);
+            expect(elf.mainBeamSpeed).toBeCloseTo(9.0, 5);
+            expect(elf.mainBeamRepeat).toBeCloseTo(0.25, 5);
+            expect(elf.lightningWidth).toBeCloseTo(0.1, 5);
+            expect(elf.lightningDist).toBeCloseTo(0.15, 5);
+            expect(elf.textures).toEqual([
+                "special/ELFBeam",
+                "special/ELFLightning",
+                "special/BlueImpact",
+            ]);
+        }
+    });
+    it("decodes retail DefaultRepairBeam fields exactly", async () => {
+        const dataBlocks = await loadDataBlocks("exogen_Katabatic_vpad.rec");
+        let repair;
+        for (const [, db] of dataBlocks) {
+            if (db.className === "RepairProjectileData") {
+                repair = db.data;
+                break;
+            }
+        }
+        expect(repair, "retail DefaultRepairBeam datablock").toBeDefined();
+        // repairpack.cs: binary-verified names (initPersistFields
+        // FUN_00644910, unpackData FUN_00644c40); numSegments is an S32
+        // whose raw bits the old decode read as a float.
+        expect(repair.beamRange).toBeCloseTo(10, 5);
+        expect(repair.beamWidth).toBeCloseTo(0.15, 5);
+        expect(repair.numSegments).toBe(20);
+        expect(repair.texRepeat).toBeCloseTo(0.2, 5);
+        expect(repair.blurFreq).toBeCloseTo(10.0, 5);
+        expect(repair.blurLifetime).toBeCloseTo(1.0, 5);
+        expect(repair.cutoffAngle).toBeCloseTo(25.0, 5);
+        expect(repair.textures).toEqual(["special/redbump2", "special/redflare"]);
+    });
+    it("decodes image-state transitions in the engine packing order", async () => {
+        // Every retail weapon image opens Activate → (timeout) →
+        // ActivateReady (e.g. blaster.cs stateTransitionOnTimeout[0]).
+        // With the old rotated names, the timeout transition surfaced under
+        // transitionGeneric0Out and consumers carried a remap table.
+        const dataBlocks = await loadDataBlocks("exogen_Katabatic_vpad.rec");
+        let checked = 0;
+        for (const [, db] of dataBlocks) {
+            if (db.className !== "ShapeBaseImageData")
+                continue;
+            const data = db.data;
+            const states = data.states;
+            if (!states || states.length < 2)
+                continue;
+            if (states[0].name.toLowerCase() !== "activate")
+                continue;
+            const readyIndex = states.findIndex((st) => st.name.toLowerCase() === "activateready");
+            if (readyIndex < 0)
+                continue;
+            // Transition values are 1-based state indices (0 = none).
+            expect(states[0].transitionOnTimeout).toBe(readyIndex + 1);
+            checked++;
+        }
+        expect(checked).toBeGreaterThan(3);
+    });
     it("decodes retail ChaingunBullet tracer fields exactly", async () => {
         const dataBlocks = await loadDataBlocks("exogen_Katabatic_vpad.rec");
         let bullet;

package/dist/DataBlockParsers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataBlockParsers.test.js","sourceRoot":"","sources":["../src/DataBlockParsers.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { DemoParser } from \"./DemoParser.js\";\nimport type {\n  LinearProjectileDataBlock,\n  PlayerDataBlock,\n  TracerProjectileDataBlock,\n} from \"./dataBlockDataTypes.js\";\n\nconst DEMO_DIR = path.resolve(import.meta.dirname, \"..\", \"data\");\n\nasync function loadDataBlocks(file: string) {\n  const buffer = fs.readFileSync(path.join(DEMO_DIR, file));\n  const parser = new DemoParser(new Uint8Array(buffer));\n  const { initialBlock } = await parser.load();\n  return initialBlock.dataBlocks;\n}\n\n/**\n * Regression tests for projectile datablock field naming, which was\n * binary-verified against Tribes2.exe build 25034 (initPersistFields\n * FUN_0062b3c0 / FUN_0063fcb0 map names to the struct offsets that\n * unpackData reads in order). Prior to that verification several fields\n * were misassigned — most damagingly, the true lifetimeMS landed in a\n * field named `fizzleType`, breaking client-side projectile simulation.\n */\ndescribe(\"projectile datablock field decoding\", () => {\n  it(\"decodes LinearProjectileData fields with engine semantics\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    const linears: LinearProjectileDataBlock[] = [];\n    for (const [, db] of dataBlocks) {\n      if (\n        db.className === \"LinearProjectileData\" ||\n        db.className === \"TracerProjectileData\" ||\n        db.className === \"LinearFlareProjectileData\"\n      ) {\n        linears.push(db.data as LinearProjectileDataBlock);\n      }\n    }\n    expect(linears.length).toBeGreaterThan(0);\n\n    for (const block of linears) {\n      // lifetimeMS/fizzleTimeMS are real milliseconds, rounded up to a\n      // 32ms tick by the engine's onAdd, and clamped to 511 ticks.\n      expect(block.lifetimeMS! % 32).toBe(0);\n      expect(block.lifetimeMS).toBeGreaterThanOrEqual(32);\n      expect(block.lifetimeMS).toBeLessThanOrEqual(511 * 32);\n      expect(block.fizzleTimeMS! % 32).toBe(0);\n      // Angles are ranged 0–90 degrees on the wire.\n      expect(block.reflectOnWaterImpactAngle).toBeGreaterThanOrEqual(0);\n      expect(block.reflectOnWaterImpactAngle).toBeLessThanOrEqual(90);\n      expect(typeof block.explodeOnDeath).toBe(\"boolean\");\n      expect(typeof block.doDynamicClientHits).toBe(\"boolean\");\n    }\n  });\n\n  it(\"decodes retail DiscProjectile exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let disc: LinearProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      const data = db.data as LinearProjectileDataBlock;\n      if (\n        db.className === \"LinearProjectileData\" &&\n        data.dryVelocity === 90 &&\n        data.explodeOnDeath === true\n      ) {\n        disc = data;\n        break;\n      }\n    }\n    expect(disc, \"retail DiscProjectile datablock\").toBeDefined();\n    // disc.cs: lifetimeMS = fizzleTimeMS = 5000 → tick-rounded to 5024.\n    expect(disc!.lifetimeMS).toBe(5024);\n    expect(disc!.fizzleTimeMS).toBe(5024);\n    // disc.cs: reflectOnWaterImpactAngle = 15.0.\n    expect(disc!.reflectOnWaterImpactAngle).toBe(15);\n  });\n\n  it(\"decodes retail ChaingunBullet tracer fields exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let bullet: TracerProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      const data = db.data as TracerProjectileDataBlock;\n      if (\n        db.className === \"TracerProjectileData\" &&\n        data.tracerTex0 === \"special/tracer00\" &&\n        data.lifetimeMS === 3008\n      ) {\n        bullet = data;\n        break;\n      }\n    }\n    expect(bullet, \"ChaingunBullet datablock\").toBeDefined();\n    // Values as recorded in this demo (a lightly modded server — tracer\n    // length/width are doubled from retail, everything else matches\n    // chaingun.cs). Each assertion pins a decode position: a swap with\n    // any neighboring field would produce a nonsensical value here.\n    expect(bullet!.dryVelocity).toBe(750);\n    expect(bullet!.wetVelocity).toBe(280);\n    expect(bullet!.fizzleTimeMS).toBe(3008);\n    expect(bullet!.explodeOnDeath).toBe(false);\n    // Chainguns are the only retail weapons with doDynamicClientHits.\n    expect(bullet!.doDynamicClientHits).toBe(true);\n    // activateDelayMS = -1 (retail default) read as U32.\n    expect(bullet!.activateDelayMS).toBe(0xffffffff);\n    expect(bullet!.tracerLength).toBe(30);\n    expect(bullet!.tracerMinPixels).toBe(6);\n    expect(bullet!.tracerWidth).toBeCloseTo(0.2, 5);\n    expect(bullet!.tracerAlpha).toBe(false);\n    // Retail chaingun.cs tracerColor: 211/255, 215/255, 120/255, 0.75.\n    expect(bullet!.tracerColor!.r).toBeCloseTo(211 / 255, 2);\n    expect(bullet!.tracerColor!.g).toBeCloseTo(215 / 255, 2);\n    expect(bullet!.tracerColor!.b).toBeCloseTo(120 / 255, 2);\n    expect(bullet!.crossViewAng).toBeCloseTo(0.99, 5);\n    expect(bullet!.crossSize).toBeCloseTo(0.2, 5);\n    expect(bullet!.renderCross).toBe(true);\n    expect(bullet!.tracerTex1).toBe(\"special/tracercross\");\n  });\n\n  it(\"decodes PlayerData movement/jet fields with engine semantics\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let armor: PlayerDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      const data = db.data as PlayerDataBlock;\n      // The armor the recorder wears: retail-value run/speed section.\n      if (db.className === \"PlayerData\" && data.maxForwardSpeed === 15) {\n        armor = data;\n        break;\n      }\n    }\n    expect(armor, \"light armor PlayerData datablock\").toBeDefined();\n    // Retail player.cs values — each pins a decode position (previously\n    // these landed in fields named jumpForce/runSurfaceAngle/etc.).\n    expect(armor!.runForce).toBe(4968); // 55.2 * 90\n    expect(armor!.maxBackwardSpeed).toBe(13);\n    expect(armor!.maxSideSpeed).toBe(13);\n    expect(armor!.underwaterVertJetFactor).toBeCloseTo(1.5, 5);\n    expect(armor!.minLookAngle).toBeCloseTo(-1.5, 5);\n    expect(armor!.maxLookAngle).toBeCloseTo(1.5, 5);\n    // Jet energy fields must decode as plausible per-tick magnitudes\n    // (this server mods them slightly, so no exact match): drain is a\n    // fraction of maxEnergy(60), threshold is a small energy value.\n    expect(armor!.jetEnergyDrain).toBeGreaterThan(0);\n    expect(armor!.jetEnergyDrain).toBeLessThan(5);\n    expect(armor!.underwaterJetEnergyDrain).toBeGreaterThan(0);\n    expect(armor!.underwaterJetEnergyDrain).toBeLessThan(5);\n    expect(armor!.minJetEnergy).toBeGreaterThanOrEqual(0);\n    expect(armor!.minJetEnergy).toBeLessThan(10);\n    // Heat signature rates — retail player.cs: 1/4 and 1/3. These are the\n    // first two reads of the ground-impact tail; the old decode shifted\n    // the whole section by two slots.\n    expect(armor!.heatDecayPerSec).toBeCloseTo(0.25, 5);\n    expect(armor!.heatIncreasePerSec).toBeCloseTo(1 / 3, 5);\n    expect(armor!.groundImpactShakeDuration).toBeCloseTo(0.6, 5);\n    expect(armor!.groundImpactShakeFalloff).toBeCloseTo(10, 5);\n  });\n\n  it(\"decodes StationFX node names and textures exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let vehicleFX: Record<string, unknown> | undefined;\n    let personalFX: Record<string, unknown> | undefined;\n    for (const [, db] of dataBlocks) {\n      if (db.className === \"StationFXVehicleData\") vehicleFX ??= db.data;\n      if (db.className === \"StationFXPersonalData\") personalFX ??= db.data;\n    }\n    // serverVehicleHud.cs VehicleInvFX values.\n    expect(vehicleFX, \"StationFXVehicleData\").toBeDefined();\n    expect(vehicleFX!.glowNodeName).toBe(\"GLOWFX\");\n    expect(vehicleFX!.leftNodeName0).toBe(\"LFX1\");\n    expect(vehicleFX!.rightNodeName0).toBe(\"RFX1\");\n    expect(vehicleFX!.leftNodeName3).toBe(\"LFX4\");\n    expect(vehicleFX!.rightNodeName3).toBe(\"RFX4\");\n    expect(vehicleFX!.texture0).toBe(\"special/stationGlow\");\n    expect(vehicleFX!.texture1).toBe(\"special/stationLight2\");\n    // station.cs personal FX values.\n    expect(personalFX, \"StationFXPersonalData\").toBeDefined();\n    expect(personalFX!.leftNodeName).toBe(\"FX1\");\n    expect(personalFX!.rightNodeName).toBe(\"FX2\");\n    expect(personalFX!.texture0).toBe(\"special/stationLight\");\n  });\n});\n"]}
+{"version":3,"file":"DataBlockParsers.test.js","sourceRoot":"","sources":["../src/DataBlockParsers.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { DemoParser } from \"./DemoParser.js\";\nimport type {\n  ELFProjectileDataBlock,\n  EnergyProjectileDataBlock,\n  LinearProjectileDataBlock,\n  PlayerDataBlock,\n  RepairProjectileDataBlock,\n  ShapeBaseImageDataBlock,\n  SniperProjectileDataBlock,\n  TracerProjectileDataBlock,\n} from \"./dataBlockDataTypes.js\";\n\nconst DEMO_DIR = path.resolve(import.meta.dirname, \"..\", \"data\");\n\nasync function loadDataBlocks(file: string) {\n  const buffer = fs.readFileSync(path.join(DEMO_DIR, file));\n  const parser = new DemoParser(new Uint8Array(buffer));\n  const { initialBlock } = await parser.load();\n  return initialBlock.dataBlocks;\n}\n\n/**\n * Regression tests for projectile datablock field naming, which was\n * binary-verified against Tribes2.exe build 25034 (initPersistFields\n * FUN_0062b3c0 / FUN_0063fcb0 map names to the struct offsets that\n * unpackData reads in order). Prior to that verification several fields\n * were misassigned — most damagingly, the true lifetimeMS landed in a\n * field named `fizzleType`, breaking client-side projectile simulation.\n */\ndescribe(\"projectile datablock field decoding\", () => {\n  it(\"decodes LinearProjectileData fields with engine semantics\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    const linears: LinearProjectileDataBlock[] = [];\n    for (const [, db] of dataBlocks) {\n      if (\n        db.className === \"LinearProjectileData\" ||\n        db.className === \"TracerProjectileData\" ||\n        db.className === \"LinearFlareProjectileData\"\n      ) {\n        linears.push(db.data as LinearProjectileDataBlock);\n      }\n    }\n    expect(linears.length).toBeGreaterThan(0);\n\n    for (const block of linears) {\n      // lifetimeMS/fizzleTimeMS are real milliseconds, rounded up to a\n      // 32ms tick by the engine's onAdd, and clamped to 511 ticks.\n      expect(block.lifetimeMS! % 32).toBe(0);\n      expect(block.lifetimeMS).toBeGreaterThanOrEqual(32);\n      expect(block.lifetimeMS).toBeLessThanOrEqual(511 * 32);\n      expect(block.fizzleTimeMS! % 32).toBe(0);\n      // Angles are ranged 0–90 degrees on the wire.\n      expect(block.reflectOnWaterImpactAngle).toBeGreaterThanOrEqual(0);\n      expect(block.reflectOnWaterImpactAngle).toBeLessThanOrEqual(90);\n      expect(typeof block.explodeOnDeath).toBe(\"boolean\");\n      expect(typeof block.doDynamicClientHits).toBe(\"boolean\");\n    }\n  });\n\n  it(\"decodes retail DiscProjectile exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let disc: LinearProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      const data = db.data as LinearProjectileDataBlock;\n      if (\n        db.className === \"LinearProjectileData\" &&\n        data.dryVelocity === 90 &&\n        data.explodeOnDeath === true\n      ) {\n        disc = data;\n        break;\n      }\n    }\n    expect(disc, \"retail DiscProjectile datablock\").toBeDefined();\n    // disc.cs: lifetimeMS = fizzleTimeMS = 5000 → tick-rounded to 5024.\n    expect(disc!.lifetimeMS).toBe(5024);\n    expect(disc!.fizzleTimeMS).toBe(5024);\n    // disc.cs: reflectOnWaterImpactAngle = 15.0.\n    expect(disc!.reflectOnWaterImpactAngle).toBe(15);\n  });\n\n  it(\"decodes retail EnergyBolt (blaster) fields exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let bolt: EnergyProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      if (db.className === \"EnergyProjectileData\") {\n        bolt = db.data as EnergyProjectileDataBlock;\n        break;\n      }\n    }\n    expect(bolt, \"retail EnergyBolt datablock\").toBeDefined();\n    // blaster.cs: binary-verified names (initPersistFields FUN_00694b40,\n    // unpackData FUN_00694d80) — these were previously mislabeled with\n    // ELF-style beam field names.\n    expect(bolt!.crossViewAng).toBeCloseTo(0.99, 5);\n    expect(bolt!.crossSize).toBeCloseTo(0.55, 5);\n    expect(bolt!.blurLifetime).toBeCloseTo(0.2, 5);\n    expect(bolt!.blurWidth).toBeCloseTo(0.25, 5);\n    expect(bolt!.blurColor!.r).toBeCloseTo(0.4, 5);\n    expect(bolt!.blurColor!.g).toBeCloseTo(0, 5);\n    expect(bolt!.blurColor!.b).toBeCloseTo(0, 5);\n    expect(bolt!.texture0).toBe(\"special/blasterBolt\");\n    expect(bolt!.texture1).toBe(\"special/blasterBoltCross\");\n    // blaster.cs: scale = \"0.25 20.0 1.0\" (bolt quad half-width / length).\n    expect(bolt!.scale!.x).toBeCloseTo(0.25, 5);\n    expect(bolt!.scale!.y).toBeCloseTo(20, 5);\n  });\n\n  it(\"decodes retail BasicSniperShot (laser rifle) fields exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let shot: SniperProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      if (db.className === \"SniperProjectileData\") {\n        shot = db.data as SniperProjectileDataBlock;\n        break;\n      }\n    }\n    expect(shot, \"retail BasicSniperShot datablock\").toBeDefined();\n    // sniperRifle.cs values.\n    expect(shot!.maxRifleRange).toBeCloseTo(1000, 5);\n    expect(shot!.beamColor!.r).toBeCloseTo(1, 2);\n    expect(shot!.beamColor!.g).toBeCloseTo(0.1, 2);\n    expect(shot!.beamColor!.b).toBeCloseTo(0.1, 2);\n    expect(shot!.fadeTime).toBeCloseTo(1.0, 5);\n    expect(shot!.startBeamWidth).toBeCloseTo(0.145, 5);\n    expect(shot!.endBeamWidth).toBeCloseTo(0.25, 5);\n    expect(shot!.pulseSpeed).toBeCloseTo(6.0, 5);\n    expect(shot!.pulseLength).toBeCloseTo(0.15, 5);\n    expect(shot!.textures![0]).toBe(\"special/flare\");\n    expect(shot!.textures![1]).toBe(\"special/nonlingradient\");\n    expect(shot!.textures![2]).toBe(\"special/laserrip01\");\n    expect(shot!.textures![11]).toBe(\"special/sniper00\");\n  });\n\n  it(\"decodes both ELF datablocks (gun and turret) exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    const elfs: ELFProjectileDataBlock[] = [];\n    for (const [, db] of dataBlocks) {\n      if (db.className === \"ELFProjectileData\") {\n        elfs.push(db.data as ELFProjectileDataBlock);\n      }\n    }\n    // Binary-verified names (initPersistFields FUN_0064a860, unpackData\n    // FUN_0064ae00) — previously fabricated beam names. Two datablocks\n    // exist: the handheld BasicELF at beamRange 38 (the z0dd/ZOD server\n    // patch every surviving server lineage runs — \"WHAT?? INCREASE ELF\n    // RANGE?!!? was 37\"; the stock script says 30) and the stock\n    // ELFTurretBolt at 75 (ELFBarrelLarge.cs).\n    expect(elfs.map((e) => e.beamRange).sort((a, b) => a! - b!)).toEqual([\n      38, 75,\n    ]);\n    for (const elf of elfs) {\n      expect(elf.mainBeamWidth).toBeCloseTo(0.1, 5);\n      expect(elf.mainBeamSpeed).toBeCloseTo(9.0, 5);\n      expect(elf.mainBeamRepeat).toBeCloseTo(0.25, 5);\n      expect(elf.lightningWidth).toBeCloseTo(0.1, 5);\n      expect(elf.lightningDist).toBeCloseTo(0.15, 5);\n      expect(elf.textures).toEqual([\n        \"special/ELFBeam\",\n        \"special/ELFLightning\",\n        \"special/BlueImpact\",\n      ]);\n    }\n  });\n\n  it(\"decodes retail DefaultRepairBeam fields exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let repair: RepairProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      if (db.className === \"RepairProjectileData\") {\n        repair = db.data as RepairProjectileDataBlock;\n        break;\n      }\n    }\n    expect(repair, \"retail DefaultRepairBeam datablock\").toBeDefined();\n    // repairpack.cs: binary-verified names (initPersistFields\n    // FUN_00644910, unpackData FUN_00644c40); numSegments is an S32\n    // whose raw bits the old decode read as a float.\n    expect(repair!.beamRange).toBeCloseTo(10, 5);\n    expect(repair!.beamWidth).toBeCloseTo(0.15, 5);\n    expect(repair!.numSegments).toBe(20);\n    expect(repair!.texRepeat).toBeCloseTo(0.2, 5);\n    expect(repair!.blurFreq).toBeCloseTo(10.0, 5);\n    expect(repair!.blurLifetime).toBeCloseTo(1.0, 5);\n    expect(repair!.cutoffAngle).toBeCloseTo(25.0, 5);\n    expect(repair!.textures).toEqual([\"special/redbump2\", \"special/redflare\"]);\n  });\n\n  it(\"decodes image-state transitions in the engine packing order\", async () => {\n    // Every retail weapon image opens Activate → (timeout) →\n    // ActivateReady (e.g. blaster.cs stateTransitionOnTimeout[0]).\n    // With the old rotated names, the timeout transition surfaced under\n    // transitionGeneric0Out and consumers carried a remap table.\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let checked = 0;\n    for (const [, db] of dataBlocks) {\n      if (db.className !== \"ShapeBaseImageData\") continue;\n      const data = db.data as ShapeBaseImageDataBlock;\n      const states = data.states;\n      if (!states || states.length < 2) continue;\n      if (states[0].name.toLowerCase() !== \"activate\") continue;\n      const readyIndex = states.findIndex(\n        (st) => st.name.toLowerCase() === \"activateready\",\n      );\n      if (readyIndex < 0) continue;\n      // Transition values are 1-based state indices (0 = none).\n      expect(states[0].transitionOnTimeout).toBe(readyIndex + 1);\n      checked++;\n    }\n    expect(checked).toBeGreaterThan(3);\n  });\n\n  it(\"decodes retail ChaingunBullet tracer fields exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let bullet: TracerProjectileDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      const data = db.data as TracerProjectileDataBlock;\n      if (\n        db.className === \"TracerProjectileData\" &&\n        data.tracerTex0 === \"special/tracer00\" &&\n        data.lifetimeMS === 3008\n      ) {\n        bullet = data;\n        break;\n      }\n    }\n    expect(bullet, \"ChaingunBullet datablock\").toBeDefined();\n    // Values as recorded in this demo (a lightly modded server — tracer\n    // length/width are doubled from retail, everything else matches\n    // chaingun.cs). Each assertion pins a decode position: a swap with\n    // any neighboring field would produce a nonsensical value here.\n    expect(bullet!.dryVelocity).toBe(750);\n    expect(bullet!.wetVelocity).toBe(280);\n    expect(bullet!.fizzleTimeMS).toBe(3008);\n    expect(bullet!.explodeOnDeath).toBe(false);\n    // Chainguns are the only retail weapons with doDynamicClientHits.\n    expect(bullet!.doDynamicClientHits).toBe(true);\n    // activateDelayMS = -1 (retail default) read as U32.\n    expect(bullet!.activateDelayMS).toBe(0xffffffff);\n    expect(bullet!.tracerLength).toBe(30);\n    expect(bullet!.tracerMinPixels).toBe(6);\n    expect(bullet!.tracerWidth).toBeCloseTo(0.2, 5);\n    expect(bullet!.tracerAlpha).toBe(false);\n    // Retail chaingun.cs tracerColor: 211/255, 215/255, 120/255, 0.75.\n    expect(bullet!.tracerColor!.r).toBeCloseTo(211 / 255, 2);\n    expect(bullet!.tracerColor!.g).toBeCloseTo(215 / 255, 2);\n    expect(bullet!.tracerColor!.b).toBeCloseTo(120 / 255, 2);\n    expect(bullet!.crossViewAng).toBeCloseTo(0.99, 5);\n    expect(bullet!.crossSize).toBeCloseTo(0.2, 5);\n    expect(bullet!.renderCross).toBe(true);\n    expect(bullet!.tracerTex1).toBe(\"special/tracercross\");\n  });\n\n  it(\"decodes PlayerData movement/jet fields with engine semantics\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let armor: PlayerDataBlock | undefined;\n    for (const [, db] of dataBlocks) {\n      const data = db.data as PlayerDataBlock;\n      // The armor the recorder wears: retail-value run/speed section.\n      if (db.className === \"PlayerData\" && data.maxForwardSpeed === 15) {\n        armor = data;\n        break;\n      }\n    }\n    expect(armor, \"light armor PlayerData datablock\").toBeDefined();\n    // Retail player.cs values — each pins a decode position (previously\n    // these landed in fields named jumpForce/runSurfaceAngle/etc.).\n    expect(armor!.runForce).toBe(4968); // 55.2 * 90\n    expect(armor!.maxBackwardSpeed).toBe(13);\n    expect(armor!.maxSideSpeed).toBe(13);\n    expect(armor!.underwaterVertJetFactor).toBeCloseTo(1.5, 5);\n    expect(armor!.minLookAngle).toBeCloseTo(-1.5, 5);\n    expect(armor!.maxLookAngle).toBeCloseTo(1.5, 5);\n    // Jet energy fields must decode as plausible per-tick magnitudes\n    // (this server mods them slightly, so no exact match): drain is a\n    // fraction of maxEnergy(60), threshold is a small energy value.\n    expect(armor!.jetEnergyDrain).toBeGreaterThan(0);\n    expect(armor!.jetEnergyDrain).toBeLessThan(5);\n    expect(armor!.underwaterJetEnergyDrain).toBeGreaterThan(0);\n    expect(armor!.underwaterJetEnergyDrain).toBeLessThan(5);\n    expect(armor!.minJetEnergy).toBeGreaterThanOrEqual(0);\n    expect(armor!.minJetEnergy).toBeLessThan(10);\n    // Heat signature rates — retail player.cs: 1/4 and 1/3. These are the\n    // first two reads of the ground-impact tail; the old decode shifted\n    // the whole section by two slots.\n    expect(armor!.heatDecayPerSec).toBeCloseTo(0.25, 5);\n    expect(armor!.heatIncreasePerSec).toBeCloseTo(1 / 3, 5);\n    expect(armor!.groundImpactShakeDuration).toBeCloseTo(0.6, 5);\n    expect(armor!.groundImpactShakeFalloff).toBeCloseTo(10, 5);\n  });\n\n  it(\"decodes StationFX node names and textures exactly\", async () => {\n    const dataBlocks = await loadDataBlocks(\"exogen_Katabatic_vpad.rec\");\n    let vehicleFX: Record<string, unknown> | undefined;\n    let personalFX: Record<string, unknown> | undefined;\n    for (const [, db] of dataBlocks) {\n      if (db.className === \"StationFXVehicleData\") vehicleFX ??= db.data;\n      if (db.className === \"StationFXPersonalData\") personalFX ??= db.data;\n    }\n    // serverVehicleHud.cs VehicleInvFX values.\n    expect(vehicleFX, \"StationFXVehicleData\").toBeDefined();\n    expect(vehicleFX!.glowNodeName).toBe(\"GLOWFX\");\n    expect(vehicleFX!.leftNodeName0).toBe(\"LFX1\");\n    expect(vehicleFX!.rightNodeName0).toBe(\"RFX1\");\n    expect(vehicleFX!.leftNodeName3).toBe(\"LFX4\");\n    expect(vehicleFX!.rightNodeName3).toBe(\"RFX4\");\n    expect(vehicleFX!.texture0).toBe(\"special/stationGlow\");\n    expect(vehicleFX!.texture1).toBe(\"special/stationLight2\");\n    // station.cs personal FX values.\n    expect(personalFX, \"StationFXPersonalData\").toBeDefined();\n    expect(personalFX!.leftNodeName).toBe(\"FX1\");\n    expect(personalFX!.rightNodeName).toBe(\"FX2\");\n    expect(personalFX!.texture0).toBe(\"special/stationLight\");\n  });\n});\n"]}

package/dist/DemoParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DemoParser.d.ts","sourceRoot":"","sources":["../src/DemoParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AAuBvE,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAWhB,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAmB;IACzC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,iBAAiB,CAAC,CAAW;IACrC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,UAAU;IA+D9B,WAAW,IAAI,aAAa;IAI5B,eAAe,IAAI,YAAY;IAI/B,eAAe,IAAI,YAAY;IAM/B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,IAAI,UAAU,CAGvB;IAED,IAAI,YAAY,IAAI,gBAAgB,CAGnC;IAED,IAAI,UAAU,IAAI,MAAM,CAkBvB;IAED,IAAI,WAAW,IAAI,MAAM,CAGxB;IAID;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAwDjC;;;;;OAKG;IACH,SAAS,IAAI,SAAS,GAAG,SAAS;IAwDlC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC;IAQxC,OAAO,CAAC,UAAU;IAwBlB;4DACwD;IACxD,OAAO,CAAC,gBAAgB;IA0OxB;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IA6EhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;IAoBvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,mBAAmB;IAyD3B,OAAO,CAAC,mBAAmB;IA8F3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA2DtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IAuCjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW;IA6BnB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"DemoParser.d.ts","sourceRoot":"","sources":["../src/DemoParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AAuBvE,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAWhB,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAmB;IACzC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,iBAAiB,CAAC,CAAW;IACrC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,UAAU;IAyE9B,WAAW,IAAI,aAAa;IAI5B,eAAe,IAAI,YAAY;IAI/B,eAAe,IAAI,YAAY;IAM/B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,IAAI,UAAU,CAGvB;IAED,IAAI,YAAY,IAAI,gBAAgB,CAGnC;IAED,IAAI,UAAU,IAAI,MAAM,CAkBvB;IAED,IAAI,WAAW,IAAI,MAAM,CAGxB;IAID;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA4DjC;;;;;OAKG;IACH,SAAS,IAAI,SAAS,GAAG,SAAS;IA2DlC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC;IAQxC,OAAO,CAAC,UAAU;IAwBlB;4DACwD;IACxD,OAAO,CAAC,gBAAgB;IA4TxB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IA6EhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,mBAAmB;IAmE3B,OAAO,CAAC,mBAAmB;IAuH3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAsEtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA4CjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW;IA0CnB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/DemoParser.js

@@ -270,6 +270,7 @@ export class DemoParser {
             dataBlockDataMap,
             connectionProtocolState: initialBlock.connectionState,
             nextRecvEventSeq: initialBlock.nextRecvEventSeq,
+            compressionPoint: initialBlock.initialCompressionPoint,
         });
         this.ghostTracker = gt;
         this.packetParser = pp;
@@ -406,13 +407,15 @@ export class DemoParser {
         let initialGhosts = [];
         let controlObjectGhostIndex = -1;
         let controlObjectData;
+        let initialCompressionPoint;
         let missionName = "";
         let missionCRC = 0;
         let phase2Error;
         try {
             debugInitial("phase2 start bit=%d remaining=%d", bs.getCurPos(), totalBits - bs.getCurPos());
             // B.10f Events
-            ({ nextRecvEventSeq, events: initialEvents } = this.readEventStartBlock(bs));
+            ({ nextRecvEventSeq, events: initialEvents } =
+                this.readEventStartBlock(bs));
             debugInitial("after initial events bit=%d count=%d", bs.getCurPos(), initialEvents.length);
             // B.10g Ghosts
             const ghostResult = this.readGhostStartBlock(bs, dataBlocks);
@@ -428,11 +431,20 @@ export class DemoParser {
                 if (ghost) {
                     const parser = this.registry.getGhostParser(ghost.classId);
                     if (parser?.readPacketData) {
+                        // getGhostParser enables the nested vehicle readPacketData
+                        // when the recorder was piloting at recording start — without
+                        // it those bytes go unread and every later read in the
+                        // initial block (mission name, CRC) is misaligned.
                         const conn = {
                             compressionPoint: { x: 0, y: 0, z: 0 },
                             ghostTracker: ibGhostTracker,
+                            getGhostParser: (classId) => this.registry.getGhostParser(classId),
                         };
                         controlObjectData = parser.readPacketData(bs, conn);
+                        // The control object's readPacketData establishes the
+                        // connection's compression point (its position) — carry it
+                        // into the packet parser seed.
+                        initialCompressionPoint = conn.compressionPoint;
                         debugInitial("after control readPacketData bit=%d parser=%s", bs.getCurPos(), parser.name);
                     }
                 }
@@ -456,9 +468,7 @@ export class DemoParser {
         }
         const remaining = totalBits - bs.getCurPos();
         const missionPrintableRatio = missionName.length > 0
-            ? missionName
-                .split("")
-                .filter((c) => {
+            ? missionName.split("").filter((c) => {
                 const code = c.charCodeAt(0);
                 return code >= 0x20 && code <= 0x7e;
             }).length / missionName.length
@@ -490,6 +500,7 @@ export class DemoParser {
             initialEvents,
             controlObjectGhostIndex,
             controlObjectData,
+            initialCompressionPoint,
             missionName,
             missionCRC,
             phase2TrailingBits: remaining,
@@ -513,7 +524,16 @@ export class DemoParser {
         const triggerFlags = [];
         for (let i = 0; i < 6; i++)
             triggerFlags.push(bs.readFlag());
-        return { clientId, teamId, score, field0, field1, field2, isBot, triggerFlags };
+        return {
+            clientId,
+            teamId,
+            score,
+            field0,
+            field1,
+            field2,
+            isBot,
+            triggerFlags,
+        };
     }
     /**
      * Read DemoValues from FUN_005fb5c0 lines 388966-388980.
@@ -696,6 +716,7 @@ export class DemoParser {
                         guaranteed: true,
                         dataBitsStart,
                         dataBitsEnd: dataBitsStart,
+                        failed: true,
                     });
                     break;
                 }
@@ -707,6 +728,7 @@ export class DemoParser {
                     guaranteed: true,
                     dataBitsStart,
                     dataBitsEnd: dataBitsStart,
+                    failed: true,
                 });
                 break;
             }
@@ -923,9 +945,22 @@ export class DemoParser {
             trigger.push(data[57 + i] !== 0);
         }
         return {
-            px, py, pz, pyaw, ppitch, proll,
-            x, y, z, yaw, pitch, roll,
-            id, sendCount, freeLook, trigger,
+            px,
+            py,
+            pz,
+            pyaw,
+            ppitch,
+            proll,
+            x,
+            y,
+            z,
+            yaw,
+            pitch,
+            roll,
+            id,
+            sendCount,
+            freeLook,
+            trigger,
         };
     }
     /**