@ai-rpg-engine/starter-template 2.4.0 → 2.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCP Tool Shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@ai-rpg-engine/starter-template",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Starter template for ai-rpg-engine — copy, rename, and build your own game",
   "type": "module",
   "files": [
     "src",
     "README.md",
+    "LICENSE",
     "tsconfig.json"
   ],
   "scripts": {

package/src/content.ts

@@ -15,7 +15,13 @@ export const manifest: GameManifest = {
 };
 
 // ═══════════════════════════════════════════════════════════════════
-// PACK METADATA (used by the CLI pack selector)
+// PACK METADATA
+// This is a minimal subset to keep the template dependency-light. To list
+// your pack in the CLI pack selector, export the full PackMetadata shape
+// from @ai-rpg-engine/pack-registry (adds: tagline, genres, difficulty,
+// tones, tags, engineVersion, narratorTone) plus a BuildCatalog from
+// @ai-rpg-engine/character-creation — see any packages/starter-* content.ts
+// for a complete example.
 // ═══════════════════════════════════════════════════════════════════
 
 export const packMeta = {

package/src/setup.ts

@@ -24,13 +24,17 @@ import { myRuleset } from './ruleset.js';
 // your starter feel different from other starters.
 // ═══════════════════════════════════════════════════════════════════
 
-// Example: a custom module that ticks your "tension" resource each combat round
+// Example: a custom module that raises your "tension" resource whenever
+// damage lands in combat. It listens on 'combat.damage.applied' — a real
+// event emitted by combat-core every time an attack connects (other engine
+// events you can hook: 'combat.contact.hit', 'combat.contact.miss',
+// 'combat.entity.defeated', 'status.applied', 'world.zone.entered').
 function createTensionPressure(): EngineModule {
     return {
         id: 'tension-pressure',
         version: '1.0.0',
         register(ctx) {
-            ctx.events.on('combat.round.end', (event: ResolvedEvent, world: WorldState) => {
+            ctx.events.on('combat.damage.applied', (event: ResolvedEvent, world: WorldState) => {
                 const p = world.entities['player'];
                 if (p && p.resources.tension !== undefined) {
                     p.resources.tension = Math.min(100, (p.resources.tension ?? 0) + 5);
@@ -49,16 +53,29 @@ export function createGame(seed?: number): Engine {
     const combat = buildCombatStack({
         statMapping: { attack: 'power', precision: 'speed', resolve: 'grit' },
         playerId: 'player',
-        // resourceProfile — uncomment and customize for your game's resource pressure:
+        // resourceProfile — uncomment and customize for your game's resource
+        // pressure. A CombatResourceProfile needs packId + the four arrays
+        // (gains / spends / drains / aiModifiers — empty arrays are fine):
         // resourceProfile: {
+        //   packId: 'my-game',
+        //   gains: [
+        //     // +2 tension every time an attack you make lands
+        //     { trigger: 'attack-hit', resourceId: 'tension', amount: 2 },
+        //   ],
         //   spends: [
-        //     { verbId: 'attack', costStat: 'stamina', amount: 2 },
+        //     // spend 2 stamina on each attack for +1 damage
+        //     { action: 'attack', resourceId: 'stamina', amount: 2, effects: { damageBonus: 1 } },
         //   ],
+        //   drains: [],
+        //   aiModifiers: [],
         // },
-        // biasTags — entity tags that cognition uses for faction bias:
-        // biasTags: ['enemy'],
-        // engagement — customize if your game uses ranged/melee distance:
-        // engagement: { defaultRange: 'melee' },
+        // biasTags — built-in pack bias tags that shape combat AI intent.
+        // Must come from PACK_BIAS_TAGS (exported by @ai-rpg-engine/modules,
+        // e.g. 'undead', 'beast', 'feral'); unknown tags warn and are dropped:
+        // biasTags: ['undead', 'beast'],
+        // engagement — backline/protector behavior for ranged parties
+        // (fields: backlineTags, protectorTags, chokepointTag, ambushTag):
+        // engagement: { backlineTags: ['ranged', 'caster'], protectorTags: ['bodyguard'] },
         // recovery — safe zone recovery:
         recovery: { safeZoneTags: ['safe'] },
     });

package/src/starter.test.ts

@@ -27,9 +27,21 @@ describe('starter template', () => {
         expect(engine).toBeDefined();
     });
 
-    it('tension pressure module is wired', () => {
+    it('tension rises when combat damage lands (tension-pressure fires)', () => {
         const engine = createGame(1);
-        const p = engine.world.entities['player'];
-        expect(p?.resources.tension).toBe(0);
+        expect(engine.world.entities['player']?.resources.tension).toBe(0);
+
+        // Walk into the danger zone and fight. combat-core emits
+        // 'combat.damage.applied' whenever a hit lands — that is the event
+        // the tension-pressure module listens on.
+        engine.submitAction('move', { targetIds: ['danger-zone'] });
+        for (let i = 0; i < 8; i++) {
+            engine.submitAction('attack', { targetIds: ['grunt'] });
+            if ((engine.world.entities['player']?.resources.tension ?? 0) > 0) break;
+        }
+
+        // Meta-test property: deleting the tension-pressure listener in
+        // setup.ts turns this RED — nothing else writes the tension resource.
+        expect(engine.world.entities['player']?.resources.tension).toBeGreaterThan(0);
     });
 });