ac-cardata 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Misha Nasledov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# ac-cardata
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Reads what an Assetto Corsa car's own data says about it: its `data/` folder,
+or the same files packed into `data.acd`, and the numbers in them that place
+things on the car.
+
+```ts
+import { carDriverEyes, carWheels, readCarFile, parseIni } from "ac-cardata"
+
+const cars = "/path/to/assettocorsa/content/cars"
+await carDriverEyes(cars, "abarth500") // [0.330737, 1.19075, -0.490002]
+await carWheels(cars, "abarth500")     // four wheel centres, FL, FR, RL, RR
+
+const ini = await readCarFile(`${cars}/abarth500`, "car.ini")
+parseIni(ini!.toString("latin1")).get("BASIC")?.get("TOTALMASS")
+```
+
+- **Files:** `readCarFile(carDir, name)` takes the unpacked `data/` folder
+  first, as the game does, and the archive otherwise. The archive's key comes
+  from the folder's name, so `carDir` must be named as the game names the car.
+  `readAcd(buffer, folder)` opens an archive you already hold.
+- **Driver's eyes:** `[GRAPHICS] DRIVEREYES`, the cockpit camera, in the frame
+  of the car's 3D model: `[BASIC] GRAPHICS_OFFSET` does not apply. +x is the
+  car's left, +y up, +z forward.
+- **Wheels:** from `suspensions.ini`, relative to the car's position as the
+  game reports it, which is its centre of gravity.
+
+Checked against all 245 archives on one install, and the eyes against where
+the steering wheel puts them on two cars' models.

package/dist/cardata.d.ts

@@ -0,0 +1,57 @@
+/**
+ * What a car's own data says about it: the files in its `data/` folder, or
+ * packed into `data.acd`, and the few numbers in them that place things on the
+ * car. Read-only and in memory; nothing here writes an archive or keeps what
+ * it read.
+ */
+export type Vec3 = [number, number, number];
+/** Body-local wheel centers, meters: x across (the car's left), y up, z forward. FL, FR, RL, RR. */
+export type WheelOffsets = [Vec3, Vec3, Vec3, Vec3];
+/** The files inside a car's data archive, by name. */
+export type CarFiles = Map<string, Buffer>;
+/**
+ * Reads `data.acd`: a run of entries, each an i32 name length, the name, an
+ * i32 byte count, then that many i32 slots whose low byte is the file's byte
+ * shifted up by the next character of a key made from the car's folder name,
+ * the key starting over for each entry.
+ */
+export declare function readAcd(buf: Buffer, folder: string): CarFiles;
+/**
+ * The key for a car's archive, from its folder name: eight checksums of the
+ * lowercased name in signed 32-bit arithmetic, each kept to its low byte,
+ * joined with "-". Written from a description of the scheme two open-source
+ * readers share; it opens all 245 archives on the machine it was checked on.
+ */
+export declare function acdKey(folder: string): string;
+/** `[SECTION]` → key → value, values with comments and padding stripped. */
+export declare function parseIni(text: string): Map<string, Map<string, string>>;
+/**
+ * Wheel centers relative to the car's center of gravity, which is where the
+ * game puts a car's position: across by half the track, down by BASEY, and
+ * along by the wheelbase split at CG_LOCATION (the share of weight on the
+ * front axle). On a Nissan R32 this reproduces the wheels the game stored in
+ * a replay to within a centimeter.
+ */
+export declare function wheelsFromSuspension(ini: string): WheelOffsets;
+/**
+ * One file of a car's data, from `<carDir>/data/` when the car is unpacked and
+ * from its `data.acd` otherwise; undefined when it has neither or the file is
+ * not in them. The archive's key is the folder's name, so `carDir` has to be
+ * the car's own folder, named as the game names it.
+ */
+export declare function readCarFile(carDir: string, name: string): Promise<Buffer | undefined>;
+/**
+ * A car's wheel offsets from `<cars>/<model>`, unpacked `data/` first, then
+ * `data.acd`; undefined when the car has neither or they can't be read.
+ */
+export declare function carWheels(carsDir: string, model: string): Promise<WheelOffsets | undefined>;
+/**
+ * Where the driver's eyes are, from `car.ini`'s `[GRAPHICS] DRIVEREYES`: the
+ * cockpit camera's position, in the frame of the car's 3D model rather than of
+ * its physics, so `[BASIC] GRAPHICS_OFFSET` does not apply to it. +x is to the
+ * car's left, +y up, +z forward, as in the model.
+ */
+export declare function driverEyes(carIni: string): Vec3;
+/** A car's driver's eyes from `<cars>/<model>`; undefined when its data can't be read. */
+export declare function carDriverEyes(carsDir: string, model: string): Promise<Vec3 | undefined>;
+//# sourceMappingURL=cardata.d.ts.map

package/dist/cardata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardata.d.ts","sourceRoot":"","sources":["../src/cardata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE3C,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAEnD,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAK1C;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAuB7D;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoC7C;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAevE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAiB9D;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK3F;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAGjG;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAS/C;AAED,0FAA0F;AAC1F,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAG7F"}

package/dist/cardata.js

@@ -0,0 +1,166 @@
+/**
+ * What a car's own data says about it: the files in its `data/` folder, or
+ * packed into `data.acd`, and the few numbers in them that place things on the
+ * car. Read-only and in memory; nothing here writes an archive or keeps what
+ * it read.
+ */
+import { readFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+/** Kunos's own cars start with this, then one more int, before the first entry. */
+const ACD_MARKER = -1111;
+/**
+ * Reads `data.acd`: a run of entries, each an i32 name length, the name, an
+ * i32 byte count, then that many i32 slots whose low byte is the file's byte
+ * shifted up by the next character of a key made from the car's folder name,
+ * the key starting over for each entry.
+ */
+export function readAcd(buf, folder) {
+    const key = acdKey(folder);
+    const out = new Map();
+    let o = buf.length >= 8 && buf.readInt32LE(0) === ACD_MARKER ? 8 : 0;
+    while (o + 4 <= buf.length) {
+        const nameLen = buf.readInt32LE(o);
+        o += 4;
+        if (nameLen <= 0 || o + nameLen + 4 > buf.length)
+            throw new Error(`${folder}/data.acd isn't an archive this reads`);
+        const name = buf.subarray(o, o + nameLen).toString("latin1");
+        o += nameLen;
+        const len = buf.readInt32LE(o);
+        o += 4;
+        if (len < 0 || o + len * 4 > buf.length)
+            throw new Error(`${folder}/data.acd: ${name} runs past the end`);
+        const data = Buffer.alloc(len);
+        for (let i = 0; i < len; i++) {
+            data[i] = (buf.readUInt8(o + i * 4) - key.charCodeAt(i % key.length)) & 0xff;
+        }
+        o += len * 4;
+        out.set(name, data);
+    }
+    return out;
+}
+/**
+ * The key for a car's archive, from its folder name: eight checksums of the
+ * lowercased name in signed 32-bit arithmetic, each kept to its low byte,
+ * joined with "-". Written from a description of the scheme two open-source
+ * readers share; it opens all 245 archives on the machine it was checked on.
+ */
+export function acdKey(folder) {
+    const c = [...folder.toLowerCase()].map((ch) => ch.charCodeAt(0));
+    const n = c.length;
+    const at = (i) => c[i];
+    const div = (a, b) => Math.trunc(a / b) | 0;
+    let k1 = 0;
+    for (let i = 0; i < n; i++)
+        k1 = (k1 + at(i)) | 0;
+    let k2 = 0;
+    for (let i = 0; i < n - 1; i += 2)
+        k2 = (Math.imul(k2, at(i)) - at(i + 1)) | 0;
+    let k3 = 0;
+    for (let i = 1; i < n - 3; i += 3) {
+        k3 = Math.imul(k3, at(i));
+        k3 = div(k3, at(i + 1) + 27);
+        k3 = (k3 - 27 - at(i - 1)) | 0;
+    }
+    let k4 = 0x1683;
+    for (let i = 1; i < n; i++)
+        k4 = (k4 - at(i)) | 0;
+    let k5 = 66;
+    for (let i = 1; i < n - 4; i += 4)
+        k5 = (Math.imul(Math.imul(k5, at(i) + 15), at(i - 1) + 15) + 22) | 0;
+    let k6 = 101;
+    for (let i = 0; i < n - 2; i += 2)
+        k6 = (k6 - at(i)) | 0;
+    let k7 = 171;
+    for (let i = 0; i < n - 2; i += 2)
+        k7 = k7 % at(i);
+    let k8 = 171;
+    for (let i = 0; i < n - 1; i++)
+        k8 = (div(k8, at(i)) + at(i + 1)) | 0;
+    return [k1, k2, k3, k4, k5, k6, k7, k8].map((k) => k & 0xff).join("-");
+}
+/** `[SECTION]` → key → value, values with comments and padding stripped. */
+export function parseIni(text) {
+    const out = new Map();
+    let section = new Map();
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.replace(/;.*$|\/\/.*$/, "").trim();
+        const head = /^\[(.+)\]$/.exec(line);
+        if (head) {
+            section = out.get(head[1]) ?? new Map();
+            out.set(head[1], section);
+        }
+        else {
+            const eq = line.indexOf("=");
+            if (eq > 0)
+                section.set(line.slice(0, eq).trim(), line.slice(eq + 1).trim());
+        }
+    }
+    return out;
+}
+/**
+ * Wheel centers relative to the car's center of gravity, which is where the
+ * game puts a car's position: across by half the track, down by BASEY, and
+ * along by the wheelbase split at CG_LOCATION (the share of weight on the
+ * front axle). On a Nissan R32 this reproduces the wheels the game stored in
+ * a replay to within a centimeter.
+ */
+export function wheelsFromSuspension(ini) {
+    const s = parseIni(ini);
+    const num = (section, key) => {
+        const v = Number(s.get(section)?.get(key));
+        if (!Number.isFinite(v))
+            throw new Error(`suspensions.ini has no usable ${section}.${key}`);
+        return v;
+    };
+    const wheelbase = num("BASIC", "WHEELBASE");
+    const cg = num("BASIC", "CG_LOCATION");
+    const front = { x: num("FRONT", "TRACK") / 2, y: num("FRONT", "BASEY"), z: wheelbase * (1 - cg) };
+    const rear = { x: num("REAR", "TRACK") / 2, y: num("REAR", "BASEY"), z: -wheelbase * cg };
+    return [
+        [front.x, front.y, front.z],
+        [-front.x, front.y, front.z],
+        [rear.x, rear.y, rear.z],
+        [-rear.x, rear.y, rear.z],
+    ];
+}
+/**
+ * One file of a car's data, from `<carDir>/data/` when the car is unpacked and
+ * from its `data.acd` otherwise; undefined when it has neither or the file is
+ * not in them. The archive's key is the folder's name, so `carDir` has to be
+ * the car's own folder, named as the game names it.
+ */
+export async function readCarFile(carDir, name) {
+    const unpacked = await readFile(join(carDir, "data", name)).catch(() => undefined);
+    if (unpacked !== undefined)
+        return unpacked;
+    const acd = await readFile(join(carDir, "data.acd")).catch(() => undefined);
+    return acd ? readAcd(acd, basename(carDir)).get(name) : undefined;
+}
+/**
+ * A car's wheel offsets from `<cars>/<model>`, unpacked `data/` first, then
+ * `data.acd`; undefined when the car has neither or they can't be read.
+ */
+export async function carWheels(carsDir, model) {
+    const ini = await readCarFile(join(carsDir, model), "suspensions.ini");
+    return ini ? wheelsFromSuspension(ini.toString("latin1")) : undefined;
+}
+/**
+ * Where the driver's eyes are, from `car.ini`'s `[GRAPHICS] DRIVEREYES`: the
+ * cockpit camera's position, in the frame of the car's 3D model rather than of
+ * its physics, so `[BASIC] GRAPHICS_OFFSET` does not apply to it. +x is to the
+ * car's left, +y up, +z forward, as in the model.
+ */
+export function driverEyes(carIni) {
+    const raw = parseIni(carIni).get("GRAPHICS")?.get("DRIVEREYES");
+    const v = (raw ?? "").split(",").map((n) => Number(n.trim()));
+    if (v.length !== 3 || !v.every(Number.isFinite)) {
+        throw new Error(`car.ini has no usable GRAPHICS.DRIVEREYES${raw === undefined ? "" : `: ${JSON.stringify(raw)}`}`);
+    }
+    return [v[0], v[1], v[2]];
+}
+/** A car's driver's eyes from `<cars>/<model>`; undefined when its data can't be read. */
+export async function carDriverEyes(carsDir, model) {
+    const ini = await readCarFile(join(carsDir, model), "car.ini");
+    return ini ? driverEyes(ini.toString("latin1")) : undefined;
+}
+//# sourceMappingURL=cardata.js.map

package/dist/cardata.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { acdKey, type CarFiles, carDriverEyes, carWheels, driverEyes, parseIni, readAcd, readCarFile, type Vec3, type WheelOffsets, wheelsFromSuspension, } from "./cardata.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,QAAQ,EACb,aAAa,EACb,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,WAAW,EACX,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { acdKey, carDriverEyes, carWheels, driverEyes, parseIni, readAcd, readCarFile, wheelsFromSuspension, } from "./cardata.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAEN,aAAa,EACb,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,WAAW,EAGX,oBAAoB,GACrB,MAAM,cAAc,CAAA"}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "ac-cardata",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Read an Assetto Corsa car's own data: data.acd and data/, car.ini, and the numbers that place wheels and the driver's eyes.",
+  "license": "MIT",
+  "author": "Misha Nasledov <misha@nasledov.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mishan/assetto-ts.git",
+    "directory": "packages/ac-cardata"
+  },
+  "homepage": "https://github.com/mishan/assetto-ts/tree/main/packages/ac-cardata#readme",
+  "bugs": "https://github.com/mishan/assetto-ts/issues",
+  "keywords": [
+    "assetto-corsa",
+    "data.acd",
+    "car.ini",
+    "sim-racing"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build"
+  }
+}

package/src/cardata.ts

@@ -0,0 +1,184 @@
+/**
+ * What a car's own data says about it: the files in its `data/` folder, or
+ * packed into `data.acd`, and the few numbers in them that place things on the
+ * car. Read-only and in memory; nothing here writes an archive or keeps what
+ * it read.
+ */
+
+import { readFile } from "node:fs/promises"
+import { basename, join } from "node:path"
+
+export type Vec3 = [number, number, number]
+
+/** Body-local wheel centers, meters: x across (the car's left), y up, z forward. FL, FR, RL, RR. */
+export type WheelOffsets = [Vec3, Vec3, Vec3, Vec3]
+
+/** The files inside a car's data archive, by name. */
+export type CarFiles = Map<string, Buffer>
+
+/** Kunos's own cars start with this, then one more int, before the first entry. */
+const ACD_MARKER = -1111
+
+/**
+ * Reads `data.acd`: a run of entries, each an i32 name length, the name, an
+ * i32 byte count, then that many i32 slots whose low byte is the file's byte
+ * shifted up by the next character of a key made from the car's folder name,
+ * the key starting over for each entry.
+ */
+export function readAcd(buf: Buffer, folder: string): CarFiles {
+  const key = acdKey(folder)
+  const out: CarFiles = new Map()
+  let o = buf.length >= 8 && buf.readInt32LE(0) === ACD_MARKER ? 8 : 0
+  while (o + 4 <= buf.length) {
+    const nameLen = buf.readInt32LE(o)
+    o += 4
+    if (nameLen <= 0 || o + nameLen + 4 > buf.length)
+      throw new Error(`${folder}/data.acd isn't an archive this reads`)
+    const name = buf.subarray(o, o + nameLen).toString("latin1")
+    o += nameLen
+    const len = buf.readInt32LE(o)
+    o += 4
+    if (len < 0 || o + len * 4 > buf.length)
+      throw new Error(`${folder}/data.acd: ${name} runs past the end`)
+    const data = Buffer.alloc(len)
+    for (let i = 0; i < len; i++) {
+      data[i] = (buf.readUInt8(o + i * 4) - key.charCodeAt(i % key.length)) & 0xff
+    }
+    o += len * 4
+    out.set(name, data)
+  }
+  return out
+}
+
+/**
+ * The key for a car's archive, from its folder name: eight checksums of the
+ * lowercased name in signed 32-bit arithmetic, each kept to its low byte,
+ * joined with "-". Written from a description of the scheme two open-source
+ * readers share; it opens all 245 archives on the machine it was checked on.
+ */
+export function acdKey(folder: string): string {
+  const c = [...folder.toLowerCase()].map((ch) => ch.charCodeAt(0))
+  const n = c.length
+  const at = (i: number): number => c[i]!
+  const div = (a: number, b: number): number => Math.trunc(a / b) | 0
+
+  let k1 = 0
+  for (let i = 0; i < n; i++) k1 = (k1 + at(i)) | 0
+
+  let k2 = 0
+  for (let i = 0; i < n - 1; i += 2) k2 = (Math.imul(k2, at(i)) - at(i + 1)) | 0
+
+  let k3 = 0
+  for (let i = 1; i < n - 3; i += 3) {
+    k3 = Math.imul(k3, at(i))
+    k3 = div(k3, at(i + 1) + 27)
+    k3 = (k3 - 27 - at(i - 1)) | 0
+  }
+
+  let k4 = 0x1683
+  for (let i = 1; i < n; i++) k4 = (k4 - at(i)) | 0
+
+  let k5 = 66
+  for (let i = 1; i < n - 4; i += 4)
+    k5 = (Math.imul(Math.imul(k5, at(i) + 15), at(i - 1) + 15) + 22) | 0
+
+  let k6 = 101
+  for (let i = 0; i < n - 2; i += 2) k6 = (k6 - at(i)) | 0
+
+  let k7 = 171
+  for (let i = 0; i < n - 2; i += 2) k7 = k7 % at(i)
+
+  let k8 = 171
+  for (let i = 0; i < n - 1; i++) k8 = (div(k8, at(i)) + at(i + 1)) | 0
+
+  return [k1, k2, k3, k4, k5, k6, k7, k8].map((k) => k & 0xff).join("-")
+}
+
+/** `[SECTION]` → key → value, values with comments and padding stripped. */
+export function parseIni(text: string): Map<string, Map<string, string>> {
+  const out = new Map<string, Map<string, string>>()
+  let section = new Map<string, string>()
+  for (const raw of text.split(/\r?\n/)) {
+    const line = raw.replace(/;.*$|\/\/.*$/, "").trim()
+    const head = /^\[(.+)\]$/.exec(line)
+    if (head) {
+      section = out.get(head[1]!) ?? new Map()
+      out.set(head[1]!, section)
+    } else {
+      const eq = line.indexOf("=")
+      if (eq > 0) section.set(line.slice(0, eq).trim(), line.slice(eq + 1).trim())
+    }
+  }
+  return out
+}
+
+/**
+ * Wheel centers relative to the car's center of gravity, which is where the
+ * game puts a car's position: across by half the track, down by BASEY, and
+ * along by the wheelbase split at CG_LOCATION (the share of weight on the
+ * front axle). On a Nissan R32 this reproduces the wheels the game stored in
+ * a replay to within a centimeter.
+ */
+export function wheelsFromSuspension(ini: string): WheelOffsets {
+  const s = parseIni(ini)
+  const num = (section: string, key: string): number => {
+    const v = Number(s.get(section)?.get(key))
+    if (!Number.isFinite(v)) throw new Error(`suspensions.ini has no usable ${section}.${key}`)
+    return v
+  }
+  const wheelbase = num("BASIC", "WHEELBASE")
+  const cg = num("BASIC", "CG_LOCATION")
+  const front = { x: num("FRONT", "TRACK") / 2, y: num("FRONT", "BASEY"), z: wheelbase * (1 - cg) }
+  const rear = { x: num("REAR", "TRACK") / 2, y: num("REAR", "BASEY"), z: -wheelbase * cg }
+  return [
+    [front.x, front.y, front.z],
+    [-front.x, front.y, front.z],
+    [rear.x, rear.y, rear.z],
+    [-rear.x, rear.y, rear.z],
+  ]
+}
+
+/**
+ * One file of a car's data, from `<carDir>/data/` when the car is unpacked and
+ * from its `data.acd` otherwise; undefined when it has neither or the file is
+ * not in them. The archive's key is the folder's name, so `carDir` has to be
+ * the car's own folder, named as the game names it.
+ */
+export async function readCarFile(carDir: string, name: string): Promise<Buffer | undefined> {
+  const unpacked = await readFile(join(carDir, "data", name)).catch(() => undefined)
+  if (unpacked !== undefined) return unpacked
+  const acd = await readFile(join(carDir, "data.acd")).catch(() => undefined)
+  return acd ? readAcd(acd, basename(carDir)).get(name) : undefined
+}
+
+/**
+ * A car's wheel offsets from `<cars>/<model>`, unpacked `data/` first, then
+ * `data.acd`; undefined when the car has neither or they can't be read.
+ */
+export async function carWheels(carsDir: string, model: string): Promise<WheelOffsets | undefined> {
+  const ini = await readCarFile(join(carsDir, model), "suspensions.ini")
+  return ini ? wheelsFromSuspension(ini.toString("latin1")) : undefined
+}
+
+/**
+ * Where the driver's eyes are, from `car.ini`'s `[GRAPHICS] DRIVEREYES`: the
+ * cockpit camera's position, in the frame of the car's 3D model rather than of
+ * its physics, so `[BASIC] GRAPHICS_OFFSET` does not apply to it. +x is to the
+ * car's left, +y up, +z forward, as in the model.
+ */
+export function driverEyes(carIni: string): Vec3 {
+  const raw = parseIni(carIni).get("GRAPHICS")?.get("DRIVEREYES")
+  const v = (raw ?? "").split(",").map((n) => Number(n.trim()))
+  if (v.length !== 3 || !v.every(Number.isFinite)) {
+    throw new Error(
+      `car.ini has no usable GRAPHICS.DRIVEREYES${raw === undefined ? "" : `: ${JSON.stringify(raw)}`}`,
+    )
+  }
+  return [v[0]!, v[1]!, v[2]!]
+}
+
+/** A car's driver's eyes from `<cars>/<model>`; undefined when its data can't be read. */
+export async function carDriverEyes(carsDir: string, model: string): Promise<Vec3 | undefined> {
+  const ini = await readCarFile(join(carsDir, model), "car.ini")
+  return ini ? driverEyes(ini.toString("latin1")) : undefined
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export {
+  acdKey,
+  type CarFiles,
+  carDriverEyes,
+  carWheels,
+  driverEyes,
+  parseIni,
+  readAcd,
+  readCarFile,
+  type Vec3,
+  type WheelOffsets,
+  wheelsFromSuspension,
+} from "./cardata.js"