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

package/dist/hud.js

@@ -0,0 +1,247 @@
+import { mapColor } from "./map.js";
+import { Ped } from "./ped.js";
+import { Vehicle } from "./vehicle.js";
+const BLIP_COLORS = { red: 0, green: 1, blue: 2, white: 3, yellow: 4, purple: 5, cyan: 6, threat: 7, destination: 8 };
+/** A blip on one player's radar (`player.hud.blip()`). */
+export class Blip {
+    #hud;
+    #spec;
+    #options;
+    id;
+    #removed = false;
+    /** @internal */
+    constructor(hud, id, spec, options = {}) {
+        this.#hud = hud;
+        this.#options = { ...options };
+        this.id = id;
+        this.#spec = spec;
+        hud.send(id, spec);
+    }
+    /** Changes the options given; the others stay as they are. */
+    set(options) {
+        if (this.#removed || !this.#spec)
+            return this;
+        this.#options = { ...this.#options, ...options };
+        this.#spec = { ...this.#spec, ...encodeBlipOptions(this.#options, this.#spec.kind) };
+        this.#hud.send(this.id, this.#spec);
+        return this;
+    }
+    remove() {
+        if (this.#removed)
+            return;
+        this.#removed = true;
+        this.#hud.send(this.id, null);
+    }
+}
+function encodeBlipOptions(o, kind) {
+    const c = o.color ?? (kind === 0 ? "destination" : "blue");
+    return {
+        color: typeof c === "string" && c in BLIP_COLORS ? BLIP_COLORS[c] : mapColor(c, 0xffffffff),
+        display: o.display === "marker" ? 1 : o.display === "blip" ? 2 : 0,
+        scale: o.scale ?? 0,
+        pulse: o.pulse ?? false,
+        sprite: o.sprite ?? 0,
+        shortRange: o.shortRange ?? false,
+    };
+}
+/** A timer or counter on one player's HUD (`player.hud.counter()`, `.timer()`). */
+export class HudCounter {
+    #native;
+    #player;
+    id;
+    #spec;
+    #removed = false;
+    /** @internal */
+    constructor(native, player, id, spec) {
+        this.#native = native;
+        this.#player = player;
+        this.id = id;
+        this.#spec = spec;
+        native.hudCounter(player, id, spec);
+    }
+    /** The number (a counter), the time left (a timer, ms), or how full (a bar). */
+    set value(value) {
+        if (this.#removed)
+            return;
+        this.#spec = { ...this.#spec, value: Math.round(value) };
+        this.#native.hudCounter(this.#player, this.id, this.#spec);
+    }
+    get value() {
+        return this.#spec.value ?? 0;
+    }
+    /**
+     * A timer held still (showing `value`, the time left) or counting again
+     * from it.
+     */
+    setPaused(paused, value) {
+        if (this.#removed)
+            return;
+        this.#spec = { ...this.#spec, value: Math.round(value), paused };
+        this.#native.hudCounter(this.#player, this.id, this.#spec);
+    }
+    /** Changes its label. */
+    set label(label) {
+        if (this.#removed)
+            return;
+        this.#spec = { ...this.#spec, label: label.slice(0, 47) };
+        this.#native.hudCounter(this.#player, this.id, this.#spec);
+    }
+    remove() {
+        if (this.#removed)
+            return;
+        this.#removed = true;
+        this.#native.hudCounter(this.#player, this.id, null);
+    }
+}
+const HUD_PARTS = { visible: 1, radar: 2, areaNames: 4, vehicleNames: 8, clock: 16, health: 32, armour: 64, chat: 128 };
+export class PlayerHud {
+    #native;
+    #player;
+    #nextId = 1;
+    #hidden = 0;
+    /** @internal */
+    constructor(native, player) {
+        this.#native = native;
+        this.#player = player;
+    }
+    /**
+     * Shows or hides parts of the game's HUD for them; parts left out stay
+     * as they are. A client script can hide parts too (`sagl.hud.set`): a
+     * part shows only if neither hides it.
+     *
+     * ```ts
+     * player.hud.set({ visible: false });                 // a login screen: nothing over the shot
+     * player.hud.set({ visible: true, clock: false });    // back, without the clock
+     * ```
+     */
+    set(parts) {
+        for (const [k, bit] of Object.entries(HUD_PARTS)) {
+            const on = parts[k];
+            if (on === undefined)
+                continue;
+            this.#hidden = on ? this.#hidden & ~bit : this.#hidden | bit;
+        }
+        this.#native.hudToggles(this.#player, this.#hidden);
+    }
+    /** Which parts show (as the server set them). */
+    get parts() {
+        const out = {};
+        for (const [k, bit] of Object.entries(HUD_PARTS))
+            out[k] = !(this.#hidden & bit);
+        return out;
+    }
+    /** @internal */
+    send(id, spec) {
+        this.#native.setBlip(this.#player, id, spec);
+    }
+    /**
+     * A blip on their radar: on a spot (with the game's cylinder marker), or
+     * on a ped, vehicle or player (an arrow over them), following it.
+     */
+    blip(target, options = {}) {
+        const id = this.#nextId++;
+        let kind = 0;
+        let at = { x: 0, y: 0, z: 0 };
+        let ref = 0;
+        if (target instanceof Ped) {
+            kind = 1;
+            ref = target.id;
+        }
+        else if (target instanceof Vehicle) {
+            kind = 2;
+            ref = target.id;
+        }
+        else if ("name" in target) {
+            kind = 3;
+            ref = target.id;
+        }
+        else {
+            at = { x: target.x, y: target.y, z: target.z };
+        }
+        return new Blip(this, id, { kind, ...at, target: ref, ...encodeBlipOptions(options, kind) }, options);
+    }
+    /**
+     * The objective, at the bottom of their screen in the game's mission text
+     * style, for `ms` (default: about as long as reading it takes; `Infinity`:
+     * until replaced or cleared).
+     */
+    objective(text, ms) {
+        this.#native.hudText(this.#player, 0, text.slice(0, 255), ms === Infinity ? 0xffffffff : Math.max(0, ms ?? 0));
+    }
+    /**
+     * The game's help box, top left (its hints: "Press F to ..."), for `ms`
+     * (default: about as long as reading it takes; `Infinity`: until replaced
+     * or cleared). Game codes and `gxt()` work. An interaction's prompt shows
+     * over it while one's in reach.
+     */
+    help(text, ms) {
+        this.#native.hudText(this.#player, 3, text.slice(0, 255), ms === Infinity ? 0xffffffff : Math.max(0, ms ?? 0));
+    }
+    /** Clears the help box. */
+    clearHelp() {
+        this.#native.hudText(this.#player, 3, "", 1);
+    }
+    /** Clears the objective. */
+    clearObjective() {
+        this.#native.hudText(this.#player, 0, "", 1);
+    }
+    /**
+     * A notice in the middle of their screen, as the game's garages and
+     * shops give ("New engine and paint job: $100"), for `ms` (default 4000).
+     * Game codes and `gxt()` work.
+     */
+    notice(text, ms = 4000) {
+        this.#native.notice(this.#player, text.slice(0, 255), Math.max(1, Math.min(60_000, Math.trunc(ms))));
+    }
+    /**
+     * The game's own big text, in one of its seven styles, as SA-MP's
+     * GameTextForPlayer (the same numbers): 0 big in the middle (mission
+     * passed), 1 bottom right (the time, money), 2 white in the middle,
+     * 3 smaller in the middle, 4 smaller, a bit higher, 5 small white in the
+     * middle, 6 light blue at the top. Game codes (`~r~`, `~n~`...) and
+     * `gxt()` work. `ms` default 3000.
+     *
+     * ```ts
+     * player.hud.gameText("~g~Welcome~n~~w~to Los Santos", 3000, GameTextStyle.Middle);
+     * ```
+     */
+    gameText(text, ms = 3000, style = 3) {
+        if (!Number.isInteger(style) || style < 0 || style > 6)
+            throw new RangeError(`not a game text style: ${style} (0-6)`);
+        this.#native.hudText(this.#player, 2, text.slice(0, 255), Math.max(1, Math.trunc(ms)), style);
+    }
+    /** Big text in the middle of their screen, for `ms`. */
+    bigText(text, ms) {
+        this.#native.hudText(this.#player, 1, text.slice(0, 255), Math.max(0, ms ?? 0));
+    }
+    /** A counter under their money: `label  value` (`value/max` with `max`), or a bar. */
+    counter(label, options = {}) {
+        return new HudCounter(this.#native, this.#player, this.#nextId++, {
+            label: label.slice(0, 47), value: Math.round(options.value ?? 0), max: Math.round(options.max ?? 0),
+            bar: options.bar ?? false, color: options.color === undefined ? 0 : mapColor(options.color, 0),
+        });
+    }
+    /** A timer under their money, counting down from `ms` (or up from it, `countUp`). */
+    timer(label, ms, options = {}) {
+        return new HudCounter(this.#native, this.#player, this.#nextId++, {
+            label: label.slice(0, 47), timer: true, countUp: options.countUp ?? false, value: Math.round(ms),
+            color: options.color === undefined ? 0 : mapColor(options.color, 0),
+        });
+    }
+    /** "MISSION PASSED!" with the game's tune, and `subtitle` under it (the reward: "$2500"). */
+    missionPassed(subtitle = "") {
+        this.#result("passed", "", subtitle, true);
+    }
+    /** "MISSION FAILED!", and `subtitle` under it (why). */
+    missionFailed(subtitle = "") {
+        this.#result("failed", "", subtitle, false);
+    }
+    /** A result screen of your own: `title` ("1st place!"), and `subtitle` under it. */
+    missionResult(title, subtitle = "") {
+        this.#result("custom", title, subtitle, false);
+    }
+    #result(kind, title, subtitle, sound) {
+        this.#native.missionResult(this.#player, kind, title.slice(0, 63), subtitle.slice(0, 127), sound, 0);
+    }
+}
+//# sourceMappingURL=hud.js.map

package/dist/hud.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+export { Server, type ServerOptions, type Branding, type VehicleOptions, type ServerEvents, type Hit, type VehicleHit, type Shot, type Explosion, type PedOptions, type AmbientSpawn, type QuitReason, type NameTagOptions } from "./server.js";
+export type { WeaponViolationReason } from "./native.js";
+export { type SpecialAction } from "./special.js";
+export { GangZone, type GangZoneArea } from "./gangzones.js";
+export { Player, type Vector3, type DialogOptions, type DialogAnswer, type NameTagSettings, type WorldBounds } from "./player.js";
+export { Vehicle, DoorDamage, TyreDamage, PanelDamage, componentSlot, componentFits, type VehicleDamage, type Indicators } from "./vehicle.js";
+export { Zone, Garage, GarageType } from "./zone.js";
+export { World, Weather, CullZone, ZoneAttribute, AudioZone, TrafficLights, type Population, type TrafficLight, type TrafficLightStates, type TrafficLightTiming, } from "./world.js";
+export { Console, type CommandHandler } from "./console.js";
+export { Weapon, Stat, BodyPart, Color, RadioStation, VoiceContext, GameSound, GameTextStyle, ComponentSlot, Bone, ExplosionType, FightingStyle, MaterialSize, MaterialTextAlign, Key, keyPressed, keyReleased, Crime } from "./constants.js";
+export { Ped, type PedStep, type PedTarget, type Pace, type OrderResult, type PedEvents, type PedSettings } from "./ped.js";
+export { ClientScripts, Channel, type ChannelData, type ClientScriptError } from "./scripts.js";
+export { GameMap, type MapMarkerOptions, type MapOverlayOptions, type MapColor } from "./map.js";
+export { PlayerHud, Blip, HudCounter, type BlipOptions, type BlipColor, type HudParts } from "./hud.js";
+export { defineMission, Mission, Missions, MissionBlip, MissionCounter, MissionMarker, MissionEnded, MissionRefused, type MissionDefinition, type MissionOutcome, type MissionEvent, type MissionEndReason, type WaitOptions, type ReachOptions, type SectionOptions, type MarkerOptions, type MissionStep, type OnEnd, type EndOptions, } from "./mission.js";
+export { gxt } from "./text.js";
+export { distance, distance2d, headingVector, headingTo, along } from "./geo.js";
+export { ServerAudio, Sound, splitSubtitles, type SoundOptions, type SpeakOptions, type Speech } from "./audio.js";
+export { ServerAnimations, type AnimationSetInfo } from "./animations.js";
+export { ServerModels, type CustomModelInfo, isCustomModelId } from "./models.js";
+export { AudioPresets, type AudioEffect, type AudioEffects, type AudioPreset } from "./audio_effects.js";
+export { Claims } from "./claims.js";
+export { command, arg, Commands, CommandBuilder, CommandError, type ArgType, type CommandArgs } from "./commands.js";
+export type { ChatOptions } from "./server.js";
+export { PlayerCamera, type CameraShot, type CameraTarget, type CameraThing, type CameraPosition, type CameraRotation, type CameraEase, type CameraPath, type CameraPathPoint, type CameraStep, type CameraPlayOptions, type CameraSequence, type CameraFocus, } from "./camera.js";
+export { PlayerSplash } from "./splash.js";
+export { ServerEffects, Effect, type EffectTarget, type EffectOptions, type DustOptions } from "./effects.js";
+export { GameObject, Pickup, Label, type ObjectOptions, type MaterialOptions, type MaterialTextOptions, type PickupOptions, type LabelOptions, type LabelTarget, type Rotation } from "./objects.js";
+export { Interaction, Interactions, type InteractionOptions, type InteractionUse } from "./interaction.js";
+export { CutscenePlay, type CutsceneOptions, type CutsceneResult } from "./cutscene.js";
+export { PayNSpray, type PayNSprayOptions } from "./paynspray.js";
+export type { Livery, PaintFinish, MetallicFinish, PearlFinish, SatinFinish, ColorShiftFinish, CustomFinish, PaintSlots } from "./paint.js";
+export { VehicleColors } from "./vehiclecolors.js";
+export { ScreenEffects, ScreenEffect, BUILT_IN_SCREEN_EFFECTS, type ScreenEffectOptions, type ScreenEffectParams } from "./screeneffects.js";
+export { ModShops, ModShop, ModShopSite, DEFAULT_MOD_SHOP_FINISHES, type ModShopOptions, type ModShopFinish, type ModShopLivery, type ModShopArea, type ModShopCreate, } from "./modshop.js";
+export { MOD_SHOP_PARTS, MOD_SHOP_SITES, MOD_SHOP_COLORS, CAR_COLORS } from "./modshop_data.js";
+export { PlayerMenu, type MenuHint, type MenuOptions, type MenuRow } from "./menu.js";
+export { PlayerUi, UiDocument, type UiEvent, type UiEventType, type UiOpenOptions, type ShowDocumentOptions } from "./ui.js";
+export { ScreenDraw, Drawn, type DrawFont, type TextOptions, type DrawChanges, type Anchor, type PlaceOptions } from "./draw.js";
+export { Actions, KEY_NAMES, type ActionOptions } from "./actions.js";

package/dist/index.js

@@ -0,0 +1,43 @@
+// @sagl/server: write SAGL gamemodes in Node.js.
+//
+//   import { Server } from "@sagl/server";
+//   const server = new Server({ port: 7777 });
+//   server.on("playerJoin", (player) => player.send("Welcome!"));
+//   server.listen();
+export { Server } from "./server.js";
+export { GangZone } from "./gangzones.js";
+export { Player } from "./player.js";
+export { Vehicle, DoorDamage, TyreDamage, PanelDamage, componentSlot, componentFits } from "./vehicle.js";
+export { Zone, Garage, GarageType } from "./zone.js";
+export { World, Weather, CullZone, ZoneAttribute, AudioZone, TrafficLights, } from "./world.js";
+export { Console } from "./console.js";
+export { Weapon, Stat, BodyPart, Color, RadioStation, VoiceContext, GameSound, GameTextStyle, ComponentSlot, Bone, ExplosionType, FightingStyle, MaterialSize, MaterialTextAlign, Key, keyPressed, keyReleased, Crime } from "./constants.js";
+export { Ped } from "./ped.js";
+export { ClientScripts, Channel } from "./scripts.js";
+export { GameMap } from "./map.js";
+export { PlayerHud, Blip, HudCounter } from "./hud.js";
+export { defineMission, Mission, Missions, MissionBlip, MissionCounter, MissionMarker, MissionEnded, MissionRefused, } from "./mission.js";
+export { gxt } from "./text.js";
+export { distance, distance2d, headingVector, headingTo, along } from "./geo.js";
+export { ServerAudio, Sound, splitSubtitles } from "./audio.js";
+export { ServerAnimations } from "./animations.js";
+export { ServerModels, isCustomModelId } from "./models.js";
+export { AudioPresets } from "./audio_effects.js";
+export { Claims } from "./claims.js";
+export { command, arg, Commands, CommandBuilder, CommandError } from "./commands.js";
+export { PlayerCamera, } from "./camera.js";
+export { PlayerSplash } from "./splash.js";
+export { ServerEffects, Effect } from "./effects.js";
+export { GameObject, Pickup, Label } from "./objects.js";
+export { Interaction, Interactions } from "./interaction.js";
+export { CutscenePlay } from "./cutscene.js";
+export { PayNSpray } from "./paynspray.js";
+export { VehicleColors } from "./vehiclecolors.js";
+export { ScreenEffects, ScreenEffect, BUILT_IN_SCREEN_EFFECTS } from "./screeneffects.js";
+export { ModShops, ModShop, ModShopSite, DEFAULT_MOD_SHOP_FINISHES, } from "./modshop.js";
+export { MOD_SHOP_PARTS, MOD_SHOP_SITES, MOD_SHOP_COLORS, CAR_COLORS } from "./modshop_data.js";
+export { PlayerMenu } from "./menu.js";
+export { PlayerUi, UiDocument } from "./ui.js";
+export { ScreenDraw, Drawn } from "./draw.js";
+export { Actions, KEY_NAMES } from "./actions.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":"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"}

package/dist/interaction.d.ts

@@ -0,0 +1,81 @@
+import type { NativeServer } from "./native.js";
+import type { Player, Vector3 } from "./player.js";
+export interface InteractionOptions {
+    /** Every map object of these models (up to 16), e.g. vending machines. */
+    models?: number[];
+    /** Or one spot. */
+    at?: Vector3;
+    /** How close they must be, facing it (m). Default 1.5, at most 3. */
+    radius?: number;
+    /**
+     * In the help box while they can use it. Game codes work,
+     * `~k~~VEHICLE_ENTER_EXIT~` for the key, and `gxt()` text. Left out:
+     * none (show your own with `onReach`).
+     */
+    prompt?: string;
+    /** Only these players can see and use it (others never hear of it). Default everyone. */
+    to?: readonly Player[];
+}
+/** Where it was used: the object (its model and position) or the spot (model 0). */
+export interface InteractionUse {
+    /** The object's model; 0: the spot. */
+    model: number;
+    /** The object's position, or the spot. */
+    position: Vector3;
+    /** Which way the object faces (degrees, 0 north, anticlockwise); 0 for a spot. */
+    heading: number;
+}
+/**
+ * Something players use by walking up to it and pressing the enter/exit key
+ * (F/Enter): any map object of some models (vending machines, payphones,
+ * ticket machines) or a spot. Made with `server.interactions.add()`.
+ */
+export declare class Interaction {
+    #private;
+    readonly id: number;
+    readonly options: Readonly<InteractionOptions>;
+    /** @internal */
+    constructor(id: number, options: InteractionOptions, remove: (i: Interaction) => void, changed: (i: Interaction) => void);
+    /** @internal Whether players' games say when it comes in reach. */
+    get notifies(): boolean;
+    /**
+     * `fn(player, use, inReach)` when it comes in a player's reach (true) and
+     * goes (false): to show your own prompt or UI (`player.ui.open()`,
+     * `player.draw`) instead of, or as well as, `prompt`.
+     */
+    onReach(fn: (player: Player, use: InteractionUse, inReach: boolean) => void): this;
+    /** `fn` when a player uses it (checked: they're near where they say). */
+    onUse(fn: (player: Player, use: InteractionUse) => void): this;
+    /** Takes it away for everyone. */
+    remove(): void;
+    /** @internal */
+    reached(player: Player, use: InteractionUse, inReach: boolean): void;
+    /** @internal */
+    used(player: Player, use: InteractionUse): void;
+}
+/** `server.interactions`: what players can walk up to and use. */
+export declare class Interactions {
+    #private;
+    /** @internal */
+    constructor(native: NativeServer, players: () => Player[]);
+    /**
+     * Something everyone can use (players joining later too).
+     *
+     * ```ts
+     * server.interactions.add({ models: [955, 956, 1775, 1776], prompt: "Press ~k~~VEHICLE_ENTER_EXIT~ to buy a drink ($1)" })
+     *   .onUse((player) => { if (player.money >= 1) { player.money -= 1; player.health = Math.min(100, player.health + 35); } });
+     * ```
+     */
+    add(options: InteractionOptions): Interaction;
+    /** @internal A player joined: everything there is. */
+    replay(player: Player): void;
+    /** @internal */
+    use(player: Player, id: number, where: {
+        event: "use" | "reach" | "leave";
+        model: number;
+        x: number;
+        y: number;
+        z: number;
+        heading: number;
+    }): void;
+}

package/dist/interaction.js

@@ -0,0 +1,143 @@
+/**
+ * Something players use by walking up to it and pressing the enter/exit key
+ * (F/Enter): any map object of some models (vending machines, payphones,
+ * ticket machines) or a spot. Made with `server.interactions.add()`.
+ */
+export class Interaction {
+    id;
+    options;
+    #handlers = [];
+    #reach = [];
+    #remove;
+    #changed;
+    /** @internal */
+    constructor(id, options, remove, changed) {
+        this.id = id;
+        this.options = options;
+        this.#remove = remove;
+        this.#changed = changed;
+    }
+    /** @internal Whether players' games say when it comes in reach. */
+    get notifies() {
+        return this.#reach.length > 0;
+    }
+    /**
+     * `fn(player, use, inReach)` when it comes in a player's reach (true) and
+     * goes (false): to show your own prompt or UI (`player.ui.open()`,
+     * `player.draw`) instead of, or as well as, `prompt`.
+     */
+    onReach(fn) {
+        this.#reach.push(fn);
+        if (this.#reach.length === 1)
+            this.#changed(this); // their games start saying so
+        return this;
+    }
+    /** `fn` when a player uses it (checked: they're near where they say). */
+    onUse(fn) {
+        this.#handlers.push(fn);
+        return this;
+    }
+    /** Takes it away for everyone. */
+    remove() {
+        this.#remove(this);
+    }
+    /** @internal */
+    reached(player, use, inReach) {
+        for (const fn of [...this.#reach]) {
+            try {
+                fn(player, use, inReach);
+            }
+            catch (err) {
+                console.error("[sagl] interaction handler threw:", err);
+            }
+        }
+    }
+    /** @internal */
+    used(player, use) {
+        for (const fn of [...this.#handlers]) {
+            try {
+                fn(player, use);
+            }
+            catch (err) {
+                console.error("[sagl] interaction handler threw:", err);
+            }
+        }
+    }
+}
+/** `server.interactions`: what players can walk up to and use. */
+export class Interactions {
+    #native;
+    #players;
+    #all = new Map();
+    #next = 1;
+    /** @internal */
+    constructor(native, players) {
+        this.#native = native;
+        this.#players = players;
+    }
+    /**
+     * Something everyone can use (players joining later too).
+     *
+     * ```ts
+     * server.interactions.add({ models: [955, 956, 1775, 1776], prompt: "Press ~k~~VEHICLE_ENTER_EXIT~ to buy a drink ($1)" })
+     *   .onUse((player) => { if (player.money >= 1) { player.money -= 1; player.health = Math.min(100, player.health + 35); } });
+     * ```
+     */
+    add(options) {
+        if (!options.models?.length && !options.at)
+            throw new TypeError("an interaction needs models or a spot (at)");
+        if ((options.models?.length ?? 0) > 16)
+            throw new RangeError("at most 16 models");
+        const i = new Interaction(this.#next++, { ...options, to: options.to ? [...options.to] : undefined }, (x) => this.#delete(x), (x) => { for (const p of this.#players())
+            if (this.#for(x, p))
+                this.#send(p, x); });
+        this.#all.set(i.id, i);
+        for (const p of this.#players())
+            if (this.#for(i, p))
+                this.#send(p, i);
+        return i;
+    }
+    /** @internal A player joined: everything there is. */
+    replay(player) {
+        for (const i of this.#all.values())
+            if (this.#for(i, player))
+                this.#send(player, i);
+    }
+    /** @internal */
+    use(player, id, where) {
+        const i = this.#all.get(id);
+        if (!i || !this.#for(i, player))
+            return;
+        const o = i.options;
+        if (where.model ? !o.models?.includes(where.model) : !o.at)
+            return;
+        const at = where.model ? where : o.at;
+        // Their game says where; the server checks they're there.
+        const p = player.position;
+        const near = Math.hypot(p.x - at.x, p.y - at.y) <= Math.min(o.radius ?? 1.5, 3) + 2 && Math.abs(p.z - at.z) <= 3;
+        if (!near && where.event !== "leave")
+            return; // (leaving: they've walked off)
+        const use = { model: where.model, position: { x: at.x, y: at.y, z: at.z }, heading: where.model ? where.heading : 0 };
+        if (where.event === "use")
+            i.used(player, use);
+        else
+            i.reached(player, use, where.event === "reach");
+    }
+    #for(i, player) {
+        return !i.options.to || i.options.to.includes(player);
+    }
+    #send(player, i) {
+        const o = i.options;
+        this.#native.interaction(player.id, i.id, {
+            models: o.models ?? [], x: o.at?.x ?? 0, y: o.at?.y ?? 0, z: o.at?.z ?? 0, radius: o.radius ?? 0,
+            prompt: o.prompt ?? "", notify: i.notifies,
+        });
+    }
+    #delete(i) {
+        if (!this.#all.delete(i.id))
+            return;
+        for (const p of this.#players())
+            this.#native.interaction(p.id, i.id, null);
+    }
+}
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

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

package/dist/junctions.d.ts

@@ -0,0 +1 @@
+export declare const JUNCTIONS: readonly (readonly [number, number, number])[];