@waica/behaviors 0.12.0 → 0.13.0

package/dist/health.d.ts

@@ -45,6 +45,10 @@ export declare class Health extends Component {
             label: string;
             ref: 'stat';
         };
+        hurtSound: {
+            label: string;
+            ref: 'sound';
+        };
     };
     static transient: string[];
     max: number;
@@ -55,6 +59,8 @@ export declare class Health extends Component {
      * publishes nothing: the stat is the project's to declare.
      */
     stat: string;
+    /** Sound played at this entity's position on every accepted hit. Empty plays nothing (CA-12). */
+    hurtSound: string;
     /** Health left; 0 is dead. Filled in from max on ready. */
     current: number;
     /** Whoever dealt the last accepted hit, for the state that reacts to it. */

package/dist/health.js

@@ -47,6 +47,7 @@ export class Health extends Component {
         max: { label: 'Max health', min: 1, max: 20, step: 1 },
         invulnerability: { label: 'Invulnerability', min: 0, max: 5, step: 0.1 },
         stat: { label: 'Stat', ref: 'stat' },
+        hurtSound: { label: 'Hurt sound', ref: 'sound' },
     };
     static transient = [
         'current',
@@ -64,6 +65,8 @@ export class Health extends Component {
      * publishes nothing: the stat is the project's to declare.
      */
     stat = '';
+    /** Sound played at this entity's position on every accepted hit. Empty plays nothing (CA-12). */
+    hurtSound = '';
     /** Health left; 0 is dead. Filled in from max on ready. */
     current = 0;
     /** Whoever dealt the last accepted hit, for the state that reacts to it. */
@@ -158,6 +161,8 @@ export class Health extends Component {
             current: this.current,
             source,
         });
+        if (this.hurtSound)
+            this.game.audio.play(this.hurtSound, { at: this.entity });
         this.invulnerable = this.invulnerability;
         this.blinkClock = 0;
         if (this.current === 0) {

package/dist/melee-attack.d.ts

@@ -29,12 +29,18 @@ export declare class MeleeAttack extends Component {
             max: number;
             step: number;
         };
+        swingSound: {
+            label: string;
+            ref: 'sound';
+        };
     };
     damage: number;
     /** How far in front of the attacker the blow reaches, in world units. */
     range: number;
     /** How wide the blow is, across the facing. */
     width: number;
+    /** Sound played on every swing. Empty plays nothing (CA-12). */
+    swingSound: string;
     /**
      * Lands one blow along `facing`: every other living entity with a Hitbox
      * and a Health inside the strike area takes `damage` once, with this

package/dist/melee-attack.js

@@ -16,12 +16,15 @@ export class MeleeAttack extends Component {
         damage: { label: 'Damage', min: 0, max: 20, step: 1 },
         range: { label: 'Range', min: 0.5, max: 5, step: 0.5 },
         width: { label: 'Width', min: 0.5, max: 5, step: 0.5 },
+        swingSound: { label: 'Swing sound', ref: 'sound' },
     };
     damage = 1;
     /** How far in front of the attacker the blow reaches, in world units. */
     range = 1;
     /** How wide the blow is, across the facing. */
     width = 1;
+    /** Sound played on every swing. Empty plays nothing (CA-12). */
+    swingSound = '';
     /**
      * Lands one blow along `facing`: every other living entity with a Hitbox
      * and a Health inside the strike area takes `damage` once, with this
@@ -33,6 +36,11 @@ export class MeleeAttack extends Component {
         const direction = logicalDirection(facing, this.game.projection);
         if (!direction)
             return [];
+        // Positional like Health's hurtSound (CA-8): an off-camera NPC's swing
+        // should attenuate and pan like the hit it causes, not play flat and
+        // dead-centre while the damage it lands sounds correctly placed.
+        if (this.swingSound)
+            this.game.audio.play(this.swingSound, { at: this.entity });
         const area = this.strikeArea(direction.x, direction.y);
         const struck = [];
         // A copy: a target with no death-handling graph is destroyed on the spot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/behaviors",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Waica built-in behaviors — the curated game-feel library",
   "license": "MIT",
   "type": "module",
@@ -19,6 +19,6 @@
     }
   },
   "dependencies": {
-    "@waica/engine": "^0.12.0"
+    "@waica/engine": "^0.13.0"
   }
 }