@sagl/server 0.0.0-stage → 0.1.0-next.49

package/dist/zone.js

@@ -0,0 +1,140 @@
+/** The game's garage types (as the map files define them). */
+export const GarageType = {
+    Mission: 1,
+    BombShopTimed: 2,
+    BombShopEngine: 3,
+    BombShopRemote: 4,
+    PayNSpray: 5,
+    SafehouseGanton: 16,
+    SafehouseSantaMaria: 17,
+    SafehouseRockshore: 18,
+    ImpoundLS: 33,
+    ImpoundSF: 34,
+    ImpoundLV: 35,
+};
+/**
+ * An area the server watches players against, firing `zoneEnter`,
+ * `zoneLeave` and `zoneMove` (each position update while inside). Positions
+ * are the ones players sync, on foot or driving.
+ */
+export class Zone {
+    id;
+    /** The garage this zone covers, for the built-in garage zones. */
+    garage;
+    /** Free-form storage for gamemode data. */
+    data = {};
+    #destroy;
+    #exists = true;
+    /** @internal Created by Server. */
+    constructor(id, garage, destroy) {
+        this.id = id;
+        this.garage = garage;
+        this.#destroy = destroy;
+    }
+    get exists() {
+        return this.#exists;
+    }
+    /** @internal */
+    markDestroyed() {
+        this.#exists = false;
+    }
+    /** Stops watching it (no leave events are sent). */
+    destroy() {
+        if (this.#exists)
+            this.#destroy(this);
+    }
+}
+/**
+ * One of the game's garages: a door the server opens and closes for
+ * everyone, and a zone over its floor. Players' games run none of the
+ * garage's own logic (no Pay 'n' Spray, safehouse storage, ...): build that
+ * from `zoneEnter` on `garage.zone`.
+ */
+export class Garage {
+    id;
+    /** As in the map files; not unique. */
+    name;
+    /** See `GarageType`. */
+    type;
+    position;
+    zone;
+    #native;
+    #open;
+    #box;
+    /** @internal Created by Server. */
+    constructor(nativeServer, state) {
+        this.#native = nativeServer;
+        this.id = state.id;
+        this.name = state.name || `garage${state.id}`;
+        this.type = state.type;
+        this.position = { x: state.x, y: state.y, z: state.z };
+        this.#open = state.open;
+        this.#box = {
+            x: state.x, y: state.y, z: state.z, ax: state.frontX - state.x, ay: state.frontY - state.y,
+            bx: state.sideX - state.x, by: state.sideY - state.y, top: state.topZ,
+        };
+    }
+    /**
+     * Whether a spot is inside it, at least `margin` m from its walls (not
+     * the floor or roof): a car's position with a margin of half its length
+     * is a car wholly inside, as the game's garages check before shutting.
+     * A negative margin reaches that far outside.
+     */
+    contains(at, margin = 0) {
+        const b = this.#box;
+        if (at.z < b.z - 1 || at.z > b.top)
+            return false;
+        const la = Math.hypot(b.ax, b.ay), lb = Math.hypot(b.bx, b.by);
+        const dx = at.x - b.x, dy = at.y - b.y;
+        // Along each side, in metres from its start.
+        const u = (dx * b.ax + dy * b.ay) / la, v = (dx * b.bx + dy * b.by) / lb;
+        return u >= margin && u <= la - margin && v >= Math.min(margin, lb / 2) && v <= lb - Math.min(margin, lb / 2);
+    }
+    /**
+     * The spot `distance` m outside the wall nearest `at`, across from `at`
+     * (for where a car drove in: in front of the door), facing away from the
+     * garage: where to put a car driving out.
+     */
+    outside(at, distance = 4) {
+        const b = this.#box;
+        const la = Math.hypot(b.ax, b.ay), lb = Math.hypot(b.bx, b.by);
+        const a1 = { x: b.ax / la, y: b.ay / la }, b1 = { x: b.bx / lb, y: b.by / lb };
+        const dx = at.x - b.x, dy = at.y - b.y;
+        const u = dx * a1.x + dy * a1.y, v = dx * b1.x + dy * b1.y;
+        // Each wall: how far `at` is in from it (outside: less than 0), the spot
+        // on it across from `at` (along a, b), its outward way.
+        const cu = Math.max(1, Math.min(la - 1, u)), cv = Math.max(1, Math.min(lb - 1, v));
+        const walls = [
+            { d: v, mid: [cu, 0], out: { x: -b1.x, y: -b1.y } },
+            { d: lb - v, mid: [cu, lb], out: b1 },
+            { d: u, mid: [0, cv], out: { x: -a1.x, y: -a1.y } },
+            { d: la - u, mid: [la, cv], out: a1 },
+        ];
+        const w = walls.reduce((m, x) => (x.d < m.d ? x : m));
+        const mx = b.x + a1.x * w.mid[0] + b1.x * w.mid[1], my = b.y + a1.y * w.mid[0] + b1.y * w.mid[1];
+        return {
+            position: { x: mx + w.out.x * distance, y: my + w.out.y * distance, z: b.z + 0.5 },
+            heading: ((Math.atan2(-w.out.x, w.out.y) * 180) / Math.PI + 360) % 360,
+        };
+    }
+    /** Its floor's middle. */
+    get center() {
+        const b = this.#box;
+        return { x: b.x + (b.ax + b.bx) / 2, y: b.y + (b.ay + b.by) / 2, z: b.z };
+    }
+    get isOpen() {
+        return this.#open;
+    }
+    open() {
+        this.#open = true;
+        this.#native.setGarageOpen(this.id, true);
+    }
+    close() {
+        this.#open = false;
+        this.#native.setGarageOpen(this.id, false);
+    }
+    toString() {
+        return `garage ${this.id} (${this.name})`;
+    }
+}
+//# sourceMappingURL=zone.js.map

package/dist/zone.js.map

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

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@sagl/server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-next.49",
+  "description": "SAGL multiplayer server for GTA: San Andreas, scriptable in Node.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "homepage": "https://docs.sagl.mp",
+  "keywords": [
+    "gta",
+    "san-andreas",
+    "multiplayer",
+    "game-server",
+    "sagl"
+  ],
+  "optionalDependencies": {
+    "@sagl/server-linux-x64": "0.1.0-next.49",
+    "@sagl/server-win32-x64": "0.1.0-next.49"
+  }
+}