@adatechnology/game-test-room 0.22.0 → 0.23.0

package/dist/index.d.ts

@@ -406,6 +406,8 @@ interface RoomAvatarState {
     running: boolean;
     crouch: boolean;
     down: boolean;
+    /** Which way the body falls while `down`: true face down, false on its back; left out, the avatar picks. A blast falls it the way it pushed. */
+    fallForward?: boolean;
     /** A firearm is the tool in hand. */
     armed: boolean;
     /** Camera pitch, radians, positive looking up (the room's own convention). */

package/dist/index.global.js

@@ -23543,7 +23543,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
           this.startFire(ev);
           this.activate(ev.object, ev.part);
           this.sound("ignite", ev.point, 0.7);
-          this.sound("burn_loop", ev.point, 0.5);
+          this.sound("burn_loop", ev.point, 0.5, this.burning(ev.object, ev.part));
           break;
         case "primed":
           if (ev.trigger !== "explosion") {
@@ -23551,7 +23551,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
             this.primedBurning.add(`${ev.object}|${ev.part}`);
             this.activate(ev.object, ev.part);
             this.sound("primed", ev.point, 0.7, { seconds: ev.delay });
-            this.sound("burn_loop", ev.point, 0.5);
+            this.sound("burn_loop", ev.point, 0.5, { fuel: "gas" });
           }
           break;
         case "spall":
@@ -23577,15 +23577,15 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
             this.stopFire(`${ev.object}|${ev.part}`);
             this.vfx.burst("steam", f.point, [0, 1, 0], 14, 1.2);
           }
-          if (f || primed) this.sound("burn_end", f?.point ?? this.rootPoint(ev.object), 0.5);
+          if (f || primed) this.sound("burn_end", f?.point ?? this.rootPoint(ev.object), 0.5, primed ? { fuel: "gas" } : this.burning(ev.object, ev.part));
           this.activate(ev.object, ev.part);
           this.sound("extinguish", f?.point ?? this.rootPoint(ev.object), 0.6);
           break;
         }
         case "burnout": {
           this.stopFire(`${ev.object}|${ev.part}`);
-          this.primedBurning.delete(`${ev.object}|${ev.part}`);
-          this.sound("burn_end", ev.point, 0.5);
+          const primed = this.primedBurning.delete(`${ev.object}|${ev.part}`);
+          this.sound("burn_end", ev.point, 0.5, primed ? { fuel: "gas" } : this.burning(ev.object, ev.part));
           this.vfx.burst("ash", ev.point, [0, 1, 0], 16, 1);
           this.vfx.burst("smoke", ev.point, [0, 1, 0], 6, 0.8, { color: SMOKE_TONES.grey });
           const pv = this.partVis(ev.object, ev.part);
@@ -23653,7 +23653,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
           break;
         }
         case "explode":
-          this.primedBurning.delete(`${ev.object}|${ev.part}`);
+          if (this.primedBurning.delete(`${ev.object}|${ev.part}`)) this.sound("burn_end", ev.point, 0.5, { fuel: "gas" });
           this.onExplode(ev);
           break;
         case "destroyed":
@@ -23668,6 +23668,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       if (detail) this.o.onSound?.(key2, point, volume, detail);
       else this.o.onSound?.(key2, point, volume);
     }
+    /** What a burning part is made of, for the fire's sound. */
+    burning(objectId, partId) {
+      const material = this.partVis(objectId, partId)?.material || this.world.part(objectId, partId)?.material;
+      return material ? { material } : void 0;
+    }
     partVis(objectId, partId) {
       return this.bounds.get(objectId)?.parts.get(partId) ?? null;
     }
@@ -24536,6 +24541,47 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     volume: 0,
     sources: ["sdk: the roar under the crackles of a fire"]
   };
+  var FIRE_FUEL_OF = {
+    wood_soft: "wood",
+    wood_hard: "wood",
+    plywood: "wood",
+    mdf: "wood",
+    green_wood: "wood",
+    foliage: "wood",
+    cactus: "wood",
+    paper: "fabric",
+    fabric: "fabric",
+    leather: "fabric",
+    foam: "plastic",
+    plastic: "plastic",
+    rubber: "plastic",
+    wax: "plastic"
+  };
+  var FIRE_LOOP_OF = {
+    wood: "fire_loop",
+    fabric: "fire_loop",
+    plastic: "fire_loop_plastic",
+    gas: "fire_loop_gas",
+    liquid: "fire_loop_liquid"
+  };
+  var FIRE_CRACKLE_OF = { wood: 1, fabric: 0.5, plastic: 0.35, gas: 0, liquid: 0 };
+  var roar = (id, bank, source) => ({
+    id,
+    bus: "world",
+    order: "chain_loop",
+    source: { kind: "noise", loop: true },
+    filters: { mode: "serial", bank },
+    volume: 0,
+    sources: [source]
+  });
+  var FIRE_FUEL_LOOPS = [
+    // a gas jet: a steady, broad roar, brighter than wood and without crackles
+    roar("fire_loop_gas", [{ type: "highpass", frequency: { set: 220 }, q: 0.7 }, { type: "lowpass", frequency: { set: 2400 }, q: 0.6 }], "sdk: a gas jet burning (a vessel venting into the flame)"),
+    // a fuel pool: a soft, low, rolling roar
+    roar("fire_loop_liquid", [{ type: "highpass", frequency: { set: 90 }, q: 0.7 }, { type: "lowpass", frequency: { set: 650 }, q: 0.9 }], "sdk: a pool of fuel burning"),
+    // plastic and rubber: a thin sizzle over a low burn
+    roar("fire_loop_plastic", [{ type: "bandpass", frequency: { set: 1800 }, q: 0.6 }], "sdk: plastic and rubber melting in the fire")
+  ];
   var BLAST_SOUND_OF = {
     grenade: "explosion_grenade",
     big: "explosion_big",
@@ -24680,7 +24726,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     impact2("plastic_crack", [sceneNoise({ type: "bandpass", f: 1800, q: 2, d: 0.06, vol: 0.75 }), sceneTone({ f: [450, 550], f2: 250, d: 0.05, vol: 0.22 })]),
     impact2("mdf_crumble", [sceneNoise({ type: "lowpass", f: 700, d: 0.25, vol: 0.75, wet: 0.2 }), ...sceneMany(4, () => sceneNoise({ type: "lowpass", f: 500, d: 0.05, vol: 0.32, delay: [0.05, 0.3] }))])
   ];
-  var DESTRUCTION_SOUND_BANK = { id: "destruction_three", sounds: [...SCENE_SOUNDS, ...DRAG_SOUNDS, ...LEAF_SOUNDS, ...IMPACT_SOUNDS, EXPLOSION_BOOM, ...BLAST_SOUNDS, ...FIRE_SOUNDS], loops: [BURN_LOOP, FIRE_LOOP] };
+  var DESTRUCTION_SOUND_BANK = { id: "destruction_three", sounds: [...SCENE_SOUNDS, ...DRAG_SOUNDS, ...LEAF_SOUNDS, ...IMPACT_SOUNDS, EXPLOSION_BOOM, ...BLAST_SOUNDS, ...FIRE_SOUNDS], loops: [BURN_LOOP, FIRE_LOOP, ...FIRE_FUEL_LOOPS] };
   var IMPACT_SOUND_KEYS = {
     impact_metal_ballistic: { sound: "metal_bullet" },
     impact_metal_blunt: { sound: "metal_blunt" },
@@ -24829,31 +24875,52 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     const rules = { ...DESTRUCTION_SOUND_KEYS.art_scene, ...options.style === "game" ? DESTRUCTION_SOUND_KEYS.game : {}, ...options.keys };
     const blastByKind = options.style !== "game" && !(options.keys && "explode" in options.keys);
     const channel = engine.channel({ seed: options.seed ?? 1 });
-    let loop;
-    let burning = 0;
+    const fuelOf = { ...FIRE_FUEL_OF, ...options.fuels };
+    const loopOf = { ...FIRE_LOOP_OF, ...options.fireLoop ? { wood: fireLoop, fabric: fireLoop } : {}, ...options.fireLoops };
+    const defaultFuel = options.defaultFuel ?? "wood";
+    const loops = /* @__PURE__ */ new Map();
     const fires = [];
     let nextCrackle = 0;
+    const fuelFor = (detail) => detail?.fuel ?? (detail?.material !== void 0 ? fuelOf[detail.material] : void 0) ?? defaultFuel;
     const setFire = () => {
       if (options.burnLoop === false) return;
-      if (burning <= 0) {
-        loop?.stop();
-        loop = void 0;
-        return;
+      const count = /* @__PURE__ */ new Map();
+      for (const f of fires) {
+        const id = loopOf[f.fuel];
+        count.set(id, (count.get(id) ?? 0) + 1);
+      }
+      for (const [id, handle] of loops) {
+        if (count.has(id)) continue;
+        handle.stop();
+        loops.delete(id);
+      }
+      for (const [id, n] of count) {
+        let handle = loops.get(id);
+        if (!handle) {
+          handle = engine.loop(id);
+          loops.set(id, handle);
+        }
+        handle.set({ volume: Math.min(fire2.max, fire2.perFire * n) });
       }
-      loop ?? (loop = engine.loop(fireLoop));
-      loop.set({ volume: Math.min(fire2.max, fire2.perFire * burning) });
     };
-    const forget = (point) => {
+    const forget = (point, fuel) => {
       let best = -1;
       let bestD = Infinity;
       fires.forEach((f, i) => {
-        const d = (f[0] - point[0]) ** 2 + (f[1] - point[1]) ** 2 + (f[2] - point[2]) ** 2;
+        if (fuel !== void 0 && f.fuel !== fuel) return;
+        const d = (f.point[0] - point[0]) ** 2 + (f.point[1] - point[1]) ** 2 + (f.point[2] - point[2]) ** 2;
         if (d < bestD) {
           bestD = d;
           best = i;
         }
       });
-      if (best >= 0) fires.splice(best, 1);
+      if (best < 0 && fuel !== void 0) forget(point, void 0);
+      else if (best >= 0) fires.splice(best, 1);
+    };
+    const reset = () => {
+      for (const handle of loops.values()) handle.stop();
+      loops.clear();
+      fires.length = 0;
     };
     const blastSound = (point, volume, detail) => {
       const named = detail?.effect === void 0 ? void 0 : kinds[detail.effect];
@@ -24865,14 +24932,12 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     return {
       onSound(key2, point, volume, detail) {
         if (key2 === "burn_loop") {
-          burning += 1;
-          fires.push(point);
+          fires.push({ point, fuel: fuelFor(detail) });
           setFire();
           return;
         }
         if (key2 === "burn_end") {
-          if (burning > 0) burning -= 1;
-          forget(point);
+          forget(point, detail?.fuel ?? (detail?.material !== void 0 ? fuelOf[detail.material] : void 0));
           setFire();
           return;
         }
@@ -24902,12 +24967,15 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       },
       update(dt) {
         if (!crackles || fires.length === 0 || options.burnLoop === false) return;
+        const weight = fires.reduce((sum2, f) => sum2 + FIRE_CRACKLE_OF[f.fuel], 0);
+        if (weight <= 0) return;
         nextCrackle -= dt;
         for (let i = 0; i < 4 && nextCrackle <= 0; i++) {
-          const rate = Math.min(crackles.max, crackles.base + crackles.perSqrtFire * Math.sqrt(fires.length));
+          const rate = Math.min(crackles.max, crackles.base * Math.min(1, weight) + crackles.perSqrtFire * Math.sqrt(weight));
           nextCrackle += (0.4 + channel.random() * 1.2) / rate;
-          const at3 = fires[Math.floor(channel.random() * fires.length)];
-          engine.play(channel.random() < 0.18 ? "fire_pop" : "fire_crackle", { position: at3, volume: crackles.volume });
+          let pick3 = channel.random() * weight;
+          const at3 = fires.find((f) => (pick3 -= FIRE_CRACKLE_OF[f.fuel]) <= 0) ?? fires[fires.length - 1];
+          engine.play(channel.random() < 0.18 ? "fire_pop" : "fire_crackle", { position: at3.point, volume: crackles.volume });
         }
         if (nextCrackle < 0) nextCrackle = 0;
       },
@@ -24916,13 +24984,14 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         for (const k of detail?.keys ?? []) if (k in rules) return rules[k] ?? void 0;
         return rules[key2] ?? void 0;
       },
-      burning: () => burning,
-      dispose() {
-        loop?.stop();
-        loop = void 0;
-        burning = 0;
-        fires.length = 0;
-      }
+      burning: () => fires.length,
+      burningBy: () => {
+        const by = {};
+        for (const f of fires) by[f.fuel] = (by[f.fuel] ?? 0) + 1;
+        return by;
+      },
+      reset,
+      dispose: reset
     };
   }
   var blast2 = (gain) => ({ bus: "world", gain, falloff: BLAST_FALLOFF, cutoffK: 6e-3, priority: 3 });
@@ -24941,7 +25010,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     fire_extinguish: fire(0.7),
     gas_leak: fire(0.5),
     // the roar: recorded fires chained with a crossfade (the level comes from `createDestructionSound`, by how much burns)
-    fire_loop: { bus: "world", gain: 4, loop: { crossfade: 1 } }
+    fire_loop: { bus: "world", gain: 4, loop: { crossfade: 1 } },
+    // each fuel has its own roar: a gas jet (burners and torches), a pool of fuel, plastic and rubber sizzling under the flames
+    fire_loop_gas: { bus: "world", gain: 6, loop: { crossfade: 1 } },
+    fire_loop_liquid: { bus: "world", gain: 3.5, loop: { crossfade: 1 } },
+    fire_loop_plastic: { bus: "world", gain: 1, loop: { crossfade: 0.6 } }
   };
 
   // src/body-sounds.ts
@@ -47790,6 +47863,7 @@ void main(){
   var LYING_EYE = 0.3;
   var LYING_PITCH = 1.05;
   var LYING_ROLL = 0.35;
+  var LYING_PITCH_FACE_DOWN = -1.05;
   function createPlayer(THREE, o) {
     const cam = o.camera;
     let yaw = 0;
@@ -47828,11 +47902,12 @@ void main(){
       floorLevel += Math.max(-reach, Math.min(reach, gap));
     };
     let knocked = null;
+    let knockedForward = false;
     let rollSide = 1;
     const apply = () => {
       const lying = knocked?.lying ?? 0;
       const fallen = lying * lying * (3 - 2 * lying);
-      euler.set(pitch + (LYING_PITCH - pitch) * fallen, yaw, LYING_ROLL * rollSide * fallen, "YXZ");
+      euler.set(pitch + ((knockedForward ? LYING_PITCH_FACE_DOWN : LYING_PITCH) - pitch) * fallen, yaw, LYING_ROLL * rollSide * fallen, "YXZ");
       cam.quaternion.setFromEuler(euler);
       const standing = eye - CROUCH_DROP * crouch - bend;
       cam.position.set(px.x, floorLevel + y + standing + (LYING_EYE - standing) * fallen, px.z);
@@ -48110,6 +48185,7 @@ void main(){
         if (next.down) {
           const right = Math.cos(yaw) * next.velocity[0] - Math.sin(yaw) * next.velocity[2];
           rollSide = right >= 0 ? -1 : 1;
+          knockedForward = -Math.sin(yaw) * next.velocity[0] - Math.cos(yaw) * next.velocity[2] > 0;
           crouchLatched = false;
         }
         if (knocked.airborne) vy2 = Math.max(vy2, knocked.velocity[1]);
@@ -48117,6 +48193,9 @@ void main(){
       get knocked() {
         return knocked;
       },
+      get knockedForward() {
+        return knockedForward;
+      },
       update(dt) {
         if (knocked) {
           stepKnocked(dt);
@@ -53946,6 +54025,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
       explosives.clear();
       fireZones.length = 0;
       burningStains.length = 0;
+      destructionSound?.reset();
       terrain.setLayout(defaultGround);
       for (const id of [...entries2.keys()]) if (!entries2.get(id)?.arena) removeEntry(id);
       clearLoose();
@@ -54113,6 +54193,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
       avatarState.running = !player.crouching && (player.keys.has("ShiftLeft") || player.keys.has("ShiftRight"));
       avatarState.crouch = crouchForced || player.crouching || push.isBent;
       avatarState.down = downForced || Boolean(player.knocked?.down || (player.knocked?.lying ?? 0) > 0.5);
+      avatarState.fallForward = downForced ? void 0 : player.knockedForward;
       avatarState.armed = armedForced ?? tool.def.action.kind === "firearm";
       avatarState.pitch = player.pitch;
       avatarState.holding = heldPiece !== null;
@@ -54312,6 +54393,15 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     };
     const fireZones = [];
     const burningStains = [];
+    const poolFire = (point, burning) => playSound(burning ? "burn_loop" : "burn_end", point, 0.5, { fuel: "liquid" });
+    const dropZone = (i) => {
+      const [zone] = fireZones.splice(i, 1);
+      if (zone) poolFire(zone.point, false);
+    };
+    const dropStain = (i) => {
+      const [stain] = burningStains.splice(i, 1);
+      if (stain) poolFire(stain.center, false);
+    };
     const stainRadius = (s) => {
       let sum2 = 0;
       for (const r of s.front) sum2 += r;
@@ -54328,6 +54418,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
           if (stainBurning(s)) continue;
           const seconds = Math.max(3, Math.min(20, 4 + s.liters * 30 + stainRadius(s) * 6));
           burningStains.push({ center: [s.center[0], s.center[1], s.center[2]], remaining: seconds, acc: 0 });
+          poolFire([s.center[0], s.center[1], s.center[2]], true);
           lit = true;
           log.add({
             channel: "event",
@@ -54358,7 +54449,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
         const a = rnd2() * Math.PI * 2;
         const r = Math.sqrt(rnd2()) * z.radius;
         renderer.emit("fire", [z.point[0] + Math.cos(a) * r, z.point[1] + 0.05, z.point[2] + Math.sin(a) * r], [0, 1, 0], 2, 1.5);
-        if (z.remaining <= 0) fireZones.splice(i, 1);
+        if (z.remaining <= 0) dropZone(i);
       }
       if (burningStains.length) {
         const stains = fluids.stains();
@@ -54379,7 +54470,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
           if (b.remaining <= 0 || !st) {
             fluids.clearStains(b.center, r + 0.1);
             log.add({ channel: "event", type: "stain_burned", text: t("ev.stain_burned"), data: { point: b.center } });
-            burningStains.splice(i, 1);
+            dropStain(i);
           }
         }
       }
@@ -54716,8 +54807,8 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
           hit.add(r.object);
           world.extinguish(r.object, void 0, u.coolC * Math.max(u.duration, 0.05) * 6);
           fluids.clearStains(r.point, 0.5);
-          for (let i = burningStains.length - 1; i >= 0; i--) if (Math.hypot(burningStains[i].center[0] - r.point[0], burningStains[i].center[2] - r.point[2]) < 1.2) burningStains.splice(i, 1);
-          for (let i = fireZones.length - 1; i >= 0; i--) if (Math.hypot(fireZones[i].point[0] - r.point[0], fireZones[i].point[2] - r.point[2]) < 1.5) fireZones.splice(i, 1);
+          for (let i = burningStains.length - 1; i >= 0; i--) if (Math.hypot(burningStains[i].center[0] - r.point[0], burningStains[i].center[2] - r.point[2]) < 1.2) dropStain(i);
+          for (let i = fireZones.length - 1; i >= 0; i--) if (Math.hypot(fireZones[i].point[0] - r.point[0], fireZones[i].point[2] - r.point[2]) < 1.5) dropZone(i);
         }
       });
       log.coalesce(
@@ -54728,7 +54819,9 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     };
     const startFire = (weapon, at3, fire3, impact3) => {
       fluids.splash("fuel", [at3[0], Math.max(at3[1], groundAt(at3[0], at3[2])), at3[2]], 0.5);
-      fireZones.push({ point: [at3[0], Math.max(0.02, groundAt(at3[0], at3[2])), at3[2]], radius: fire3.radius, temperature: fire3.temperature, remaining: fire3.seconds, acc: 0 });
+      const zone = { point: [at3[0], Math.max(0.02, groundAt(at3[0], at3[2])), at3[2]], radius: fire3.radius, temperature: fire3.temperature, remaining: fire3.seconds, acc: 0 };
+      fireZones.push(zone);
+      poolFire(zone.point, true);
       renderer.emit("fire", at3, [0, 1, 0], 24, 3);
       action("molotov_fire", t("act.molotov_fire", { weapon: toolName(weapon), seconds: num(fire3.seconds, 0), radius: num(fire3.radius, 1) }), { data: { weapon, impact: impact3 } });
     };
@@ -55866,6 +55959,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
       loading,
       addView: (view) => moduleViews.add(view),
       setViewCamera: (view) => moduleViews.setMain(view ?? null),
+      holdPlayer: (held) => player.setWalkHeld(held),
       ...options.blastShove ? { blastShove: options.blastShove } : {},
       blastReach: (point, target, ignore) => world.blastReach(point, target, ignore ? { ignore } : {}),
       tool: () => ({