@ai-rpg-engine/starter-zombie 2.2.4 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. package/LICENSE +21 -21
  2. package/README.es.md +73 -73
  3. package/README.fr.md +73 -73
  4. package/README.hi.md +73 -73
  5. package/README.it.md +73 -73
  6. package/README.ja.md +73 -73
  7. package/README.md +79 -79
  8. package/README.pt-BR.md +73 -73
  9. package/README.zh.md +73 -73
  10. package/dist/content.d.ts.map +1 -1
  11. package/dist/content.js +1 -2
  12. package/dist/content.js.map +1 -1
  13. package/dist/index.d.ts +1 -1
  14. package/dist/index.d.ts.map +1 -1
  15. package/dist/index.js +1 -1
  16. package/dist/index.js.map +1 -1
  17. package/dist/setup.d.ts.map +1 -1
  18. package/dist/setup.js +6 -4
  19. package/dist/setup.js.map +1 -1
  20. package/package.json +48 -48
package/README.it.md CHANGED
@@ -1,73 +1,73 @@
1
- <p align="center">
2
- <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
3
- </p>
4
-
5
- <p align="center">
6
- <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
- </p>
8
-
9
- <p align="center">
10
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
- <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
- </p>
14
-
15
- # @ai-rpg-engine/starter-zombie
16
-
17
- **Ashfall Dead** — un mondo di esempio per giochi di sopravvivenza a tema zombie, progettato per AI RPG Engine.
18
-
19
- ## Installazione
20
-
21
- ```bash
22
- npm install @ai-rpg-engine/starter-zombie
23
- ```
24
-
25
- ## Cosa imparerai
26
-
27
- Questo esempio dimostra l'intera struttura del motore attraverso uno scenario di sopravvivenza:
28
-
29
- | Caratteristiche | Cosa mostra lo zombie |
30
- |---|---|
31
- | **Rulesets** | `zombieMinimalRuleset` — statistiche (forma fisica/intelligenza/coraggio), risorse (punti vita/energia/infezione), verbi, formule. |
32
- | **Zones & traversal** | 5 zone in 3 ambienti, con adiacenze, livelli di illuminazione, elementi interattivi e pericoli. |
33
- | **Districts** | Il rifugio (fazione dei sopravvissuti) contro la zona infestata (ostile, non-morta). |
34
- | **Dialogue** | Conversazione ramificata con un medico, con una missione secondaria per recuperare rifornimenti ospedalieri. |
35
- | **Combat** | Zombie lenti e resistenti (Shambler) e zombie veloci e fragili (Runner), con intelligenza artificiale aggressiva. |
36
- | **Cognition & perception** | Decadimento della memoria, filtro percettivo, regola di presentazione della fame degli zombie. |
37
- | **Progression** | Albero di sopravvivenza con 3 livelli, con ricompense di esperienza per ogni nemico sconfitto. |
38
- | **Environment** | Zombie erranti che consumano energia, zone a rischio di infezione che aumentano il livello di infezione. |
39
- | **Factions** | Fazione dei sopravvissuti con medico, saccheggiatore e leader militare. |
40
- | **Belief provenance** | Diffusione di voci con ritardo, tracciamento delle credenze. |
41
- | **Inventory** | Antibiotici con effetto di utilizzo programmato che riduce l'infezione. |
42
- | **Simulation inspector** | Sistema di analisi completo per la revisione delle partite. |
43
-
44
- ## Cosa è incluso
45
-
46
- - **5 zone** — Lobby del rifugio, stazione di servizio abbandonata, strada invasa, ala est dell'ospedale, tetto dell'ospedale.
47
- - **3 PNG** — Dott. Chen (medico), Rook (saccheggiatore), Sergente Marsh (leader militare).
48
- - **2 nemici** — Shambler (non-morto lento e resistente), Runner (non-morto veloce e fragile).
49
- - **1 oggetto** — Antibiotici (riducono l'infezione del 25%).
50
- - **1 albero di progressione** — Sopravvivenza (Scrapper → Cool-Headed → Last One Standing).
51
- - **1 regola di presentazione** — Gli zombie percepiscono tutti gli esseri viventi come prede.
52
- - **15 moduli collegati** — movimento, stato, combattimento, inventario, dialogo, cognizione, percezione, progressione, ambiente, fazioni, voci, distretti, credenze, presentazione dell'osservatore, ispettore.
53
-
54
- ## Utilizzo
55
-
56
- ```typescript
57
- import { createGame } from '@ai-rpg-engine/starter-zombie';
58
-
59
- // One line — all 15 modules, content, and ruleset pre-wired
60
- const engine = createGame(42);
61
-
62
- // Or import pieces individually:
63
- import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
64
- ```
65
-
66
- ## Documentazione
67
-
68
- - [Manuale](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
69
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
70
-
71
- ---
72
-
73
- Creato da <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
1
+ <p align="center">
2
+ <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
3
+ </p>
4
+
5
+ <p align="center">
6
+ <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
+ </p>
8
+
9
+ <p align="center">
10
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
+ <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
+ </p>
14
+
15
+ # @ai-rpg-engine/starter-zombie
16
+
17
+ **Ashfall Dead** — un mondo di esempio per giochi di sopravvivenza a tema zombie, progettato per AI RPG Engine.
18
+
19
+ ## Installazione
20
+
21
+ ```bash
22
+ npm install @ai-rpg-engine/starter-zombie
23
+ ```
24
+
25
+ ## Cosa imparerai
26
+
27
+ Questo esempio dimostra l'intera struttura del motore attraverso uno scenario di sopravvivenza:
28
+
29
+ | Caratteristiche | Cosa mostra lo zombie |
30
+ |---|---|
31
+ | **Rulesets** | `zombieMinimalRuleset` — statistiche (forma fisica/intelligenza/coraggio), risorse (punti vita/energia/infezione), verbi, formule. |
32
+ | **Zones & traversal** | 5 zone in 3 ambienti, con adiacenze, livelli di illuminazione, elementi interattivi e pericoli. |
33
+ | **Districts** | Il rifugio (fazione dei sopravvissuti) contro la zona infestata (ostile, non-morta). |
34
+ | **Dialogue** | Conversazione ramificata con un medico, con una missione secondaria per recuperare rifornimenti ospedalieri. |
35
+ | **Combat** | Zombie lenti e resistenti (Shambler) e zombie veloci e fragili (Runner), con intelligenza artificiale aggressiva. |
36
+ | **Cognition & perception** | Decadimento della memoria, filtro percettivo, regola di presentazione della fame degli zombie. |
37
+ | **Progression** | Albero di sopravvivenza con 3 livelli, con ricompense di esperienza per ogni nemico sconfitto. |
38
+ | **Environment** | Zombie erranti che consumano energia, zone a rischio di infezione che aumentano il livello di infezione. |
39
+ | **Factions** | Fazione dei sopravvissuti con medico, saccheggiatore e leader militare. |
40
+ | **Belief provenance** | Diffusione di voci con ritardo, tracciamento delle credenze. |
41
+ | **Inventory** | Antibiotici con effetto di utilizzo programmato che riduce l'infezione. |
42
+ | **Simulation inspector** | Sistema di analisi completo per la revisione delle partite. |
43
+
44
+ ## Cosa è incluso
45
+
46
+ - **5 zone** — Lobby del rifugio, stazione di servizio abbandonata, strada invasa, ala est dell'ospedale, tetto dell'ospedale.
47
+ - **3 PNG** — Dott. Chen (medico), Rook (saccheggiatore), Sergente Marsh (leader militare).
48
+ - **2 nemici** — Shambler (non-morto lento e resistente), Runner (non-morto veloce e fragile).
49
+ - **1 oggetto** — Antibiotici (riducono l'infezione del 25%).
50
+ - **1 albero di progressione** — Sopravvivenza (Scrapper → Cool-Headed → Last One Standing).
51
+ - **1 regola di presentazione** — Gli zombie percepiscono tutti gli esseri viventi come prede.
52
+ - **15 moduli collegati** — movimento, stato, combattimento, inventario, dialogo, cognizione, percezione, progressione, ambiente, fazioni, voci, distretti, credenze, presentazione dell'osservatore, ispettore.
53
+
54
+ ## Utilizzo
55
+
56
+ ```typescript
57
+ import { createGame } from '@ai-rpg-engine/starter-zombie';
58
+
59
+ // One line — all 15 modules, content, and ruleset pre-wired
60
+ const engine = createGame(42);
61
+
62
+ // Or import pieces individually:
63
+ import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
64
+ ```
65
+
66
+ ## Documentazione
67
+
68
+ - [Manuale](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
69
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
70
+
71
+ ---
72
+
73
+ Creato da <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.ja.md CHANGED
@@ -1,73 +1,73 @@
1
- <p align="center">
2
- <a href="README.md">English</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
3
- </p>
4
-
5
- <p align="center">
6
- <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
- </p>
8
-
9
- <p align="center">
10
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
- <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
- </p>
14
-
15
- # @ai-rpg-engine/starter-zombie
16
-
17
- **Ashfall Dead** — AI RPG Engine用の、ゾンビサバイバルをテーマにしたスターターワールド。
18
-
19
- ## インストール
20
-
21
- ```bash
22
- npm install @ai-rpg-engine/starter-zombie
23
- ```
24
-
25
- ## 学習内容
26
-
27
- このスターターは、サバイバルシナリオを通じて、AIエンジンの機能をすべて紹介しています。
28
-
29
- | 特徴 | ゾンビの動作 |
30
- |---|---|
31
- | **Rulesets** | `zombieMinimalRuleset` — 属性（体力/知力/精神力）、資源（HP/スタミナ/感染）、動詞、数式 |
32
- | **Zones & traversal** | 隣接関係、明るさ、インタラクション可能なオブジェクト、危険要素を持つ、3つの部屋に5つのエリア |
33
- | **Districts** | 安全地帯（生存者派閥） vs デッドゾーン（敵対、アンデッド） |
34
- | **Dialogue** | 病院の物資調達クエストにつながる、医療担当者との会話分岐 |
35
- | **Combat** | ゆっくりとしたが頑丈な「シャムラー」と、素早くも脆い「ランナー」のゾンビ。それぞれに攻撃AIを搭載。 |
36
- | **Cognition & perception** | 記憶の減衰、知覚フィルター、ゾンビの飢餓状態の表示ルール |
37
- | **Progression** | 敵を倒すと経験値を獲得できる、3つのノードからなるサバイバルツリー |
38
- | **Environment** | 徘徊するゾンビによるスタミナの消耗、感染リスクのあるエリアによる感染の増加 |
39
- | **Factions** | 医療担当者、スカベンジャー、軍事指導者を含む生存者派閥 |
40
- | **Belief provenance** | 遅延付きの噂の伝播、信念の追跡 |
41
- | **Inventory** | 感染を軽減するスクリプトによるアイテム使用効果を持つ抗生物質 |
42
- | **Simulation inspector** | リプレイ分析のための完全な検査機能 |
43
-
44
- ## 内容
45
-
46
- - **5つのエリア** — 安全地帯ロビー、廃墟となったガソリンスタンド、占拠された通り、病院東棟、病院屋上
47
- - **3人のNPC** — Dr.チェン（医療担当者）、ルーク（スカベンジャー）、軍曹マーシュ（軍事指導者）
48
- - **2種類の敵** — シャムラー（ゆっくりとした頑丈なアンデッド）、ランナー（素早くも脆いアンデッド）
49
- - **1つのアイテム** — 抗生物質（感染を25%軽減）
50
- - **1つの成長ツリー** — サバイバル（スカッパー → 冷静沈着 → 最後の生き残り）
51
- - **1つの表示ルール** — ゾンビはすべての生き物を獲物として認識する
52
- - **15のモジュール** — 移動、状態、戦闘、インベントリ、会話、認知、知覚、成長、環境、派閥、噂、地区、信念、観察表示、検査
53
-
54
- ## 使用方法
55
-
56
- ```typescript
57
- import { createGame } from '@ai-rpg-engine/starter-zombie';
58
-
59
- // One line — all 15 modules, content, and ruleset pre-wired
60
- const engine = createGame(42);
61
-
62
- // Or import pieces individually:
63
- import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
64
- ```
65
-
66
- ## ドキュメント
67
-
68
- - [ハンドブック](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
69
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
70
-
71
- ---
72
-
73
- 制作：<a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
1
+ <p align="center">
2
+ <a href="README.md">English</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
3
+ </p>
4
+
5
+ <p align="center">
6
+ <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
+ </p>
8
+
9
+ <p align="center">
10
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
+ <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
+ </p>
14
+
15
+ # @ai-rpg-engine/starter-zombie
16
+
17
+ **Ashfall Dead** — AI RPG Engine用の、ゾンビサバイバルをテーマにしたスターターワールド。
18
+
19
+ ## インストール
20
+
21
+ ```bash
22
+ npm install @ai-rpg-engine/starter-zombie
23
+ ```
24
+
25
+ ## 学習内容
26
+
27
+ このスターターは、サバイバルシナリオを通じて、AIエンジンの機能をすべて紹介しています。
28
+
29
+ | 特徴 | ゾンビの動作 |
30
+ |---|---|
31
+ | **Rulesets** | `zombieMinimalRuleset` — 属性（体力/知力/精神力）、資源（HP/スタミナ/感染）、動詞、数式 |
32
+ | **Zones & traversal** | 隣接関係、明るさ、インタラクション可能なオブジェクト、危険要素を持つ、3つの部屋に5つのエリア |
33
+ | **Districts** | 安全地帯（生存者派閥） vs デッドゾーン（敵対、アンデッド） |
34
+ | **Dialogue** | 病院の物資調達クエストにつながる、医療担当者との会話分岐 |
35
+ | **Combat** | ゆっくりとしたが頑丈な「シャムラー」と、素早くも脆い「ランナー」のゾンビ。それぞれに攻撃AIを搭載。 |
36
+ | **Cognition & perception** | 記憶の減衰、知覚フィルター、ゾンビの飢餓状態の表示ルール |
37
+ | **Progression** | 敵を倒すと経験値を獲得できる、3つのノードからなるサバイバルツリー |
38
+ | **Environment** | 徘徊するゾンビによるスタミナの消耗、感染リスクのあるエリアによる感染の増加 |
39
+ | **Factions** | 医療担当者、スカベンジャー、軍事指導者を含む生存者派閥 |
40
+ | **Belief provenance** | 遅延付きの噂の伝播、信念の追跡 |
41
+ | **Inventory** | 感染を軽減するスクリプトによるアイテム使用効果を持つ抗生物質 |
42
+ | **Simulation inspector** | リプレイ分析のための完全な検査機能 |
43
+
44
+ ## 内容
45
+
46
+ - **5つのエリア** — 安全地帯ロビー、廃墟となったガソリンスタンド、占拠された通り、病院東棟、病院屋上
47
+ - **3人のNPC** — Dr.チェン（医療担当者）、ルーク（スカベンジャー）、軍曹マーシュ（軍事指導者）
48
+ - **2種類の敵** — シャムラー（ゆっくりとした頑丈なアンデッド）、ランナー（素早くも脆いアンデッド）
49
+ - **1つのアイテム** — 抗生物質（感染を25%軽減）
50
+ - **1つの成長ツリー** — サバイバル（スカッパー → 冷静沈着 → 最後の生き残り）
51
+ - **1つの表示ルール** — ゾンビはすべての生き物を獲物として認識する
52
+ - **15のモジュール** — 移動、状態、戦闘、インベントリ、会話、認知、知覚、成長、環境、派閥、噂、地区、信念、観察表示、検査
53
+
54
+ ## 使用方法
55
+
56
+ ```typescript
57
+ import { createGame } from '@ai-rpg-engine/starter-zombie';
58
+
59
+ // One line — all 15 modules, content, and ruleset pre-wired
60
+ const engine = createGame(42);
61
+
62
+ // Or import pieces individually:
63
+ import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
64
+ ```
65
+
66
+ ## ドキュメント
67
+
68
+ - [ハンドブック](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
69
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
70
+
71
+ ---
72
+
73
+ 制作：<a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.md CHANGED
@@ -1,79 +1,79 @@
1
- <p align="center">
2
- <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
3
- </p>
4
-
5
- <p align="center">
6
- <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
- </p>
8
-
9
- <p align="center">
10
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
- <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
- </p>
14
-
15
- # @ai-rpg-engine/starter-zombie
16
-
17
- > **Composition Example** — This starter demonstrates how to wire the engine for zombie survival. It is an example to learn from, not a template to copy. See the [Composition Guide](../../docs/handbook/57-composition-guide.md) to build your own game.
18
-
19
- **Ashfall Dead** — a zombie survival starter world for AI RPG Engine.
20
-
21
- ## Install
22
-
23
- ```bash
24
- npm install @ai-rpg-engine/starter-zombie
25
- ```
26
-
27
- ## Patterns Demonstrated
28
-
29
- This starter demonstrates the full engine stack through a survival scenario:
30
-
31
- | Feature | What the Zombie shows |
32
- |---|---|
33
- | **Rulesets** | `zombieMinimalRuleset` — stats (fitness/wits/nerve), resources (hp/stamina/infection), verbs, formulas |
34
- | **Zones & traversal** | 5 zones across 3 rooms with adjacency, light levels, interactables, hazards |
35
- | **Districts** | The Safehouse (survivors faction) vs Dead Zone (hostile, undead) |
36
- | **Dialogue** | Branching medic conversation with hospital supply-run quest hook |
37
- | **Combat** | Shambler (slow, tough) and Runner (fast, fragile) with aggressive AI |
38
- | **Cognition & perception** | Memory decay, perception filter, zombie hunger presentation rule |
39
- | **Progression** | 3-node Survival tree with XP rewards on entity defeat |
40
- | **Environment** | Roaming dead draining stamina, infection-risk zones raising infection |
41
- | **Factions** | Survivors faction with medic, scavenger, and military leader |
42
- | **Belief provenance** | Rumor propagation with delay, belief tracking |
43
- | **Inventory** | Antibiotics with scripted item-use effect reducing infection |
44
- | **Simulation inspector** | Full inspection wired for replay analysis |
45
-
46
- ## What's Inside
47
-
48
- - **5 zones** — Safehouse Lobby, Abandoned Gas Station, Overrun Street, Hospital East Wing, Hospital Rooftop
49
- - **3 NPCs** — Dr. Chen (medic), Rook (scavenger), Sergeant Marsh (military leader)
50
- - **2 enemies** — Shambler (slow, tough undead), Runner (fast, fragile undead)
51
- - **1 item** — Antibiotics (reduces infection by 25)
52
- - **1 progression tree** — Survival (Scrapper → Cool-Headed → Last One Standing)
53
- - **1 presentation rule** — zombies perceive all living as prey
54
- - **15 modules wired** — traversal, status, combat, inventory, dialogue, cognition, perception, progression, environment, factions, rumors, districts, belief, observer presentation, inspector
55
-
56
- ## Usage
57
-
58
- ```typescript
59
- import { createGame } from '@ai-rpg-engine/starter-zombie';
60
-
61
- // One line — all 15 modules, content, and ruleset pre-wired
62
- const engine = createGame(42);
63
-
64
- // Or import pieces individually:
65
- import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
66
- ```
67
-
68
- ## What to Borrow
69
-
70
- Consequence-only resource pattern — infection accumulates from events and combat but cannot be voluntarily spent. Study how a resource that only grows creates escalating tension and forces players toward the item economy (antibiotics) as the only relief valve.
71
-
72
- ## Documentation
73
-
74
- - [Handbook](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
75
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
76
-
77
- ---
78
-
79
- Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
1
+ <p align="center">
2
+ <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
3
+ </p>
4
+
5
+ <p align="center">
6
+ <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
+ </p>
8
+
9
+ <p align="center">
10
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
+ <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
+ </p>
14
+
15
+ # @ai-rpg-engine/starter-zombie
16
+
17
+ > **Composition Example** — This starter demonstrates how to wire the engine for zombie survival. It is an example to learn from, not a template to copy. See the [Composition Guide](../../docs/handbook/57-composition-guide.md) to build your own game.
18
+
19
+ **Ashfall Dead** — a zombie survival starter world for AI RPG Engine.
20
+
21
+ ## Install
22
+
23
+ ```bash
24
+ npm install @ai-rpg-engine/starter-zombie
25
+ ```
26
+
27
+ ## Patterns Demonstrated
28
+
29
+ This starter demonstrates the full engine stack through a survival scenario:
30
+
31
+ | Feature | What the Zombie shows |
32
+ |---|---|
33
+ | **Rulesets** | `zombieMinimalRuleset` — stats (fitness/wits/nerve), resources (hp/stamina/infection), verbs, formulas |
34
+ | **Zones & traversal** | 5 zones across 3 rooms with adjacency, light levels, interactables, hazards |
35
+ | **Districts** | The Safehouse (survivors faction) vs Dead Zone (hostile, undead) |
36
+ | **Dialogue** | Branching medic conversation with hospital supply-run quest hook |
37
+ | **Combat** | Shambler (slow, tough) and Runner (fast, fragile) with aggressive AI |
38
+ | **Cognition & perception** | Memory decay, perception filter, zombie hunger presentation rule |
39
+ | **Progression** | 3-node Survival tree with XP rewards on entity defeat |
40
+ | **Environment** | Roaming dead draining stamina, infection-risk zones raising infection |
41
+ | **Factions** | Survivors faction with medic, scavenger, and military leader |
42
+ | **Belief provenance** | Rumor propagation with delay, belief tracking |
43
+ | **Inventory** | Antibiotics with scripted item-use effect reducing infection |
44
+ | **Simulation inspector** | Full inspection wired for replay analysis |
45
+
46
+ ## What's Inside
47
+
48
+ - **5 zones** — Safehouse Lobby, Abandoned Gas Station, Overrun Street, Hospital East Wing, Hospital Rooftop
49
+ - **3 NPCs** — Dr. Chen (medic), Rook (scavenger), Sergeant Marsh (military leader)
50
+ - **2 enemies** — Shambler (slow, tough undead), Runner (fast, fragile undead)
51
+ - **1 item** — Antibiotics (reduces infection by 25)
52
+ - **1 progression tree** — Survival (Scrapper → Cool-Headed → Last One Standing)
53
+ - **1 presentation rule** — zombies perceive all living as prey
54
+ - **15 modules wired** — traversal, status, combat, inventory, dialogue, cognition, perception, progression, environment, factions, rumors, districts, belief, observer presentation, inspector
55
+
56
+ ## Usage
57
+
58
+ ```typescript
59
+ import { createGame } from '@ai-rpg-engine/starter-zombie';
60
+
61
+ // One line — all 15 modules, content, and ruleset pre-wired
62
+ const engine = createGame(42);
63
+
64
+ // Or import pieces individually:
65
+ import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
66
+ ```
67
+
68
+ ## What to Borrow
69
+
70
+ Consequence-only resource pattern — infection accumulates from events and combat but cannot be voluntarily spent. Study how a resource that only grows creates escalating tension and forces players toward the item economy (antibiotics) as the only relief valve.
71
+
72
+ ## Documentation
73
+
74
+ - [Handbook](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
75
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
76
+
77
+ ---
78
+
79
+ Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.pt-BR.md CHANGED
@@ -1,73 +1,73 @@
1
- <p align="center">
2
- <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.md">English</a>
3
- </p>
4
-
5
- <p align="center">
6
- <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
- </p>
8
-
9
- <p align="center">
10
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
- <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
- <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
- </p>
14
-
15
- # @ai-rpg-engine/starter-zombie
16
-
17
- **Ashfall Dead** — um mundo inicial de sobrevivência contra zumbis para o AI RPG Engine.
18
-
19
- ## Instalação
20
-
21
- ```bash
22
- npm install @ai-rpg-engine/starter-zombie
23
- ```
24
-
25
- ## O que você vai aprender
26
-
27
- Este modelo demonstra toda a estrutura do motor através de um cenário de sobrevivência:
28
-
29
- | Características | O que o zumbi demonstra |
30
- |---|---|
31
- | **Rulesets** | `zombieMinimalRuleset` — estatísticas (condição física/inteligência/nervos), recursos (pontos de vida/resistência/infecção), verbos, fórmulas. |
32
- | **Zones & traversal** | 5 zonas em 3 ambientes, com adjacências, níveis de iluminação, elementos interativos e perigos. |
33
- | **Districts** | O Refúgio (facção dos sobreviventes) vs. Zona Morta (hostil, mortos-vivos). |
34
- | **Dialogue** | Diálogo ramificado com um médico, com uma missão secundária para buscar suprimentos no hospital. |
35
- | **Combat** | Zumbis lentos e resistentes (Shambler) e zumbis rápidos e frágeis (Runner), com inteligência artificial agressiva. |
36
- | **Cognition & perception** | Decaimento da memória, filtro de percepção, regra de apresentação da fome dos zumbis. |
37
- | **Progression** | Árvore de sobrevivência com 3 níveis, com recompensas de experiência ao derrotar entidades. |
38
- | **Environment** | Mortos-vivos que se movem, drenando a resistência, zonas de risco de infecção que aumentam a infecção. |
39
- | **Factions** | Facção dos sobreviventes, com um médico, um saqueador e um líder militar. |
40
- | **Belief provenance** | Propagação de rumores com atraso, rastreamento da crença. |
41
- | **Inventory** | Antibióticos com efeito de uso programado que reduzem a infecção. |
42
- | **Simulation inspector** | Inspeção completa para análise de repetições. |
43
-
44
- ## O que está incluído
45
-
46
- - **5 zonas** — Hall do Refúgio, Posto de Gasolina Abandonado, Rua Invadida, Ala Leste do Hospital, Terraço do Hospital.
47
- - **3 NPCs** — Dra. Chen (médica), Rook (saqueador), Sargento Marsh (líder militar).
48
- - **2 inimigos** — Shambler (morto-vivo lento e resistente), Runner (morto-vivo rápido e frágil).
49
- - **1 item** — Antibióticos (reduz a infecção em 25).
50
- - **1 árvore de progressão** — Sobrevivência (Scrapper → Cool-Headed → Last One Standing).
51
- - **1 regra de apresentação** — zumbis percebem todos os seres vivos como presas.
52
- - **15 módulos conectados** — movimentação, status, combate, inventário, diálogo, cognição, percepção, progressão, ambiente, facções, rumores, distritos, crença, apresentação do observador, inspetor.
53
-
54
- ## Uso
55
-
56
- ```typescript
57
- import { createGame } from '@ai-rpg-engine/starter-zombie';
58
-
59
- // One line — all 15 modules, content, and ruleset pre-wired
60
- const engine = createGame(42);
61
-
62
- // Or import pieces individually:
63
- import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
64
- ```
65
-
66
- ## Documentação
67
-
68
- - [Manual](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
69
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
70
-
71
- ---
72
-
73
- Criado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
1
+ <p align="center">
2
+ <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.md">English</a>
3
+ </p>
4
+
5
+ <p align="center">
6
+ <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
7
+ </p>
8
+
9
+ <p align="center">
10
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
11
+ <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
12
+ <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
13
+ </p>
14
+
15
+ # @ai-rpg-engine/starter-zombie
16
+
17
+ **Ashfall Dead** — um mundo inicial de sobrevivência contra zumbis para o AI RPG Engine.
18
+
19
+ ## Instalação
20
+
21
+ ```bash
22
+ npm install @ai-rpg-engine/starter-zombie
23
+ ```
24
+
25
+ ## O que você vai aprender
26
+
27
+ Este modelo demonstra toda a estrutura do motor através de um cenário de sobrevivência:
28
+
29
+ | Características | O que o zumbi demonstra |
30
+ |---|---|
31
+ | **Rulesets** | `zombieMinimalRuleset` — estatísticas (condição física/inteligência/nervos), recursos (pontos de vida/resistência/infecção), verbos, fórmulas. |
32
+ | **Zones & traversal** | 5 zonas em 3 ambientes, com adjacências, níveis de iluminação, elementos interativos e perigos. |
33
+ | **Districts** | O Refúgio (facção dos sobreviventes) vs. Zona Morta (hostil, mortos-vivos). |
34
+ | **Dialogue** | Diálogo ramificado com um médico, com uma missão secundária para buscar suprimentos no hospital. |
35
+ | **Combat** | Zumbis lentos e resistentes (Shambler) e zumbis rápidos e frágeis (Runner), com inteligência artificial agressiva. |
36
+ | **Cognition & perception** | Decaimento da memória, filtro de percepção, regra de apresentação da fome dos zumbis. |
37
+ | **Progression** | Árvore de sobrevivência com 3 níveis, com recompensas de experiência ao derrotar entidades. |
38
+ | **Environment** | Mortos-vivos que se movem, drenando a resistência, zonas de risco de infecção que aumentam a infecção. |
39
+ | **Factions** | Facção dos sobreviventes, com um médico, um saqueador e um líder militar. |
40
+ | **Belief provenance** | Propagação de rumores com atraso, rastreamento da crença. |
41
+ | **Inventory** | Antibióticos com efeito de uso programado que reduzem a infecção. |
42
+ | **Simulation inspector** | Inspeção completa para análise de repetições. |
43
+
44
+ ## O que está incluído
45
+
46
+ - **5 zonas** — Hall do Refúgio, Posto de Gasolina Abandonado, Rua Invadida, Ala Leste do Hospital, Terraço do Hospital.
47
+ - **3 NPCs** — Dra. Chen (médica), Rook (saqueador), Sargento Marsh (líder militar).
48
+ - **2 inimigos** — Shambler (morto-vivo lento e resistente), Runner (morto-vivo rápido e frágil).
49
+ - **1 item** — Antibióticos (reduz a infecção em 25).
50
+ - **1 árvore de progressão** — Sobrevivência (Scrapper → Cool-Headed → Last One Standing).
51
+ - **1 regra de apresentação** — zumbis percebem todos os seres vivos como presas.
52
+ - **15 módulos conectados** — movimentação, status, combate, inventário, diálogo, cognição, percepção, progressão, ambiente, facções, rumores, distritos, crença, apresentação do observador, inspetor.
53
+
54
+ ## Uso
55
+
56
+ ```typescript
57
+ import { createGame } from '@ai-rpg-engine/starter-zombie';
58
+
59
+ // One line — all 15 modules, content, and ruleset pre-wired
60
+ const engine = createGame(42);
61
+
62
+ // Or import pieces individually:
63
+ import { manifest, zombieMinimalRuleset, survivalTree } from '@ai-rpg-engine/starter-zombie';
64
+ ```
65
+
66
+ ## Documentação
67
+
68
+ - [Manual](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
69
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
70
+
71
+ ---
72
+
73
+ Criado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>