@waica/archetype-third-person 0.29.0 → 0.30.0

package/README.md

@@ -22,12 +22,13 @@ npx @waica/cli            # New project → 3D → Third person
 - **Combat.** `MeleeAttack` strikes a box in front of the Knight's yaw;
   skeletons (the `enemy` role) patrol, chase, wind up, strike, flinch and
   die. Hits push back, blink the model and shake the camera.
-- **Checkpoints.** Touch a banner to make it your respawn point; dying fades
-  out and back in there with full health.
+- **Checkpoints.** Touch a banner hung on a wall to make it your respawn
+  point; dying fades out and back in on the floor in front of it with full
+  health (the Checkpoint's `spawnOffset`).
 - **The demo.** A walled courtyard with columns, wall torches (Point
-  Lights), three skeletons, two checkpoints and the goal chest on a raised
-  platform: reach it to win. The blank start is a ground plane, a Sun and
-  the playable Knight.
+  Lights), three skeletons, two checkpoint banners on the side walls and the
+  goal chest on a raised platform: reach it to win. The blank start is a
+  ground plane, a Sun and the playable Knight.
 
 ## Controls
 

package/dist/prefabs.d.ts

@@ -3,9 +3,16 @@ import type { PrefabJson } from '@waica/engine';
 export declare const KNIGHT_CLIPS: Readonly<Record<string, string>>;
 /** The Skeleton Warrior's clip for each `enemy` state (assets/ATTRIBUTION.md). */
 export declare const SKELETON_CLIPS: Readonly<Record<string, string>>;
+/**
+ * How deep a checkpoint banner's origin sits inside the wall it hangs on: the
+ * banner is modelled to hang on a wall, its cloth's back 0.378 in front of
+ * its origin, so at this inset the cloth lies flush on the wall's inner face.
+ * The scene places the origin by it and the prefab its sensor and spawn.
+ */
+export declare const BANNER_INSET = 0.35;
 /**
  * The archetype's prefabs (issue #181 CA-25): the Knight and the Skeleton
- * Warrior, a checkpoint and the goal chest (sensors), and the level pieces —
+ * Warrior, a checkpoint (a wall banner) and the goal chest (sensors), and the level pieces —
  * each a KayKit Dungeon Remastered model on a fixed Collider sized to it, the
  * torch with a warm Point Light. A step is the foundation block scaled flat.
  */

package/dist/prefabs.js

@@ -74,9 +74,22 @@ const SKELETON = {
         { type: 'Health', props: { max: 3, invulnerability: 0.3, healthBar: 'health-bar', damageNumber: 'damage-number' } },
     ],
 };
+/**
+ * How deep a checkpoint banner's origin sits inside the wall it hangs on: the
+ * banner is modelled to hang on a wall, its cloth's back 0.378 in front of
+ * its origin, so at this inset the cloth lies flush on the wall's inner face.
+ * The scene places the origin by it and the prefab its sensor and spawn.
+ */
+export const BANNER_INSET = 0.35;
+/**
+ * How far in front of a checkpoint banner's origin its 2-deep sensor and its
+ * spawn sit: the sensor starts at the wall's inner face and the Knight
+ * respawns 1 from it.
+ */
+const CHECKPOINT_REACH = BANNER_INSET + 1;
 /**
  * The archetype's prefabs (issue #181 CA-25): the Knight and the Skeleton
- * Warrior, a checkpoint and the goal chest (sensors), and the level pieces —
+ * Warrior, a checkpoint (a wall banner) and the goal chest (sensors), and the level pieces —
  * each a KayKit Dungeon Remastered model on a fixed Collider sized to it, the
  * torch with a warm Point Light. A step is the foundation block scaled flat.
  */
@@ -88,8 +101,9 @@ export const THIRD_PERSON_PREFABS = {
         type: 'object',
         components: [
             { type: 'Model', props: { src: 'waica:tp-banner' } },
-            { type: 'Collider', props: { shape: 'box', size: [2, 3, 2], offset: [0, 1.5, 0], sensor: true, layer: 'world' } },
-            { type: 'Checkpoint' },
+            // A wall banner: its origin on the wall, its sensor and spawn on the floor in front of the wall (local +z).
+            { type: 'Collider', props: { shape: 'box', size: [2, 3, 2], offset: [0, 1.5, CHECKPOINT_REACH], sensor: true, layer: 'world' } },
+            { type: 'Checkpoint', props: { spawnOffset: [0, 0, CHECKPOINT_REACH] } },
         ],
     },
     'objects/goal-chest': {

package/dist/scene-default.js

@@ -1,3 +1,4 @@
+import { BANNER_INSET } from './prefabs.js';
 /**
  * The orbit camera every scene follows the Player with. `position`/`target`
  * frame the editor's first look: where the orbit starts behind a Player at
@@ -32,6 +33,12 @@ const TILE_CENTERS = [-8, -4, 0, 4, 8];
 function floorTiles() {
     return TILE_CENTERS.flatMap((x) => TILE_CENTERS.map((z) => ({ name: `Floor ${x} ${z}`, prefab: 'tiles/floor', position: [x, 0, z] })));
 }
+/**
+ * Where a checkpoint's wall banner hangs from the yard's centre: BANNER_INSET
+ * inside a wall whose inner face is HALF - 0.5 away (the wall pieces are 1
+ * thick), so its cloth lies flush on it.
+ */
+const BANNER_AT = HALF - 0.5 + BANNER_INSET;
 /** The four sides of wall pieces, each turned to face the yard. */
 function walls() {
     return TILE_CENTERS.flatMap((at) => [
@@ -71,8 +78,9 @@ export const THIRD_PERSON_SCENE = threeDScene([
     { name: 'Torch NE', prefab: 'tiles/torch', position: [4, 2.5, -9.5] },
     { name: 'Torch SW', prefab: 'tiles/torch', position: [-4, 2.5, 9.5], rotation: [0, 180, 0] },
     { name: 'Torch SE', prefab: 'tiles/torch', position: [4, 2.5, 9.5], rotation: [0, 180, 0] },
-    { name: 'Checkpoint West', prefab: 'objects/checkpoint', position: [-7, 0, 6] },
-    { name: 'Checkpoint East', prefab: 'objects/checkpoint', position: [8, 0, 3] },
+    // Each banner hangs centred on a side wall's z 4 piece, turned like that wall to face the yard.
+    { name: 'Checkpoint West', prefab: 'objects/checkpoint', position: [-BANNER_AT, 0, 4], rotation: [0, 90, 0] },
+    { name: 'Checkpoint East', prefab: 'objects/checkpoint', position: [BANNER_AT, 0, 4], rotation: [0, -90, 0] },
     { name: 'Goal Chest', prefab: 'objects/goal-chest', position: [6, 0.5, -6] },
     ...SKELETONS,
     { name: 'Player', prefab: 'characters/player', position: [0, 0, 3.5] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-third-person",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Waica third-person archetype — an orbit camera, camera-relative controls and 3D melee combat in a dungeon courtyard",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@waica/behaviors": "^0.29.0",
-    "@waica/engine": "^0.29.0"
+    "@waica/behaviors": "^0.30.0",
+    "@waica/engine": "^0.30.0"
   }
 }