@adatechnology/game-contracts 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -127,7 +127,10 @@ type DamageType =
 'ballistic'
 /** hammers, falls, thrown objects, vehicle impacts: `energy`, `radius` of contact */
  | 'blunt'
-/** axes, knives, machetes: `energy`; cuts and splinters, opens fabric */
+/**
+ * axes, knives, machetes: `energy`; cuts and splinters, opens fabric. A cut only goes through a slice of the part, so its cost follows the
+ * cross-section, not the length: on a part longer than 1 m, slash damage is multiplied by its longest dimension in metres (at most 50).
+ */
  | 'slash'
 /** blasts: `energy`, `radius`; damage and impulse fall off with distance, joints break, fragments fly */
  | 'explosive'
@@ -157,6 +160,8 @@ interface Hit {
     source?: string;
 }
 type PartStatus = 'intact' | 'damaged'
+/** the part lost its support path to the ground and fell with its group (reported by a `collapse` event); it still exists as a piece */
+ | 'collapsed'
 /** hp reached 0; the part fractured into fragments (it no longer exists as one piece) */
  | 'broken'
 /** melted into a puddle */
@@ -208,7 +213,7 @@ interface PartState {
     liters?: number;
     /**
      * Structural parts only. Load in kg: own mass plus what rests on the part. `stress` = `load / capacity`; above 1 the part takes damage every
-     * `update` (`(stress - 1) * maxHp * 0.5` per second), which can cascade. Capacity is `structure.capacity`, else `compressive * section` of the
+     * `update` (`min(0.6, 0.12 + 0.8 * (stress - 1))` of `maxHp` per second: about 7 s at stress 1.02, 2 s at 1.5, 1.7 s above 1.7), which can cascade. Capacity is `structure.capacity`, else `compressive * section` of the
      * material, where the section is the product of the two smallest dimensions (columns, beams, roofs, stairs, foundations x10), thickness times longest dimension (slabs) or
      * thickness times horizontal length (walls). Example: a 0.3 m concrete column carries 40 t, a 0.2 m brick wall 8 t per metre, a 0.1x0.2 m softwood beam 2 t.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-contracts",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "license": "MIT",
   "description": "The contracts every game module depends on, and nothing else: destruction (parts, hits, events, DestructibleImpl), weapons (shots), fluids (containers, item uses), item animations and the TestableModule a module hands the test room. Types plus tiny checkers, no runtime dependencies.",
   "keywords": [