@adatechnology/game-test-room 0.27.0 → 0.28.1

package/dist/index.d.ts

@@ -485,7 +485,9 @@ interface RoomAvatar {
      */
     eye?(out?: THREE_NS.Vector3): THREE_NS.Vector3;
     /** Hides the head and neck from `camera` while the view is `first` (shadows, mirrors and other cameras keep seeing them). */
-    setView?(mode: CameraMode, camera: THREE_NS.Object3D | null): void;
+    setView?(mode: CameraMode, camera: THREE_NS.Object3D | null, options?: {
+        readonly arms?: boolean;
+    }): void;
     /**
      * Plays the strike `clipId` (on the body, in both views) and answers the seconds until its impact, or null when this avatar has no such clip. The room then waits that long
      * before the blow lands (`strikeClips`); an avatar without `strike`, or one that answers null, gets the blow at the click.
@@ -704,6 +706,19 @@ interface SceneryTap {
     /** Turn about the vertical axis, radians (default 0). */
     rotationY?: number;
 }
+/** What the room needs of first-person arms: a root it puts in the scene, and the pose of each frame (the eye, the hand targets of the tool and the stance, how fast the body moves). */
+interface RoomFirstPersonArms {
+    readonly root: THREE_NS.Object3D;
+    update(dt: number, state: {
+        camera: THREE_NS.Object3D;
+        targets?: HandTargets | null;
+        stance?: string;
+        speed?: number;
+        running?: boolean;
+        crouch?: boolean;
+    }): void;
+    dispose(): void;
+}
 interface TestRoomOptions {
     THREE: ThreeNamespace;
     /** Element the bench fills (canvas + HUD). */
@@ -790,6 +805,11 @@ interface TestRoomOptions {
     ui?: boolean;
     /** The player's body (see `TestRoom.setAvatar`). */
     avatar?: RoomAvatar;
+    /**
+     * Arms drawn for the first-person view (the viewmodel arms, `createFirstPersonArms` of game-characters-three fits it): in first person the room hides the body's arms from the eye, draws
+     * these on `FIRST_PERSON_LAYER` with the tool in the hands, and brings their hands to the tool's grips. Absent: the body's arms are the ones seen.
+     */
+    firstPersonArms?: RoomFirstPersonArms;
     /** The view the room starts in (default `first`; the V key and `TestRoom.setCameraMode` change it). */
     cameraMode?: CameraMode;
     /**
@@ -1299,4 +1319,4 @@ declare function encodeBenchState(controls: readonly BenchControl[], layers: rea
 /** Reads an encoded state as hostile input: unknown ids, NaN, options not offered and malformed pairs are dropped; numbers are clamped. */
 declare function decodeBenchState(encoded: string, controls: readonly ModuleControl[], layers: readonly ModuleLayer[]): Map<string, ControlValue>;
 
-export { type AnimationInfo, type BenchControl, type BenchHandle, type BenchLayer, type BuildFromSpecOptions, type CameraMode, DEFAULT_HAND_STANCES, DEFAULT_STRIKE_CLIPS, DEFAULT_TRIALS, type HudState, type InspectInfo, type KickLeg, LOADING_CLASS, LOADING_CSS, type LoadingOptions, type LoadingState, type LogEntry, MATERIAL_COLORS, type ModuleReport, type NewEntry, type NewLogEntry, type ProjectileModel, type ProjectileQuery, type PunchHand, type RoomAvatar, type RoomAvatarState, type RoomDoorEvent, type RoomDoorState, type RoomFirstPersonState, type RoomGraphicsOptions, type RoomLoading, type RoomMetricId, type RoomPushEvent, type RoomPushState, type RoomReachView, type RoomSeat, type RoomStrings, type ScenarioContext, type ScenarioReport, type SceneryObject, type SceneryTap, type SpawnedObject, type StrikeComboOption, TRIAL_KINDS, type TestRoom, type TestRoomItem, type TestRoomLocale, type TestRoomLog, type TestRoomOptions, type TestRoomScenario, type TestTable, type TestTableContext, type TestTableObject, type TestTableOptions, type TestTablePage, type ThirdPersonOptions, type ThreeNamespace, type ToolMenuGroup, type ToolMenuSection, type ToolMenuTool, type TrialKind, type TrialTool, type UseStatus, type WritableLog, brickWallSpec, buildFromSpec, createLoading, createLog, createTestRoom, createTestTable, decodeBenchState, encodeBenchState, fitRow, loadingMarkup, locales, nextPaint, resolveStrings, rowCentres, trialView };
+export { type AnimationInfo, type BenchControl, type BenchHandle, type BenchLayer, type BuildFromSpecOptions, type CameraMode, DEFAULT_HAND_STANCES, DEFAULT_STRIKE_CLIPS, DEFAULT_TRIALS, type HudState, type InspectInfo, type KickLeg, LOADING_CLASS, LOADING_CSS, type LoadingOptions, type LoadingState, type LogEntry, MATERIAL_COLORS, type ModuleReport, type NewEntry, type NewLogEntry, type ProjectileModel, type ProjectileQuery, type PunchHand, type RoomAvatar, type RoomAvatarState, type RoomDoorEvent, type RoomDoorState, type RoomFirstPersonArms, type RoomFirstPersonState, type RoomGraphicsOptions, type RoomLoading, type RoomMetricId, type RoomPushEvent, type RoomPushState, type RoomReachView, type RoomSeat, type RoomStrings, type ScenarioContext, type ScenarioReport, type SceneryObject, type SceneryTap, type SpawnedObject, type StrikeComboOption, TRIAL_KINDS, type TestRoom, type TestRoomItem, type TestRoomLocale, type TestRoomLog, type TestRoomOptions, type TestRoomScenario, type TestTable, type TestTableContext, type TestTableObject, type TestTableOptions, type TestTablePage, type ThirdPersonOptions, type ThreeNamespace, type ToolMenuGroup, type ToolMenuSection, type ToolMenuTool, type TrialKind, type TrialTool, type UseStatus, type WritableLog, brickWallSpec, buildFromSpec, createLoading, createLog, createTestRoom, createTestTable, decodeBenchState, encodeBenchState, fitRow, loadingMarkup, locales, nextPaint, resolveStrings, rowCentres, trialView };

package/dist/index.global.js

@@ -473,6 +473,7 @@ var GameTestRoom = (() => {
     if (!state.opened) return "sealed";
     return void 0;
   };
+  var FIRST_PERSON_LAYER = 9;
   var TWIST_LIFT = 0.012;
   var TURNING = 0.7;
   var smooth = (k) => k * k * (3 - 2 * k);
@@ -16749,7 +16750,7 @@ var GameTestRoom = (() => {
     const { core, def, random, x, y, z } = context;
     const mark = def.mark;
     const keepsMarks = !core.marklessAt?.(x, z);
-    if (keepsMarks && mark.crater && mark.dent && y < 1.2) {
+    if (keepsMarks && mark.crater && mark.dent && y < 1.2 && (core.cratersAt?.(x, z) ?? true)) {
       core.emit({ type: "crater", x, z, radius: mark.crater, depth: mark.dent });
       core.trace?.crater?.(x, z, mark.crater, mark.dent);
       addCrater(core.marks, core.ground, random, { x, z, radius: mark.crater, depth: mark.dent, marks: core.layers.mark });
@@ -18515,6 +18516,7 @@ var GameTestRoom = (() => {
       clock: { time: 0, lastBlast: -1, lod: 1, forcedLod: null },
       groundAt,
       ...options.marklessAt ? { marklessAt: options.marklessAt } : {},
+      ...options.cratersAt ? { cratersAt: options.cratersAt } : {},
       emit: (request) => options.onRequest?.(request)
     };
     function definitionOf(id) {
@@ -38174,7 +38176,9 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       dimensions: {
         length: 0.801,
         barrel: 0.559,
-        emptyMass: 39
+        emptyMass: 39,
+        barrels: 6,
+        barrelMass: 2
       },
       archetype: "rifle_7_62x39",
       sources: [
@@ -39154,19 +39158,41 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     }
   };
   var DEFAULT_HEAT = {
-    cap: 140,
-    displayMax: 120,
-    decayBase: 1.6,
-    decayPerPoint: 0.03,
-    faultFrom: 60,
-    faultSpan: 40,
-    perShot: { shell: 3, big: 6, tiny: 0.5, pistol: 1.2, rifle: 2 },
+    cap: 900,
+    displayMax: 750,
+    faultFrom: 350,
+    faultSpan: 200,
+    specificHeat: 490,
+    barrelShare: { shell: 0.48, big: 0.48, tiny: 0.3, pistol: 0.3, rifle: 0.48 },
+    barrelKilogramsPerMetre: {
+      pistol: 1,
+      revolver: 1.4,
+      smg: 1.2,
+      carbine: 1.6,
+      rifle: 1.6,
+      dmr: 2.4,
+      sniper: 2.4,
+      hunting: 2.4,
+      machine_gun: 3,
+      shotgun: 1.1
+    },
+    barrelFallback: { metres: 0.4, kilogramsPerMetre: 1.6 },
+    cooling: { baseSeconds: 30, secondsPerKilogram: 250 },
     perRocket: 35,
-    visual: { smokeFrom: 70, smokeSeconds: 2.5, glowFrom: 80, glowSpan: 40 }
+    visual: { smokeFrom: 250, smokeSpan: 300, smokeSeconds: 2.5, glowFrom: 450, glowSpan: 300 }
   };
   var GALLERY_HEAT = {
     ...DEFAULT_HEAT,
-    perShot: { shell: 6, big: 9, tiny: 1.2, pistol: 3, rifle: 4.5 }
+    cap: 140,
+    displayMax: 120,
+    faultFrom: 60,
+    faultSpan: 40,
+    visual: { smokeFrom: 70, smokeSpan: 100, smokeSeconds: 2.5, glowFrom: 80, glowSpan: 40 },
+    gallery: {
+      perShot: { shell: 6, big: 9, tiny: 1.2, pistol: 3, rifle: 4.5 },
+      decayBase: 1.6,
+      decayPerPoint: 0.03
+    }
   };
   var defaultFaultChance = (context) => {
     const factor = context.def.action.kind === "firearm" ? context.def.action.faultFactor ?? 1 : 1;
@@ -39449,17 +39475,55 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       ...explosive.stunSeconds !== void 0 ? { stunSeconds: explosive.stunSeconds } : {}
     };
   };
+  var EPS22 = 1e-9;
+  var MANUAL_MODES = /* @__PURE__ */ new Set(["pump", "bolt", "lever"]);
+  var weaponSpeed = (action, caliber) => action.muzzleSpeed ?? caliber.muzzleSpeed * (action.barrel ?? 1);
+  var weaponNoise = (action, caliber) => action.noise ?? caliber.noise ?? 0;
+  var timingsOf = (action) => "timings" in action ? action.timings : void 0;
+  var drawSeconds = (action, rules) => timingsOf(action)?.draw ?? rules.draw;
+  var clearSeconds = (action, rules) => timingsOf(action)?.clear ?? rules.clear;
+  var manualCycleSeconds = (action, mode) => MANUAL_MODES.has(mode) ? action.timings?.cycle ?? 0 : 0;
+  var planRounds = (action, mode, ammo, firstAt, frameEnd) => {
+    const interval = 60 / action.rpm;
+    const times = [];
+    if (mode === "auto") {
+      for (let t = firstAt; times.length < ammo && (times.length === 0 ? t <= frameEnd + EPS22 : t < frameEnd - EPS22); t += interval) times.push(t);
+      return times;
+    }
+    if (mode === "burst") {
+      const count = Math.min(action.burst ?? 3, ammo);
+      for (let k = 0; k < count; k++) times.push(firstAt + k * interval);
+      return times;
+    }
+    if (mode === "volley") return Array.from({ length: Math.min(action.magazine, ammo) }, () => firstAt);
+    return [firstAt];
+  };
   var SUBSTEP_SECONDS = 1 / 60;
-  var decayHeat = (heat, seconds, rules) => {
+  var barrelMassOf = (def, rules) => {
+    const dimensions = def.dimensions;
+    const kilogramsPerMetre = rules.barrelKilogramsPerMetre[def.category] ?? rules.barrelFallback.kilogramsPerMetre;
+    const single = dimensions?.barrelMass ?? (dimensions?.barrel ?? rules.barrelFallback.metres) * kilogramsPerMetre;
+    return single * (dimensions?.barrels ?? 1);
+  };
+  var coolingTimeConstant = (barrelMass, rules) => rules.cooling.baseSeconds + rules.cooling.secondsPerKilogram * barrelMass;
+  var decayHeat = (heat, seconds, barrelMass, rules) => {
+    if (heat <= 0) return 0;
+    if (rules.gallery) return decayGallery(heat, seconds, rules.gallery);
+    return heat * Math.exp(-seconds / coolingTimeConstant(barrelMass, rules));
+  };
+  var decayGallery = (heat, seconds, gallery) => {
     const steps = Math.max(1, Math.ceil(seconds / SUBSTEP_SECONDS - 1e-9));
     const step = seconds / steps;
     let current = heat;
-    for (let i = 0; i < steps && current > 0; i++) current = Math.max(0, current - step * (rules.decayBase + current * rules.decayPerPoint));
+    for (let i = 0; i < steps && current > 0; i++) current = Math.max(0, current - step * (gallery.decayBase + current * gallery.decayPerPoint));
     return current;
   };
-  var heatPerRound = (action, caliber, rules) => {
+  var heatPerRound = ({ action, caliber, energy, barrelMass, rules }) => {
     if (action.kind === "launcher") return rules.perRocket;
-    return caliber?.caseType ? rules.perShot[caliber.caseType] : 0;
+    const caseType = caliber?.caseType;
+    if (!caseType) return 0;
+    if (rules.gallery) return rules.gallery.perShot[caseType];
+    return rules.barrelShare[caseType] * energy / (barrelMass * rules.specificHeat);
   };
   var burstNoise = (base, recentShots, rules) => base * (1 + Math.min(rules.cap, rules.step * recentShots));
   var magazineOut = { stage: "magazine_out", at: 0 };
@@ -39586,29 +39650,6 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     return roll.ammoQuality.faultChance > 0 && roll.random() < roll.ammoQuality.faultChance ? "misfire" : null;
   };
   var isDudWithoutJam = (action, fault) => fault === "misfire" && action.kind === "firearm" && MISFIRE_ONLY.has(action.family);
-  var EPS22 = 1e-9;
-  var MANUAL_MODES = /* @__PURE__ */ new Set(["pump", "bolt", "lever"]);
-  var weaponSpeed = (action, caliber) => action.muzzleSpeed ?? caliber.muzzleSpeed * (action.barrel ?? 1);
-  var weaponNoise = (action, caliber) => action.noise ?? caliber.noise ?? 0;
-  var timingsOf = (action) => "timings" in action ? action.timings : void 0;
-  var drawSeconds = (action, rules) => timingsOf(action)?.draw ?? rules.draw;
-  var clearSeconds = (action, rules) => timingsOf(action)?.clear ?? rules.clear;
-  var manualCycleSeconds = (action, mode) => MANUAL_MODES.has(mode) ? action.timings?.cycle ?? 0 : 0;
-  var planRounds = (action, mode, ammo, firstAt, frameEnd) => {
-    const interval = 60 / action.rpm;
-    const times = [];
-    if (mode === "auto") {
-      for (let t = firstAt; times.length < ammo && (times.length === 0 ? t <= frameEnd + EPS22 : t < frameEnd - EPS22); t += interval) times.push(t);
-      return times;
-    }
-    if (mode === "burst") {
-      const count = Math.min(action.burst ?? 3, ammo);
-      for (let k = 0; k < count; k++) times.push(firstAt + k * interval);
-      return times;
-    }
-    if (mode === "volley") return Array.from({ length: Math.min(action.magazine, ammo) }, () => firstAt);
-    return [firstAt];
-  };
   var activeParts = (fitted, catalogue) => fitted.flatMap((part) => {
     const def = catalogue.get(part.id);
     const isOn = def?.kind !== "light" && def?.kind !== "laser" ? true : part.on === true;
@@ -39841,6 +39882,10 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     get safety() {
       return this._safety;
     }
+    /** Kg of steel that heat up with the shots. */
+    get barrelMass() {
+      return barrelMassOf(this.def, this.rules.heat);
+    }
     get heat() {
       return this._heat;
     }
@@ -39893,7 +39938,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     }
     advance(seconds) {
       if (seconds <= 0) return;
-      this._heat = decayHeat(this._heat, seconds, this.rules.heat);
+      this._heat = decayHeat(this._heat, seconds, this.barrelMass, this.rules.heat);
       this.clock += seconds;
     }
     /** Complete what falls at or before `t`: scheduled events and the reload steps. */
@@ -40445,7 +40490,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         res.shots.push(shot);
       }
       this._ammo -= 1;
-      this._heat = Math.min(this.rules.heat.cap, this._heat + heatPerRound(a, cal, this.rules.heat) * this.load.heatFactor);
+      this._heat = Math.min(this.rules.heat.cap, this._heat + heatPerRound({ action: a, caliber: cal, energy: energy * pellets, barrelMass: this.barrelMass, rules: this.rules.heat }) * this.load.heatFactor);
       this.readyAt = t + 60 / a.rpm;
       this.extra = Math.min(bloomNow + (a.bloomDeg ?? 0), a.spreadDeg * (BLOOM_CAP - 1));
       this.extraClock = t;
@@ -40534,7 +40579,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       }
       const t = Math.max(start, this.readyAt);
       this._ammo -= 1;
-      this._heat = Math.min(this.rules.heat.cap, this._heat + heatPerRound(a, null, this.rules.heat));
+      this._heat = Math.min(this.rules.heat.cap, this._heat + heatPerRound({ action: a, caliber: null, energy: 0, barrelMass: this.barrelMass, rules: this.rules.heat }));
       this.emit({ type: "shot", shots: 0, rounds: 1, mode: this.mode, at: t });
       return result("ok", { uses: launcherUses(a, this.explosive, origin, dir), recoil: [a.recoil[0], a.recoil[1]], noise: a.noise ?? 0, rounds: 1, roundTimes: [t - start] });
     }
@@ -49409,6 +49454,7 @@ void main(){
   }
 
   // src/player.ts
+  var RECOIL_RETURN = { share: 0.7, seconds: 0.25 };
   var SLAM_MIN_SPEED2 = 1.5;
   var LANDING_MIN_SPEED = 1;
   var EYE = 1.7;
@@ -49438,6 +49484,18 @@ void main(){
     const cam = o.camera;
     let yaw = 0;
     let pitch = 0;
+    const recoilReturn = o.recoilReturn ?? RECOIL_RETURN;
+    const recoilDebt = { pitch: 0, yaw: 0 };
+    const returnRecoil = (dt) => {
+      if (Math.abs(recoilDebt.pitch) + Math.abs(recoilDebt.yaw) < 1e-6) return;
+      const k = 1 - Math.exp(-3 * dt / Math.max(1e-3, recoilReturn.seconds));
+      const back = { pitch: recoilDebt.pitch * k, yaw: recoilDebt.yaw * k };
+      recoilDebt.pitch -= back.pitch;
+      recoilDebt.yaw -= back.yaw;
+      pitch = Math.max(-1.5, Math.min(1.5, pitch - back.pitch));
+      yaw -= back.yaw;
+      apply();
+    };
     let y = 0;
     let eye = EYE;
     let crouch = 0;
@@ -49779,6 +49837,7 @@ void main(){
         return stunLeft;
       },
       update(dt) {
+        returnRecoil(dt);
         if (stunLeft > 0) {
           stunLeft = Math.max(0, stunLeft - dt);
           stunPhase += dt * 2.4;
@@ -49827,6 +49886,8 @@ void main(){
       },
       setPose(position, yw, pt2) {
         knocked = null;
+        recoilDebt.pitch = 0;
+        recoilDebt.yaw = 0;
         px.x = position[0];
         px.z = position[2];
         floorLevel = floorHere();
@@ -49839,6 +49900,8 @@ void main(){
       },
       look(position, target) {
         knocked = null;
+        recoilDebt.pitch = 0;
+        recoilDebt.yaw = 0;
         px.x = position[0];
         px.z = position[2];
         floorLevel = floorHere();
@@ -49853,8 +49916,11 @@ void main(){
         apply();
       },
       kick(pitchDeg, yawDeg) {
+        const before = pitch;
         pitch = Math.max(-1.5, Math.min(1.5, pitch + pitchDeg * Math.PI / 180));
         yaw += yawDeg * Math.PI / 180;
+        recoilDebt.pitch += (pitch - before) * recoilReturn.share;
+        recoilDebt.yaw += yawDeg * Math.PI / 180 * recoilReturn.share;
         apply();
       },
       moveBy(dx, dz) {
@@ -51034,6 +51100,8 @@ void main(){
     { id: "dry_clay", strata: [{ material: "clay", thickness: 0.35 }, { material: "soil", thickness: 1.5 }, { material: "stone", thickness: 0.5 }] },
     { id: "snow", strata: [{ material: "snow", thickness: 0.3 }, { material: "soil", thickness: 1.5 }, { material: "stone", thickness: 0.5 }] },
     { id: "cobblestone", strata: [{ material: "cobble", thickness: 0.12 }, { material: "sand", thickness: 0.06 }, { material: "gravel", thickness: 0.2 }, { material: "soil", thickness: 1.2 }] },
+    // rock at the surface (an outcrop, a quarry floor): a blast only spalls it and a shot chips it
+    { id: "bedrock", surfacePattern: "rock", strata: [{ material: "stone", thickness: 3 }] },
     { id: "paver_floor", strata: [{ material: "paver", thickness: 0.08 }, { material: "sand", thickness: 0.05 }, { material: "gravel", thickness: 0.15 }, { material: "soil", thickness: 1.2 }] },
     { id: "shallow_water", water: { liquid: "water", depth: 0.3, drag: 0.65, blowShare: WATER_BLOW_SHARE }, strata: [{ material: "mud", thickness: 0.15 }, { material: "soil", thickness: 1.5 }, { material: "stone", thickness: 0.5 }] }
   ];
@@ -52268,7 +52336,7 @@ void main(){
       }
     };
   }
-  var TERRAIN_PATTERNS = ["plain", "grass", "soil", "sand", "asphalt", "concrete", "tile", "planks", "stone", "mud", "gravel", "clay", "snow", "cobble", "paver"];
+  var TERRAIN_PATTERNS = ["plain", "grass", "soil", "sand", "asphalt", "concrete", "tile", "planks", "stone", "mud", "gravel", "clay", "snow", "cobble", "paver", "rock"];
   var STRIDE = 0.72;
   var FOOT_LENGTH = 0.15;
   var FOOT_APART = 0.11;
@@ -52316,10 +52384,10 @@ void main(){
     };
   }
 
-  // ../game-terrain-three/dist/chunk-B5EA72GU.js
+  // ../game-terrain-three/dist/chunk-6YHNPX3W.js
   var PROFILE_NAMES = {
-    en: { lawn: "Lawn", dirt: "Dirt", sand: "Sand", road: "Asphalt road", concrete_slab: "Concrete slab", suspended_slab: "Slab over a void", tile_floor: "Tile floor", wood_floor: "Wood floor", stone_paving: "Stone paving" },
-    "pt-BR": { lawn: "Grama", dirt: "Terra", sand: "Areia", road: "Asfalto", concrete_slab: "Laje de concreto", suspended_slab: "Laje sobre v\xE3o", tile_floor: "Piso cer\xE2mico", wood_floor: "Assoalho", stone_paving: "Cal\xE7amento de pedra" }
+    en: { lawn: "Lawn", dirt: "Dirt", sand: "Sand", road: "Asphalt road", concrete_slab: "Concrete slab", suspended_slab: "Slab over a void", tile_floor: "Tile floor", wood_floor: "Wood floor", stone_paving: "Stone paving", mud: "Mud", gravel_bed: "Gravel", dry_clay: "Dry clay", snow: "Snow", cobblestone: "Cobblestones", paver_floor: "Concrete pavers", shallow_water: "Shallow water", bedrock: "Bare rock" },
+    "pt-BR": { lawn: "Grama", dirt: "Terra", sand: "Areia", road: "Asfalto", concrete_slab: "Laje de concreto", suspended_slab: "Laje sobre v\xE3o", tile_floor: "Piso cer\xE2mico", wood_floor: "Assoalho", stone_paving: "Cal\xE7amento de pedra", mud: "Lama", gravel_bed: "Cascalho", dry_clay: "Barro seco", snow: "Neve", cobblestone: "Paralelep\xEDpedo", paver_floor: "Bloquete", shallow_water: "\xC1gua rasa", bedrock: "Rocha" }
   };
   function terrainProfileName(profileId, localeId) {
     return (PROFILE_NAMES[localeId] ?? PROFILE_NAMES.en)[profileId] ?? profileId;
@@ -52329,20 +52397,20 @@ void main(){
       name: "Terrain",
       group: "Terrain",
       weight: "Concrete block (60 kg)",
-      surfaces: { dirt: "Dirt", lawn: "Lawn", sand: "Sand", road: "Asphalt", concrete_slab: "Concrete slab", suspended_slab: "Slab over a void", wood_floor: "Wood floor", tile_floor: "Tile", stone_paving: "Stone paving", mud: "Mud", gravel_bed: "Gravel", dry_clay: "Dry clay", snow: "Snow", cobblestone: "Cobblestones", paver_floor: "Concrete pavers", shallow_water: "Shallow water" }
+      surfaces: { dirt: "Dirt", lawn: "Lawn", sand: "Sand", road: "Asphalt", concrete_slab: "Concrete slab", suspended_slab: "Slab over a void", wood_floor: "Wood floor", tile_floor: "Tile", stone_paving: "Stone paving", mud: "Mud", gravel_bed: "Gravel", dry_clay: "Dry clay", snow: "Snow", cobblestone: "Cobblestones", paver_floor: "Concrete pavers", shallow_water: "Shallow water", bedrock: "Bare rock" }
     },
     "pt-BR": {
       name: "Terreno",
       group: "Terreno",
       weight: "Bloco de concreto (60 kg)",
-      surfaces: { dirt: "Terra", lawn: "Grama", sand: "Areia", road: "Asfalto", concrete_slab: "Laje de concreto", suspended_slab: "Laje sobre v\xE3o", wood_floor: "Assoalho", tile_floor: "Cer\xE2mica", stone_paving: "Pedra", mud: "Lama", gravel_bed: "Cascalho", dry_clay: "Barro seco", snow: "Neve", cobblestone: "Paralelep\xEDpedo", paver_floor: "Bloquete", shallow_water: "\xC1gua rasa" }
+      surfaces: { dirt: "Terra", lawn: "Grama", sand: "Areia", road: "Asfalto", concrete_slab: "Laje de concreto", suspended_slab: "Laje sobre v\xE3o", wood_floor: "Assoalho", tile_floor: "Cer\xE2mica", stone_paving: "Pedra", mud: "Lama", gravel_bed: "Cascalho", dry_clay: "Barro seco", snow: "Neve", cobblestone: "Paralelep\xEDpedo", paver_floor: "Bloquete", shallow_water: "\xC1gua rasa", bedrock: "Rocha" }
     }
   };
   var locale = (id) => LOCALES[id] ?? LOCALES.en;
-  var TERRAIN_STRIPS = ["lawn", "dirt", "sand", "mud", "dry_clay", "gravel_bed", "snow", "shallow_water", "road", "cobblestone", "paver_floor", "stone_paving", "concrete_slab", "suspended_slab", "tile_floor", "wood_floor"];
-  var LOT_WIDTH = 3.4;
+  var TERRAIN_STRIPS = ["lawn", "dirt", "sand", "mud", "dry_clay", "gravel_bed", "snow", "shallow_water", "bedrock", "road", "cobblestone", "paver_floor", "stone_paving", "concrete_slab", "suspended_slab", "tile_floor", "wood_floor"];
+  var LOT_WIDTH = 3;
   var LOT_DEPTH = 3.8;
-  var LOTS_PER_ROW = 8;
+  var LOTS_PER_ROW = 9;
   var LOTS_Z1 = -1.4;
   var lotRect = (index) => {
     const row = Math.floor(index / LOTS_PER_ROW);
@@ -52435,11 +52503,18 @@ vec3 terrainSurface(vec3 base, vec2 xz, float kind) {
     float seam = max(tsLine(xz.y, 0.2, 0.014), tsLine(along, 0.3, 0.014));
     return base * (0.72 + 0.6 * tsHash(cell)) * (0.82 + 0.36 * tsFbm(xz * 22.0)) * (1.0 - 0.8 * seam);
   }
-  float row = floor(xz.y / 0.2);
-  float along = xz.x - mod(abs(row), 2.0) * 0.1;
-  vec2 cell = vec2(floor(along / 0.2), row);
-  float seam = max(tsLine(xz.y, 0.2, 0.008), tsLine(along, 0.2, 0.008));
-  return base * (0.86 + 0.26 * tsHash(cell)) * (0.92 + 0.16 * tsNoise(xz * 70.0)) * (1.0 - 0.7 * seam);
+  if (k < 14.5) {
+    float row = floor(xz.y / 0.2);
+    float along = xz.x - mod(abs(row), 2.0) * 0.1;
+    vec2 cell = vec2(floor(along / 0.2), row);
+    float seam = max(tsLine(xz.y, 0.2, 0.008), tsLine(along, 0.2, 0.008));
+    return base * (0.86 + 0.26 * tsHash(cell)) * (0.92 + 0.16 * tsNoise(xz * 70.0)) * (1.0 - 0.7 * seam);
+  }
+  // bare rock: weathered blotches, lichen-dark patches and a few long joints, no grid
+  float blotch = tsFbm(xz * 0.9) * 0.6 + tsFbm(xz * 4.0 + 2.0) * 0.4;
+  float joint = 1.0 - smoothstep(0.0, 0.035, abs(tsNoise(xz * vec2(0.7, 1.9)) - 0.5));
+  float grain = tsNoise(xz * 95.0);
+  return base * (0.62 + 0.75 * blotch) * (0.88 + 0.24 * grain) * (1.0 - 0.6 * joint);
 }
 `
   );
@@ -52468,9 +52543,9 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     const index = row * terrain.stride + column;
     let material = terrain.vertexMaterial(column, row);
     if (terrain.loose[index] > LOOSE_VISIBLE) {
-      const profile = terrain.profileList[terrain.profileIndex[index]];
-      const first = profile.strata[0];
-      material = terrain.material(first.thickness < THIN_SKIN && profile.strata[1] ? profile.strata[1].material : first.material);
+      const profile2 = terrain.profileList[terrain.profileIndex[index]];
+      const first = profile2.strata[0];
+      material = terrain.material(first.thickness < THIN_SKIN && profile2.strata[1] ? profile2.strata[1].material : first.material);
     }
     const broken = material.pattern === "concrete" && terrain.dug[index] > BROKEN_DEPTH;
     const tone = broken ? BROKEN_TONE : 1;
@@ -52479,7 +52554,9 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     base[2] = material.color[2] * tone;
     shade[0] = Math.max(MIN_DEPTH_LIGHT, 1 - terrain.dug[index] / DEPTH_SHADE);
     shade[1] = terrain.scorch[index];
-    return patternIndex(broken ? "soil" : material.pattern);
+    const profile = terrain.profileList[terrain.profileIndex[index]];
+    const untouched = profile.surfacePattern !== void 0 && terrain.dug[index] <= BROKEN_DEPTH && terrain.loose[index] <= LOOSE_VISIBLE;
+    return patternIndex(broken ? "soil" : untouched ? profile.surfacePattern : material.pattern);
   }
   function chunkVertexCount(terrain, chunk, step) {
     const lastColumn = Math.min(terrain.columns, chunk.column + chunk.cells);
@@ -55519,6 +55596,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     const scene2 = options.scene ?? new THREE.Scene();
     const camera2 = options.camera ?? new THREE.PerspectiveCamera(72, width() / height(), 0.05, 140);
     if (!options.camera) scene2.add(camera2);
+    camera2.layers.disable(FIRST_PERSON_LAYER);
     const resize = () => {
       const w = width();
       const h = height();
@@ -55625,7 +55703,9 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
         profile: quality,
         ...options.debris?.particles ? { sprites: { kinds: patchSpriteKinds(SPRITE_KINDS, options.debris.particles) } } : {},
         groundAt,
-        marklessAt: (x, z) => terrain.waterAt(x, z) !== null
+        marklessAt: (x, z) => terrain.waterAt(x, z) !== null,
+        // the dirt crater of the effects only where the ground is loose; rock, asphalt and a slab keep the soot and the bowl the terrain itself dug
+        cratersAt: (x, z) => terrain.material(terrain.columnAt(x, z).material).reposeDegrees !== void 0
       })
     });
     const renderer = createDestructionRenderer(THREE, {
@@ -56610,10 +56690,21 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
       return { ...pose, position: pose.at(camDistance), free: camDistance };
     };
     const thirdActive = () => cameraMode === "third" && avatar !== null;
+    const firstPersonArms = options.firstPersonArms ?? null;
+    if (firstPersonArms) {
+      firstPersonArms.root.visible = cameraMode === "first";
+      scene2.add(firstPersonArms.root);
+    }
     const syncAvatarVisible = () => {
+      if (firstPersonArms) firstPersonArms.root.visible = cameraMode === "first";
       if (!avatar) return;
       avatar.root.visible = cameraMode === "third" || !!avatar.eye;
-      avatar.setView?.(cameraMode, camera2);
+      avatar.setView?.(cameraMode, camera2, { arms: firstPersonArms !== null });
+    };
+    const updateFirstPersonArms = (dt) => {
+      if (!firstPersonArms || cameraMode !== "first") return;
+      firstPersonArms.update(dt, { camera: camera2, targets: lastHand.targets, stance: lastHand.stance, speed: player.speed, running: avatarState.running, crouch: avatarState.crouch });
+      firstPersonArms.root.traverse((node) => node.layers.set(FIRST_PERSON_LAYER));
     };
     const setCameraMode = (mode) => {
       if (mode !== "first" && mode !== "third") return;
@@ -56697,6 +56788,39 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     };
     let handSource = null;
     let muzzleSource = null;
+    let viewmodelFov = null;
+    const firstPersonCamera = new THREE.PerspectiveCamera(72, 1, 0.01, 30);
+    firstPersonCamera.layers.set(FIRST_PERSON_LAYER);
+    let firstPersonPasses = 0;
+    const drawFirstPersonLayer = () => {
+      if (!firstPersonArms && viewmodelFov === null) return;
+      const renderer2 = gl;
+      if (typeof renderer2.clearDepth !== "function" || typeof renderer2.render !== "function") return;
+      if (firstPersonPasses++ % 60 === 0) {
+        scene2.traverse((node) => {
+          if (node.isLight) node.layers.enable(FIRST_PERSON_LAYER);
+        });
+      }
+      firstPersonCamera.position.copy(camera2.position);
+      firstPersonCamera.quaternion.copy(camera2.quaternion);
+      const fov = viewmodelFov ?? camera2.fov;
+      if (firstPersonCamera.fov !== fov || firstPersonCamera.aspect !== camera2.aspect) {
+        firstPersonCamera.fov = fov;
+        firstPersonCamera.aspect = camera2.aspect;
+        firstPersonCamera.updateProjectionMatrix();
+      }
+      firstPersonCamera.updateMatrixWorld();
+      const { autoClear } = renderer2;
+      const { background, fog } = scene2;
+      renderer2.autoClear = false;
+      scene2.background = null;
+      scene2.fog = null;
+      renderer2.clearDepth();
+      renderer2.render(scene2, firstPersonCamera);
+      scene2.background = background;
+      scene2.fog = fog;
+      renderer2.autoClear = autoClear ?? true;
+    };
     let debugView = null;
     let lastHand = { stance: "relaxed", triggerFinger: null, targets: null };
     const strikeClips = options.strikeClips ?? DEFAULT_STRIKE_CLIPS;
@@ -56844,7 +56968,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
         const line = new THREE.Line(g, tracerMat);
         line.frustumCulled = false;
         scene2.add(line);
-        tr = { line, life: 0 };
+        tr = { line, life: 0, follows: false };
         tracers.push(tr);
       }
       const attr = tr.line.geometry.getAttribute("position");
@@ -56853,6 +56977,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
       attr.needsUpdate = true;
       tr.line.visible = true;
       tr.life = 0.07;
+      tr.follows = muzzleSource !== null;
     };
     const fireZones = [];
     const burningStains = [];
@@ -58168,10 +58293,16 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
       }
     };
     const simulateAfterModules = (dt) => {
+      const drawn = tracers.some((tr) => tr.life > 0 && tr.follows) ? muzzleSource?.() ?? null : null;
       for (const tr of tracers) {
         if (tr.life > 0) {
           tr.life -= dt;
           if (tr.life <= 0) tr.line.visible = false;
+          else if (tr.follows && drawn) {
+            const attr = tr.line.geometry.getAttribute("position");
+            attr.setXYZ(0, drawn.position[0], drawn.position[1], drawn.position[2]);
+            attr.needsUpdate = true;
+          }
         }
       }
       flush();
@@ -58205,6 +58336,7 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
     };
     const updatePresent = (dt) => {
       reachAvatar();
+      updateFirstPersonArms(dt);
       if (progress && simTime - progress.at > 0.25) progress = null;
       ui?.flushLog();
       hudAcc += dt;
@@ -58554,6 +58686,9 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
           if (handSource === source) handSource = null;
         };
       },
+      setViewmodelFov(degrees) {
+        viewmodelFov = degrees;
+      },
       setMuzzleSource(source) {
         muzzleSource = source;
         return () => {
@@ -59285,7 +59420,9 @@ ${SURFACE_GLSL}`).replace("#include <color_fragment>", "#include <color_fragment
           for (const batcher of batchers.values()) batcher.update();
           const restoreCamera = room.applyCamera();
           graphics?.beforeRender(camera2);
-          gl.render(scene2, debugView ?? moduleViews.main(camera2));
+          const view = debugView ?? moduleViews.main(camera2);
+          gl.render(scene2, view);
+          if (view === camera2 && cameraMode === "first") drawFirstPersonLayer();
           moduleViews.render(scene2);
           graphics?.afterRender();
           restoreCamera();