@ai-rpg-engine/starter-fantasy 2.1.3 → 2.4.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 (16) hide show
  1. package/LICENSE +21 -21
  2. package/README.es.md +74 -74
  3. package/README.fr.md +74 -74
  4. package/README.hi.md +74 -74
  5. package/README.it.md +74 -74
  6. package/README.ja.md +74 -74
  7. package/README.md +80 -80
  8. package/README.pt-BR.md +74 -74
  9. package/README.zh.md +74 -74
  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/setup.d.ts.map +1 -1
  14. package/dist/setup.js +16 -9
  15. package/dist/setup.js.map +1 -1
  16. package/package.json +50 -50
package/README.it.md CHANGED
@@ -1,74 +1,74 @@
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-fantasy
16
-
17
- **La Soglia della Cappella** — un mondo di fantasia oscura per il motore di giochi di ruolo AI.
18
-
19
- ## Installazione
20
-
21
- ```bash
22
- npm install @ai-rpg-engine/starter-fantasy
23
- ```
24
-
25
- ## Cosa imparerai
26
-
27
- Questo esempio dimostra l'intera struttura del motore in un mondo compatto:
28
-
29
- | Caratteristiche | Cosa mostra la Cappella |
30
- |---|---|
31
- | **Rulesets** | `fantasyMinimalRuleset` — statistiche (vigore/istinto/volontà), risorse (punti ferita/stamina), verbi, formule. |
32
- | **Zones & traversal** | 5 zone in 2 stanze, con adiacenze, livelli di illuminazione, elementi interattivi e pericoli. |
33
- | **Districts** | Terreno della Cappella (sacro) contro le Profondità della Cripta (maledette, controllate da una fazione). |
34
- | **Dialogue** | Conversazione con un pellegrino con diramazioni, 3 percorsi e effetti su flag globali. |
35
- | **Combat** | Ghoul di Cenere con profilo di intelligenza artificiale aggressivo, tag di "paura" e obiettivo di guardia. |
36
- | **Cognition & perception** | Decadimento della memoria, filtro percettivo, regola di presentazione per i non morti. |
37
- | **Progression** | Albero di Maestria del Combattimento con 3 nodi e ricompense di esperienza alla sconfitta dell'entità. |
38
- | **Environment** | Pericolo di pavimento instabile che consuma stamina all'ingresso nella zona. |
39
- | **Factions** | Fazione dei non morti della Cappella con impostazione di coesione. |
40
- | **Belief provenance** | Diffusione di voci con ritardo, tracciamento delle credenze. |
41
- | **Inventory** | Pozione curativa con effetto di utilizzo programmato che ripristina 8 punti ferita. |
42
- | **Simulation inspector** | Ispezione completa per l'analisi delle partite. |
43
-
44
- ## Cosa c'è all'interno
45
-
46
- - **5 zone** — Ingresso della Cappella in rovina, Navata, Nicchia Ombrata, Corridoio della Sagrestia, Anticamera della Cripta.
47
- - **1 PNG** — Pellegrino Sospetto (dialogo con diramazioni, 3 percorsi di conversazione).
48
- - **1 nemico** — Ghoul di Cenere (intelligenza artificiale aggressiva, paura del fuoco e del sacro).
49
- - **1 oggetto** — Pozione Curativa (effetto di utilizzo programmato che ripristina 8 punti ferita).
50
- - **1 albero di progressione** — Maestria del Combattimento (Indurito → Occhio Acuto → Furia in Battaglia).
51
- - **1 regola di presentazione** — i non morti percepiscono tutti gli esseri viventi come minacce.
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-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
64
- ```
65
-
66
- ## Documentazione
67
-
68
- - [La Soglia della Cappella (Cap. 20)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
69
- - [Manuale](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
70
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
71
-
72
- ---
73
-
74
- 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-fantasy
16
+
17
+ **La Soglia della Cappella** — un mondo di fantasia oscura per il motore di giochi di ruolo AI.
18
+
19
+ ## Installazione
20
+
21
+ ```bash
22
+ npm install @ai-rpg-engine/starter-fantasy
23
+ ```
24
+
25
+ ## Cosa imparerai
26
+
27
+ Questo esempio dimostra l'intera struttura del motore in un mondo compatto:
28
+
29
+ | Caratteristiche | Cosa mostra la Cappella |
30
+ |---|---|
31
+ | **Rulesets** | `fantasyMinimalRuleset` — statistiche (vigore/istinto/volontà), risorse (punti ferita/stamina), verbi, formule. |
32
+ | **Zones & traversal** | 5 zone in 2 stanze, con adiacenze, livelli di illuminazione, elementi interattivi e pericoli. |
33
+ | **Districts** | Terreno della Cappella (sacro) contro le Profondità della Cripta (maledette, controllate da una fazione). |
34
+ | **Dialogue** | Conversazione con un pellegrino con diramazioni, 3 percorsi e effetti su flag globali. |
35
+ | **Combat** | Ghoul di Cenere con profilo di intelligenza artificiale aggressivo, tag di "paura" e obiettivo di guardia. |
36
+ | **Cognition & perception** | Decadimento della memoria, filtro percettivo, regola di presentazione per i non morti. |
37
+ | **Progression** | Albero di Maestria del Combattimento con 3 nodi e ricompense di esperienza alla sconfitta dell'entità. |
38
+ | **Environment** | Pericolo di pavimento instabile che consuma stamina all'ingresso nella zona. |
39
+ | **Factions** | Fazione dei non morti della Cappella con impostazione di coesione. |
40
+ | **Belief provenance** | Diffusione di voci con ritardo, tracciamento delle credenze. |
41
+ | **Inventory** | Pozione curativa con effetto di utilizzo programmato che ripristina 8 punti ferita. |
42
+ | **Simulation inspector** | Ispezione completa per l'analisi delle partite. |
43
+
44
+ ## Cosa c'è all'interno
45
+
46
+ - **5 zone** — Ingresso della Cappella in rovina, Navata, Nicchia Ombrata, Corridoio della Sagrestia, Anticamera della Cripta.
47
+ - **1 PNG** — Pellegrino Sospetto (dialogo con diramazioni, 3 percorsi di conversazione).
48
+ - **1 nemico** — Ghoul di Cenere (intelligenza artificiale aggressiva, paura del fuoco e del sacro).
49
+ - **1 oggetto** — Pozione Curativa (effetto di utilizzo programmato che ripristina 8 punti ferita).
50
+ - **1 albero di progressione** — Maestria del Combattimento (Indurito → Occhio Acuto → Furia in Battaglia).
51
+ - **1 regola di presentazione** — i non morti percepiscono tutti gli esseri viventi come minacce.
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-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
64
+ ```
65
+
66
+ ## Documentazione
67
+
68
+ - [La Soglia della Cappella (Cap. 20)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
69
+ - [Manuale](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
70
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
71
+
72
+ ---
73
+
74
+ Creato da <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.ja.md CHANGED
@@ -1,74 +1,74 @@
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-fantasy
16
-
17
- **The Chapel Threshold**：AI RPG Engine用の、ダークファンタジーをテーマにした入門ワールド。
18
-
19
- ## インストール
20
-
21
- ```bash
22
- npm install @ai-rpg-engine/starter-fantasy
23
- ```
24
-
25
- ## 学習内容
26
-
27
- この入門サンプルは、コンパクトな世界の中で、エンジン全体の機能を網羅的に示しています。
28
-
29
- | 特徴 | The Chapelで示されている機能 |
30
- |---|---|
31
- | **Rulesets** | `fantasyMinimalRuleset`：ステータス（体力/本能/意志）、リソース（HP/スタミナ）、動詞、数式 |
32
- | **Zones & traversal** | 隣接関係、光量、インタラクション可能なオブジェクト、危険要素を持つ、2つの部屋に5つのエリア |
33
- | **Districts** | 聖域であるChapel Groundsと、呪われ、特定の勢力によって支配されているCrypt Depths |
34
- | **Dialogue** | 3つの選択肢とグローバルフラグの効果を持つ、巡礼者の会話 |
35
- | **Combat** | 攻撃的なAIプロファイル、恐怖のタグ、守護目標を持つAsh Ghoul |
36
- | **Cognition & perception** | 記憶の減衰、知覚フィルター、アンデッドの表示ルール |
37
- | **Progression** | 敵を倒すと経験値が得られる、3つのノードを持つCombat Mastery（戦闘スキル）ツリー |
38
- | **Environment** | エリアに入る際にスタミナを消費する、不安定な床の危険要素 |
39
- | **Factions** | 結束度を設定可能な、Chapelのアンデッド勢力 |
40
- | **Belief provenance** | 遅延付きの噂の伝播、信念の追跡 |
41
- | **Inventory** | 使用時にスクリプトによってHPを8回復する、回復薬 |
42
- | **Simulation inspector** | リプレイ分析のために、詳細な情報が記録されている |
43
-
44
- ## 内容
45
-
46
- - **5つのエリア**：廃墟の礼拝堂入口、中央聖堂、影の隠れ場所、聖具室の通路、地下墓所の前室
47
- - **1人のNPC**：怪しい巡礼者（分岐する会話、3つの会話ルート）
48
- - **1体の敵**：Ash Ghoul（攻撃的なAI、火と聖域に対する恐怖）
49
- - **1つのアイテム**：回復薬（使用時にスクリプトによってHPを8回復）
50
- - **1つのスキルツリー**：Combat Mastery（タフネス → 鋭い観察眼 → 戦闘狂）
51
- - **1つの表示ルール**：アンデッドはすべての生者を脅威として認識する
52
- - **15のモジュール**：移動、状態、戦闘、インベントリ、会話、認知、知覚、成長、環境、勢力、噂、地区、信念、観察表示、検査
53
-
54
- ## 使い方
55
-
56
- ```typescript
57
- import { createGame } from '@ai-rpg-engine/starter-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
64
- ```
65
-
66
- ## ドキュメント
67
-
68
- - [The Chapel Threshold (第20章)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
69
- - [ハンドブック](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
70
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
71
-
72
- ---
73
-
74
- 制作：<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-fantasy
16
+
17
+ **The Chapel Threshold**：AI RPG Engine用の、ダークファンタジーをテーマにした入門ワールド。
18
+
19
+ ## インストール
20
+
21
+ ```bash
22
+ npm install @ai-rpg-engine/starter-fantasy
23
+ ```
24
+
25
+ ## 学習内容
26
+
27
+ この入門サンプルは、コンパクトな世界の中で、エンジン全体の機能を網羅的に示しています。
28
+
29
+ | 特徴 | The Chapelで示されている機能 |
30
+ |---|---|
31
+ | **Rulesets** | `fantasyMinimalRuleset`：ステータス（体力/本能/意志）、リソース（HP/スタミナ）、動詞、数式 |
32
+ | **Zones & traversal** | 隣接関係、光量、インタラクション可能なオブジェクト、危険要素を持つ、2つの部屋に5つのエリア |
33
+ | **Districts** | 聖域であるChapel Groundsと、呪われ、特定の勢力によって支配されているCrypt Depths |
34
+ | **Dialogue** | 3つの選択肢とグローバルフラグの効果を持つ、巡礼者の会話 |
35
+ | **Combat** | 攻撃的なAIプロファイル、恐怖のタグ、守護目標を持つAsh Ghoul |
36
+ | **Cognition & perception** | 記憶の減衰、知覚フィルター、アンデッドの表示ルール |
37
+ | **Progression** | 敵を倒すと経験値が得られる、3つのノードを持つCombat Mastery（戦闘スキル）ツリー |
38
+ | **Environment** | エリアに入る際にスタミナを消費する、不安定な床の危険要素 |
39
+ | **Factions** | 結束度を設定可能な、Chapelのアンデッド勢力 |
40
+ | **Belief provenance** | 遅延付きの噂の伝播、信念の追跡 |
41
+ | **Inventory** | 使用時にスクリプトによってHPを8回復する、回復薬 |
42
+ | **Simulation inspector** | リプレイ分析のために、詳細な情報が記録されている |
43
+
44
+ ## 内容
45
+
46
+ - **5つのエリア**：廃墟の礼拝堂入口、中央聖堂、影の隠れ場所、聖具室の通路、地下墓所の前室
47
+ - **1人のNPC**：怪しい巡礼者（分岐する会話、3つの会話ルート）
48
+ - **1体の敵**：Ash Ghoul（攻撃的なAI、火と聖域に対する恐怖）
49
+ - **1つのアイテム**：回復薬（使用時にスクリプトによってHPを8回復）
50
+ - **1つのスキルツリー**：Combat Mastery（タフネス → 鋭い観察眼 → 戦闘狂）
51
+ - **1つの表示ルール**：アンデッドはすべての生者を脅威として認識する
52
+ - **15のモジュール**：移動、状態、戦闘、インベントリ、会話、認知、知覚、成長、環境、勢力、噂、地区、信念、観察表示、検査
53
+
54
+ ## 使い方
55
+
56
+ ```typescript
57
+ import { createGame } from '@ai-rpg-engine/starter-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
64
+ ```
65
+
66
+ ## ドキュメント
67
+
68
+ - [The Chapel Threshold (第20章)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
69
+ - [ハンドブック](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
70
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
71
+
72
+ ---
73
+
74
+ 制作：<a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.md CHANGED
@@ -1,80 +1,80 @@
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-fantasy
16
-
17
- > **Composition Example** — This starter demonstrates how to wire the engine for dark fantasy. 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
- **The Chapel Threshold** — a dark fantasy starter world for AI RPG Engine.
20
-
21
- ## Install
22
-
23
- ```bash
24
- npm install @ai-rpg-engine/starter-fantasy
25
- ```
26
-
27
- ## Patterns Demonstrated
28
-
29
- This starter demonstrates the full engine stack in a compact world:
30
-
31
- | Feature | What the Chapel shows |
32
- |---|---|
33
- | **Rulesets** | `fantasyMinimalRuleset` — stats (vigor/instinct/will), resources (hp/stamina), verbs, formulas |
34
- | **Zones & traversal** | 5 zones across 2 rooms with adjacency, light levels, interactables, hazards |
35
- | **Districts** | Chapel Grounds (sacred) vs Crypt Depths (cursed, faction-controlled) |
36
- | **Dialogue** | Branching pilgrim conversation with 3 paths and global-flag effects |
37
- | **Combat** | Ash Ghoul with aggressive AI profile, fear tags, guard goal |
38
- | **Cognition & perception** | Memory decay, perception filter, undead presentation rule |
39
- | **Progression** | 3-node Combat Mastery tree with XP rewards on entity defeat |
40
- | **Environment** | Unstable-floor hazard draining stamina on zone entry |
41
- | **Factions** | Chapel-undead faction with cohesion setting |
42
- | **Belief provenance** | Rumor propagation with delay, belief tracking |
43
- | **Inventory** | Healing draught with scripted item-use effect |
44
- | **Simulation inspector** | Full inspection wired for replay analysis |
45
-
46
- ## What's Inside
47
-
48
- - **5 zones** — Ruined Chapel Entrance, Nave, Shadowed Alcove, Vestry Passage, Crypt Antechamber
49
- - **1 NPC** — Suspicious Pilgrim (branching dialogue, 3 conversation paths)
50
- - **1 enemy** — Ash Ghoul (aggressive AI, fear of fire and sacred)
51
- - **1 item** — Healing Draught (scripted use-effect restoring 8 HP)
52
- - **1 progression tree** — Combat Mastery (Toughened → Keen Eye → Battle Fury)
53
- - **1 presentation rule** — undead perceive all living as threats
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-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
66
- ```
67
-
68
- ## What to Borrow
69
-
70
- Simplest combat wiring in the catalog — no resources beyond HP/stamina, no engagement roles. If you are building your first game, start here to understand the minimal combat loop before adding complexity.
71
-
72
- ## Documentation
73
-
74
- - [The Chapel Threshold (Ch. 20)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
75
- - [Handbook](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
76
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
77
-
78
- ---
79
-
80
- 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-fantasy
16
+
17
+ > **Composition Example** — This starter demonstrates how to wire the engine for dark fantasy. 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
+ **The Chapel Threshold** — a dark fantasy starter world for AI RPG Engine.
20
+
21
+ ## Install
22
+
23
+ ```bash
24
+ npm install @ai-rpg-engine/starter-fantasy
25
+ ```
26
+
27
+ ## Patterns Demonstrated
28
+
29
+ This starter demonstrates the full engine stack in a compact world:
30
+
31
+ | Feature | What the Chapel shows |
32
+ |---|---|
33
+ | **Rulesets** | `fantasyMinimalRuleset` — stats (vigor/instinct/will), resources (hp/stamina), verbs, formulas |
34
+ | **Zones & traversal** | 5 zones across 2 rooms with adjacency, light levels, interactables, hazards |
35
+ | **Districts** | Chapel Grounds (sacred) vs Crypt Depths (cursed, faction-controlled) |
36
+ | **Dialogue** | Branching pilgrim conversation with 3 paths and global-flag effects |
37
+ | **Combat** | Ash Ghoul with aggressive AI profile, fear tags, guard goal |
38
+ | **Cognition & perception** | Memory decay, perception filter, undead presentation rule |
39
+ | **Progression** | 3-node Combat Mastery tree with XP rewards on entity defeat |
40
+ | **Environment** | Unstable-floor hazard draining stamina on zone entry |
41
+ | **Factions** | Chapel-undead faction with cohesion setting |
42
+ | **Belief provenance** | Rumor propagation with delay, belief tracking |
43
+ | **Inventory** | Healing draught with scripted item-use effect |
44
+ | **Simulation inspector** | Full inspection wired for replay analysis |
45
+
46
+ ## What's Inside
47
+
48
+ - **5 zones** — Ruined Chapel Entrance, Nave, Shadowed Alcove, Vestry Passage, Crypt Antechamber
49
+ - **1 NPC** — Suspicious Pilgrim (branching dialogue, 3 conversation paths)
50
+ - **1 enemy** — Ash Ghoul (aggressive AI, fear of fire and sacred)
51
+ - **1 item** — Healing Draught (scripted use-effect restoring 8 HP)
52
+ - **1 progression tree** — Combat Mastery (Toughened → Keen Eye → Battle Fury)
53
+ - **1 presentation rule** — undead perceive all living as threats
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-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
66
+ ```
67
+
68
+ ## What to Borrow
69
+
70
+ Simplest combat wiring in the catalog — no resources beyond HP/stamina, no engagement roles. If you are building your first game, start here to understand the minimal combat loop before adding complexity.
71
+
72
+ ## Documentation
73
+
74
+ - [The Chapel Threshold (Ch. 20)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
75
+ - [Handbook](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
76
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
77
+
78
+ ---
79
+
80
+ Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
package/README.pt-BR.md CHANGED
@@ -1,74 +1,74 @@
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-fantasy
16
-
17
- **O Limiar da Capela** — um mundo de fantasia sombria para o AI RPG Engine.
18
-
19
- ## Instalação
20
-
21
- ```bash
22
- npm install @ai-rpg-engine/starter-fantasy
23
- ```
24
-
25
- ## O que você aprenderá
26
-
27
- Este projeto de exemplo demonstra toda a estrutura do motor em um mundo compacto:
28
-
29
- | Características | O que a Capela demonstra |
30
- |---|---|
31
- | **Rulesets** | `fantasyMinimalRuleset` — atributos (vigor/instinto/vontade), recursos (pontos de vida/energia), verbos, fórmulas |
32
- | **Zones & traversal** | 5 zonas em 2 ambientes, com adjacências, níveis de luz, elementos interativos e perigos. |
33
- | **Districts** | Terreno da Capela (sagrado) versus Profundezas da Cripta (amaldiçoado, controlado por facção). |
34
- | **Dialogue** | Diálogo ramificado com um peregrino, com 3 caminhos e efeitos de "flag" global. |
35
- | **Combat** | Ghoul de Cinzas com perfil de IA agressivo, tags de "medo" e objetivo de "guardião". |
36
- | **Cognition & perception** | Decaimento da memória, filtro de percepção, regra de apresentação de mortos-vivos. |
37
- | **Progression** | Árvore de "Domínio de Combate" com 3 níveis, com recompensas de experiência ao derrotar entidades. |
38
- | **Environment** | Perigo de "chão instável" que drena energia ao entrar na zona. |
39
- | **Factions** | Facção de mortos-vivos da Capela com configuração de coesão. |
40
- | **Belief provenance** | Propagação de rumores com atraso, rastreamento de crenças. |
41
- | **Inventory** | Poção de cura com efeito de uso programado que restaura 8 pontos de vida. |
42
- | **Simulation inspector** | Inspeção completa para análise de repetição. |
43
-
44
- ## O que está incluído
45
-
46
- - **5 zonas** — Entrada da Capela em Ruínas, Nave, Recanto Sombrio, Passagem da Sacristia, Antessala da Cripta.
47
- - **1 NPC** — Peregrino Suspeito (diálogo ramificado, 3 caminhos de conversa).
48
- - **1 inimigo** — Ghoul de Cinzas (IA agressiva, medo de fogo e de coisas sagradas).
49
- - **1 item** — Poção de Cura (efeito de uso programado que restaura 8 pontos de vida).
50
- - **1 árvore de progressão** — Domínio de Combate (Endurecido → Olhar Aguçado → Fúria de Batalha).
51
- - **1 regra de apresentação** — Mortos-vivos percebem todos os seres vivos como ameaças.
52
- - **15 módulos conectados** — travessia, 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-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
64
- ```
65
-
66
- ## Documentação
67
-
68
- - [O Limiar da Capela (Cap. 20)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
69
- - [Manual](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
70
- - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
71
-
72
- ---
73
-
74
- 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-fantasy
16
+
17
+ **O Limiar da Capela** — um mundo de fantasia sombria para o AI RPG Engine.
18
+
19
+ ## Instalação
20
+
21
+ ```bash
22
+ npm install @ai-rpg-engine/starter-fantasy
23
+ ```
24
+
25
+ ## O que você aprenderá
26
+
27
+ Este projeto de exemplo demonstra toda a estrutura do motor em um mundo compacto:
28
+
29
+ | Características | O que a Capela demonstra |
30
+ |---|---|
31
+ | **Rulesets** | `fantasyMinimalRuleset` — atributos (vigor/instinto/vontade), recursos (pontos de vida/energia), verbos, fórmulas |
32
+ | **Zones & traversal** | 5 zonas em 2 ambientes, com adjacências, níveis de luz, elementos interativos e perigos. |
33
+ | **Districts** | Terreno da Capela (sagrado) versus Profundezas da Cripta (amaldiçoado, controlado por facção). |
34
+ | **Dialogue** | Diálogo ramificado com um peregrino, com 3 caminhos e efeitos de "flag" global. |
35
+ | **Combat** | Ghoul de Cinzas com perfil de IA agressivo, tags de "medo" e objetivo de "guardião". |
36
+ | **Cognition & perception** | Decaimento da memória, filtro de percepção, regra de apresentação de mortos-vivos. |
37
+ | **Progression** | Árvore de "Domínio de Combate" com 3 níveis, com recompensas de experiência ao derrotar entidades. |
38
+ | **Environment** | Perigo de "chão instável" que drena energia ao entrar na zona. |
39
+ | **Factions** | Facção de mortos-vivos da Capela com configuração de coesão. |
40
+ | **Belief provenance** | Propagação de rumores com atraso, rastreamento de crenças. |
41
+ | **Inventory** | Poção de cura com efeito de uso programado que restaura 8 pontos de vida. |
42
+ | **Simulation inspector** | Inspeção completa para análise de repetição. |
43
+
44
+ ## O que está incluído
45
+
46
+ - **5 zonas** — Entrada da Capela em Ruínas, Nave, Recanto Sombrio, Passagem da Sacristia, Antessala da Cripta.
47
+ - **1 NPC** — Peregrino Suspeito (diálogo ramificado, 3 caminhos de conversa).
48
+ - **1 inimigo** — Ghoul de Cinzas (IA agressiva, medo de fogo e de coisas sagradas).
49
+ - **1 item** — Poção de Cura (efeito de uso programado que restaura 8 pontos de vida).
50
+ - **1 árvore de progressão** — Domínio de Combate (Endurecido → Olhar Aguçado → Fúria de Batalha).
51
+ - **1 regra de apresentação** — Mortos-vivos percebem todos os seres vivos como ameaças.
52
+ - **15 módulos conectados** — travessia, 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-fantasy';
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, zones, pilgrimDialogue, fantasyMinimalRuleset } from '@ai-rpg-engine/starter-fantasy';
64
+ ```
65
+
66
+ ## Documentação
67
+
68
+ - [O Limiar da Capela (Cap. 20)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/20-chapel-threshold/)
69
+ - [Manual](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
70
+ - [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
71
+
72
+ ---
73
+
74
+ Criado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>