@adatechnology/game-destruction-three 0.14.0 → 0.15.1

package/README.md

@@ -104,7 +104,7 @@ loose meshes. An invalid range (outside the geometry or empty) throws from `bind
 |---|---|---|
 | `dent` | vertices within `dent.radius` pushed in by `depth * (1 - (d/r)^2)^2` (skipped on `low` for meshes over 20k vertices); sparks on metal | `impact_*` |
 | `hole` | dark disc decal on the surface (and on the exit side of a through hole); a crack star on transparent materials; sparks on metal | `impact_*` |
-| `crack` | star of jagged lines, white on glass, dark otherwise | `impact_*` |
+| `crack` | star of jagged white lines on glass (transparent materials) only; an opaque body draws no lines, its damage shows as chips, holes and dents | `impact_*` |
 | `ricochet` | sparks along the reflected direction | `ricochet` |
 | `debris` | a burst of the requested kind (`sparks`, `dust`, `shards`, `splinters`, `chips`, `fibers`, `leaves`, `drips`, `ash`, `smoke`, `steam`) | |
 | `fracture` | part hidden; fragments (boxes, thin irregular prisms for shards) with gravity, ground bounce, settling, sleep and shrink-away; debris burst by style | `shatter_glass`, `crumble`, `splinter`, `impact_*` |

package/dist/index.d.ts

@@ -32,6 +32,10 @@ interface SoundDetail {
     readonly confinement?: number;
     /** `primed`: seconds until the vessel bursts (the gas leak lasts that long). */
     readonly seconds?: number;
+    /** `burn_loop` / `burn_end`: the material burning (`wood_hard`, `rubber`...), which picks the fire's sound. */
+    readonly material?: string;
+    /** `burn_loop` / `burn_end`: the fuel itself, when it is not a material (a gas jet, a pool of fuel). Wins over `material`. */
+    readonly fuel?: 'wood' | 'fabric' | 'plastic' | 'gas' | 'liquid';
 }
 interface RendererOptions {
     /** Scene that receives fragments, loose pieces, decals and particles. */
@@ -352,6 +356,12 @@ declare const BLAST_SOUNDS: readonly SoundRecipe[];
 declare const FIRE_SOUNDS: readonly SoundRecipe[];
 /** The roar of the fires: low, soft noise; `createDestructionSound` raises it with every part that burns and sprinkles crackles on it. */
 declare const FIRE_LOOP: LoopRecipe;
+/**
+ * What is burning, for the sound: each fuel has its own roar (a gas jet, a fuel pool, wood, plastic) and its own share of crackles. The rules are the
+ * same for all (the level grows with how much burns, fades with distance, never clips); only the timbre comes from the fuel.
+ */
+declare const FIRE_FUELS: readonly ["wood", "fabric", "plastic", "gas", "liquid"];
+type FireFuel = (typeof FIRE_FUELS)[number];
 /** The sound of a blast family. */
 declare const BLAST_SOUND_OF: Readonly<Record<BlastKind, string>>;
 
@@ -394,8 +404,14 @@ type DestructionSoundOptions = {
     };
     /** Burn loop on or off (default on). */
     readonly burnLoop?: boolean;
-    /** The fire loop played while something burns (default `fire_loop`; `burn_loop` is the art scene's bright one). */
+    /** The loop of the wood fire (default `fire_loop`; `burn_loop` is the art scene's bright one). */
     readonly fireLoop?: string;
+    /** Adds to or changes `FIRE_FUEL_OF`: which fuel a burning material sounds like. */
+    readonly fuels?: Readonly<Record<string, FireFuel>>;
+    /** Adds to or changes `FIRE_LOOP_OF`: the loop of each fuel. */
+    readonly fireLoops?: Partial<Readonly<Record<FireFuel, string>>>;
+    /** The fuel of a fire whose material is not in the table (default `wood`). */
+    readonly defaultFuel?: FireFuel;
     /** Crackles per second over the fire loop: `base + perSqrtFire × √(parts burning)`, at most `max` (default 2, 3, 14). `false` turns them off. */
     readonly crackles?: false | {
         readonly base?: number;
@@ -423,6 +439,10 @@ type DestructionSound = {
     rule(key: string, detail?: SoundDetail): SoundKeyRule | undefined;
     /** Parts burning now. */
     readonly burning: () => number;
+    /** Parts burning now, by fuel. */
+    readonly burningBy: () => Readonly<Partial<Record<FireFuel, number>>>;
+    /** Puts every fire sound out (the scene was cleared); the engine and the bank stay. */
+    reset(): void;
     dispose(): void;
 };
 declare const DEFAULT_FIRE: {

package/dist/index.global.js

@@ -13021,7 +13021,6 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
   var rendererCount = 0;
   var COLLAPSE_CLOUD_KG = 1e3;
   var CHIP_DECAL_EDGE = 0.05;
-  var OPAQUE_CRACK = 0.1;
   var WOOD_RIM = 1.5;
   var IMPACT_TAGS = ["metal", "glass", "wood"];
   var GLOW_FROM_C = 430;
@@ -13728,7 +13727,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") {
@@ -13736,7 +13735,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":
@@ -13762,15 +13761,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);
@@ -13838,7 +13837,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":
@@ -13853,6 +13852,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       if (detail) this.o.onSound?.(key, point, volume, detail);
       else this.o.onSound?.(key, 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;
     }
@@ -13952,14 +13956,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       const pv = b?.parts.get(ev.part);
       if (!b || !pv) return;
       const def = this.world.materials.get(pv.material);
-      const wp = new this.THREE.Vector3(ev.worldPoint[0], ev.worldPoint[1], ev.worldPoint[2]);
-      const mv = this.nearestMesh(pv, wp);
-      if (mv) {
-        const glass2 = !!def?.visual?.transparent;
-        const own = this.partColor(pv, def) ?? fallbackColor(pv.material, def);
-        const color = glass2 ? 15267071 : new this.THREE.Color(own).multiplyScalar(0.45).getHex();
-        const length = glass2 ? ev.crack.length : Math.min(ev.crack.length, OPAQUE_CRACK);
-        this.visuals.addCrack(mv, wp, this.worldDir(b, ev.crack.normal), ev.crack.rays, length, color, hashNumbers(ev.time, ev.worldPoint[0], ev.worldPoint[1], ev.worldPoint[2]));
+      if (def?.visual?.transparent) {
+        const wp = new this.THREE.Vector3(ev.worldPoint[0], ev.worldPoint[1], ev.worldPoint[2]);
+        const mv = this.nearestMesh(pv, wp);
+        const seed = hashNumbers(ev.time, ev.worldPoint[0], ev.worldPoint[1], ev.worldPoint[2]);
+        if (mv) this.visuals.addCrack(mv, wp, this.worldDir(b, ev.crack.normal), ev.crack.rays, ev.crack.length, 15267071, seed);
       }
       this.impactSound(pv.material, ev.worldPoint, 0.5, ev.blow);
     }
@@ -14539,7 +14540,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     }
   };
 
-  // ../game-audio/dist/chunk-7TLFY7VO.js
+  // ../game-audio/dist/chunk-KBTUANNG.js
   var DISTANCE_CURVES = {
     /** The game's `sfx`: `vol / (1 + d² × 0.004)`, cutoff `/ (1 + d × 0.01)`, silent below 0.01 (jogo L62091–62092, L62101). */
     game_sfx: { model: "inverse_square", k: 4e-3, cutoffK: 0.01, minGain: 0.01 },
@@ -14752,7 +14753,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       ["casing_drop_terra_pistol", 1],
       ["casing_drop_terra_rifle", 1],
       ["casing_drop_terra_shell", 1],
-      ["rocket_fire", 2]
+      ["rocket_fire", 2],
+      ["smg_45_auto", 2, "sfx_pistol"],
+      ["weapon_draw", 2],
+      ["suppressor_attach", 3],
+      ["suppressor_detach", 3]
     ]),
     ...entries("explosoes-fogo", [
       ["explosion_grenade", 1, "boom"],
@@ -14766,7 +14771,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       ["fire_loop_large", 1],
       ["fire_extinguish", 2, "hiss"],
       ["gas_leak_hiss", 2],
-      ["structure_collapse", 2, "crumble"]
+      ["structure_collapse", 2, "crumble"],
+      ["grenade_bounce", 1],
+      ["c4_plant", 2],
+      ["c4_beep", 2],
+      ["c4_disarm", 2]
     ]),
     ...entries("personagem", [
       ["footstep_concrete_walk", 1, "sfx_step"],
@@ -14782,7 +14791,19 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       ["blunt_hit", 1],
       ["bite", 1, "sfx_flesh"],
       ["body_fall", 1],
-      ["player_hurt", 2]
+      ["player_hurt", 2],
+      ["footstep_tile_walk", 1, "sfx_step"],
+      ["footstep_water_walk", 1, "sfx_step"],
+      ["footstep_grate_walk", 2, "sfx_step"],
+      ["footstep_duct_walk", 3, "sfx_step"],
+      ["ladder_climb", 2],
+      ["swim", 2],
+      ["zombie_groan", 1],
+      ["zombie_alert", 1],
+      ["zombie_attack", 1],
+      ["zombie_pain", 1],
+      ["zombie_claw_hit", 1, "sfx_flesh"],
+      ["zombie_claw_miss", 2]
     ]),
     ...entries("veiculos", [
       ["engine_loop_car", 1],
@@ -14810,7 +14831,8 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       ["wind_loop", 2],
       ["thunder_near", 2],
       ["thunder_far", 2],
-      ["water_splash", 2]
+      ["water_splash", 2],
+      ["helicopter_loop", 3]
     ])
   ];
   var SFX_MATERIALS = [
@@ -14892,6 +14914,60 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     burst: 20,
     burstSpacing: 0.06
   };
+  var SFX_TIERS = { light: 0, medium: 0.34, heavy: 0.67 };
+  function splitTier(id) {
+    const match = /^(.*)_(light|medium|heavy)$/.exec(id);
+    return match ? { base: match[1], tier: match[2] } : { base: id };
+  }
+  var refsOf = (entries2, baseUrl) => (entries2 ?? []).map((entry) => ({ url: `${baseUrl}${entry.file}` }));
+  function sampleBankFromManifest(manifest, options) {
+    const baseUrl = options.baseUrl ?? "";
+    const samples = [];
+    const tiersOf = /* @__PURE__ */ new Map();
+    for (const sound of manifest.sounds) {
+      const { base, tier } = splitTier(sound.id);
+      if (tier) tiersOf.set(base, [...tiersOf.get(base) ?? [], sound]);
+    }
+    const bases = /* @__PURE__ */ new Map();
+    for (const sound of manifest.sounds) {
+      if (!splitTier(sound.id).tier) bases.set(sound.id, sound);
+    }
+    for (const [base, tiers] of tiersOf) {
+      if (!bases.has(base)) bases.set(base, { id: base, category: tiers[0]?.category ?? "", layers: { close: tiers[0]?.layers.close ?? [] } });
+    }
+    for (const sound of bases.values()) {
+      const numbers = options.sounds?.[sound.id] ?? options.defaults?.(sound);
+      const close = refsOf(sound.layers.close, baseUrl);
+      if (!numbers || close.length === 0) continue;
+      const tiers = (tiersOf.get(sound.id) ?? []).map((tier) => {
+        const name = splitTier(tier.id).tier;
+        const tierFar = refsOf(tier.layers.far, baseUrl);
+        return { name, from: SFX_TIERS[name] ?? 0, close: refsOf(tier.layers.close, baseUrl), ...tierFar.length > 0 ? { far: tierFar } : {} };
+      }).sort((a, b) => a.from - b.from);
+      const far = refsOf(sound.layers.far, baseUrl);
+      const indoor = refsOf(sound.layers.tail_in, baseUrl);
+      const outdoor = refsOf(sound.layers.tail_out, baseUrl);
+      const files = [sound, ...tiersOf.get(sound.id) ?? []].flatMap((entry) => Object.values(entry.layers).flatMap((entries2) => entries2 ?? []));
+      samples.push({
+        id: sound.id,
+        bus: numbers.bus,
+        close,
+        ...far.length > 0 ? { far } : {},
+        ...tiers.length > 0 ? { tiers } : {},
+        ...numbers.crossover ? { crossover: numbers.crossover } : {},
+        ...indoor.length > 0 || outdoor.length > 0 ? { tail: { ...indoor.length > 0 ? { indoor } : {}, ...outdoor.length > 0 ? { outdoor } : {}, ...numbers.tailGain === void 0 ? {} : { gain: numbers.tailGain } } } : {},
+        ...numbers.pitch === void 0 ? {} : { pitch: numbers.pitch },
+        ...numbers.gain === void 0 ? {} : { gain: numbers.gain },
+        ...numbers.falloff ? { falloff: numbers.falloff } : {},
+        ...numbers.cutoffK === void 0 ? {} : { cutoffK: numbers.cutoffK },
+        ...numbers.group ? { group: numbers.group } : {},
+        ...numbers.priority === void 0 ? {} : { priority: numbers.priority },
+        ...numbers.fallback ? { fallback: numbers.fallback } : {},
+        sources: files.map((file) => `${file.file}: ${file.source} ${file.author} ${file.license}`)
+      });
+    }
+    return { id: options.id, samples };
+  }
   var PT = {
     group: "Som",
     name: "Painel de som (arquivos e C1\u2013C10)",
@@ -14899,6 +14975,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       category: "1 \xB7 Categoria",
       sound: "1 \xB7 Som",
       play: "1 \xB7 \u25B6 Tocar",
+      play_user: "1 \xB7 \u25B6 Tocar o seu",
       material: "2 \xB7 Material",
       blow: "2 \xB7 Golpe",
       strike: "2 \xB7 \u25B6 Tocar golpe",
@@ -14920,6 +14997,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       approve: "5 \xB7 Aprovo (C10)"
     },
     hints: {
+      play_user: "Toca a sua grava\xE7\xE3o deste som (dos seus pacotes, fora do git), mesmo quando o SDK tem uma melhor e toca na frente.",
       sound: "A = arquivo, S = sintetizado, F = faltando. O que tem arquivo toca o arquivo; o resto toca o som atual.",
       strike: "Toca impact_<material>_<golpe>: o arquivo se existir, sen\xE3o o som atual daquele material.",
       wall: "P\xF5e a parede de casa entre voc\xEA e a fonte: o som fica abafado (C4).",
@@ -14964,9 +15042,10 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     strengths: { light: "leve", medium: "m\xE9dio", heavy: "forte" },
     states: { file: "A", synth: "S", missing: "F" },
     criteria: { C1: "C1 Sincronia", C2: "C2 Certo p/ a\xE7\xE3o", C3: "C3 Dist\xE2ncia", C4: "C4 Posi\xE7\xE3o", C5: "C5 Varia\xE7\xE3o", C6: "C6 Volume", C7: "C7 Intensidade", C8: "C8 Cauda", C9: "C9 Rajada", C10: "C10 Escuta" },
-    metrics: { chosen: "1 \xB7 Escolhido", matrix: "2 \xB7 Matriz", last: "\xDAltimo tocado", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Prefer\xEAncias", state: "5 \xB7 Medi\xE7\xE3o", count: "1 \xB7 Cat\xE1logo" },
+    metrics: { source: "1 \xB7 Fonte do que tocou", chosen: "1 \xB7 Escolhido", matrix: "2 \xB7 Matriz", last: "\xDAltimo tocado", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Prefer\xEAncias", state: "5 \xB7 Medi\xE7\xE3o", count: "1 \xB7 Cat\xE1logo" },
     run: { idle: "parada", measuring: "medindo\u2026", done: "pronta", failed: "falhou", recording: "gravando\u2026", recorded: "grava\xE7\xE3o baixada" },
     words: { none: "\u2014", hidden: "? (revele)", prefers: "prefere", approved: "aprovado pelo dono" },
+    sources: { sdk: "SDK", user: "seu som", synth: "sintetizado" },
     probe: "Fonte do som",
     wall: "Parede (oclus\xE3o)",
     scenarios: { pipeline: "Arquivo \u2192 decodifica \u2192 toca (round-robin, cauda)", criteria: "Crit\xE9rios C1\u2013C9 no som de calibra\xE7\xE3o", loop: "Loop de arquivo: emenda sem buraco (crossfade)", panel: "Painel: categorias, matriz, A/B e parede" }
@@ -14979,6 +15058,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       category: "1 \xB7 Category",
       sound: "1 \xB7 Sound",
       play: "1 \xB7 \u25B6 Play",
+      play_user: "1 \xB7 \u25B6 Play yours",
       material: "2 \xB7 Material",
       blow: "2 \xB7 Blow",
       strike: "2 \xB7 \u25B6 Play blow",
@@ -15000,6 +15080,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       approve: "5 \xB7 Approve (C10)"
     },
     hints: {
+      play_user: "Plays your own take of this sound (from your packs, kept out of git), even where the SDK has a better one that plays first.",
       sound: "A = file, S = synthesized, F = missing. A file plays the file; the rest plays the current sound.",
       strike: "Plays impact_<material>_<blow>: the file if there is one, else the current sound of that material.",
       wall: "Puts the house wall between you and the source: the sound is muffled (C4).",
@@ -15034,69 +15115,16 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     environments: { indoor: "indoor", outdoor: "outdoor" },
     strengths: { light: "light", medium: "medium", heavy: "heavy" },
     criteria: { C1: "C1 Sync", C2: "C2 Right sound", C3: "C3 Distance", C4: "C4 Position", C5: "C5 Variation", C6: "C6 Level", C7: "C7 Strength", C8: "C8 Tail", C9: "C9 Burst", C10: "C10 Listening" },
-    metrics: { chosen: "1 \xB7 Chosen", matrix: "2 \xB7 Matrix", last: "Last played", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Preferences", state: "5 \xB7 Measurement", count: "1 \xB7 Catalogue" },
+    metrics: { source: "1 \xB7 Source of what played", chosen: "1 \xB7 Chosen", matrix: "2 \xB7 Matrix", last: "Last played", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Preferences", state: "5 \xB7 Measurement", count: "1 \xB7 Catalogue" },
     run: { idle: "idle", measuring: "measuring\u2026", done: "done", failed: "failed", recording: "recording\u2026", recorded: "recording downloaded" },
     words: { none: "\u2014", hidden: "? (reveal)", prefers: "prefers", approved: "approved by the owner" },
+    sources: { sdk: "SDK", user: "your sound", synth: "synthesized" },
     probe: "Sound source",
     wall: "Wall (occlusion)",
     scenarios: { pipeline: "File \u2192 decode \u2192 play (round-robin, tail)", criteria: "Criteria C1\u2013C9 on the calibration sound", loop: "File loop: seamless joins (crossfade)", panel: "Panel: categories, matrix, A/B and wall" }
   };
 
   // ../game-audio/dist/index.js
-  var SFX_TIERS = { light: 0, medium: 0.34, heavy: 0.67 };
-  function splitTier(id) {
-    const match = /^(.*)_(light|medium|heavy)$/.exec(id);
-    return match ? { base: match[1], tier: match[2] } : { base: id };
-  }
-  var refsOf = (entries2, baseUrl) => (entries2 ?? []).map((entry) => ({ url: `${baseUrl}${entry.file}` }));
-  function sampleBankFromManifest(manifest, options) {
-    const baseUrl = options.baseUrl ?? "";
-    const samples = [];
-    const tiersOf = /* @__PURE__ */ new Map();
-    for (const sound of manifest.sounds) {
-      const { base, tier } = splitTier(sound.id);
-      if (tier) tiersOf.set(base, [...tiersOf.get(base) ?? [], sound]);
-    }
-    const bases = /* @__PURE__ */ new Map();
-    for (const sound of manifest.sounds) {
-      if (!splitTier(sound.id).tier) bases.set(sound.id, sound);
-    }
-    for (const [base, tiers] of tiersOf) {
-      if (!bases.has(base)) bases.set(base, { id: base, category: tiers[0]?.category ?? "", layers: { close: tiers[0]?.layers.close ?? [] } });
-    }
-    for (const sound of bases.values()) {
-      const numbers = options.sounds?.[sound.id] ?? options.defaults?.(sound);
-      const close = refsOf(sound.layers.close, baseUrl);
-      if (!numbers || close.length === 0) continue;
-      const tiers = (tiersOf.get(sound.id) ?? []).map((tier) => {
-        const name = splitTier(tier.id).tier;
-        const tierFar = refsOf(tier.layers.far, baseUrl);
-        return { name, from: SFX_TIERS[name] ?? 0, close: refsOf(tier.layers.close, baseUrl), ...tierFar.length > 0 ? { far: tierFar } : {} };
-      }).sort((a, b) => a.from - b.from);
-      const far = refsOf(sound.layers.far, baseUrl);
-      const indoor = refsOf(sound.layers.tail_in, baseUrl);
-      const outdoor = refsOf(sound.layers.tail_out, baseUrl);
-      const files = [sound, ...tiersOf.get(sound.id) ?? []].flatMap((entry) => Object.values(entry.layers).flatMap((entries2) => entries2 ?? []));
-      samples.push({
-        id: sound.id,
-        bus: numbers.bus,
-        close,
-        ...far.length > 0 ? { far } : {},
-        ...tiers.length > 0 ? { tiers } : {},
-        ...numbers.crossover ? { crossover: numbers.crossover } : {},
-        ...indoor.length > 0 || outdoor.length > 0 ? { tail: { ...indoor.length > 0 ? { indoor } : {}, ...outdoor.length > 0 ? { outdoor } : {}, ...numbers.tailGain === void 0 ? {} : { gain: numbers.tailGain } } } : {},
-        ...numbers.pitch === void 0 ? {} : { pitch: numbers.pitch },
-        ...numbers.gain === void 0 ? {} : { gain: numbers.gain },
-        ...numbers.falloff ? { falloff: numbers.falloff } : {},
-        ...numbers.cutoffK === void 0 ? {} : { cutoffK: numbers.cutoffK },
-        ...numbers.group ? { group: numbers.group } : {},
-        ...numbers.priority === void 0 ? {} : { priority: numbers.priority },
-        ...numbers.fallback ? { fallback: numbers.fallback } : {},
-        sources: files.map((file) => `${file.file}: ${file.source} ${file.author} ${file.license}`)
-      });
-    }
-    return { id: options.id, samples };
-  }
   var ATTACK = 2e-3;
   function lengthOf(d, attack) {
     if (typeof d === "number") return attack + d;
@@ -16087,6 +16115,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",
@@ -16233,7 +16302,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] };
 
   // src/audio/sound.ts
   var IMPACT_SOUND_KEYS = {
@@ -16384,31 +16453,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];
@@ -16420,14 +16510,12 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     return {
       onSound(key, point, volume, detail) {
         if (key === "burn_loop") {
-          burning += 1;
-          fires.push(point);
+          fires.push({ point, fuel: fuelFor(detail) });
           setFire();
           return;
         }
         if (key === "burn_end") {
-          if (burning > 0) burning -= 1;
-          forget(point);
+          forget(point, detail?.fuel ?? (detail?.material !== void 0 ? fuelOf[detail.material] : void 0));
           setFire();
           return;
         }
@@ -16457,12 +16545,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((sum, f) => sum + 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;
       },
@@ -16471,13 +16562,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[key] ?? 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
     };
   }
 
@@ -16498,7 +16590,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 } }
   };
   function blastFireSampleBank(manifest, options = {}) {
     const sounds = options.sounds ?? BLAST_FIRE_SAMPLES;