Files
mod_characters_base/docs/ja.md
T

85 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Characters Engine — キャラクター、そのアクション、パーティ
Characters Engine は、誰が戦闘に参加するかを定義します。主人公・仲間・敵に、HP・攻撃・防御・アクションポイント、そして使えるアクションカードを持たせるものです。さらに**キャラクターアクション**パネルを表示します。ここでパーティを見ながら、どのカードを各キャラクターが戦闘に持っていくか決めます。会話の台詞のそばに出るポートレートも、この mod が供給します。
Cthangover と RPG Plus の一部であり、戦闘 mod、recruiting、各エディターがこの上に作られています。
## キャラクターアクションパネル
ツールバーのカード・アイコンで開きます。
![Cthangover のキャラクターアクションパネル: HP・AP・ATK・DEF を持つ Marao と Murakami、目標・コスト・値つきのアクションカード(基本攻撃、防御、スタン)、それぞれの空いた三つ目のスロット、右側の空のアクションプール。](assets/character-panel.jpg)
- **パーティ** — パーティの全キャラクターを、ポートレート・HP(体力)・ターンごとの AP(アクションポイント)・ATK(攻撃)・DEF(防御)つきで一覧にします。
- **スロット** — 各キャラクターにはアクションカード用のスロットが三つあります。カードには目標(敵・味方・自分)、AP コスト、値が表示されます。
- **アクションプール** — 持っているけれどまだ割り当てていないカード。カードをスロットへドラッグするか、カードを選んでからスロットを選びます。スロット間のドラッグは入れ替えになります。検索とフィルターでプールを絞り込めます。
- **リセット** は、各キャラクターの定義の先頭三つのアクションをスロットへ戻します。残りはプールへ移ります。
## 三つの異なる絵
キャラクターは三つの姿で現れ、それぞれ別の場所から来ます。
![左: Marao の会話ポートレート(アバター「marao/sad」)。中央: カードに映る Marao のキャラクター画像。右: RPG Plus の主人公のマップスプライト(charset)で、これは別のシステムのもの。](assets/three-pictures.jpg)
1. **会話ポートレート(アバター)** — mod の `avatars/` フォルダーに入る画像で、シナリオの行ごとに選びます。`text "…" first=marao/sad` が一つ目のポートレート位置を、`second=…` が二つ目(二人の会話)を埋めます。キャラクターの定義とは結びついていません。
2. **キャラクター画像** — 定義の `Image`。このパネルのカードと戦闘で表示されます。
3. **マップスプライト(charset)** — タイルマップを歩くスプライト。選ぶのは RPG mod(ゲームの**外見**設定かイベントの `Sprite`)で、この mod ではありません。
## キャラクターの定義
キャラクターは、mod の `characters/` フォルダーに入る kind `character` の JSON ファイルです。こちらは Cthangover の Marao。上のパネルのカードと見比べてください。
```json
{
"Kind": "character",
"Items": [
{
"Id": "Marao",
"Name": "characters/player/marao",
"Image": "characters/player/marao",
"Level": 1,
"Point": 1,
"Health": 16,
"Defence": 0,
"Attack": 5,
"Actions": ["physics/attack", "physics/defence"]
}
]
}
```
`Health 16` がカードの **HP 16/16**、`Point 1` が **AP 1**、`Attack 5` が **ATK 5** で、二つの `Actions` がスロットの**基本攻撃**と**防御**のカードです。
その他のフィールド: `Behaviour`(敵の戦闘 AI。例は `base`)、`Exp`(倒したときの経験値)、`RecruitmentChance`、そして `Loot` — キャラクターを倒したときに落ちる `ItemId`・`MinCount`・`MaxCount`・`Probability` の一覧です。
## アクションカード
アクションは kind `action` の JSON ファイルです。この mod は基本的な物理アクション — **基本攻撃**・**防御**・**スタン** — を同梱しています。
```json
{
"Id": "physics/attack",
"Name": "characters/action/physics_attack/name",
"Description": "characters/action/physics_attack/description",
"Image": "characters/actions/physics_attack",
"Type": "ToEnemy",
"Values": ["RequiredPoint=1", "Attack=1.0", "AttackType=Physics"]
}
```
`Type` が目標(敵・味方・自分)を決め、パッシブかアクティブかも定めます。`RequiredPoint` は AP コストです。ほかの値が戦闘で何をするかは、使われている戦闘 mod が決めます。
## シナリオからパーティにキャラクターを加える
```scenario
action party.add id=rpg_hero
```
キャラクターはパーティと戦闘メンバーに入ります。すでに名簿にいる者はレベルと HP を保ちます。RPG Demo はこの行で、村に初めて入ったときに主人公をプレイヤーに渡します。
## うまく動かないとき
1. **キャラクターが名前ではなく id を表示する。** `Name` は翻訳キーです。mod の `locale` ファイルに追加してください。
2. **台詞のそばにポートレートがない。** `first=` / `second=` の後のアバター名が、いずれかの mod の `avatars/` フォルダーにある画像と一致する必要があります。例は `marao/sad` に対する `avatars/marao/sad.png`。
3. **カードが戦闘で使えない。** キャラクターの AP がカードの `RequiredPoint` に足りていません。