@adatechnology/game-weapons-three 0.15.0 → 0.17.0

package/dist/{chunk-GBO6L7CQ.js → chunk-BDYIF7JD.js}

@@ -1,6 +1,6 @@
 // src/test-area/area.ts
 import { markKitOrigin as markKitOrigin6 } from "@adatechnology/game-contracts";
-import { createArsenal, genericWeapons } from "@adatechnology/game-weapons";
+import { createArsenal, genericWeapons, roundsToWarningOf } from "@adatechnology/game-weapons";
 import { furnitureSpec } from "@adatechnology/game-floorplan-three";
 import { isLightBudget, isRenderPools } from "@adatechnology/game-render-three";
 
@@ -183,6 +183,9 @@ function createAccessoryBench(options) {
     signature = "";
   });
   return {
+    get aimProgress() {
+      return aimProgress;
+    },
     handleChange(change) {
       if (change.kind === "action") return act(change.id);
       if (change.kind === "control" && change.id === SUPPORTED_CONTROL_ID && typeof change.value === "boolean") {
@@ -1413,6 +1416,10 @@ function computeCasingSound(input) {
   const surfaceName = surface === "hard" ? "concreto" : surface === "soft" ? "terra" : surface === "wood" ? "madeira" : "metal";
   return { surface, kind, sample: `casing_drop_${surfaceName}_${kind}`, voices };
 }
+function magazineDropId(material) {
+  const surface = casingSurfaceOf(material);
+  return `mag_drop_${surface === "hard" ? "concreto" : surface === "soft" ? "terra" : surface === "wood" ? "madeira" : "metal"}`;
+}
 
 // src/audio/flyby.ts
 function computeFlyby(input) {
@@ -2217,7 +2224,7 @@ var CUES_IN_SAMPLE = { mag_release: "mag_out", mag_insert: "mag_seat" };
 var isGunshot = (id) => GUNSHOT_SAMPLE_IDS.includes(id);
 function weaponSampleDefaults(sound3, overrides = {}) {
   if (sound3.category !== "armas") return void 0;
-  const base = sound3.id.startsWith("suppressed_") ? SUPPRESSED_SAMPLE : isGunshot(sound3.id) ? GUNSHOT_SAMPLE : sound3.id.startsWith("casing_drop_") ? CASING_SAMPLE : RELOAD_SAMPLE;
+  const base = sound3.id.startsWith("suppressed_") ? SUPPRESSED_SAMPLE : isGunshot(sound3.id) ? GUNSHOT_SAMPLE : sound3.id.startsWith("casing_drop_") || sound3.id.startsWith("mag_drop_") ? CASING_SAMPLE : RELOAD_SAMPLE;
   return { ...base, ...overrides[sound3.id] };
 }
 function weaponSampleBank(options) {
@@ -2268,6 +2275,8 @@ function createWeaponAudio(volume = 0.6, options = {}) {
     void loadSamples();
     return false;
   };
+  const fittedReady = (id) => sampleIds.has(id) && engine.registry.sound(id) === void 0 && engine.registry.set(id) !== void 0;
+  const hostReady = (id) => sampleReady(id) || engine.registry.sound(id) === void 0 && engine.registry.set(id) !== void 0;
   const burst = (config) => {
     const id = config.filter === "highpass" ? BURST_IDS.highpass : BURST_IDS.lowpass;
     const params = { frequency: config.frequency, q: config.q ?? 0.8, gain: Math.max(config.gain, 2e-4), seconds: config.seconds };
@@ -2322,6 +2331,11 @@ function createWeaponAudio(volume = 0.6, options = {}) {
       options.onCasing?.(sound3, "sample");
       return;
     }
+    if (recorded && fittedReady(recorded)) {
+      if ((input.bounce ?? 0) === 0) channel.play(recorded, { volume: Math.min(1, Math.max(0.2, (input.speed ?? 1.5) / 2.5)) });
+      options.onCasing?.(sound3, "fitted");
+      return;
+    }
     for (const voice of sound3.voices) playCasingVoice(voice);
     options.onCasing?.(sound3, "synth");
   };
@@ -2346,7 +2360,9 @@ function createWeaponAudio(volume = 0.6, options = {}) {
         const pitch = 1 + (channel.random() * 2 - 1) * pitchSpread;
         const shot = computeGunshot({ ...base, take, pitch }, options.gunshot);
         const recorded = shot.samples.close;
-        if (shot.audible && sampleReady(recorded)) {
+        const sample = shot.audible && sampleReady(recorded);
+        const fitted = shot.audible && !sample && fittedReady(recorded);
+        if (sample || fitted) {
           const occlusion = Math.min(1, Math.max(0, extras.occlusion ?? 0));
           const handle = channel.play(recorded, {
             volume: (extras.volume ?? 1) * (1 - 0.5 * occlusion),
@@ -2359,7 +2375,7 @@ function createWeaponAudio(volume = 0.6, options = {}) {
             for (const voice of shot.voices) if (voice.group === "tail") playGunshotVoice(voice, extras);
           }
           const layers = handle?.kind === "sample" ? handle.plan.layers.map((layer) => ({ role: layer.role, take: layer.take, rate: layer.rate })) : [];
-          options.onGunshot?.(shot, { ...base, take, pitch }, { kind: "sample", id: recorded, layers });
+          options.onGunshot?.(shot, { ...base, take, pitch }, fitted ? { kind: "fitted", id: recorded } : { kind: "sample", id: recorded, layers });
           return;
         }
         for (const voice of shot.voices) playGunshotVoice(voice, extras);
@@ -2380,10 +2396,11 @@ function createWeaponAudio(volume = 0.6, options = {}) {
     mechanical,
     cue(id, profile, lead = 0) {
       const carriedBy = CUES_IN_SAMPLE[id];
-      if (carriedBy && sampleReady(carriedBy)) return "carried";
-      if (sampleReady(id)) {
+      if (carriedBy && (sampleReady(carriedBy) || fittedReady(carriedBy))) return "carried";
+      const recorded = sampleReady(id);
+      if (recorded || fittedReady(id)) {
         channel.play(id, { intensity: WEIGHT_INTENSITY[(profile ?? DEFAULT_SOUND_PROFILE).weight] });
-        return "sample";
+        return recorded ? "sample" : "fitted";
       }
       for (const entry of reloadCueSteps(id, profile, cueTable)) step(lead > 0 ? { ...entry, at: entry.at + lead } : entry);
       return "synth";
@@ -2410,7 +2427,12 @@ function createWeaponAudio(volume = 0.6, options = {}) {
     casing,
     flyby(input) {
       const sound3 = computeFlyby({ ...input, pitch: input.pitch ?? 1 + (channel.random() * 2 - 1) * 0.05 });
-      for (const voice of sound3?.voices ?? []) playCasingVoice(voice, input.position);
+      if (!sound3) return;
+      if (hostReady(sound3.sample)) {
+        channel.play(sound3.sample, { volume: Math.min(1, 1 / (1 + input.miss / 1.5)), ...input.position ? { position: [input.position[0], input.position[1], input.position[2]] } : {} });
+        return;
+      }
+      for (const voice of sound3.voices) playCasingVoice(voice, input.position);
     },
     clink() {
       if (options.shotModel !== "game") {
@@ -2421,8 +2443,13 @@ function createWeaponAudio(volume = 0.6, options = {}) {
       const at = 0.25 + channel.random() * 0.2;
       sceneTone({ layer: "scene_tone", at, wave: "sine", f, f2: 3800, d: 0.06, vol: 0.06 });
     },
-    thud() {
-      burst({ seconds: 0.09, gain: 0.35, filter: "lowpass", frequency: 380 });
+    thud(input = {}) {
+      const id = magazineDropId(input.surface);
+      if (hostReady(id)) {
+        if ((input.bounce ?? 0) === 0) channel.play(id, { volume: Math.min(1, Math.max(0.2, (input.speed ?? 1.5) / 2.5)) });
+        return;
+      }
+      burst({ seconds: 0.09, gain: 0.35 * (input.speed === void 0 ? 1 : Math.min(1, Math.max(0.3, input.speed / 2.5))) * ((input.bounce ?? 0) === 0 ? 1 : 0.5), filter: "lowpass", frequency: 380 });
     },
     setVolume(next) {
       const level = Math.max(0, Math.min(1, next));
@@ -2436,6 +2463,7 @@ function createWeaponAudio(volume = 0.6, options = {}) {
 }
 
 // src/box-fx.ts
+import { FIRST_PERSON_LAYER } from "@adatechnology/game-contracts";
 import { createRng, muzzleEnergy as muzzleEnergy3 } from "@adatechnology/game-weapons";
 
 // src/fx/layers.ts
@@ -2497,6 +2525,8 @@ var BODY_HOLD = {
   shoulderGripTo: 0.34,
   /** The farthest apart two hands hold a long gun (a support hand past it slides back along the gun, toward the grip). */
   supportSpan: 0.5,
+  /** A gun carried at the hip (`carry: 'hip'`): its rear grip low at the right hip, a little ahead of it. */
+  hipGrip: [0.25, -0.5, -0.24],
   /** How much of the aim's pitch a tool held low in one hand follows. */
   toolPitch: 0.5
 };
@@ -2508,6 +2538,7 @@ var placeOnBody = (placement) => {
   holder.scale.setScalar(1);
   hand.position.set(...frame.position);
   hand.quaternion.set(...frame.quaternion);
+  if (placement.hip) return placeAtHip(placement);
   const shouldered = !placement.handgun && placement.left !== null && placement.lengthMetres >= BODY_HOLD.shoulderedFrom;
   if (shouldered) {
     holder.position.set(0, BODY_HOLD.boreAbove, placement.rear);
@@ -2531,6 +2562,21 @@ var placeOnBody = (placement) => {
   hand.position.add(want.sub(now));
   hand.updateMatrixWorld(true);
 };
+var placeAtHip = (placement) => {
+  const { THREE, hand, holder } = placement;
+  scratch.a ?? (scratch.a = new THREE.Vector3());
+  scratch.b ?? (scratch.b = new THREE.Vector3());
+  scratch.euler ?? (scratch.euler = new THREE.Euler());
+  const turn2 = scratch.euler.setFromQuaternion(hand.quaternion, "YXZ");
+  hand.quaternion.setFromEuler(turn2.set(turn2.x * BODY_HOLD.toolPitch, turn2.y, 0, "YXZ"));
+  holder.position.set(0, 0, 0);
+  hand.updateMatrixWorld(true);
+  if (!placement.right) return;
+  const want = scratch.a.set(...BODY_HOLD.hipGrip).applyQuaternion(hand.quaternion).add(hand.position);
+  const now = placement.right.part.localToWorld(scratch.b.copy(placement.right.offset));
+  hand.position.add(want.sub(now));
+  hand.updateMatrixWorld(true);
+};
 var limitSupportSpan = (targets) => {
   const right = targets.R?.position;
   const left = targets.L?.position;
@@ -2554,6 +2600,57 @@ var createEyeFrame = (THREE, camera) => {
   };
 };
 
+// src/fx/view-hold.ts
+var VIEW_HOLD = {
+  long: { grip: [0.2, -0.28, -0.38], fov: 84, sights: { distance: 0.34, fromRear: 0.3 } },
+  handgun: { grip: [0.13, -0.15, -0.33], fov: 76, sights: { distance: 0.42, fromRear: 0.02 } },
+  launcher: { grip: [0.2, -0.14, -0.3], fov: 84, sights: { distance: 0.18, fromRear: 0.25 } },
+  tool: { grip: [0.21, -0.31, -0.36], fov: 84, sights: { distance: 0.3, fromRear: 0.1 }, tilt: 0.3 },
+  // the gun at the hip, its rear grip low and to the right, the barrels ahead of the body; it has no sights to bring to the eye
+  hip: { grip: [0.44, -0.32, -0.42], fov: 84, sights: { distance: 0.6, fromRear: 0.1 } }
+};
+var NO_GRIP_REAR = [0.2, -0.24, -0.12];
+var SIGHT_UNDER_EYE = 0.02;
+var scratch2 = { grip: null, hip: null, aimed: null, tilt: null };
+var ease = (k) => k * k * (3 - 2 * k);
+function placeInView(placement) {
+  const { THREE, hand, holder, camera, right, box: box2, kind } = placement;
+  const hold = VIEW_HOLD[kind];
+  holder.scale.setScalar(1);
+  hand.position.copy(camera.position);
+  hand.quaternion.copy(camera.quaternion);
+  if (hold.tilt) {
+    scratch2.tilt ?? (scratch2.tilt = new THREE.Quaternion());
+    hand.quaternion.multiply(scratch2.tilt.setFromAxisAngle(new THREE.Vector3(1, 0, 0), hold.tilt));
+  }
+  hand.scale.setScalar(1);
+  holder.position.set(0, 0, 0);
+  hand.updateMatrixWorld(true);
+  scratch2.hip ?? (scratch2.hip = new THREE.Vector3());
+  const hip = scratch2.hip;
+  if (right) {
+    scratch2.grip ?? (scratch2.grip = new THREE.Vector3());
+    const grip = hand.worldToLocal(right.part.localToWorld(scratch2.grip.copy(right.offset)));
+    hip.set(hold.grip[0] - grip.x, hold.grip[1] - grip.y, hold.grip[2] - grip.z);
+  } else hip.set(NO_GRIP_REAR[0], NO_GRIP_REAR[1], NO_GRIP_REAR[2] + box2.min.x);
+  const k = ease(Math.max(0, Math.min(1, placement.aim)));
+  if (k > 0) {
+    const along = box2.min.x + hold.sights.fromRear;
+    scratch2.aimed ?? (scratch2.aimed = new THREE.Vector3());
+    hip.lerp(scratch2.aimed.set(0, -SIGHT_UNDER_EYE - box2.max.y, along - hold.sights.distance), k);
+  }
+  holder.position.copy(hip).add(placement.offset);
+  hand.updateMatrixWorld(true);
+}
+function toWorldLens(camera, point, worldFov, lensFov) {
+  const k = Math.tan(worldFov * Math.PI / 360) / Math.tan(lensFov * Math.PI / 360);
+  camera.updateMatrixWorld();
+  camera.worldToLocal(point);
+  point.x *= k;
+  point.y *= k;
+  return camera.localToWorld(point);
+}
+
 // src/fx/hand-hold.ts
 var HAND_HOLD = {
   /** Half the width of a pistol grip, the palm sits this far (plus the palm) off its middle. */
@@ -2632,6 +2729,7 @@ function holdOfModel(THREE, model, holderScale) {
   const toRoot = (x, y, z) => V(THREE, inner.position.x + x * inner.scale.x, y, z);
   const handgun = parts.family === "pistol" || parts.family === "revolver";
   root.updateWorldMatrix(true, true);
+  if (parts.holdRight || parts.holdLeft) return namedHold(THREE, model, holderScale);
   let gripAt;
   let up;
   if (parts.grip) {
@@ -2678,6 +2776,18 @@ function holdOfModel(THREE, model, holderScale) {
     gripLeft: HAND_HOLD.forend
   };
 }
+function namedHold(THREE, model, holderScale) {
+  const { parts } = model;
+  const on = (mark, fingers) => mark ? { part: mark, offset: V(THREE, 0, HAND_HOLD.palm, 0), quaternion: handFrame(THREE, fingers, V(THREE, 0, 1, 0)) } : null;
+  return {
+    right: on(parts.holdRight, V(THREE, 1, 0, 0)),
+    left: on(parts.holdLeft, V(THREE, 0, 0, 1)),
+    leftMagazine: null,
+    scale: holderScale,
+    grip: HAND_HOLD.closed,
+    gripLeft: HAND_HOLD.closed
+  };
+}
 function holdOfProp(THREE, group, category, scale) {
   const handle = group.getObjectByName("handle") ?? group.getObjectByName("body") ?? group;
   const head = group.getObjectByName("head");
@@ -3186,6 +3296,15 @@ function createBoxFx(options) {
   const q2 = new THREE.Quaternion();
   const pointForward = new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(0, 1, 0), Math.PI / 2);
   const frontOf = new THREE.Vector3();
+  const restBox = new THREE.Box3();
+  const noMotion = new THREE.Vector3();
+  let inLens = false;
+  const setLens = (on) => {
+    if (on !== inLens) options.viewmodelFov?.(on ? VIEW_HOLD.tool.fov : null);
+    inLens = on;
+    const layer = on ? FIRST_PERSON_LAYER : 0;
+    hand.traverse((node) => node.layers.set(layer));
+  };
   const equip = (weapon) => {
     if (model) hand.remove(model);
     model = null;
@@ -3193,6 +3312,8 @@ function createBoxFx(options) {
     def = arsenal.weapons.get(weapon) ?? null;
     if (!def || BODY_ACTIONS.has(def.id)) return;
     model = buildWeaponModel(THREE, def, options.items);
+    restBox.setFromObject(model);
+    inLens = false;
     const length = new THREE.Box3().setFromObject(model).getSize(v).x;
     rear = new THREE.Box3().setFromObject(model).min.x;
     lengthMetres = length;
@@ -3293,6 +3414,7 @@ function createBoxFx(options) {
   return {
     unequip() {
       if (model) hand.remove(model);
+      if (inLens) setLens(false);
       model = null;
       inHand = null;
       hold = null;
@@ -3301,6 +3423,7 @@ function createBoxFx(options) {
       if (!model || !def || !SPOUTS.has(def.action.kind)) return null;
       hand.updateMatrixWorld(true);
       const at = model.localToWorld(v.copy(frontOf));
+      if (inLens) toWorldLens(camera, at, camera.fov ?? 72, VIEW_HOLD.tool.fov);
       const along = v2.set(1, 0, 0).applyQuaternion(model.getWorldQuaternion(q2)).normalize();
       return { position: [at.x, at.y, at.z], direction: [along.x, along.y, along.z], drawsFlash: false };
     },
@@ -3323,7 +3446,13 @@ function createBoxFx(options) {
     update(dt) {
       kick *= Math.exp(-dt * 14);
       dip += ((reloading ? 1 : 0) - dip) * Math.min(1, dt * 8);
-      if (inHand && model) {
+      if (inHand && model && options.firstPerson?.()) {
+        setLens(true);
+        placeInView({ THREE, hand, holder: model, camera, right: hold?.right ?? null, box: restBox, kind: "tool", aim: 0, offset: noMotion });
+        hand.position.add(v.set(0, -0.12 * dip, 0.05 * kick).applyQuaternion(camera.quaternion));
+        hand.updateMatrixWorld(true);
+      } else if (inHand && model) {
+        if (inLens) setLens(false);
         const handgun = def?.category === "pistol" || def?.category === "revolver";
         placeOnBody({ THREE, hand, holder: model, frame: options.bodyHold?.() ?? eyeFrame(), rear, lengthMetres, handgun, right: hold?.right ?? null, left: hold?.left ?? null });
         hand.position.add(v.set(0, -0.12 * dip, 0.05 * kick).applyQuaternion(camera.quaternion));
@@ -5868,6 +5997,9 @@ function buildHousing(kit, parts, group) {
     cylinderZ(group, 0.016, 0.07, M.poly, 0.06, -0.01, side * 0.2, 14);
   }
   parts.trigger = box2(group, 0.012, 0.02, 0.016, M.dark, 0.1, 0.085, 0.14, 0.3);
+  parts.holdRight = kit.mark(group, 0.06, 6e-3, 0.2);
+  parts.holdLeft = kit.mark(group, 0.22, 0.164, 0);
+  parts.carry = "hip";
   parts.safety = box2(group, 0.014, 6e-3, 0.01, M.dark, 0.2, 0.073, -0.076, 0.4);
 }
 function buildFeed(kit, parts, group) {
@@ -6295,7 +6427,7 @@ function buildWeaponModelById(THREE, id) {
 }
 
 // src/fx/viewmodel.ts
-import { createToolClipPlayer, toolAnimationStep, warnOnce as warnOnce2 } from "@adatechnology/game-contracts";
+import { createToolClipPlayer, FIRST_PERSON_LAYER as FIRST_PERSON_LAYER2, toolAnimationStep, warnOnce as warnOnce2 } from "@adatechnology/game-contracts";
 import { discardObject3D as discardObject3D3 } from "@adatechnology/game-shapes-three";
 import { createRng as createRng2, muzzleEnergy as muzzleEnergy4 } from "@adatechnology/game-weapons";
 
@@ -6305,7 +6437,7 @@ var RELOAD_SAMPLE_HITS2 = reload_sample_hits_default.hits;
 var ROOT = "root";
 var AXIS_INDEX = { x: 0, y: 1, z: 2 };
 var EASE_STEPS = 10;
-var ease = (progress) => progress < 0.5 ? 2 * progress * progress : 1 - (-2 * progress + 2) ** 2 / 2;
+var ease2 = (progress) => progress < 0.5 ? 2 * progress * progress : 1 - (-2 * progress + 2) ** 2 / 2;
 var move = (part, axis, start, duration, from, to) => ({ part, channel: "position", axis, start, duration, from, to });
 var turn = (part, axis, start, duration, from, to) => ({ part, channel: "rotation", axis, start, duration, from, to });
 var cue = (t, type, data) => ({ t, type, ...data ? { data } : {} });
@@ -6319,7 +6451,7 @@ var valueAt = (tweens, t, includeInstants) => {
   for (const tween of tweens) {
     if (tween.start > t || tween.duration === 0 && (tween.start === t ? !includeInstants : false)) continue;
     if (tween.duration === 0 || t >= tween.start + tween.duration) value = tween.to;
-    else value = tween.from + (tween.to - tween.from) * ease((t - tween.start) / tween.duration);
+    else value = tween.from + (tween.to - tween.from) * ease2((t - tween.start) / tween.duration);
   }
   return value;
 };
@@ -7401,38 +7533,6 @@ function createEffects(THREE, sink, random) {
   };
 }
 
-// src/fx/view-hold.ts
-var VIEW_HOLD = {
-  /** The right hand's grip, from the eye. */
-  grip: [0.2, -0.2, -0.3],
-  /** A handgun's grip: higher and nearer the middle, the arms out in front. */
-  handgunGrip: [0.13, -0.15, -0.33],
-  /** A rocket launcher's grip: its tube rides on the shoulder, so the hands are higher. */
-  launcherGrip: [0.2, -0.14, -0.3],
-  /** A gun with no grip anchor: the rear of its bore, from the eye. */
-  rear: [0.2, -0.24, -0.12]
-};
-var scratch2 = { grip: null };
-function placeInView(placement) {
-  const { THREE, hand, holder, camera, right } = placement;
-  holder.scale.setScalar(1);
-  hand.position.copy(camera.position);
-  hand.quaternion.copy(camera.quaternion);
-  hand.scale.setScalar(1);
-  holder.position.set(0, 0, 0);
-  hand.updateMatrixWorld(true);
-  if (!right) {
-    holder.position.set(VIEW_HOLD.rear[0], VIEW_HOLD.rear[1], VIEW_HOLD.rear[2] + placement.rear);
-    hand.updateMatrixWorld(true);
-    return;
-  }
-  scratch2.grip ?? (scratch2.grip = new THREE.Vector3());
-  const grip = hand.worldToLocal(right.part.localToWorld(scratch2.grip.copy(right.offset)));
-  const [x, y, z] = placement.kind === "handgun" ? VIEW_HOLD.handgunGrip : placement.kind === "launcher" ? VIEW_HOLD.launcherGrip : VIEW_HOLD.grip;
-  holder.position.set(x - grip.x, y - grip.y, z - grip.z);
-  hand.updateMatrixWorld(true);
-}
-
 // src/fx/heavy.ts
 import { LIGHT_PRIORITY as LIGHT_PRIORITY2, geometryKey, materialKey } from "@adatechnology/game-render-three";
 import { discardObject3D } from "@adatechnology/game-shapes-three";
@@ -7821,11 +7921,12 @@ function createClipEventHandler(world, session) {
     switch (event.type) {
       case "muzzle_flash":
         if (data.at === "ugl") {
-          if (parts.uglMuzzle && world.layers.muzzleFlash) effects.muzzleFlash(positionOf(parts.uglMuzzle), root.getWorldQuaternion(new THREE.Quaternion()), UGL_FLASH);
+          if (parts.uglMuzzle && world.layers.muzzleFlash) world.afterPose(() => parts.uglMuzzle && effects.muzzleFlash(positionOf(parts.uglMuzzle), root.getWorldQuaternion(new THREE.Quaternion()), UGL_FLASH));
         } else if (parts.muzzle && world.layers.muzzleFlash && (session.def.action.kind === "firearm" || session.def.action.kind === "launcher")) {
           const profile = muzzleSmokeOf({ caliber: session.caliber, weapon: session.def, suppressed: session.suppressed });
           const size = session.def.action.kind === "launcher" ? 2.2 : FLASH_BY_CASE[session.caseType];
-          effects.muzzleFlash(positionOf(parts.muzzle), root.getWorldQuaternion(new THREE.Quaternion()), size, profile);
+          const muzzle = parts.muzzle;
+          world.afterPose(() => effects.muzzleFlash(positionOf(muzzle), root.getWorldQuaternion(new THREE.Quaternion()), size, profile));
         }
         break;
       case "eject_casing":
@@ -8366,7 +8467,9 @@ function workWeights(works, running) {
 
 // src/fx/viewmodel.ts
 var PI14 = Math.PI;
-var HEAT_DISPLAY_MAX_FALLBACK = 120;
+var HEAT_DISPLAY_MAX_FALLBACK = 750;
+var SMOKE_WISPS_PER_SECOND = 10;
+var SMOKE_THICKNESS_GAIN = 1.7;
 var WALL_PULL = { margin: 0.03, max: 1.2, rate: 14, probe: 3 };
 var HAND_IN_VIEW = { floor: -0.88, max: 0.3, rate: 10 };
 var LAUNCH_VOLUME = 0.6;
@@ -8385,6 +8488,7 @@ var indexCurl = (turn2, sinceShot) => {
   const held = sinceShot < TRIGGER_FINGER.burstSeconds ? TRIGGER_FINGER.pulled - TRIGGER_FINGER.tremor * (0.5 + 0.5 * Math.sin(sinceShot * 220)) : 0;
   return Math.max(ready + (TRIGGER_FINGER.pulled - ready) * pull, held);
 };
+var VIEW_MOTION = { sway: 6e-3, swayMax: 0.02, swayRate: 9, bobX: 6e-3, bobY: 8e-3, run: 1.6, fullSpeed: 4, frequency: 3.2 };
 function createViewmodel(options) {
   const { THREE, scene, camera, arsenal, groundAt, audio } = options;
   const kit = modelKit(THREE);
@@ -8392,16 +8496,33 @@ function createViewmodel(options) {
   const layers = options.layers ?? createLayers();
   const distance = () => options.soundDistance?.() ?? 0;
   const particles = createParticles(THREE, scene, groundAt, options.particleLimit);
+  const spawnParticle = particles.spawn.bind(particles);
+  particles.spawn = (object, velocity, particleOptions) => {
+    if (lens) toWorldLens(camera, object.position, worldFovOf(), lens.fov);
+    spawnParticle(object, velocity, particleOptions);
+  };
   particles.onBounce = (kind, hit) => {
-    if (kind === "magazine") audio?.thud();
-    if (kind !== "casing" || !audio) return;
-    const caseType = hit?.object.userData["caseType"];
+    if (!audio || kind !== "casing" && kind !== "magazine") return;
     const surface = hit ? options.surfaceAt?.(hit.object.position.x, hit.object.position.z) : void 0;
+    if (kind === "magazine") {
+      audio.thud({ ...surface ? { surface } : {}, ...hit ? { speed: hit.speed, bounce: hit.bounce } : {} });
+      return;
+    }
+    const caseType = hit?.object.userData["caseType"];
     audio.casing({ ...caseType ? { caseType } : {}, ...surface ? { surface } : {}, ...hit ? { speed: hit.speed, bounce: hit.bounce } : {} });
   };
   if (!options.effects) warnOnce2("game-weapons-three.own-effects-world", "game-weapons-three made an effects world of its own because the host lent none (options.effects); pass the host effects so the effects share one budget");
   const ownVfx = options.effects ? void 0 : createVfxRenderer(THREE, { scene, camera, vfx: { profile: "medium" }, ...options.lights ? { lights: options.lights } : {} });
-  const effects = createEffects(THREE, options.effects ?? ownVfx, random);
+  const worldSink = options.effects ?? ownVfx;
+  const lensSink = worldSink ? {
+    play: (request) => {
+      if (!lens || !request.point) return worldSink.play(request);
+      const at = toWorldLens(camera, lensPoint.set(...request.point), worldFovOf(), lens.fov);
+      return worldSink.play({ ...request, point: [at.x, at.y, at.z] });
+    },
+    stop: (handle) => worldSink.stop(handle)
+  } : void 0;
+  const effects = createEffects(THREE, lensSink, random);
   const hand = new THREE.Group();
   hand.name = VIEWMODEL_NODE_NAME;
   scene.add(hand);
@@ -8427,6 +8548,7 @@ function createViewmodel(options) {
   const rootQuaternion = new THREE.Quaternion();
   const muzzleAt = new THREE.Vector3();
   const muzzleAlong = new THREE.Vector3();
+  const posed = [];
   const world = {
     kit,
     scene,
@@ -8440,13 +8562,17 @@ function createViewmodel(options) {
       const played = audio?.cue(cue2, profile, lead);
       options.onSound?.({ weapon, cue: cue2, profile, ...played ? { played } : {} });
     },
-    schedule: (delay, seconds, step, done) => void tasks.push({ delay, seconds, elapsed: 0, step: (progress) => step(ease(progress)), done })
+    afterPose: (emit) => void posed.push(emit),
+    schedule: (delay, seconds, step, done) => void tasks.push({ delay, seconds, elapsed: 0, step: (progress) => step(ease2(progress)), done })
   };
   const heatMax = arsenal.rules.heat.displayMax || HEAT_DISPLAY_MAX_FALLBACK;
   const visual = arsenal.rules.heat.visual;
   const hasSuppressor = (parts) => parts.some((part) => arsenal.attachments.get(part.id)?.kind === "suppressor");
   const release = () => {
     if (!session) return;
+    if (lens) options.viewmodelFov?.(null);
+    lens = null;
+    lensLayer = -1;
     session.attachments?.dispose();
     discardObject3D3(session.model.root);
     player = null;
@@ -8486,6 +8612,9 @@ function createViewmodel(options) {
     const modelBox = new THREE.Box3().setFromObject(model.root);
     const length = modelBox.getSize(new THREE.Vector3()).x;
     modelRear = modelBox.min.x;
+    restBox.copy(modelBox);
+    lens = null;
+    lensLayer = -1;
     holder.add(model.root);
     const caliber = caliberOf(arsenal, def);
     const dims = caliber?.cartridge;
@@ -8548,6 +8677,42 @@ function createViewmodel(options) {
   let reach = 0;
   let pull = 0;
   let lift = 0;
+  const restBox = new THREE.Box3();
+  let lens = null;
+  let lensLayer = -1;
+  const lensPoint = new THREE.Vector3();
+  const worldFovOf = () => camera.fov ?? 72;
+  const setLens = (kind) => {
+    const fov = kind ? VIEW_HOLD[kind].fov : null;
+    if ((lens?.fov ?? null) !== fov) options.viewmodelFov?.(fov);
+    lens = kind && fov !== null ? { kind, fov } : null;
+    const layer = lens ? FIRST_PERSON_LAYER2 : 0;
+    if (layer === lensLayer && !lens) return;
+    lensLayer = layer;
+    hand.traverse((node) => node.layers.set(layer));
+  };
+  const motion = { phase: 0, swayX: 0, swayY: 0, lastYaw: Number.NaN, lastPitch: Number.NaN };
+  const motionEuler = new THREE.Euler(0, 0, 0, "YXZ");
+  const motionOffset = new THREE.Vector3();
+  const viewMotion = (dt, aim) => {
+    const moving = options.motion?.() ?? { speed: 0, running: false };
+    const calm = 1 - 0.8 * Math.max(0, Math.min(1, aim));
+    motionEuler.setFromQuaternion(camera.quaternion, "YXZ");
+    const turnYaw = Number.isNaN(motion.lastYaw) || dt <= 0 ? 0 : Math.atan2(Math.sin(motionEuler.y - motion.lastYaw), Math.cos(motionEuler.y - motion.lastYaw)) / dt;
+    const turnPitch = Number.isNaN(motion.lastPitch) || dt <= 0 ? 0 : (motionEuler.x - motion.lastPitch) / dt;
+    motion.lastYaw = motionEuler.y;
+    motion.lastPitch = motionEuler.x;
+    const follow = Math.min(1, dt * VIEW_MOTION.swayRate);
+    motion.swayX += (Math.max(-VIEW_MOTION.swayMax, Math.min(VIEW_MOTION.swayMax, turnYaw * VIEW_MOTION.sway)) - motion.swayX) * follow;
+    motion.swayY += (Math.max(-VIEW_MOTION.swayMax, Math.min(VIEW_MOTION.swayMax, -turnPitch * VIEW_MOTION.sway)) - motion.swayY) * follow;
+    const stride = Math.min(1, moving.speed / VIEW_MOTION.fullSpeed) * (moving.running ? VIEW_MOTION.run : 1);
+    motion.phase += dt * moving.speed * VIEW_MOTION.frequency;
+    return motionOffset.set(
+      (motion.swayX + Math.sin(motion.phase) * VIEW_MOTION.bobX * stride) * calm,
+      (motion.swayY - Math.abs(Math.cos(motion.phase)) * VIEW_MOTION.bobY * stride) * calm,
+      0
+    );
+  };
   const ahead = new THREE.Vector3();
   const up = new THREE.Vector3();
   const seen = new THREE.Vector3();
@@ -8580,13 +8745,17 @@ function createViewmodel(options) {
     const family = session.model.parts.family;
     session.holderScale = 1;
     if (options.firstPerson?.()) {
-      placeInView({ THREE, hand, holder, camera, right: hold?.right ?? null, rear: modelRear, kind: family === "pistol" || family === "revolver" ? "handgun" : family === "rocket" ? "launcher" : "long" });
+      const kind = session.model.parts.carry === "hip" ? "hip" : family === "pistol" || family === "revolver" ? "handgun" : family === "rocket" ? "launcher" : "long";
+      const aim = kind === "hip" ? 0 : options.aim?.() ?? 0;
+      placeInView({ THREE, hand, holder, camera, right: hold?.right ?? null, box: restBox, kind, aim, offset: viewMotion(dt, aim) });
+      setLens(kind);
       lift = 0;
-      pullFromWall(dt);
+      pull = 0;
       return;
     }
+    setLens(null);
     hand.scale.set(1, 1, 1);
-    placeOnBody({ THREE, hand, holder, frame: options.bodyHold?.() ?? eyeFrame(), rear: modelRear, lengthMetres: session.lengthMetres, handgun: family === "pistol" || family === "revolver", right: hold?.right ?? null, left: hold?.left ?? null });
+    placeOnBody({ THREE, hand, holder, frame: options.bodyHold?.() ?? eyeFrame(), rear: modelRear, lengthMetres: session.lengthMetres, handgun: family === "pistol" || family === "revolver", hip: session.model.parts.carry === "hip", right: hold?.right ?? null, left: hold?.left ?? null });
     hand.updateMatrixWorld(true);
     lift += (liftToKeepInView() - lift) * Math.min(1, dt * HAND_IN_VIEW.rate);
     if (lift > 1e-4) hand.position.addScaledVector(up.set(0, 1, 0).applyQuaternion(camera.quaternion), lift);
@@ -8662,6 +8831,10 @@ function createViewmodel(options) {
       if (session) {
         place(dt);
         player?.update(dt);
+        if (posed.length) {
+          hand.updateMatrixWorld(true);
+          for (const emit of posed.splice(0)) emit();
+        }
         const wantsMagazine = reloading || options.tool?.().reloading === true;
         magazineHand += ((wantsMagazine ? 1 : 0) - magazineHand) * Math.min(1, dt * HAND_HOLD.magRate);
         const tool = options.tool?.();
@@ -8677,10 +8850,11 @@ function createViewmodel(options) {
         }
         secondsSinceShot += dt;
         if (tool && tool.heat !== void 0 && tool.heat * heatMax > visual.smokeFrom && secondsSinceShot < visual.smokeSeconds && session.model.parts.muzzle) {
-          smokeDebt += dt * (tool.heat * heatMax - visual.smokeFrom) * 0.1;
+          const smokeLevel = Math.min(1, (tool.heat * heatMax - visual.smokeFrom) / visual.smokeSpan);
+          smokeDebt += dt * smokeLevel * SMOKE_WISPS_PER_SECOND;
           while (smokeDebt > 1) {
             smokeDebt -= 1;
-            const k = 0.5 + (tool.heat * heatMax - visual.smokeFrom) / 60;
+            const k = 0.5 + smokeLevel * SMOKE_THICKNESS_GAIN;
             effects.smoke(worldPositionOf(session, session.model.parts.muzzle, new THREE.Vector3()), new THREE.Vector3((random() - 0.5) * 0.015, 0.07 + random() * 0.08, (random() - 0.5) * 0.015), 4e-3 * k, 1.2 + random() * 0.6, Math.min(0.18, 0.06 + k * 0.04));
           }
         }
@@ -8707,6 +8881,7 @@ function createViewmodel(options) {
       if (!session || !mark) return null;
       hand.updateMatrixWorld(true);
       const at = worldPositionOf(session, mark, muzzleAt);
+      if (lens) toWorldLens(camera, at, worldFovOf(), lens.fov);
       const along = muzzleAlong.set(1, 0, 0).applyQuaternion(session.model.root.getWorldQuaternion(rootQuaternion)).normalize();
       const kind = session.def.action.kind;
       return { position: [at.x, at.y, at.z], direction: [along.x, along.y, along.z], drawsFlash: kind === "firearm" || kind === "launcher" };
@@ -8716,7 +8891,8 @@ function createViewmodel(options) {
       hand.updateMatrixWorld(true);
       const targets = targetsOf(THREE, hold, session.model.root.getWorldQuaternion(rootQuaternion), magazineHand, hold.works ? workWeights(hold.works, player?.running ?? []) : void 0);
       const trigger = session.model.parts.trigger;
-      if (trigger) targets.fingers = { index: indexCurl(trigger.rotation.z - triggerRest, clock - lastShot) };
+      if (session.model.parts.carry === "hip") targets.fingers = { index: 1 };
+      else if (trigger) targets.fingers = { index: indexCurl(trigger.rotation.z - triggerRest, clock - lastShot) };
       return limitSupportSpan(targets);
     },
     get inHand() {
@@ -8766,6 +8942,9 @@ function createWeaponFx(options) {
     ...options.contact ? { contact: options.contact } : {},
     ...options.bodyHold ? { bodyHold: options.bodyHold } : {},
     ...options.firstPerson ? { firstPerson: options.firstPerson } : {},
+    ...options.viewmodelFov ? { viewmodelFov: options.viewmodelFov } : {},
+    ...options.aim ? { aim: options.aim } : {},
+    ...options.motion ? { motion: options.motion } : {},
     ...options.effects ? { effects: options.effects } : {},
     ...options.flyRocket === void 0 ? {} : { flyRocket: options.flyRocket },
     ...options.particleLimit ? { particleLimit: options.particleLimit } : {},
@@ -9858,6 +10037,7 @@ var TEXT = {
     reloadClip: "Reload of {weapon}: {kind}, clip {clip} ({seconds} s)",
     soundCue: "Sound: {cue} ({weapon})",
     cueRecorded: " \xB7 recorded",
+    cueFitted: " \xB7 fitted copy of the recording",
     cueCarried: " \xB7 inside the next recording",
     gunshotSound: "Shot sound: {profile}, take {take}/4, pitch {pitch}, {space}, {distance} m{far}",
     gunshotRecorded: " \xB7 recorded take {takes}",
@@ -9882,7 +10062,7 @@ var TEXT = {
     fuseLength: "Dynamite fuse length",
     fuseLengthHint: "Metres of safety fuse (131 s per metre): a long one is set down lit, for a delayed trap",
     layers: { muzzle_flash: "Muzzle flash", casings: "Ejected casings", magazines: "Dropped magazines" },
-    metrics: { casings_live: "Casings in the scene", magazines_live: "Magazines in the scene", heat: "Barrel heat" }
+    metrics: { casings_live: "Casings in the scene", magazines_live: "Magazines in the scene", heat: "Barrel temperature above ambient", rounds_to_warning: "Rounds to the heat warning (cyclic rate, from cold)" }
   },
   "pt-BR": {
     group: "Armas",
@@ -9893,6 +10073,7 @@ var TEXT = {
     reloadClip: "Recarga de {weapon}: {kind}, clipe {clip} ({seconds} s)",
     soundCue: "Som: {cue} ({weapon})",
     cueRecorded: " \xB7 grava\xE7\xE3o",
+    cueFitted: " \xB7 c\xF3pia medida da grava\xE7\xE3o",
     cueCarried: " \xB7 dentro da grava\xE7\xE3o seguinte",
     gunshotSound: "Som do tiro: {profile}, tomada {take}/4, tom {pitch}, {space}, {distance} m{far}",
     gunshotRecorded: " \xB7 grava\xE7\xE3o, tomada {takes}",
@@ -9917,7 +10098,7 @@ var TEXT = {
     fuseLength: "Pavio da dinamite",
     fuseLengthHint: "Metros de pavio de seguran\xE7a (131 s por metro): um longo \xE9 posto no ch\xE3o aceso, para armadilha com atraso",
     layers: { muzzle_flash: "Clar\xE3o do cano", casings: "C\xE1psulas ejetadas", magazines: "Pentes que caem" },
-    metrics: { casings_live: "C\xE1psulas na cena", magazines_live: "Pentes na cena", heat: "Calor do cano" }
+    metrics: { casings_live: "C\xE1psulas na cena", magazines_live: "Pentes na cena", heat: "Temperatura do cano acima do ambiente", rounds_to_warning: "Tiros at\xE9 o aviso de calor (cad\xEAncia, a frio)" }
   }
 };
 var textOf = (locale) => TEXT[locale] ?? TEXT.en;
@@ -10041,7 +10222,12 @@ function createWeaponsTestModule(options = {}) {
   let host = null;
   let soundDistance = 0;
   let soundIndoors = false;
-  const heatPercent = () => Math.min(100, (host?.tool().heat ?? 0) * 100);
+  const barrelCelsius = () => (host?.tool().heat ?? 0) * arsenal.rules.heat.displayMax;
+  const roundsToWarning = () => {
+    const weaponId = host?.tool().weapon;
+    const rounds = weaponId ? roundsToWarningOf(arsenal, weaponId) : Infinity;
+    return Number.isFinite(rounds) ? rounds : "-";
+  };
   return {
     id: "weapons_area",
     name: text.name,
@@ -10094,7 +10280,8 @@ function createWeaponsTestModule(options = {}) {
     metrics: () => [
       { id: "casings_live", name: text.metrics.casings_live, read: () => fx?.casings ?? 0 },
       { id: "magazines_live", name: text.metrics.magazines_live, read: () => fx?.magazines ?? 0 },
-      { id: "heat", name: text.metrics.heat, unit: "%", max: 100, digits: 0, read: heatPercent },
+      { id: "heat", name: text.metrics.heat, unit: "\xB0C", max: arsenal.rules.heat.displayMax, digits: 0, read: barrelCelsius },
+      { id: "rounds_to_warning", name: text.metrics.rounds_to_warning, read: roundsToWarning },
       ...accessoryMetrics(accessoryText, () => host?.tool() ?? EMPTY_TOOL)
     ],
     attach(lent) {
@@ -10107,20 +10294,20 @@ function createWeaponsTestModule(options = {}) {
           engine: lentEngine,
           ...options.samples ? { samples: options.samples } : {},
           onGunshot: (shot, input, played) => {
-            const recorded = played.kind === "sample" && played.layers.length > 0 ? fill(text.gunshotRecorded, { takes: played.layers.map((layer) => `${layer.role} ${layer.take + 1}`).join(", ") }) : "";
+            const recorded = played.kind === "sample" && played.layers.length > 0 ? fill(text.gunshotRecorded, { takes: played.layers.map((layer) => `${layer.role} ${layer.take + 1}`).join(", ") }) : played.kind === "fitted" ? text.cueFitted : "";
             lent.log(
               fill(text.gunshotSound, { profile: shot.profile, take: String(shot.take + 1), pitch: `${shot.pitch >= 1 ? "+" : ""}${((shot.pitch - 1) * 100).toFixed(1)} %`, space: text.spaces[input.space ?? "outdoor"], distance: String(Math.round(input.distance ?? 0)), far: shot.closeMix < 1 ? ` (${Math.round((1 - shot.closeMix) * 100)} % far)` : "" }) + recorded,
               { profile: shot.profile, take: shot.take, pitch: shot.pitch, space: input.space ?? "outdoor", distance: input.distance ?? 0, closeMix: shot.closeMix, delay: shot.delay, samples: shot.samples, played },
               "sound"
             );
           },
-          onCasing: (sound3, played) => lent.log(fill(text.casingSound, { case: sound3.kind, surface: text.surfaces[sound3.surface] }) + (played === "sample" ? text.cueRecorded : ""), { case: sound3.kind, surface: sound3.surface, sample: sound3.sample, played }, "sound")
+          onCasing: (sound3, played) => lent.log(fill(text.casingSound, { case: sound3.kind, surface: text.surfaces[sound3.surface] }) + (played === "sample" ? text.cueRecorded : played === "fitted" ? text.cueFitted : ""), { case: sound3.kind, surface: sound3.surface, sample: sound3.sample, played }, "sound")
         });
       }
       let simulatedMs = 0;
       const offClock = lent.onFrame((dt) => simulatedMs += dt * 1e3);
       const created = createWeaponFx({
-        onSound: ({ weapon, cue: cue2, profile, played }) => lent.log(fill(text.soundCue, { weapon: arsenal.name(weapon), cue: text.soundCues[cue2] ?? cue2 }) + (played === "sample" ? text.cueRecorded : played === "carried" ? text.cueCarried : ""), { weapon, cue: cue2, weight: profile.weight, material: profile.material, ...played ? { played } : {} }, "sound"),
+        onSound: ({ weapon, cue: cue2, profile, played }) => lent.log(fill(text.soundCue, { weapon: arsenal.name(weapon), cue: text.soundCues[cue2] ?? cue2 }) + (played === "sample" ? text.cueRecorded : played === "fitted" ? text.cueFitted : played === "carried" ? text.cueCarried : ""), { weapon, cue: cue2, weight: profile.weight, material: profile.material, ...played ? { played } : {} }, "sound"),
         THREE: lent.THREE,
         scene: lent.scene,
         camera: lent.camera,
@@ -10137,6 +10324,10 @@ function createWeaponsTestModule(options = {}) {
         contact: createLaserRaycast(lent.THREE, lent.scene, lent.camera, { now: () => simulatedMs }),
         ...lent.holdFrame ? { bodyHold: () => lent.holdFrame?.() ?? null } : {},
         firstPerson: () => lent.player().cameraMode === "first",
+        // the lens of the gun in first person, how far it is brought to the eye (the right button) and how the body moves (the bob and the sway follow it)
+        ...lent.setViewmodelFov ? { viewmodelFov: (degrees) => lent.setViewmodelFov?.(degrees) } : {},
+        aim: () => accessories.aimProgress,
+        motion: () => ({ speed: lent.player().speed, running: lent.player().running }),
         ...lent.effects ? { effects: lent.effects } : {},
         ...lent.particleLimit ? { particleLimit: lent.particleLimit } : {},
         ...isLightBudget(lent.lights) ? { lights: lent.lights } : {},
@@ -10170,6 +10361,7 @@ function createWeaponsTestModule(options = {}) {
       const offEvents = lent.on((event) => {
         worldEffects.handle(event, lent.effects);
         if (event.type === "explosion") {
+          if (lentEngine) return;
           const away = Math.hypot(event.point[0] - camera.position.x, event.point[1] - camera.position.y, event.point[2] - camera.position.z);
           ownAudio()?.play("explosion", Math.min(1, EXPLOSION_VOLUME_BASE + event.radius * EXPLOSION_VOLUME_PER_METRE), away);
           return;
@@ -11238,6 +11430,8 @@ export {
   weaponSampleDefaults,
   weaponSampleBank,
   createWeaponAudio,
+  VIEW_HOLD,
+  toWorldLens,
   BODY_ACTIONS,
   weaponProp,
   buildProp,
@@ -11272,6 +11466,7 @@ export {
   buildCartridge,
   buildCasing,
   buildRound,
+  VIEW_MOTION,
   createWeaponFx,
   buildModeledProp,
   buildTripodMountedProp,
@@ -11299,4 +11494,4 @@ export {
   DEFAULT_EXPLOSIVES_SCENE,
   createExplosivesTestModule
 };
-//# sourceMappingURL=chunk-GBO6L7CQ.js.map
+//# sourceMappingURL=chunk-BDYIF7JD.js.map