@adatechnology/game-test-room 0.28.2 → 0.29.0

package/dist/index.js

@@ -14,6 +14,9 @@ var DEFAULT_TOOL_BLOWS = {
   kick: "kick",
   shove: "shove",
   knife: "blade",
+  kabar: "blade",
+  katana: "blade",
+  brass_knuckles: "punch",
   machete: "blade",
   utility_knife: "blade",
   axe: "chop",
@@ -80,7 +83,7 @@ function createStrideCounter(stride = STRIDE_METRES) {
 }
 
 // src/room.ts
-import { createArsenal, DEFAULT_LOADOUT, realLoadout, weaponMenu } from "@adatechnology/game-weapons";
+import { canDualWield, createArsenal, DEFAULT_LOADOUT, realLoadout, weaponMenu } from "@adatechnology/game-weapons";
 import { createFilmLcg, createFluids, createItemUse, ITEM_USES, resolveStrings as resolveFluidStrings } from "@adatechnology/game-fluids";
 import { createFilmBridge, createFilmManager, createFluidRenderer } from "@adatechnology/game-fluids-three";
 import { SPRITE_KINDS, createVfx, patchSpriteKinds } from "@adatechnology/game-vfx";
@@ -627,6 +630,11 @@ var segmentTouchesBox = (from, to, min, max) => {
 };
 
 // src/explosives.ts
+var SMOKE_PUFFS_PER_SECOND = 36;
+var SMOKE_PUFF_LIFE = 3.2;
+var SMOKE_PUFF_SPEED = 1.7;
+var SMOKE_PUFF_SIZE = 5;
+var SMOKE_PUFF_ALPHA = 1.5;
 var CONE_BLAST_RADIUS = 0.5;
 var summarizeBlast = (results) => {
   const reports = results.flatMap((r) => r.blast ? [r.blast] : []);
@@ -642,6 +650,8 @@ var toArray = (vector) => [vector.x, vector.y, vector.z];
 function createExplosives(context) {
   const { THREE, scene, camera, world, renderer, arsenal, translate, format, action } = context;
   const projectiles = [];
+  const smokeSources = [];
+  const random = context.random ?? Math.random;
   const meshes = [];
   const up = new THREE.Vector3(0, 1, 0);
   const drop = (objects) => {
@@ -649,6 +659,7 @@ function createExplosives(context) {
     releaseObject3D(objects, { keep: scene });
   };
   const clear = () => {
+    smokeSources.length = 0;
     projectiles.length = 0;
     drop(meshes);
     meshes.length = 0;
@@ -815,6 +826,12 @@ function createExplosives(context) {
   const detonate = (projectile, detonation) => {
     const weaponName = context.toolName(projectile.weapon);
     const reach = Math.max(detonation.injuryRadius, detonation.lethalRadius);
+    if (detonation.smoke) {
+      const [shortest, longest] = detonation.smoke.seconds;
+      smokeSources.push({ point: detonation.point, left: shortest + (longest - shortest) * random(), owed: 0, color: detonation.smoke.color });
+      action("smoke", translate("act.smoke", { weapon: weaponName, seconds: format(smokeSources[smokeSources.length - 1].left, 0) }), { data: { weapon: projectile.weapon, explosive: detonation.explosive, point: detonation.point } });
+      return;
+    }
     const results = detonation.energy <= 0 || detonation.cone ? [] : world.explode(detonation.point, detonation.energy, reach, "player", context.blast());
     const reached = detonation.energy <= 0 ? 0 : detonation.cone ? coneBlast(detonation) : results.length;
     if (!detonation.cone) told(results);
@@ -936,7 +953,22 @@ function createExplosives(context) {
     action("tripwire", translate("act.tripwire", { weapon: context.toolName(projectile.weapon), who: crosser }), { data: { weapon: projectile.weapon, body: crosser } });
     detonate(projectile, event.detonation);
   };
+  const burnSmoke = (dt) => {
+    for (let index = smokeSources.length - 1; index >= 0; index--) {
+      const source = smokeSources[index];
+      source.left -= dt;
+      source.owed += SMOKE_PUFFS_PER_SECOND * dt;
+      for (; source.owed >= 1; source.owed -= 1) {
+        const angle = random() * Math.PI * 2;
+        const speed = SMOKE_PUFF_SPEED * (0.4 + random());
+        const velocity = [Math.cos(angle) * speed, 0.5 + random() * 0.8, Math.sin(angle) * speed];
+        context.effects.spawn("smoke", [source.point[0], source.point[1] + 0.08, source.point[2]], velocity, { color: source.color, size: SMOKE_PUFF_SIZE, life: SMOKE_PUFF_LIFE, alpha: SMOKE_PUFF_ALPHA });
+      }
+      if (source.left <= 0) smokeSources.splice(index, 1);
+    }
+  };
   const update = (dt) => {
+    burnSmoke(dt);
     for (let index = projectiles.length - 1; index >= 0; index--) {
       const projectile = projectiles[index];
       if (!projectile) continue;
@@ -957,7 +989,7 @@ function createExplosives(context) {
       }
     }
   };
-  return { throwUse, placeUse, backblastUse, detonateCharges, blastAt, update, clear };
+  return { throwUse, placeUse, backblastUse, detonateCharges, blastAt, update, clear, smokeLeft: () => smokeSources.map((source) => source.left) };
 }
 
 // src/test-table.ts
@@ -1171,6 +1203,65 @@ var toHostEvent = (weapon, event, options = {}) => {
   }
 };
 
+// src/dual-reload.ts
+var otherHand = (hand) => hand === "R" ? "L" : "R";
+function createDualReload(host, stowSeconds) {
+  let queue = [];
+  let current = null;
+  const next = () => {
+    let hand = queue.shift();
+    while (hand && !host.needs(hand)) hand = queue.shift();
+    if (!hand) {
+      current = null;
+      return;
+    }
+    const seconds = stowSeconds();
+    current = { hand, phase: "stow", left: seconds };
+    host.stow(otherHand(hand), true, seconds);
+  };
+  const draw = (hand) => {
+    const seconds = stowSeconds();
+    current = { hand, phase: "draw", left: seconds };
+    host.stow(otherHand(hand), false, seconds);
+  };
+  return {
+    start(order) {
+      if (current) return;
+      queue = [...order];
+      next();
+    },
+    step(dt) {
+      if (!current) return;
+      if (current.phase === "reload") {
+        if (!host.reloading(current.hand)) draw(current.hand);
+        return;
+      }
+      current.left -= dt;
+      if (current.left > 0) return;
+      if (current.phase === "draw") {
+        next();
+        return;
+      }
+      current.phase = "reload";
+      if (!host.startReload(current.hand)) draw(current.hand);
+    },
+    get busy() {
+      return current !== null;
+    },
+    get current() {
+      return current ? { hand: current.hand, phase: current.phase } : null;
+    },
+    stowed(hand) {
+      return current !== null && current.phase !== "draw" && otherHand(current.hand) === hand;
+    },
+    cancel() {
+      if (current && current.phase !== "draw") host.stow(otherHand(current.hand), false, 0);
+      current = null;
+      queue = [];
+    }
+  };
+}
+
 // src/loading-view.ts
 var LOADING_CLASS = "tr-loading";
 var LOADING_CSS = [
@@ -2344,6 +2435,10 @@ function createPlayer(THREE, o) {
     o.hooks.primaryDown();
   };
   const onMouseUp = (e) => {
+    if (e.button === 2) {
+      o.hooks.secondaryUp?.();
+      return;
+    }
     if (e.button !== 0) return;
     if (holdTimer) clearTimeout(holdTimer);
     if (dragging) {
@@ -3361,7 +3456,7 @@ import { createFootprints, createTerrain, createTerrainImpl, DEFAULT_PROFILE, wa
 import { createTerrainRenderer, terrainProfileName } from "@adatechnology/game-terrain-three";
 
 // src/avatar.ts
-var DEFAULT_STRIKE_CLIPS = { hand: "punch_right", fists: "punch_right", shove: "shove_two_hands", kick: "front_kick" };
+var DEFAULT_STRIKE_CLIPS = { hand: "punch_right", fists: "punch_right", brass_knuckles: "punch_right", shove: "shove_two_hands", kick: "front_kick" };
 var DEFAULT_HAND_STANCES = { fists: "fists" };
 var THIRD_PERSON_DEFAULTS = {
   back: 3.8,
@@ -3534,6 +3629,12 @@ var en = {
     "act.clear": "Cleared the room",
     "act.reset": "Repaired every object",
     "act.tool": "Equipped {weapon}",
+    "act.tool_left": "{weapon} in the left hand: left button fires the right one, right button the left one",
+    "act.tool_left_off": "Left hand free: one weapon again",
+    "act.stow": "{weapon} tucked against the body: the {hand} hand is free for the other magazine",
+    "act.unstow": "{weapon} back in the {hand} hand",
+    "hud.no_dual": "{weapon} does not go one in each hand",
+    "hud.left": "L",
     "act.shoot.hit": "{weapon}: shot, {energy} J, hit {where} at {dist} m",
     "act.shoot.miss": "{weapon}: shot, {energy} J, hit nothing",
     "act.shoot.pellets": "{weapon}: shot, {n} projectiles of up to {energy} J, {hits} hit {where} at {dist} m",
@@ -3563,6 +3664,7 @@ var en = {
     "hud.no_charges": "No charge set down waits for the remote detonator",
     "blast.zone.lethal": "lethal",
     "blast.zone.injury": "injury",
+    "act.smoke": "{weapon}: smoke, burning for {seconds} s",
     "act.explode": "{weapon}: exploded, {energy} J within {radius} m, {n} objects in range",
     "act.molotov_fire": "{weapon}: fire on the ground, radius {radius} m for {seconds} s",
     "act.tool.none": "{weapon}: nothing in reach",
@@ -3701,6 +3803,7 @@ var en = {
     "ui.clear_log": "Clear",
     "ui.catalog": "Catalogue",
     "ui.tool_menu": "Weapons",
+    "ui.tool_menu.dual": "Shift+click: one in each hand",
     "ui.tool_menu.search": "Search weapons and tools",
     "ui.tool_menu.close": "Close",
     "ui.tool_menu.results": "{n} found",
@@ -3904,6 +4007,12 @@ var ptBR = {
     "act.clear": "Limpou a sala",
     "act.reset": "Consertou todos os objetos",
     "act.tool": "Equipou {weapon}",
+    "act.tool_left": "{weapon} na m\xE3o esquerda: bot\xE3o esquerdo dispara a da direita, bot\xE3o direito a da esquerda",
+    "act.tool_left_off": "M\xE3o esquerda livre: uma arma de novo",
+    "act.stow": "{weapon} encostada no corpo: a m\xE3o {hand} fica livre para o outro carregador",
+    "act.unstow": "{weapon} de volta na m\xE3o {hand}",
+    "hud.no_dual": "{weapon} n\xE3o vai uma em cada m\xE3o",
+    "hud.left": "E",
     "act.shoot.hit": "{weapon}: disparo, {energy} J, acertou {where} a {dist} m",
     "act.shoot.miss": "{weapon}: disparo, {energy} J, n\xE3o acertou nada",
     "act.shoot.pellets": "{weapon}: disparo, {n} proj\xE9teis de at\xE9 {energy} J, {hits} acertaram {where} a {dist} m",
@@ -3933,6 +4042,7 @@ var ptBR = {
     "hud.no_charges": "Nenhuma carga posta espera o detonador",
     "blast.zone.lethal": "letal",
     "blast.zone.injury": "de ferimento",
+    "act.smoke": "{weapon}: fuma\xE7a, queima por {seconds} s",
     "act.explode": "{weapon}: explodiu, {energy} J em {radius} m, {n} objetos ao alcance",
     "act.molotov_fire": "{weapon}: fogo no ch\xE3o, raio de {radius} m por {seconds} s",
     "act.tool.none": "{weapon}: nada ao alcance",
@@ -4071,6 +4181,7 @@ var ptBR = {
     "ui.clear_log": "Limpar",
     "ui.catalog": "Cat\xE1logo",
     "ui.tool_menu": "Armas",
+    "ui.tool_menu.dual": "Shift+clique: uma em cada m\xE3o",
     "ui.tool_menu.search": "Buscar armas e ferramentas",
     "ui.tool_menu.close": "Fechar",
     "ui.tool_menu.results": "{n} encontradas",
@@ -4279,6 +4390,27 @@ function createBenchPanel(o) {
     return wrap;
   };
   let playhead = null;
+  const sheetImage = (image) => {
+    const figure = mk("figure", "tr-sheet-image");
+    const picture = mk("img");
+    picture.src = image.url;
+    picture.alt = image.alt;
+    picture.loading = "lazy";
+    picture.referrerPolicy = "no-referrer";
+    figure.appendChild(picture);
+    if (image.credit || image.page) {
+      const caption = mk("figcaption", "sub", image.credit ?? "");
+      if (image.page) {
+        const link = mk("a", void 0, image.credit ? " \u2197" : image.page);
+        link.href = image.page;
+        link.target = "_blank";
+        link.rel = "noopener noreferrer";
+        caption.appendChild(link);
+      }
+      figure.appendChild(caption);
+    }
+    return figure;
+  };
   const sheetCard = (sheet) => {
     const card = mk("div", "tr-sheet");
     if (sheet.kicker) card.appendChild(mk("div", "sub", sheet.kicker));
@@ -4330,6 +4462,7 @@ function createBenchPanel(o) {
       playhead = { node: head, metric, end };
       card.appendChild(strip);
     }
+    if (sheet.image) card.appendChild(sheetImage(sheet.image));
     if (sheet.note) card.appendChild(mk("p", "sub", sheet.note));
     return card;
   };
@@ -4563,7 +4696,7 @@ function createToolMenu(o) {
   const close = mk3("button", "tr-btn", "\xD7");
   close.type = "button";
   close.title = o.t("ui.tool_menu.close");
-  header.append(mk3("h3", void 0, o.t("ui.tool_menu")), search, close);
+  header.append(mk3("h3", void 0, o.t("ui.tool_menu")), mk3("small", "tr-hint", o.t("ui.tool_menu.dual")), search, close);
   const tabs = mk3("div", "tr-tabs");
   const body = mk3("div", "tr-wmenu-body");
   element.append(header, tabs, body);
@@ -4571,15 +4704,17 @@ function createToolMenu(o) {
   let activeGroup = "";
   let groups = [];
   const toolButton = (tool, group) => {
-    const button = mk3("button", tool.id === o.current() ? "tr-btn on" : "tr-btn");
+    const left = o.currentLeft?.() === tool.id;
+    const button = mk3("button", tool.id === o.current() || left ? "tr-btn on" : "tr-btn");
     button.type = "button";
     button.title = tool.name;
+    if (left) button.dataset.left = "";
     button.dataset.tool = tool.id;
     if (tool.thumbnail) button.appendChild(o.thumb(tool.thumbnail, tool.thumbnailCredit));
     button.appendChild(mk3("span", void 0, tool.name));
     if (group) button.appendChild(mk3("small", void 0, group));
-    button.onclick = () => {
-      o.onPick(tool.id);
+    button.onclick = (event) => {
+      o.onPick(tool.id, { second: event.shiftKey });
       toggle(false);
     };
     return button;
@@ -4675,6 +4810,8 @@ var CSS = `
 .tr-prog b{display:block;font-weight:500;margin-bottom:3px}
 .tr-sheet{margin-top:8px;padding:8px;border:1px solid #2a2e36;border-radius:6px;font-size:12px;line-height:1.4}
 .tr-sheet h4{margin:2px 0 4px;font-size:13px}.tr-sheet p{margin:4px 0}
+/* the picture of a sheet floats over the scene, top centre, next to what it shows: the bench panel is too short to hold it */
+.tr-sheet-image{position:fixed;top:52px;left:50%;transform:translateX(-50%);width:min(400px,42vw);z-index:5;margin:0;padding:6px;background:rgba(18,20,24,.92);border:1px solid #2a2e36;border-radius:6px;pointer-events:auto}.tr-sheet-image img{display:block;width:100%;max-height:200px;object-fit:contain;background:#f4f4f2;border-radius:4px}.tr-sheet-image figcaption{margin-top:3px;font-size:11px}.tr-sheet-image a{color:#8ab4f8}
 .tr-facts{display:grid;grid-template-columns:auto 1fr;gap:2px 8px;margin:4px 0}.tr-facts dt{opacity:.7}.tr-facts dd{margin:0}
 .tr-steps{margin:4px 0;padding-left:16px}.tr-swatches{display:flex;flex-wrap:wrap;gap:6px}.tr-swatch i{display:inline-block;width:10px;height:10px;border-radius:50%;margin-right:4px}
 .tr-timeline{position:relative;height:22px;margin:8px 0;background:#1b1e24;border-radius:4px;overflow:hidden}
@@ -4802,7 +4939,7 @@ function createUi(o) {
   bottom.append(held, hotbar);
   let currentTool = "";
   const menuOptions = o.toolMenu;
-  const toolMenu = menuOptions ? createToolMenu({ t, groups: menuOptions.groups, current: () => currentTool, onPick: menuOptions.onPick, ...menuOptions.onOpen ? { onOpen: menuOptions.onOpen } : {}, thumb }) : null;
+  const toolMenu = menuOptions ? createToolMenu({ t, groups: menuOptions.groups, current: () => currentTool, onPick: menuOptions.onPick, ...menuOptions.onOpen ? { onOpen: menuOptions.onOpen } : {}, ...menuOptions.currentLeft ? { currentLeft: menuOptions.currentLeft } : {}, thumb }) : null;
   if (toolMenu && menuOptions) {
     const menuButton = mk4("button", "tr-slot tr-menu-btn");
     menuButton.type = "button";
@@ -5450,6 +5587,8 @@ function createModuleViews(THREE, gl) {
 
 // src/room.ts
 var FIXED_DT = 1 / 60;
+var LEFT_HAND_KEY = "#L";
+var OFF_HAND_SEED = 11;
 var TOOL_MENU_KEY_LABELS = { Backquote: "'" };
 var EXPLOSIVE_EFFECT_IDS = ["m67", "molotov", "pipe_bomb", "m79_40mm", "m72_66mm", "at4_84mm", "dynamite", "c4", "claymore"];
 var DEFAULT_PARTICLE_LIMIT = 900;
@@ -5745,6 +5884,11 @@ function createTestRoom(options) {
     return s;
   };
   let tool = toolState(toolId);
+  let offToolId = null;
+  let offTool = null;
+  let offHeld = false;
+  let offFirst = false;
+  let firedHand = "R";
   const catalogMap = /* @__PURE__ */ new Map();
   for (const i of options.catalog) catalogMap.set(i.id, i);
   const catalog = [...options.catalog];
@@ -5954,9 +6098,19 @@ function createTestRoom(options) {
         releaseTrigger();
       },
       secondary: () => {
+        if (offTool && !heldEntry) {
+          offHeld = true;
+          offFirst = true;
+          return;
+        }
         if (heldEntry) throwHeld();
         else grab();
       },
+      secondaryUp: () => {
+        if (!offHeld) return;
+        offHeld = false;
+        releaseTrigger("L");
+      },
       key: (code, down, e) => onKey(code, down, e),
       wheel: (dir) => cycleTool(dir)
     }
@@ -6495,6 +6649,10 @@ function createTestRoom(options) {
     for (const listener of [...resetListeners]) listener();
     tools.clear();
     tool = toolState(toolId);
+    dualReload.cancel();
+    offTool = null;
+    offToolId = null;
+    firedHand = "R";
     if (pristineWorld) {
       for (const id of world.ids()) world.remove(id);
       world.load(pristineWorld);
@@ -6760,12 +6918,13 @@ function createTestRoom(options) {
   const pocketAt = new THREE.Vector3();
   const aimTurn = new THREE.Quaternion();
   const aimEuler = new THREE.Euler(0, 0, 0, "YXZ");
-  const bodyHoldFrame = () => {
-    const shoulder = avatar?.shoulder?.("R");
+  const bodyHoldFrame = (hand = "R") => {
+    const shoulder = avatar?.shoulder?.(hand);
     if (!shoulder) return null;
     shoulder.getWorldPosition(pocketAt);
-    pocketAt.x -= Math.cos(player.yaw) * SHOULDER_POCKET_IN;
-    pocketAt.z += Math.sin(player.yaw) * SHOULDER_POCKET_IN;
+    const inward = hand === "L" ? -SHOULDER_POCKET_IN : SHOULDER_POCKET_IN;
+    pocketAt.x -= Math.cos(player.yaw) * inward;
+    pocketAt.z += Math.sin(player.yaw) * inward;
     aimTurn.setFromEuler(aimEuler.set(player.pitch, player.yaw, 0, "YXZ"));
     return { position: [pocketAt.x, pocketAt.y, pocketAt.z], quaternion: [aimTurn.x, aimTurn.y, aimTurn.z, aimTurn.w] };
   };
@@ -6875,17 +7034,18 @@ function createTestRoom(options) {
     rng = rng * 1664525 + 1013904223 >>> 0;
     return rng / 4294967296;
   };
-  const muzzlePose = () => {
-    const lent = muzzleSource?.();
-    return lent ? { position: [...lent.position], drawsFlash: lent.drawsFlash } : { position: muzzle(), drawsFlash: false };
+  const muzzlePose = (hand = "R") => {
+    const lent = muzzleSource?.(hand);
+    return lent ? { position: [...lent.position], drawsFlash: lent.drawsFlash } : { position: muzzle(hand), drawsFlash: false };
   };
-  const muzzle = () => {
+  const muzzle = (hand = "R") => {
     aim();
     const e = camera.matrixWorld.elements;
+    const side = hand === "L" ? -0.16 : 0.16;
     return [
-      aimO[0] + aimD[0] * 0.45 + e[0] * 0.16 - e[4] * 0.1,
-      aimO[1] + aimD[1] * 0.45 + e[1] * 0.16 - e[5] * 0.1,
-      aimO[2] + aimD[2] * 0.45 + e[2] * 0.16 - e[6] * 0.1
+      aimO[0] + aimD[0] * 0.45 + e[0] * side - e[4] * 0.1,
+      aimO[1] + aimD[1] * 0.45 + e[1] * side - e[5] * 0.1,
+      aimO[2] + aimD[2] * 0.45 + e[2] * side - e[6] * 0.1
     ];
   };
   const tracers = [];
@@ -7065,10 +7225,10 @@ function createTestRoom(options) {
       renderer.impulse(objectId, push2.impulse, push2.point);
     }
   };
-  const fireShots = (shots, recoil) => {
+  const fireShots = (shots, recoil, id = toolId, hand = "R") => {
     if (shots.length === 0) return;
-    const w = toolName();
-    const { position: m, drawsFlash } = muzzlePose();
+    const w = toolName(id);
+    const { position: m, drawsFlash } = muzzlePose(hand);
     if (!drawsFlash) {
       renderer.emit("flash", m, [aimD[0], aimD[1], aimD[2]], 1, 0);
       renderer.emit("sparks", m, [aimD[0], aimD[1], aimD[2]], 4, 6);
@@ -7107,7 +7267,7 @@ function createTestRoom(options) {
       objectId: f?.object,
       itemId: f ? entryOf(f.object)?.so.itemId : void 0,
       part: f?.part,
-      data: { weapon: toolId, shots: shots.length, hits, energyJ: Math.round(energy), caliberMm: shots[0].caliber, distanceM: f ? Math.round(f.distance * 100) / 100 : null }
+      data: { weapon: id, shots: shots.length, hits, energyJ: Math.round(energy), caliberMm: shots[0].caliber, distanceM: f ? Math.round(f.distance * 100) / 100 : null, ...hand === "L" ? { hand } : {} }
     });
   };
   const fireRays = (u) => {
@@ -7211,7 +7371,7 @@ function createTestRoom(options) {
   const kickLeg = options.kickLeg ?? "alternate";
   let nextLeg = "right";
   const punchHand = options.punchHand ?? "alternate";
-  const punchTools = new Set(options.punchTools ?? ["hand", "fists"]);
+  const punchTools = new Set(options.punchTools ?? ["hand", "fists", "brass_knuckles"]);
   let nextHand = "right";
   const combo = options.strikeCombo;
   let comboOn = !!combo && options.strikeComboOn === true;
@@ -7225,16 +7385,16 @@ function createTestRoom(options) {
     action("combo", t(on ? "act.combo.on" : "act.combo.off", { name }), { data: { combo: combo.id, on } });
     say(t(on ? "act.combo.on" : "act.combo.off", { name }));
   };
-  const strikeUse = (u, id = toolId) => {
+  const strikeUse = (u, id = toolId, side) => {
     const stepIndex = comboOn && combo?.tools.includes(id) && combo.steps.length > 0 ? simTime - comboAt > combo.reset ? 0 : comboNext : null;
     const step2 = stepIndex === null ? void 0 : combo.steps[stepIndex];
     const clip = step2 ? step2.clip : strikeClips[id];
     const leg = id === "kick" ? kickLeg === "alternate" ? nextLeg : kickLeg : void 0;
-    const hand = step2 ? step2.hand : punchTools.has(id) ? punchHand === "alternate" ? nextHand : punchHand : void 0;
-    const side = leg ? { leg } : hand ? { hand } : void 0;
-    const seconds = clip === void 0 ? null : avatar?.strike?.(clip, side) ?? null;
+    const hand = side ? side.hand : step2 ? step2.hand : punchTools.has(id) ? punchHand === "alternate" ? nextHand : punchHand : void 0;
+    const limb = leg ? { leg } : hand ? { hand } : void 0;
+    const seconds = clip === void 0 ? null : avatar?.strike?.(clip, limb) ?? null;
     if (leg && seconds !== null && kickLeg === "alternate") nextLeg = leg === "right" ? "left" : "right";
-    if (!step2 && hand && seconds !== null && punchHand === "alternate") nextHand = hand === "right" ? "left" : "right";
+    if (!step2 && !side && hand && seconds !== null && punchHand === "alternate") nextHand = hand === "right" ? "left" : "right";
     if (step2 && stepIndex !== null) {
       comboNext = (stepIndex + 1) % combo.steps.length;
       comboAt = simTime;
@@ -7255,7 +7415,7 @@ function createTestRoom(options) {
       data: { weapon: id, clip, impactIn: seconds, ...leg ? { leg } : {}, ...hand ? { hand } : {}, ...step2 ? { combo: combo.id, step: stepIndex } : {} }
     });
     strikes.push({
-      key: id,
+      key: side?.key ?? id,
       remaining: seconds,
       ...swing && seconds > lead ? { swing, lead } : {},
       land: () => {
@@ -7385,20 +7545,50 @@ function createTestRoom(options) {
     say,
     projectileModel: options.projectileModel
   });
-  const useTool = (dt, held) => {
+  const toolOf = (hand) => hand === "L" ? offTool && offToolId ? { id: offToolId, state: offTool } : null : { id: toolId, state: tool };
+  const dualReload = createDualReload(
+    {
+      needs: (hand) => {
+        const state = toolOf(hand)?.state;
+        return state !== void 0 && (state.def.action.kind === "firearm" || state.def.action.kind === "launcher") && state.ammo < state.capacity && state.reserve > 0;
+      },
+      startReload: (hand) => startReload(hand),
+      reloading: (hand) => toolOf(hand)?.state.reloading ?? false,
+      stow: (hand, on, seconds) => {
+        const slot2 = toolOf(hand);
+        if (!slot2) return;
+        if (on) slot2.state.release();
+        emitHost({ type: "stow", weapon: slot2.id, on, duration: seconds, ...hand === "L" ? { hand } : {} });
+        action("stow", t(on ? "act.stow" : "act.unstow", { weapon: toolName(slot2.id), hand: t(hand === "L" ? "hand.left" : "hand.right") }), { data: { weapon: slot2.id, hand, on, seconds } });
+      }
+    },
+    () => arsenal.rules.dualWield.stowSeconds
+  );
+  const strikeKeyOf = (id, hand) => hand === "L" ? `${id}${LEFT_HAND_KEY}` : id;
+  const useTool = (dt, held, hand = "R") => {
     aim();
-    const cat = tool.def.category;
+    const slot2 = toolOf(hand);
+    if (!slot2) return "cooldown";
+    const { id, state } = slot2;
+    if (offTool && dualReload.busy) {
+      if (!held) say(t("hud.reloading"));
+      return "reloading";
+    }
+    const cat = state.def.category;
     if (cat === "hand") {
       if (strikes.some((strike) => strike.key === "hand" || strike.key === "fists")) return "cooldown";
       strikeUse({ kind: "melee", damage: "blunt", energy: 25, radius: 0.1, reach: 0.8, origin: [aimO[0], aimO[1], aimO[2]], direction: [aimD[0], aimD[1], aimD[2]] }, "hand");
       return "ok";
     }
-    if (strikes.some((strike) => strike.key === toolId)) return "cooldown";
-    const res = tool.trigger([aimO[0], aimO[1], aimO[2]], [aimD[0], aimD[1], aimD[2]], dt, held, "player");
-    flushEvents(toolId, tool, res.recoil);
+    if (strikes.some((strike) => strike.key === strikeKeyOf(id, hand))) return "cooldown";
+    const res = state.trigger([aimO[0], aimO[1], aimO[2]], [aimD[0], aimD[1], aimD[2]], dt, held, "player");
+    flushEvents(id, state, res.recoil, hand);
     if (res.status === "empty") {
-      if (!tool.reloading && tool.reserve > 0) startReload();
-      say(t(tool.reloading ? "hud.reloading" : "hud.empty"));
+      if (!state.reloading && state.reserve > 0) {
+        if (offTool) dualReload.start([hand, hand === "R" ? "L" : "R"]);
+        else startReload(hand);
+      }
+      say(t(state.reloading ? "hud.reloading" : "hud.empty"));
       return res.status;
     }
     if (res.status !== "ok") {
@@ -7408,15 +7598,18 @@ function createTestRoom(options) {
       else if (res.status === "safe") say(t("hud.safe"));
       return res.status;
     }
-    applyUses(res, dt);
+    firedHand = hand;
+    applyUses(res, dt, hand);
     return res.status;
   };
-  const applyUses = (res, dt) => {
-    if (res.shots.length) fireShots(res.shots, res.recoil);
+  const applyUses = (res, dt, hand = "R") => {
+    const id = toolOf(hand)?.id ?? toolId;
+    if (res.shots.length) fireShots(res.shots, res.recoil, id, hand);
     for (const u of res.uses) {
       switch (u.kind) {
         case "melee":
-          strikeUse(u);
+          if (hand === "L") strikeUse(u, id, { hand: "left", key: strikeKeyOf(id, hand) });
+          else strikeUse(u);
           break;
         case "flame":
           heatRays(u, "fire");
@@ -7444,15 +7637,17 @@ function createTestRoom(options) {
       }
     }
   };
-  const releaseTrigger = () => {
-    if (!tool.cooking) {
-      tool.release();
+  const releaseTrigger = (hand = "R") => {
+    const slot2 = toolOf(hand);
+    if (!slot2) return;
+    if (!slot2.state.cooking) {
+      slot2.state.release();
       return;
     }
     aim();
-    const res = tool.release([aimO[0], aimO[1], aimO[2]], [aimD[0], aimD[1], aimD[2]]);
-    flushEvents(toolId, tool);
-    if (res) applyUses(res, 0);
+    const res = slot2.state.release([aimO[0], aimO[1], aimO[2]], [aimD[0], aimD[1], aimD[2]]);
+    flushEvents(slot2.id, slot2.state, void 0, hand);
+    if (res) applyUses(res, 0, hand);
   };
   const kick = () => {
     if (!arsenal.weapons.has("kick") || strikes.some((strike) => strike.key === "kick")) return false;
@@ -7481,8 +7676,43 @@ function createTestRoom(options) {
     }));
   };
   const toggleToolMenu = (open) => ui?.toolMenu(open) ?? false;
+  const dropOffTool = () => {
+    if (!offTool) return;
+    releaseTrigger("L");
+    offTool = null;
+    offToolId = null;
+    offHeld = false;
+    offFirst = false;
+    dualReload.cancel();
+    firedHand = "R";
+    tool.setStance({ dualWield: false });
+    action("tool_left", t("act.tool_left_off"), { data: { hand: "L" } });
+    emitHost({ type: "tool", weapon: "", hand: "L" });
+  };
+  const setOffTool = (id) => {
+    if (id === null) {
+      dropOffTool();
+      return true;
+    }
+    if (!arsenal.weapons.has(id)) throw new Error(`game-test-room: unknown weapon "${id}"`);
+    if (!canDualWield(arsenal, id) || !canDualWield(arsenal, toolId)) return false;
+    if (offTool) releaseTrigger("L");
+    const state = arsenal.create(id, { seed: OFF_HAND_SEED, reserve: 999, ...toolSettings });
+    state.setFuseLength(fuseLength);
+    state.refill();
+    state.setStance({ dualWield: true });
+    tool.setStance({ dualWield: true });
+    offTool = state;
+    offToolId = id;
+    dualReload.cancel();
+    action("tool_left", t("act.tool_left", { weapon: toolName(id) }), { data: { weapon: id, hand: "L" } });
+    state.draw();
+    flushEvents(id, state, void 0, "L");
+    return true;
+  };
   const setTool = (id) => {
     if (!arsenal.weapons.has(id)) throw new Error(`game-test-room: unknown weapon "${id}"`);
+    dropOffTool();
     releaseTrigger();
     toolId = id;
     const i = loadout.indexOf(id);
@@ -7975,15 +8205,13 @@ function createTestRoom(options) {
       case "KeyR":
         if (heldPiece) heldYaw += Math.PI / 8;
         else {
-          startReload();
+          reloadHands();
           say(t("hud.reloading"));
         }
         break;
-      case "KeyQ": {
-        tool.cycleMode();
-        flushEvents(toolId, tool);
+      case "KeyQ":
+        cycleToolMode();
         break;
-      }
       case "KeyX":
         clearToolFault();
         break;
@@ -8040,6 +8268,20 @@ function createTestRoom(options) {
     if (!loadout.includes(weaponId)) loadout.push(weaponId);
     setTool(weaponId);
   };
+  const pickTool = (weaponId, pick = { second: false }) => {
+    if (!arsenal.weapons.has(weaponId)) return;
+    if (!pick.second) {
+      equip(weaponId);
+      return;
+    }
+    if (!canDualWield(arsenal, weaponId)) {
+      equip(weaponId);
+      say(t("hud.no_dual", { weapon: toolName(weaponId) }));
+      return;
+    }
+    if (!offTool || !canDualWield(arsenal, toolId)) equip(weaponId);
+    setOffTool(weaponId);
+  };
   let hudAimHit;
   const inspectTarget = () => {
     if (hudAimHit !== void 0) return hudAimHit;
@@ -8243,6 +8485,11 @@ function createTestRoom(options) {
       s.update(dt);
       flushEvents(id, s);
     }
+    if (offTool && offToolId) {
+      offTool.update(dt);
+      flushEvents(offToolId, offTool, void 0, "L");
+      dualReload.step(dt);
+    }
     if (audio) {
       const look = camera.getWorldDirection(listenerDirection);
       audio.setListener({ position: [camera.position.x, camera.position.y, camera.position.z], yaw: Math.atan2(-look.x, -look.z) });
@@ -8288,6 +8535,10 @@ function createTestRoom(options) {
       } else if (useHeld) useTool(dt, !useFirst);
       useFirst = false;
     }
+    if ((offHeld || offFirst) && offTool && !isPaused && !push.active) {
+      useTool(dt, !offFirst, "L");
+      offFirst = false;
+    }
     if (!isPaused) followHeld(dt);
   };
   const updatePresent = (dt) => {
@@ -8314,12 +8565,18 @@ function createTestRoom(options) {
       hudAimHit = void 0;
     }
   };
+  const ammoText = (state) => {
+    const kind = state.def.action.kind;
+    if (kind === "firearm") return `${state.ammo}/${state.capacity}${state.reserve ? ` \xB7 ${state.reserve}` : ""}`;
+    return kind === "hand" || kind === "melee" || kind === "tool" ? "" : `${num(state.ammo, 0)}`;
+  };
   const readHudState = () => {
     const page = Math.floor(toolIndex / 10);
     const slots = loadout.slice(page * 10, page * 10 + 10).map((id) => arsenal.name(id));
-    const ammo = tool.def.action.kind === "firearm" ? `${tool.ammo}/${tool.capacity}${tool.reserve ? ` \xB7 ${tool.reserve}` : ""}` : tool.def.action.kind === "hand" ? "" : tool.def.action.kind === "melee" || tool.def.action.kind === "tool" ? "" : `${num(tool.ammo, 0)}`;
+    const left = offTool ? ammoText(offTool) : "";
+    const ammo = `${ammoText(tool)}${left ? ` | ${t("hud.left")} ${left}` : ""}`;
     return {
-      toolName: toolName(),
+      toolName: offToolId ? `${toolName()} + ${toolName(offToolId)}` : toolName(),
       toolId,
       ammo,
       slots,
@@ -8509,26 +8766,53 @@ function createTestRoom(options) {
     if (event.type === "explosion") knockPlayer(event);
     for (const listener of hostListeners) listener(event);
   }
-  function flushEvents(id, state, recoil) {
+  function flushEvents(id, state, recoil, hand = "R") {
     const phase = state.phase;
     for (const event of state.drain()) {
       const hostEvent = toHostEvent(id, event, { ...recoil ? { recoil } : {}, phase });
-      if (hostEvent) emitHost(hostEvent);
+      if (hostEvent) emitHost(hand === "L" ? { ...hostEvent, hand } : hostEvent);
     }
   }
-  function startReload() {
-    tool.reload();
-    flushEvents(toolId, tool);
+  function startReload(hand = "R") {
+    const slot2 = toolOf(hand);
+    if (!slot2) return false;
+    const started = slot2.state.reload();
+    flushEvents(slot2.id, slot2.state, void 0, hand);
+    return started;
+  }
+  function reloadHands() {
+    if (!offTool) {
+      startReload();
+      return;
+    }
+    dualReload.start(["R", "L"]);
   }
+  const commandHand = () => offTool ? firedHand : "R";
   function clearToolFault() {
-    if (!tool.clearFault()) return;
-    flushEvents(toolId, tool);
-    say(t("hud.clearing"));
+    const order = offTool ? [firedHand, firedHand === "R" ? "L" : "R"] : ["R"];
+    for (const hand of order) {
+      const slot2 = toolOf(hand);
+      if (!slot2?.state.fault || !slot2.state.clearFault()) continue;
+      flushEvents(slot2.id, slot2.state, void 0, hand);
+      say(t("hud.clearing"));
+      return;
+    }
   }
   function toggleSafety() {
-    tool.setSafety(!tool.safety);
-    flushEvents(toolId, tool);
-    say(t(tool.safety ? "hud.safety_on" : "hud.safety_off"));
+    const hand = commandHand();
+    const slot2 = toolOf(hand);
+    if (!slot2) return;
+    slot2.state.setSafety(!slot2.state.safety);
+    flushEvents(slot2.id, slot2.state, void 0, hand);
+    say(`${t(slot2.state.safety ? "hud.safety_on" : "hud.safety_off")}${offTool ? ` (${toolName(slot2.id)}, ${t(hand === "L" ? "hand.left" : "hand.right")})` : ""}`);
+  }
+  function cycleToolMode() {
+    const hand = commandHand();
+    const slot2 = toolOf(hand);
+    if (!slot2) return;
+    slot2.state.cycleMode();
+    flushEvents(slot2.id, slot2.state, void 0, hand);
+    if (offTool) say(`${toolName(slot2.id)} (${t(hand === "L" ? "hand.left" : "hand.right")}): ${slot2.state.mode}`);
   }
   function runToolCommand(request) {
     const work = (done) => done.ok ? { ok: true, seconds: done.seconds } : { ok: false, reason: done.reason };
@@ -8550,6 +8834,24 @@ function createTestRoom(options) {
         return { ok: false, reason: "unknown" };
     }
   }
+  const hostToolOf = (id, state) => ({
+    weapon: id,
+    category: state.def.category,
+    ammo: state.ammo,
+    capacity: state.capacity,
+    reserve: state.reserve,
+    reloading: state.reloading,
+    mode: state.mode,
+    ...state.fault ? { fault: state.fault } : {},
+    safety: state.safety,
+    heat: state.heatLevel,
+    attachments: state.attachments.map((part) => ({ id: part.id, mount: part.mount, ...part.integral ? { integral: true } : {}, ...part.on === void 0 ? {} : { on: part.on } })),
+    stock: state.stock,
+    suppressed: state.suppressed,
+    underbarrelActive: state.underbarrelActive,
+    mass: state.mass,
+    aimSeconds: state.aimSeconds
+  });
   const host = {
     THREE,
     scene,
@@ -8576,22 +8878,9 @@ function createTestRoom(options) {
     ...options.blastShove ? { blastShove: options.blastShove } : {},
     blastReach: (point, target, ignore) => world.blastReach(point, target, ignore ? { ignore } : {}),
     tool: () => ({
-      weapon: toolId,
-      category: tool.def.category,
-      ammo: tool.ammo,
-      capacity: tool.capacity,
-      reserve: tool.reserve,
-      reloading: tool.reloading,
-      mode: tool.mode,
-      ...tool.fault ? { fault: tool.fault } : {},
-      safety: tool.safety,
-      heat: tool.heatLevel,
-      attachments: tool.attachments.map((part) => ({ id: part.id, mount: part.mount, ...part.integral ? { integral: true } : {}, ...part.on === void 0 ? {} : { on: part.on } })),
-      stock: tool.stock,
-      suppressed: tool.suppressed,
-      underbarrelActive: tool.underbarrelActive,
-      mass: tool.mass,
-      aimSeconds: tool.aimSeconds
+      ...hostToolOf(toolId, tool),
+      ...dualReload.stowed("R") ? { stowed: true } : {},
+      ...offTool && offToolId ? { offHand: { ...hostToolOf(offToolId, offTool), ...dualReload.stowed("L") ? { stowed: true } : {} } } : {}
     }),
     command(request) {
       const result = runToolCommand(request);
@@ -8628,7 +8917,7 @@ function createTestRoom(options) {
     onFrame(update, frameOptions) {
       return scheduler.add((ctx) => update(ctx.dt), { phase: frameOptions?.phase ?? "lateSimulate", order: frameOptions?.order ?? 0, id: `module.frame#${moduleFrameCount++}` });
     },
-    holdFrame: () => bodyHoldFrame(),
+    holdFrame: (hand) => bodyHoldFrame(hand),
     reachFor(reach) {
       if (!avatar) {
         reach.onGrip?.();
@@ -9004,6 +9293,7 @@ function createTestRoom(options) {
     fluids,
     film: filmBridge,
     vfx: vfx.world,
+    effects: vfx,
     fluidRenderer: fluidView,
     audio,
     environment,
@@ -9019,6 +9309,29 @@ function createTestRoom(options) {
     clear,
     resetAll,
     setTool,
+    setOffTool,
+    get offTool() {
+      return offTool;
+    },
+    useOff(hold = 0) {
+      if (!offTool) return "cooldown";
+      const status = useTool(FIXED_DT, false, "L");
+      flush();
+      let t0 = 0;
+      while (t0 < hold) {
+        useTool(FIXED_DT, true, "L");
+        directStep = true;
+        try {
+          runHeadless(() => scheduler.advance(FIXED_DT));
+        } finally {
+          directStep = false;
+        }
+        t0 += FIXED_DT;
+      }
+      releaseTrigger("L");
+      return status;
+    },
+    reload: () => reloadHands(),
     useItem,
     use(hold = 0) {
       if (tool.def.category === "hand") {
@@ -9316,7 +9629,8 @@ function createTestRoom(options) {
       ...options.toolMenu !== false ? {
         toolMenu: {
           groups: toolMenuGroups,
-          onPick: equip,
+          onPick: pickTool,
+          currentLeft: () => offToolId,
           // the list takes clicks: the mouse leaves the view while it is open
           onOpen: (open) => {
             if (open && document.pointerLockElement) document.exitPointerLock?.();