@adatechnology/game-weather-three 0.3.2 → 0.4.0

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { WorkshopEngine, VfxWorld, Puddle } from '@adatechnology/game-vfx';
 import { WeatherSample, WeatherVisualFactory } from '@adatechnology/game-weather';
 
 /** The only three.js members the renderer needs at runtime. Pass your own `THREE` instance (the whole namespace works). */
-type ThreeLib = Pick<typeof THREE_NS, 'AdditiveBlending' | 'BoxGeometry' | 'BufferAttribute' | 'BufferGeometry' | 'Color' | 'ConeGeometry' | 'DoubleSide' | 'Fog' | 'FogExp2' | 'Group' | 'HemisphereLight' | 'Mesh' | 'MeshBasicMaterial' | 'Object3D' | 'PlaneGeometry' | 'Points' | 'ShaderMaterial' | 'SpotLight' | 'Vector3'>;
+type ThreeLib = Pick<typeof THREE_NS, 'AdditiveBlending' | 'Box3' | 'BoxGeometry' | 'BufferAttribute' | 'BufferGeometry' | 'Color' | 'ConeGeometry' | 'DoubleSide' | 'Fog' | 'FogExp2' | 'Group' | 'HemisphereLight' | 'Mesh' | 'Matrix4' | 'MeshBasicMaterial' | 'Object3D' | 'PlaneGeometry' | 'Points' | 'ShaderMaterial' | 'SpotLight' | 'Vector3'>;
 /** What the renderer reads of a weather world: its sample. A `createWeather` world fits. */
 type WeatherSource = {
     sample(): WeatherSample;
@@ -320,6 +320,11 @@ type WeatherVisualOptions = Pick<WeatherRendererOptions, 'profile' | 'random' |
     readonly vehicles?: (THREE: ThreeLib) => RigVehicles;
     /** Fleet id of the rig's car (default `midsize_sedan`). */
     readonly rigVehicle?: string;
+    /**
+     * The rig's car as an item of the host's catalogue (`sedan` of the vehicles test module): the host puts it in its world (`ModuleHost.addObject`), so shots, blows, blasts and fire damage it, it
+     * blocks the player and its doors open, and the lamps go on its nose. Wins over `vehicles` when the host can place it; until a loaded module has the item the rig has only the lamps.
+     */
+    readonly rigItem?: string;
     /** Which layers start on (all do by default); the room that is not about weather starts the sky and the fog off to keep its own look. */
     readonly layers?: Partial<Record<WeatherLayerId, boolean>>;
 };
@@ -330,6 +335,7 @@ interface RigVehicles {
     }): {
         readonly group: THREE_NS.Object3D;
         readonly length: number;
+        readonly width?: number;
         dispose(): void;
     };
 }

package/dist/index.global.js

@@ -2348,6 +2348,24 @@ var GameWeatherThree = (() => {
     };
   }
 
+  // ../game-contracts/dist/index.js
+  function footprintBlocker(object, footprint) {
+    return (x, z, radius) => {
+      const o = typeof object === "function" ? object() : object;
+      const fp = typeof footprint === "function" ? footprint() : footprint;
+      if (!o || !fp || !o.parent) return false;
+      o.updateWorldMatrix?.(true, false);
+      const e = o.matrixWorld.elements;
+      const dx = x - e[12];
+      const dz = z - e[14];
+      const ax = e[0] ** 2 + e[1] ** 2 + e[2] ** 2;
+      const az = e[8] ** 2 + e[9] ** 2 + e[10] ** 2;
+      const lx = (dx * e[0] + dz * e[2]) / (ax || 1);
+      const lz = (dx * e[8] + dz * e[10]) / (az || 1);
+      return lx > fp.minX - radius && lx < fp.maxX + radius && lz > fp.minZ - radius && lz < fp.maxZ + radius;
+    };
+  }
+
   // src/bench/text.ts
   var TEXTS = {
     en: { layers: { far_rain: "Rain curtain", near_rain: "Near rain and splashes", mist: "Mist and ash", sky: "Sky", lightning: "Lightning", headlights: "Headlights", haze: "Heat haze" } },
@@ -2367,8 +2385,10 @@ var GameWeatherThree = (() => {
       car.group.position.z = HEADLIGHTS.lamp[2] + 0.1 - car.length / 2;
       group.add(car.group);
     }
+    const footprint = car ? footprintOf(car) : void 0;
     return {
       group,
+      ...footprint ? { footprint } : {},
       dispose() {
         car?.dispose();
       }
@@ -2395,19 +2415,58 @@ var GameWeatherThree = (() => {
           ...options.headlights ? { headlights: options.headlights } : {},
           ...options.layers ? { layers: options.layers } : {}
         });
-        return attachRig(THREE, host, renderer, options.rig === void 0 ? RIG_DEFAULT : options.rig, options.vehicles?.(THREE), options.rigVehicle ?? RIG_VEHICLE);
+        const item = options.rigItem && host.addObject ? options.rigItem : void 0;
+        return attachRig(THREE, host, renderer, options.rig === void 0 ? RIG_DEFAULT : options.rig, item ? void 0 : options.vehicles?.(THREE), options.rigVehicle ?? RIG_VEHICLE, item);
       }
     };
   }
-  function attachRig(THREE, host, renderer, place, vehicles, key) {
+  function footprintOf(car) {
+    if (!car.width) return void 0;
+    const z = car.group.position.z;
+    return { minX: -car.width / 2, maxX: car.width / 2, minZ: z - car.length / 2, maxZ: z + car.length / 2 };
+  }
+  function lengthOf(THREE, root) {
+    root.updateMatrixWorld(true);
+    const inverse = new THREE.Matrix4().copy(root.matrixWorld).invert();
+    const box = new THREE.Box3();
+    const piece = new THREE.Box3();
+    const matrix = new THREE.Matrix4();
+    root.traverse((mesh2) => {
+      const m = mesh2;
+      if (!m.isMesh || !m.geometry) return;
+      if (!m.geometry.boundingBox) m.geometry.computeBoundingBox();
+      piece.copy(m.geometry.boundingBox).applyMatrix4(matrix.multiplyMatrices(inverse, m.matrixWorld));
+      box.union(piece);
+    });
+    return box.isEmpty() ? 0 : box.max.z - box.min.z;
+  }
+  function attachRig(THREE, host, renderer, place, vehicles, key, item) {
     const scene = host.scene;
     const rig = place === false ? void 0 : buildRig(THREE, vehicles, key);
     let detach;
+    let unblock;
     if (rig && place) {
       rig.group.position.set(place[0], 0, place[1]);
       rig.group.rotation.y = place[2];
       scene.add(rig.group);
       detach = renderer.headlights.attach(rig.group);
+      if (rig.footprint) unblock = host.addBlocker?.(footprintBlocker(rig.group, rig.footprint));
+    }
+    let car = null;
+    let stopWaiting;
+    if (item && place) {
+      const tryPlace = () => {
+        if (car || !host.addObject) return;
+        const placed = host.addObject(item, { position: [place[0], 0, place[1]], rotationY: place[2] });
+        if (!placed) return;
+        car = placed;
+        stopWaiting?.();
+        stopWaiting = void 0;
+        const ahead = lengthOf(THREE, placed.root) / 2 - HEADLIGHTS.lamp[2] - 0.1;
+        rig.group.position.set(place[0] + Math.sin(place[2]) * ahead, 0, place[1] + Math.cos(place[2]) * ahead);
+      };
+      tryPlace();
+      if (!car) stopWaiting = host.onFrame(tryPlace);
     }
     return {
       update: (dt) => renderer.update(dt),
@@ -2416,6 +2475,9 @@ var GameWeatherThree = (() => {
       },
       dispose() {
         detach?.();
+        unblock?.();
+        stopWaiting?.();
+        car?.remove();
         if (rig) {
           scene.remove(rig.group);
           rig.dispose();