# Stats Engine — キャラクターを形づくる数字

Stats Engine は、ゲームがキャラクターについて何でも数えられるようにします。RPG なら筋力と HP、ビジュアルノベルなら勇気や信頼です。ゲームはステータスをデータとして記述します——名前、ほかのステータスからの計算方法、レベルに応じた伸び——そしてエンジンは各キャラクターのシートを計算し、**キャラクターシート**パネルに表示し、シナリオが数値を読み取って変更できるようにし、HP・攻撃・防御をバトルへ渡します。

エンジン自体はステータスをひとつも知りません。下の画像にある筋力・敏捷・HP・マナは、RPG Plus が含むルールパック **Classic RPG Rules** によるものです。同じエンジンで、まったく別のステータスを持つゲームも作れます。

## キャラクターシート

ツールバーのシートのアイコンで開きます。

![RPG Plus のキャラクターシート: 主人公はレベル 1 のウォリアー、経験値は 20 中 0。能力値（筋力 9、敏捷 5、知力 2、体力 8、カリスマ 4、幸運 4）、戦闘（HP 42 +4、マナ 6/6、攻撃 12 +2、装甲 4、魔法 3）、そして木剣の入った装備ブロック。](assets/sheet.jpg)

- 左側は **パーティー**。メンバー全員とそのレベル。
- 上部は **職業・レベル・経験値** と、職業の説明。
- **ステータスはグループごと**に並び、名前はゲームが決めます。小さな緑の数字はボーナスのぶん——装備や職業の特性によるものです。マナのように消費して回復するステータスは「現在 / 最大」を表示します。
- その下に **他の MOD のブロック**。たとえば **外す** ボタンのある装備ブロックです。

## ひとつの選択で、ふたりの違う主人公

RPG Plus のプロローグで、プレイヤーは主人公が何者だったかを語ります。その答えが職業——**アーキタイプ**——を与え、シート全体がそこから決まります。

![プロローグ後のシート 2 枚。ウォリアー: 筋力 9、知力 2、体力 8、HP 42、マナ 6/6、攻撃 12、魔法 3。メイジ: 筋力 3、知力 10、体力 5、HP 29、マナ 34/34、攻撃 4、魔法 15。](assets/warrior-mage.jpg)

その答えの裏にあるシナリオの行:

```scenario
action stat.archetype who=rpg_hero id=classic/warrior
```

Classic RPG Rules におけるウォリアーのアーキタイプ:

```json
{
  "Id": "classic/warrior",
  "Name": "classic/archetype/warrior",
  "Stats": { "str": "7 + level * 2", "agi": "4 + level", "int": "2 + floor(level / 2)",
             "vit": "6 + level * 2", "cha": "4 + floor(level / 2)", "luk": "4 + floor(level / 2)" },
  "Traits": [ { "Stat": "hp", "Percent": 10 } ],
  "Learnings": [ { "Level": 1, "Action": "classic/power_strike" }, { "Level": 3, "Action": "classic/guard_break" } ]
}
```

そしてステータス 2 つ:

```json
{ "Id": "hp",  "Group": "combat", "Formula": "12 + vit * 3 + level * 2", "Min": 1, "Binds": "health" },
{ "Id": "atk", "Group": "combat", "Formula": "str + level", "Min": 0, "Binds": "attack" }
```

レベル 1 のウォリアーは、筋力 7 + 2 = **9**、体力 6 + 2 = **8**。HP は 12 + 8 × 3 + 2 = 38 で、ウォリアーの特性が 10% 加えて **42**。シートの「+4」の正体です。攻撃は 9 + 1 = 10 に、木剣の特性の 2 を足して **12**。メイジの数字は、同じステータスとメイジのアーキタイプから出ています。

## 作者向け: ステータスの記述

**ステータス**は kind が `stat` のエンティティです。

- `Id`、および翻訳キーとしての `Name`、`Short`、`Description`。
- `Group` と `Order` — シートのどこに現れるか（`stats/group/<group>` がグループ名）。
- `Default`、またはほかのステータスと `level` による `Formula`。`Min`、`Max`。
- `Pool: true` — マナのように消費して回復するステータス。
- `Binds` — 化ける戦闘数値。`health`、`attack`、`defence`、`point`。
- `Hidden` — 計算はされるが表示しない。

**アーキタイプ**（kind は `archetype`）は職業、ノベルなら気質です。ステータスごとの値か式を持つ `Stats`、`Traits`、`Learnings`（レベルで覚えるアクション）、`ExpCurve`、`MaxLevel` を持ちます。

**特性**——`{ "Stat": "atk", "Add": 2 }` のようなもので、`Add`、`Percent`、`Formula` のいずれか——は、アーキタイプ・キャラクター・アイテム、どのエンティティにも書けます。木剣がアイテム MOD にステータスを意識させずに攻撃を上げているのはこの仕組みです。

**式**では `+ - * / % ^`、比較、`&& || !`、`cond ? a : b` が使え、`min`、`max`、`floor`、`round`、`clamp`、`rand(lo, hi)`、`chance(p)` といった関数もあります。知らない名前は 0 として数えられ、壊れた式はログに 1 回だけ報告されます。

値の決まり方: まずキャラクター自身の `Stats` の項目、なければアーキタイプのもの、なければステータスの `Formula`、なければ `Default`。その後に恒久ボーナス、すべての特性が続き、最後に `Min`/`Max` が締めます。

## シナリオの中で

```scenario
action stat.add stat=cha value=1 who=rpg_hero
action stat.exp value=35 who=rpg_hero
when "stat(rpg_hero, cha) >= 8" -> :charming
```

- `stat.add`、`stat.archetype`、`stat.exp`（経験値。曲線に従ってレベルを上げる）、`stat.restore`（HP とプールを回復）。`who=` にはキャラクターの id、`player`、`party`。
- 条件は `stat(who, stat)`、`level(who)`、`archetype(who, 'id')`。スラッシュ入りの id は引用符で囲みます。
- ダイスつきのステータス判定（`check cha 10 -> :label`）は Stat Checks が、装備は Equipment が担います。

## バトル

`Binds` を持つステータスは、パーティーメンバーの戦闘数値に書き込まれます。そのため両方のバトルコアが、ステータスを知らずにそのまま使います。アーキタイプもステータスも特性も持たないキャラクターは、キャラクターファイルの数値のままです。ステータスを使わないゲームにルールパックを加えても、何も変わりません。

## うまくいかないとき

1. **ステータスが 0 になる。** その式が存在しないステータスを参照しています（知らない名前は 0）。壊れた式はログに 1 回だけ報告されます。
2. **キャラクターがレベルアップしない。** レベルが上がるのはアーキタイプを持つキャラクターだけです。ゲーム設定 `stats.leveling` が `all` であれば別です。
3. **戦闘数値が変わらない。** ステータスに `Binds` が必要で、かつキャラクターがステータスに参加している（アーキタイプ、固有のステータスか特性、装備のいずれか）必要があります。