@adatechnology/game-destruction 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Vec3, Quat, MaterialId, FractureStyle, DamageType, DebrisKind, DestructionEvent, StructureRole, SoilProfile, WindExposure, IgnitionRules, BlastOptions, DestructibleSpec, ObjectState, DestructibleImpl, Hit, HitResult, RayHit, BallisticExtras, ToolKind, JointState, PartState, DestructionEventType, ConfinementOptions, FragmentHitOptions, ShelterOptions, ExplosionChain, PartSpec, JointKind, JointSpec, PartShape, SurfaceLayer, PartUnits, Reinforcement, PartBreach, DeepPartial, PileSpec, PartStatus, CostOptions } from '@adatechnology/game-contracts';
+import { Vec3, Quat, MaterialId, FractureStyle, DamageType, DebrisKind, DestructionEvent, StructureRole, SoilProfile, WindExposure, IgnitionRules, BlastOptions, DestructibleSpec, ObjectState, DestructibleImpl, Hit, HitResult, ShelterOptions, RayHit, BallisticExtras, ToolKind, JointState, PartState, DestructionEventType, ConfinementOptions, FragmentHitOptions, ExplosionChain, PartSpec, JointKind, JointSpec, PartShape, SurfaceLayer, PartUnits, Reinforcement, PartBreach, DeepPartial, PileSpec, PartStatus, CostOptions } from '@adatechnology/game-contracts';
 export { BallisticExtras, BlastOptions, BlastReport, ChainDelay, ConfinementOptions, Crack, DamageStage, DamageType, DebrisKind, Dent, DestructibleImpl, DestructibleSpec, DestructionEvent, DestructionEventType, ExplosionChain, FluidKind, FractureStyle, Fragment, FragmentHitOptions, FragmentMark, Hit, HitIgnition, HitResult, Hole, IMPACT_CONTRACT, ImpactContract, JointKind, JointSpec, JointState, MaterialId, ObjectState, PartBreach, PartShape, PartSpec, PartState, PartStatus, PartUnits, PileSpec, Quat, RayHit, Reinforcement, ShelterOptions, SoilLayer, SoilProfile, SoilState, StructureRole, SurfaceLayer, TensionRebar, ToolKind, TunedMassDamper, Vec3, WindExposure, WindState, checkHit } from '@adatechnology/game-contracts';
 
 /**
@@ -457,6 +457,16 @@ interface DestructionWorld {
      * that target, and a `blast` event sums it up.
      */
     explode(point: Vec3, energy: number, radius: number, source?: string, options?: BlastOptions): HitResult[];
+    /**
+     * The share (0..1) of a blast at `point` that reaches `target` through what stands between them: every part the straight line crosses lets
+     * `exp(-r / k)` through (`ShelterOptions`; `r` the hit points of the slab per square metre), a broken part or a hole lets it all by. Always on, whatever
+     * `BlastOptions.shelter` says: the shove of a blast (people, the player, loose things) is blocked by cover in every room. `ignore` lists objects that never
+     * block (the explosive itself, the body being shoved).
+     */
+    blastReach(point: Vec3, target: Vec3, options?: {
+        readonly ignore?: readonly string[];
+        readonly shelter?: ShelterOptions;
+    }): number;
     /** Cost of the last `explode`: parts in range of the broad phase (`partsTested`) and those whose bounding sphere the blast reached (`partsNear`). */
     blastProbe(): {
         partsTested: number;

package/dist/index.global.js

@@ -3210,7 +3210,13 @@ var GameDestruction = (() => {
       const typed = listeners.get(e.type);
       if (typed) for (const fn of [...typed]) fn(e);
     };
-    const base = (o, source) => source === void 0 ? { object: o.id, time } : { object: o.id, time, source };
+    let blow;
+    const base = (o, source) => ({
+      object: o.id,
+      time,
+      ...source === void 0 ? {} : { source },
+      ...blow === void 0 ? {} : { blow }
+    });
     const pendingCollapse = /* @__PURE__ */ new Map();
     let runDepth = 0;
     const drainBlasts = () => {
@@ -5355,7 +5361,17 @@ var GameDestruction = (() => {
       res.events = cur.slice(start);
       return res;
     };
-    const doHit = (o, hit, only) => {
+    const withBlow = (type, fn) => () => {
+      const outer = blow;
+      blow = type;
+      try {
+        return fn();
+      } finally {
+        blow = outer;
+      }
+    };
+    const doHit = (o, hit, only) => withBlow(hit.type, () => resolveHit(o, hit, only))();
+    const resolveHit = (o, hit, only) => {
       let point = hit.point;
       let dir = hit.direction;
       if (hit.space === "local") {
@@ -5794,6 +5810,44 @@ var GameDestruction = (() => {
       blastProbe() {
         return { ...blastProbe };
       },
+      blastReach(point, target, options2 = {}) {
+        const L = vec.distance(point, target);
+        if (L < 1e-4) return 1;
+        const shelter = { ...SHELTER_DEFAULTS, ...options2.shelter };
+        const ignore = new Set(options2.ignore ?? []);
+        const d = vec.scale(vec.sub(target, point), 1 / L);
+        let t = 1;
+        for (const o of objects.values()) {
+          if (ignore.has(o.id) || raySphereMiss(point, d, toWorld(o.st.position, o.st.rotation, o.bc), o.br, L)) continue;
+          for (const p of o.parts) {
+            if (isLost(p) || p.st.stripped) continue;
+            const r = rayPart(o, p, point, d);
+            if (!r) continue;
+            const t0 = Math.max(r.t0, 0);
+            const path = Math.min(r.t1, L) - t0;
+            if (path < shelter.minPath) continue;
+            if (p.st.opening && insideOpening(o, p, toLocal(o.st.position, o.st.rotation, vec.madd(point, d, t0 + path / 2)))) continue;
+            t *= Math.exp(-(p.mat.hpPerKg * p.mat.density * path * (p.mat.damageScale?.shelter ?? 1)) / shelter.k);
+            if (t < 1e-4) return 0;
+          }
+        }
+        for (const im of impls.values()) {
+          if (ignore.has(im.impl.id)) continue;
+          for (const ps of im.impl.describe().parts) {
+            const mat = materials.get(ps.material);
+            if (!mat) continue;
+            const ov = im.poses.get(ps.id);
+            const r = rayPartRaw(im.position, im.rotation, ps, ov?.q ?? quatFromEuler(...ps.rotation ?? [0, 0, 0]), point, d, ov?.pos);
+            if (!r || r.t1 < 0 || r.t0 > L) continue;
+            let path = Math.min(r.t1, L) - Math.max(r.t0, 0);
+            if (ps.thickness !== void 0 && ps.thickness > 0) path = Math.min(path, 2 * ps.thickness);
+            else if (path < shelter.minPath) continue;
+            t *= Math.exp(-(mat.hpPerKg * mat.density * path * (mat.damageScale?.shelter ?? 1)) / shelter.k);
+            if (t < 1e-4) return 0;
+          }
+        }
+        return t;
+      },
       explode(point, energy, radius, source, blast) {
         blastProbe.partsTested = 0;
         blastProbe.partsNear = 0;
@@ -5818,7 +5872,7 @@ var GameDestruction = (() => {
       },
       shoot(origin, direction, energy, caliber, source, round) {
         const extras = typeof round === "number" ? { piercing: round } : round ?? {};
-        return withCollapses(run(() => {
+        return withCollapses(run(withBlow("ballistic", () => {
           const results = [];
           const d = vec.normalize(direction);
           const ignore = /* @__PURE__ */ new Set();
@@ -5829,10 +5883,12 @@ var GameDestruction = (() => {
             if (!rh) break;
             const im = impls.get(rh.object);
             if (im) {
-              const r = implHit(im, { type: "ballistic", point: rh.point, part: rh.part, normal: rh.normal, direction: d, energy: E, caliber, ...extras, ...source !== void 0 ? { source } : {} });
+              const scaled = extras.penetration && E < energy ? { ...extras, penetration: Object.fromEntries(Object.entries(extras.penetration).map(([k, mm]) => [k, mm * (E / energy)])) } : extras;
+              const r = implHit(im, { type: "ballistic", point: rh.point, part: rh.part, normal: rh.normal, direction: d, energy: E, caliber, ...scaled, ...source !== void 0 ? { source } : {} });
               r.part = rh.part;
               r.point = rh.point;
-              r.exitEnergy = r.penetrated ? E * 0.5 : 0;
+              const left = r.events.find((e) => e.type === "hole" && e.energyLeft !== void 0);
+              r.exitEnergy = r.penetrated ? left?.energyLeft ?? E * 0.5 : 0;
               results.push(r);
               ignore.add(`${im.impl.id}\0${rh.part}`);
               if (!r.penetrated) break;
@@ -5851,7 +5907,7 @@ var GameDestruction = (() => {
             E = out.exitEnergy;
           }
           return results;
-        }));
+        })));
       },
       disassemble(objectId, jointId, tool, dt) {
         const im = impls.get(objectId);