@adatechnology/game-vfx-three 0.2.1 → 0.3.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as THREE_NS from 'three';
-import { EffectSink, TestableModule } from '@adatechnology/game-contracts';
+import { EffectSink, WarmUpProbes, TestableModule } from '@adatechnology/game-contracts';
 import { VfxWorld, ScreenState, VfxOptions, VfxProfileName, EffectDef, ExplosionDef, GroundField, SpriteKindSystem, MarkEvent } from '@adatechnology/game-vfx';
 
 /** The only three.js members the renderer needs at runtime. Pass your own `THREE` instance (the whole namespace works). */
@@ -56,6 +56,8 @@ interface VfxRenderer extends EffectSink {
     readonly world: VfxWorld;
     /** Steps the world, then redraws everything from it. Call once per frame (a shared world is stepped here, nowhere else). */
     update(dt: number): void;
+    /** Meshes that use the materials of the solid particles, to render once so that the first effect does not build their shader programs in the middle of a frame. */
+    warmUpProbes(): WarmUpProbes;
     /** Shakes the camera for the render that follows (the Lab's L1092) and answers the function that puts it back. */
     applyCamera(): () => void;
     stats(): VfxRendererStats;

package/dist/index.global.js

@@ -44,6 +44,15 @@ var GameVfxThree = (() => {
     createVfxTestModule: () => createVfxTestModule
   });
 
+  // ../game-contracts/dist/index.js
+  var KIT_ORIGIN_KEY = "kitOrigin";
+  function markKitOrigin(object, origin) {
+    const node = object;
+    node.userData = node.userData ?? {};
+    node.userData[KIT_ORIGIN_KEY] = { ...origin };
+    return object;
+  }
+
   // ../game-vfx/dist/index.js
   var __defProp2 = Object.defineProperty;
   var __defNormalProp = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -3098,6 +3107,17 @@ var GameVfxThree = (() => {
       ])
     ]
   };
+  var FUEL_LEAK_ONLY = {
+    id: "fuel_leak_only",
+    pageId: "vazamento",
+    team: "vehicles",
+    budget: { particles: 200, lights: 0 },
+    loop: 11,
+    view: FUEL_LEAK.view,
+    setup: FUEL_LEAK.setup,
+    timeline: [decal(POOL[0], 0, POOL[2], 2.2, 2040368, { grow: 3, life: 60, ar: 0.6, fluid: "oil" })],
+    tick: [emit("drip", "normal", 12, { p: TANK, box: [0.05, 0, 0.05], sp: 0, life: 1, size: 0.03, c0: 5921402, a: 0.9, g: 9.8, fi: 0, gnd: 1 })]
+  };
   var CAR_EXPLOSION = {
     id: "car_explosion",
     pageId: "explosao",
@@ -3451,6 +3471,8 @@ var GameVfxThree = (() => {
   ];
   var PI = Math.PI;
   var SMOKE = { color: 9079430, width: 10, height: 8, gravity: -0.08, drag: 2.2, growth: 2.1 };
+  var DEFAULT_SMOKE = { puffs: 2, radius: 0.01, opacity: 0.14, life: 0.7, drift: 0.2, rise: 0.06, growth: 2.1, flash: 1 };
+  var DEFAULT_SPREAD = { drift: 0.1, rise: 0.04, side: 0.06 };
   var FLASH_SECONDS = 0.055;
   var FLASH_RAMP = [0.6, 0.9];
   var FLASH_OPACITY = 0.95;
@@ -3458,8 +3480,10 @@ var GameVfxThree = (() => {
   var FLAME_ADDITIVE = 3;
   var ORIGIN2 = [0, 0, 0];
   var SIZE = variable("size");
+  var FLASH_SCALE = variable("flash");
+  var fallback = (name, defaultValue) => ite(ne(variable(name), void 0), variable(name), defaultValue);
   var wide = (width) => mul(sub(rand(), 0.5), width);
-  var puff2 = (point, velocity, world, radius, life, opacity) => mesh({
+  var puff2 = (point, velocity, world, radius, life, opacity, growth = SMOKE.growth) => mesh({
     shape: "sphere",
     p: point,
     v: velocity,
@@ -3474,7 +3498,7 @@ var GameVfxThree = (() => {
     lit: true,
     g: SMOKE.gravity,
     drag: SMOKE.drag,
-    grow: SMOKE.growth
+    grow: growth
   });
   var flameBit = (point, velocity, world, radius, life) => [
     set("bitPoint", point),
@@ -3507,37 +3531,55 @@ var GameVfxThree = (() => {
     id: "viewmodel_muzzle_flash",
     pageId: "event:viewmodel_muzzle_flash",
     team: "weapons",
-    budget: { particles: 12, lights: 1 },
+    budget: { particles: 14, lights: 1 },
     loop: 0.1,
+    setup: [
+      set("size", fallback("size", 1)),
+      set("puffs", fallback("puffs", DEFAULT_SMOKE.puffs)),
+      set("radius", fallback("radius", DEFAULT_SMOKE.radius)),
+      set("opacity", fallback("opacity", DEFAULT_SMOKE.opacity)),
+      set("life", fallback("life", DEFAULT_SMOKE.life)),
+      set("drift", fallback("drift", DEFAULT_SMOKE.drift)),
+      set("rise", fallback("rise", DEFAULT_SMOKE.rise)),
+      set("growth", fallback("growth", DEFAULT_SMOKE.growth)),
+      set("flash", fallback("flash", DEFAULT_SMOKE.flash)),
+      set("driftSpread", fallback("driftSpread", DEFAULT_SPREAD.drift)),
+      set("riseSpread", fallback("riseSpread", DEFAULT_SPREAD.rise)),
+      set("sideSpread", fallback("sideSpread", DEFAULT_SPREAD.side)),
+      set("lifeSpread", ite(ne(variable("lifeSpread"), void 0), variable("lifeSpread"), mul(variable("life"), 0.3)))
+    ],
     timeline: [
       set("angles", []),
       repeat(4, append("angles", add(div(mul(INDEX, PI), 2), mul(rand(), 0.6)))),
       set("roll", mul(rand(), PI)),
-      flash(ORIGIN2, 16756832, mul(4, SIZE), FLASH_SECONDS, mul(2, SIZE), true, true),
-      flashPiece("cone_open", mul(0.013, SIZE), mul(0.085, SIZE), 10, [mul(0.042, SIZE), 0, 0], [0, 0, -PI / 2], 16757575),
-      repeat(
-        4,
-        set("angle", pick(variable("angles"), INDEX)),
-        flashPiece(
-          "cone",
-          mul(5e-3, SIZE),
-          mul(0.04, SIZE),
-          6,
-          [mul(0.012, SIZE), mul(cos(variable("angle")), 0.016, SIZE), mul(sin(variable("angle")), 0.016, SIZE)],
-          [variable("angle"), 0, -PI / 2],
-          16757575
-        )
-      ),
-      flashPiece("sphere", mul(0.016, SIZE), void 0, 12, [mul(8e-3, SIZE), 0, 0], [0, 0, 0], 16773568),
+      when(gt(FLASH_SCALE, 0), [
+        flash(ORIGIN2, 16756832, mul(4, SIZE, FLASH_SCALE), FLASH_SECONDS, mul(2, SIZE, FLASH_SCALE), true, true),
+        flashPiece("cone_open", mul(0.013, SIZE, FLASH_SCALE), mul(0.085, SIZE, FLASH_SCALE), 10, [mul(0.042, SIZE, FLASH_SCALE), 0, 0], [0, 0, -PI / 2], 16757575),
+        repeat(
+          4,
+          set("angle", pick(variable("angles"), INDEX)),
+          flashPiece(
+            "cone",
+            mul(5e-3, SIZE, FLASH_SCALE),
+            mul(0.04, SIZE, FLASH_SCALE),
+            6,
+            [mul(0.012, SIZE, FLASH_SCALE), mul(cos(variable("angle")), 0.016, SIZE, FLASH_SCALE), mul(sin(variable("angle")), 0.016, SIZE, FLASH_SCALE)],
+            [variable("angle"), 0, -PI / 2],
+            16757575
+          )
+        ),
+        flashPiece("sphere", mul(0.016, SIZE, FLASH_SCALE), void 0, 12, [mul(8e-3, SIZE, FLASH_SCALE), 0, 0], [0, 0, 0], 16773568)
+      ]),
       repeat(
-        6,
+        variable("puffs"),
         puff2(
           ORIGIN2,
-          [add(0.15, mul(rand(), 0.35)), add(0.03, mul(rand(), 0.12)), mul(sub(rand(), 0.5), 0.14)],
+          [add(variable("drift"), mul(rand(), variable("driftSpread"))), add(variable("rise"), mul(rand(), variable("riseSpread"))), mul(sub(rand(), 0.5), variable("sideSpread"))],
           [0, 0, 0],
-          mul(0.013, SIZE),
-          add(1.3, mul(rand(), 0.6)),
-          0.45
+          mul(variable("radius"), SIZE),
+          add(variable("life"), mul(rand(), variable("lifeSpread"))),
+          variable("opacity"),
+          variable("growth")
         )
       )
     ]
@@ -3591,8 +3633,10 @@ var GameVfxThree = (() => {
     aliasOf(ENGINE_SMOKE, "vehicle_fire", { params: { id: "condition", options: ["100", "60", "30", "10"], default: 3 }, loop: 12 }),
     /** The exhaust of a car under way: `engine_smoke` in the best condition, for half a second so a moving car asks again. */
     aliasOf(ENGINE_SMOKE, "vehicle_exhaust", { params: { id: "condition", options: ["100", "60", "30", "10"], default: 0 }, loop: 0.5 }),
-    /** A hole in the tank: the page's own petrol leak (drips, pool, sparks, fire running to the tank). */
-    aliasOf(FUEL_LEAK, "vehicle_leak", {})
+    /** A hole in the tank: the page's petrol leak without the fire and the blast (the pool and the drips). A normal bullet does only this. */
+    aliasOf(FUEL_LEAK_ONLY, "vehicle_leak", {}),
+    /** The leak caught fire (an incendiary or tracer round, a spark, a fire near): the page's whole sequence, the fire running along the pool to the tank and the blast. */
+    aliasOf(FUEL_LEAK, "vehicle_leak_ignited", {})
   ];
   var ALL_EFFECTS = [BLOOD_HIT, HEADSHOT, DISMEMBER, BLOATER_CLOUD, SCREAMER_SHRIEK, CORPSE_DECAY, REANIMATION, EYES_IN_FOG, MUZZLE_FLASH, IMPACT_BY_MATERIAL, PENETRATION, CASINGS_AND_MAGAZINE, MOLOTOV, GRENADE, EXPLOSIVE_BARREL, SHOPFRONT_GLASS, DOOR_STAGES, BUILDING_COLLAPSE, BLOCK_WALL, METAL_DOOR_EFFECT, IRON_RAILING, WOODEN_FENCE, HIT_POINT_BREAKAGE, PRESSURE_CYLINDERS, BUILDING_FIRE, RAIN_AND_PUDDLES, FOG_AND_ASH, SCRAPING_SPARKS, ENGINE_SMOKE, FUEL_LEAK, CAR_EXPLOSION, WINDSHIELD, HEADLIGHTS_IN_RAIN, DAMAGE_AND_BITE, INFECTION_PHASES, PANIC, BLOATER_BLINDNESS, CAMPFIRE, COUGH_AND_BREATH];
   var WORKSHOP_EFFECTS = Object.fromEntries(ALL_EFFECTS.map((effect) => [effect.id, effect]));
@@ -7238,7 +7282,7 @@ var GameVfxThree = (() => {
     blood_hit: {
       name: "Blood by infection age",
       short: "A mist on the way in, a jet on the way out, a pool that grows. Age changes colour and amount.",
-      cost: "\u2264 70 part.",
+      cost: "\u2264 70 particles",
       costNote: "1 pool \xB7 6 splashes",
       paramLabel: "Age",
       when: "Every bullet or blow that hits a zombie. The blood value comes from the bestiary age: 1.0 \xB7 0.7 \xB7 0.35 \xB7 0.1.",
@@ -7249,7 +7293,7 @@ var GameVfxThree = (() => {
     headshot: {
       name: "Headshot",
       short: "The head bursts, the eyes go out on the same frame and the body drops.",
-      cost: "\u2264 70 part.",
+      cost: "\u2264 70 particles",
       costNote: "8 debris \xB7 1 pool",
       when: "A head hit that kills (bestiary rule: a head kills at once).",
       look: "A red mist around the head, a jet of drops backwards, 6 to 8 pieces of bone and skin, a swap to the burst-neck mesh. The eye glow goes out on the same frame, which is the most readable signal from afar.",
@@ -7259,7 +7303,7 @@ var GameVfxThree = (() => {
     dismember: {
       name: "Dismemberment",
       short: "The arm comes off whole with physics and the shoulder gushes for half a second.",
-      cost: "\u2264 60 part.",
+      cost: "\u2264 60 particles",
       costNote: "1 limb \xB7 4 splashes",
       when: "Damage to a limb above the threshold (multipliers by region from the bestiary) or an axe blow.",
       look: "The limb becomes a loose piece with physics and bounces. A short pulsing jet from the shoulder, drops that form a trail to the pool. The zombie staggers but keeps walking.",
@@ -7269,7 +7313,7 @@ var GameVfxThree = (() => {
     bloater_cloud: {
       name: "Bloater cloud",
       short: "The belly pulses for 0.5 s, bursts and leaves 4 m of gas for 8 s.",
-      cost: "\u2264 180 part.",
+      cost: "\u2264 180 particles",
       costNote: "server entity",
       when: "Death of the Bloater, by any cause.",
       look: "A 0.5 s warning with the belly swelling, a burst with pieces and a greenish jet, and a low moss-green cloud that undulates on the ground for 8 s. Loose green glows inside the cloud mark the area.",
@@ -7279,7 +7323,7 @@ var GameVfxThree = (() => {
     screamer_shriek: {
       name: "Screamer shriek",
       short: "A 1.5 s wind-up with steam, a wave on the ground and the horde's eyes light up.",
-      cost: "\u2264 150 part.",
+      cost: "\u2264 150 particles",
       costNote: "3 rings \xB7 aberration",
       when: "The Screamer spots the player and starts the shriek (1.5 s wind-up, calls everyone within 150 m).",
       look: "Head back and steam from the mouth during the wind-up. On the shriek, three pressure rings on the ground, dust raised in the radius, a short chromatic aberration on the screen of whoever is near, and the eyes of nearby zombies flare when they hear.",
@@ -7299,7 +7343,7 @@ var GameVfxThree = (() => {
     corpse_decay: {
       name: "Corpse: darken and dissolve",
       short: "15 minutes in 8 seconds: fall, darken, flies and turn to dust.",
-      cost: "\u2264 40 part.",
+      cost: "\u2264 40 particles",
       costNote: "pool of 400 bodies",
       when: "Zombie death. Bestiary timeline: ragdoll 3 s, frozen mesh, darken, dissolve between 14 and 15 min.",
       look: "The skin loses colour until almost black, the pool dries to brown, flies appear from minute 5 and in the last minute the body sinks and gives off dark dust.",
@@ -7309,7 +7353,7 @@ var GameVfxThree = (() => {
     reanimation: {
       name: "Reanimation",
       short: "Veins light up, spasms, the eyes switch on and the body gets up.",
-      cost: "\u2264 30 part.",
+      cost: "\u2264 30 particles",
       costNote: "emissive in the shader",
       when: "End of infection of a player or NPC: reanimates in 2 to 6 min as Fresh (70% Slow, 30% Runner).",
       look: "Green pulses through the skin (emissive in the shader, not particles), spasms in the arms and head, the eyes light up from the inside out and the body stands. Breath as steam on the first shriek.",
@@ -7319,7 +7363,7 @@ var GameVfxThree = (() => {
     muzzle_flash: {
       name: "Muzzle flash",
       short: "Core, petals and smoke scaled by weapon. The Barrett raises dust.",
-      cost: "\u2264 60 part.",
+      cost: "\u2264 60 particles",
       costNote: "1 light \xB7 50 ms",
       paramLabel: "Weapon",
       when: "Every shot. In first person it uses the weapon model; from afar it is only the core sprite.",
@@ -7330,7 +7374,7 @@ var GameVfxThree = (() => {
     impact: {
       name: "Impact by material",
       short: "Concrete, metal, wood, glass, flesh and water: each with its own response.",
-      cost: "\u2264 40 part.",
+      cost: "\u2264 40 particles",
       costNote: "1 hole",
       paramLabel: "Material",
       when: "Every bullet that hits something. The material comes from the mesh surface tag.",
@@ -7341,7 +7385,7 @@ var GameVfxThree = (() => {
     penetration: {
       name: "Bullet through the horde",
       short: "Barrett tracer passing through 5 zombies, in 10x slow motion.",
-      cost: "\u2264 250 part.",
+      cost: "\u2264 250 particles",
       costNote: "aggregate event",
       when: "Weapon with penetration: the AK goes through 2, the Remington 700 through 3, the Barrett through 6 and cars.",
       look: "A tracer with a hot-air trail, blood exiting each body in the order the bullet passes (each in the colour of its age), bodies falling one after another and a final impact on the concrete.",
@@ -7361,7 +7405,7 @@ var GameVfxThree = (() => {
     molotov: {
       name: "Molotov cocktail",
       short: "A lit wick in the arc, glass breaking and a pool of fire that spreads.",
-      cost: "\u2264 300 part.",
+      cost: "\u2264 300 particles",
       costNote: "2 lights \xB7 entity",
       when: "A molotov hitting the ground or a zombie.",
       look: "A bottle in an arc with the wick giving off flame and smoke. On impact, green shards and a splash of fire that opens from 0.5 m to 2.2 m in 0.8 s. Low flames, embers, dark smoke and a flickering light for 6 s, then embers and a burn mark.",
@@ -7371,7 +7415,7 @@ var GameVfxThree = (() => {
     grenade: {
       name: "Fragmentation grenade",
       short: "A bounce on the asphalt, flash, shock wave, shrapnel and a ring of dust.",
-      cost: "\u2264 400 part.",
+      cost: "\u2264 400 particles",
       costNote: "aggregate event",
       when: "A grenade exploding (1.8 s fuse after the throw).",
       look: "The grenade bounces twice. A layered explosion: a white flash that paints the screen, a short fireball, a shock ring on the ground and another facing the camera, bright shrapnel that bounces, a ring of low dust, grey smoke that rises and a burn mark. Zombies in the radius fall outwards.",
@@ -7381,7 +7425,7 @@ var GameVfxThree = (() => {
     explosive_barrel: {
       name: "Explosive barrel",
       short: "A mushroom of fire, the lid flying, petrol burning on the ground and a column of smoke.",
-      cost: "\u2264 450 part.",
+      cost: "\u2264 450 particles",
       costNote: "2 lights \xB7 fire entity",
       when: "A red barrel with damage above the threshold, a shot or fire touching it.",
       look: "Everything the grenade does, plus: a fireball that rises into a mushroom, the lid and red pieces flying high, three pools of petrol burning for 5 s and a black smoke column that serves as a landmark from afar.",
@@ -7401,7 +7445,7 @@ var GameVfxThree = (() => {
     door_stages: {
       name: "Door giving way in 3 stages",
       short: "Blows shake dust from the frame, a plank cracks and the door falls.",
-      cost: "\u2264 120 part.",
+      cost: "\u2264 120 particles",
       costNote: "3 stages",
       when: "The horde hitting a door or barricade (the Brute does 3x damage). Stages: 66%, 33%, 0% health.",
       look: "Each blow shakes the door and loosens dust from the frame and splinters. At stage 2 the middle plank cracks and falls. At 3 the door topples and raises a cloud of low dust, and the zombie comes out of the dark.",
@@ -7411,7 +7455,7 @@ var GameVfxThree = (() => {
     building_collapse: {
       name: "Collapse",
       short: "Dust trickling from the awning, blocks falling and a cloud of dust rolling down the street.",
-      cost: "\u2264 350 part.",
+      cost: "\u2264 350 particles",
       costNote: "26 debris",
       when: "A structure that loses its health: explosion, vehicle impact, a big horde pushing (destruction of the map buildings).",
       look: "Before: fine dust trickling and pebbles falling for 1 s, as a warning. Then: large and small blocks fall, the camera shakes and a cloud of grey-beige dust rolls along the ground and hangs in the air for 5 s, hiding zombies.",
@@ -7421,7 +7465,7 @@ var GameVfxThree = (() => {
     block_wall: {
       name: "Wall brought down with holes",
       short: "A burst leaves holes and chips; the wall falls in blocks and the holes stay on them.",
-      cost: "\u2264 300 part.",
+      cost: "\u2264 300 particles",
       costNote: "30 blocks \xB7 attached holes",
       when: "A concrete wall, low wall or barricade that loses health from shots, explosion, the Brute or a car (map and arsenal destruction).",
       look: "Each bullet opens a dark hole with a chipped rim, giving off dust and pebbles. When the wall gives way it splits into blocks that topple with physics and a cloud of dust rolls along the ground. The bullet holes are attached to the blocks: they stay on the fallen pieces, turned with them, and do not vanish when the wall breaks.",
@@ -7431,7 +7475,7 @@ var GameVfxThree = (() => {
     metal_door: {
       name: "Metal door denting",
       short: "Each blow sinks the plate, flakes the paint and throws sparks; the hinge bursts.",
-      cost: "\u2264 160 part.",
+      cost: "\u2264 160 particles",
       costNote: "deformable mesh",
       when: "A door, gate or steel plate taking a zombie blow (Brute 3x), a 12-gauge shot or a car hit.",
       look: "The plate sinks where it is hit (a deformed mesh, not a model swap), with 3 visible levels. Each blow gives off sparks, flakes of green paint and rust dust. When the health runs out the top hinge bursts in sparks, the door topples and scrapes on the ground giving off more sparks.",
@@ -7441,7 +7485,7 @@ var GameVfxThree = (() => {
     iron_railing: {
       name: "Iron railing bending",
       short: "The horde pushes, the bars bow, the weld pops in a spark and the railing falls.",
-      cost: "\u2264 200 part.",
+      cost: "\u2264 200 particles",
       costNote: "3 deformable bars",
       when: "A railing, iron gate, handrail or chain-link fence with zombies pushing (horde pressure) or a car hitting it.",
       look: "The bars bow gradually at the point of pressure and the vertical ones tilt with them. Rust falls in a thread during the strain. At two moments the weld pops with a crackle of sparks. At the end the middle post gives and the railing topples, leaving the bent iron on the ground.",
@@ -7451,7 +7495,7 @@ var GameVfxThree = (() => {
     wooden_fence: {
       name: "Wooden fence breaking",
       short: "Planks snap one by one, chips and dust, and the section topples as the horde passes.",
-      cost: "\u2264 150 part.",
+      cost: "\u2264 150 particles",
       costNote: "12 planks",
       when: "A fence, yard gate or plank barricade taking a shot, blow or horde pressure.",
       look: "Each plank snaps at a random point: the stump stays on the rail and the top piece flies off with chips and wood dust. The zombie appears through the gap. At the end the rail cracks and the whole section topples forward.",
@@ -7461,7 +7505,7 @@ var GameVfxThree = (() => {
     hit_point_breakage: {
       name: "Breakage by the point hit",
       short: "A shot to the leg, a machete on the corner, a bat on the top and a 12-gauge up close: each weapon breaks the part it hit.",
-      cost: "\u2264 120 part.",
+      cost: "\u2264 120 particles",
       costNote: "parts with their own health",
       when: "Any destructible item. The damage goes to the part that was hit, not to the whole item.",
       look: "A 9 mm shot to the front leg: the lower part of the leg breaks off and the table tips toward that corner. A machete on the corner of the top: the corner comes off whole in a straight cut, with chips in a line. A bat on the other corner: the top cracks and falls apart in pieces with dust. A 12-gauge up close on what is left: 9 grouped holes that stay in the wood.",
@@ -7471,7 +7515,7 @@ var GameVfxThree = (() => {
     pressure_cylinders: {
       name: "Extinguisher and oxygen cylinder",
       short: "A shot to the extinguisher makes a white cloud and a spin; on oxygen the valve breaks and the cylinder becomes a rocket.",
-      cost: "\u2264 250 part.",
+      cost: "\u2264 250 particles",
       costNote: "cloud entity",
       paramLabel: "Cylinder",
       when: "A shot, a strong blow or fire on an extinguisher, oxygen cylinder or welding cylinder (extinguisher and oxygen_cylinder keys of the map catalogue).",
@@ -7482,7 +7526,7 @@ var GameVfxThree = (() => {
     building_fire: {
       name: "Building on fire",
       short: "Fire coming out of the windows, licking the facade, embers and smoke with the wind.",
-      cost: "\u2264 600 part.",
+      cost: "\u2264 600 particles",
       costNote: "2 lights \xB7 reference",
       when: "A building fire (molotov, explosion, vehicle). It lasts minutes and spreads to the neighbour.",
       look: "Windows lit orange that flicker, tongues of fire coming out of the top of each window and climbing the facade, embers carried by the wind and a thick slanted column of smoke. The light paints the street.",
@@ -7523,7 +7567,7 @@ var GameVfxThree = (() => {
     engine_smoke: {
       name: "Engine smoke",
       short: "White steam, grey smoke, then black with fire, depending on condition.",
-      cost: "\u2264 120 part.",
+      cost: "\u2264 120 particles",
       costNote: "continuous",
       paramLabel: "Condition",
       when: "Whenever the engine is on or hot, from the part condition (0 to 100) in the fleet brief.",
@@ -7534,7 +7578,7 @@ var GameVfxThree = (() => {
     fuel_leak: {
       name: "Tank leak and fire",
       short: "Dripping petrol, a pool, a spark and the fire running to the tank.",
-      cost: "\u2264 400 part.",
+      cost: "\u2264 400 particles",
       costNote: "fire entity",
       when: "A tank punctured by a shot or a crash. A spark, a shot or nearby fire lights the pool.",
       look: "Drops of petrol with an oily sheen forming a growing pool. A shot on the metal throws a spark, the fire lights on the pool, runs to the car and, if nobody puts it out, the car explodes.",
@@ -7544,7 +7588,7 @@ var GameVfxThree = (() => {
     car_explosion: {
       name: "Car explosion",
       short: "A fireball, the car jumping, the bonnet and doors flying, the shell burning.",
-      cost: "\u2264 600 part.",
+      cost: "\u2264 600 particles",
       costNote: "rare event",
       when: "A tank on fire for more than 4 s, or damage above the threshold on a car with fuel.",
       look: "A large explosion (grenade scale 1.8), the car jumps and lands crooked, the bonnet, doors and a wheel fly off, the glass bursts into shards. The bodywork goes black and the shell burns with black smoke for minutes.",
@@ -7605,7 +7649,7 @@ var GameVfxThree = (() => {
     bloater_blindness: {
       name: "Bloater blindness",
       short: "Green gas in the face: a blurred screen for 5 s and mucus on the lens.",
-      cost: "post + 30 part.",
+      cost: "post + 30 particles",
       costNote: "server entity",
       when: "A player inside the Bloater cloud (radius 4 m) when it spawns.",
       look: "A green cloud bursts between the zombie and the camera, the screen goes green and blurred and clears in 5 s, with drops of green mucus on the lens that run down. A cough shakes the camera twice.",
@@ -7615,7 +7659,7 @@ var GameVfxThree = (() => {
     campfire: {
       name: "Campsite fire",
       short: "A low flame, embers spiralling up and a flickering warm light.",
-      cost: "\u2264 120 part.",
+      cost: "\u2264 120 particles",
       costNote: "1 fire light",
       when: "A campfire lit by the group or by NPCs. It warms, lights and draws zombies from afar (light).",
       look: "Small low flames, embers that rise turning and fade, thin smoke and a warm light that flickers and paints the survivor.",
@@ -7625,7 +7669,7 @@ var GameVfxThree = (() => {
     cough_and_breath: {
       name: "Cough, breath and flashlight",
       short: "Breath vapour in the cold, the fever cough visible to others and the flashlight beam.",
-      cost: "\u2264 40 part.",
+      cost: "\u2264 40 particles",
       costNote: "1 spot with shadow",
       when: "A cold night: breath always. Infection fever: a cough every few seconds, audible at 10 m.",
       look: "A short puff of vapour every 2.4 s. On a cough, three quick bigger puffs and the body jolts. The flashlight shows the beam in the fog and is the only light with a shadow.",
@@ -8575,6 +8619,81 @@ void main(){
     };
   }
 
+  // src/mesh-layer.ts
+  var SPHERE_DEFAULT_WIDTH = 8;
+  var SPHERE_DEFAULT_HEIGHT = 6;
+  function geometryOf(THREE, particle) {
+    switch (particle.shape) {
+      case "cone":
+        return new THREE.ConeGeometry(particle.radius, particle.height, particle.segments || void 0, particle.segments2 || 1, false);
+      case "cone_open":
+        return new THREE.ConeGeometry(particle.radius, particle.height, particle.segments || void 0, particle.segments2 || 1, true);
+      case "sphere":
+        return new THREE.SphereGeometry(particle.radius, particle.segments || SPHERE_DEFAULT_WIDTH, particle.segments2 || SPHERE_DEFAULT_HEIGHT);
+      case "icosahedron":
+        return new THREE.IcosahedronGeometry(particle.radius, particle.segments);
+    }
+  }
+  function materialOf(THREE, particle) {
+    if (particle.lit) return new THREE.MeshStandardMaterial({ color: particle.color, roughness: 1, metalness: 0, transparent: true, opacity: particle.opacity, depthWrite: false });
+    return new THREE.MeshBasicMaterial({ color: particle.color, transparent: true, opacity: particle.opacity, depthWrite: false, ...particle.additive ? { blending: THREE.AdditiveBlending } : {} });
+  }
+  function createMeshLayerProbes(THREE) {
+    const geometry = new THREE.BoxGeometry(1e-3, 1e-3, 1e-3);
+    return [{ lit: true, additive: false }, { lit: false, additive: false }, { lit: false, additive: true }].map(
+      (kind) => new THREE.Mesh(geometry, materialOf(THREE, { ...kind, color: 8421504, opacity: 0.5 }))
+    );
+  }
+  function createMeshLayer(THREE, pool) {
+    const group = new THREE.Group();
+    group.name = "workshop-meshes";
+    const drawn = /* @__PURE__ */ new Map();
+    const frame = new THREE.Quaternion();
+    const euler = new THREE.Euler();
+    const turn = new THREE.Quaternion();
+    const offset = new THREE.Vector3();
+    function release(mesh2) {
+      mesh2.removeFromParent();
+      mesh2.geometry.dispose();
+      mesh2.material.dispose();
+    }
+    return {
+      group,
+      sync() {
+        const live = /* @__PURE__ */ new Set();
+        for (const particle of pool.particles) {
+          live.add(particle.id);
+          let mesh2 = drawn.get(particle.id);
+          if (!mesh2) {
+            mesh2 = new THREE.Mesh(geometryOf(THREE, particle), materialOf(THREE, particle));
+            mesh2.frustumCulled = false;
+            mesh2.renderOrder = particle.additive ? 5 : 3;
+            drawn.set(particle.id, mesh2);
+            group.add(mesh2);
+          }
+          frame.set(particle.frame[0], particle.frame[1], particle.frame[2], particle.frame[3]);
+          offset.set(particle.at[0], particle.at[1], particle.at[2]).multiplyScalar(particle.scale).applyQuaternion(frame);
+          mesh2.position.set(particle.x + offset.x, particle.y + offset.y, particle.z + offset.z);
+          turn.setFromEuler(euler.set(particle.rx, particle.ry, particle.rz));
+          mesh2.quaternion.copy(frame).multiply(turn);
+          mesh2.scale.setScalar(particle.scale);
+          mesh2.material.opacity = particle.opacity;
+        }
+        for (const [id, mesh2] of drawn) {
+          if (live.has(id)) continue;
+          release(mesh2);
+          drawn.delete(id);
+        }
+        return pool.count;
+      },
+      dispose() {
+        for (const mesh2 of drawn.values()) release(mesh2);
+        drawn.clear();
+        group.removeFromParent();
+      }
+    };
+  }
+
   // src/screen-overlay.ts
   var clamp5 = (value, min2, max2) => value < min2 ? min2 : value > max2 ? max2 : value;
   function layer(container, name, blend) {
@@ -8754,75 +8873,6 @@ void main() {
     };
   }
 
-  // src/mesh-layer.ts
-  var SPHERE_DEFAULT_WIDTH = 8;
-  var SPHERE_DEFAULT_HEIGHT = 6;
-  function geometryOf(THREE, particle) {
-    switch (particle.shape) {
-      case "cone":
-        return new THREE.ConeGeometry(particle.radius, particle.height, particle.segments || void 0, particle.segments2 || 1, false);
-      case "cone_open":
-        return new THREE.ConeGeometry(particle.radius, particle.height, particle.segments || void 0, particle.segments2 || 1, true);
-      case "sphere":
-        return new THREE.SphereGeometry(particle.radius, particle.segments || SPHERE_DEFAULT_WIDTH, particle.segments2 || SPHERE_DEFAULT_HEIGHT);
-      case "icosahedron":
-        return new THREE.IcosahedronGeometry(particle.radius, particle.segments);
-    }
-  }
-  function materialOf(THREE, particle) {
-    if (particle.lit) return new THREE.MeshStandardMaterial({ color: particle.color, roughness: 1, metalness: 0, transparent: true, opacity: particle.opacity, depthWrite: false });
-    return new THREE.MeshBasicMaterial({ color: particle.color, transparent: true, opacity: particle.opacity, depthWrite: false, ...particle.additive ? { blending: THREE.AdditiveBlending } : {} });
-  }
-  function createMeshLayer(THREE, pool) {
-    const group = new THREE.Group();
-    group.name = "workshop-meshes";
-    const drawn = /* @__PURE__ */ new Map();
-    const frame = new THREE.Quaternion();
-    const euler = new THREE.Euler();
-    const turn = new THREE.Quaternion();
-    const offset = new THREE.Vector3();
-    function release(mesh2) {
-      mesh2.removeFromParent();
-      mesh2.geometry.dispose();
-      mesh2.material.dispose();
-    }
-    return {
-      group,
-      sync() {
-        const live = /* @__PURE__ */ new Set();
-        for (const particle of pool.particles) {
-          live.add(particle.id);
-          let mesh2 = drawn.get(particle.id);
-          if (!mesh2) {
-            mesh2 = new THREE.Mesh(geometryOf(THREE, particle), materialOf(THREE, particle));
-            mesh2.frustumCulled = false;
-            mesh2.renderOrder = particle.additive ? 5 : 3;
-            drawn.set(particle.id, mesh2);
-            group.add(mesh2);
-          }
-          frame.set(particle.frame[0], particle.frame[1], particle.frame[2], particle.frame[3]);
-          offset.set(particle.at[0], particle.at[1], particle.at[2]).multiplyScalar(particle.scale).applyQuaternion(frame);
-          mesh2.position.set(particle.x + offset.x, particle.y + offset.y, particle.z + offset.z);
-          turn.setFromEuler(euler.set(particle.rx, particle.ry, particle.rz));
-          mesh2.quaternion.copy(frame).multiply(turn);
-          mesh2.scale.setScalar(particle.scale);
-          mesh2.material.opacity = particle.opacity;
-        }
-        for (const [id, mesh2] of drawn) {
-          if (live.has(id)) continue;
-          release(mesh2);
-          drawn.delete(id);
-        }
-        return pool.count;
-      },
-      dispose() {
-        for (const mesh2 of drawn.values()) release(mesh2);
-        drawn.clear();
-        group.removeFromParent();
-      }
-    };
-  }
-
   // src/shaders/workshop-sprite.ts
   var WORKSHOP_SPRITE_VERTEX = `attribute float size;attribute float alpha;attribute vec3 pcol;varying vec3 vC;varying float vA;uniform float uScale;
 void main(){vC=pcol;vA=alpha;vec4 mv=modelViewMatrix*vec4(position,1.);gl_PointSize=clamp(size*uScale/-mv.z,1.,512.);gl_Position=projectionMatrix*mv;}`;
@@ -9193,7 +9243,14 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     const requested = options.vfx;
     const world = isWorld(requested) ? requested : createVfx({ profile: options.quality ?? "medium", reducedMotion, ...requested });
     const pools = world.pools();
-    const root = new THREE.Group();
+    let anchors;
+    const releaseAnchors = () => {
+      if (!anchors) return;
+      anchors.meshes[0]?.geometry.dispose();
+      for (const mesh2 of anchors.meshes) mesh2.material.dispose();
+      anchors = void 0;
+    };
+    const root = markKitOrigin(new THREE.Group(), { owner: "game-vfx-three", kind: "effect" });
     options.scene.add(root);
     const direction = new THREE.Vector3(...options.lightDirection ?? LAB_LIGHT_DIRECTION).normalize();
     const sky = hexToLinearRgb(SKY_COLOR);
@@ -9309,6 +9366,16 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         syncAll();
         overlay?.update(screenNow());
       },
+      warmUpProbes() {
+        releaseAnchors();
+        const meshes = createMeshLayerProbes(THREE);
+        for (const mesh2 of meshes) mesh2.frustumCulled = false;
+        const group = new THREE.Group();
+        group.add(...meshes);
+        anchors = { meshes, group };
+        return { group, dispose: () => {
+        } };
+      },
       applyCamera() {
         const shake = screenNow().shake;
         if (reducedMotion || !(shake > SHAKE_FLOOR)) return () => {
@@ -9327,6 +9394,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       },
       screen: screenNow,
       dispose() {
+        releaseAnchors();
         stopMarks();
         overlay?.dispose();
         workshopLayers?.dispose();
@@ -9591,6 +9659,11 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       controls,
       layers,
       metrics,
+      // opening the effects area puts the camera at the bench view (the initial distance does not move it: that would take the player's view on load)
+      area: () => ({
+        placements: [],
+        view: { eye: eyeFor(DEFAULT_DISTANCE), target: [0, 1.2, 0] }
+      }),
       attach(host) {
         const bench = host.bench;
         let own;
@@ -9610,6 +9683,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         let phase = 0;
         let handle = null;
         let sinceRepeat = 0;
+        let live = false;
         read = () => {
           const def = explosions[effect];
           const recipe = recipes[effect];
@@ -9648,7 +9722,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
             }
           );
           bench?.sheet?.(sheetFor(id));
-          replay();
+          if (live) replay();
         }
         function look() {
           const eye = eyeFor(distance);
@@ -9665,7 +9739,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
             choose(change.value);
           else if (change.id === "variant" && typeof change.value === "string") {
             variant = change.value;
-            if (recipes[effect]?.params) replay();
+            if (live && recipes[effect]?.params) replay();
           } else if (change.id === "auto_repeat") auto = change.value === true;
           else if (change.id === "distance" && typeof change.value === "number") {
             distance = change.value;
@@ -9675,6 +9749,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         };
         const offChange = bench?.onChange(apply);
         const offFrame = host.onFrame((dt) => {
+          live = true;
           phase += dt;
           sinceRepeat += dt;
           own?.update(dt);