Add mod documentation in seven languages

collection_settings.json

@@ -0,0 +1,9 @@
+{
+  "options": [
+    {
+      "key": "battle.core",
+      "value": "ff_battle",
+      "name": "collection_settings/ff"
+    }
+  ]
+}

docs/en.md

@@ -0,0 +1,56 @@
+# FF Battle — battles with a command menu
+
+FF Battle is a battle system in the style of classic console RPGs: the party at the bottom left, the enemies at the top, and a command menu — Attack, Items, Defend, Escape. It is the battle system of RPG Plus. The battle itself — its start, backdrop, victory and defeat screens, experience and loot — comes from Turn Battle Base; FF Battle is the way the player fights.
+
+## The battle screen
+
+The RPG Plus warrior meets a wolf in the village:
+
+![The FF battle screen: the wolf's card at the top (31/31, ATK 7, DEF 2), the hero's small card at the bottom left (42/42, MP 6/6, DEF 4, one yellow action point), the Battle panel at the top left (Round 1, Enemies 1, Party 1), the speed buttons and the battle log on the right.](assets/ff-start.jpg)
+
+- **Cards.** Each character shows health, the attack and defence (DEF is a shield that absorbs damage first), mana if the game has it, and the yellow dots of action points (AP).
+- **Battle panel** — the round, how many enemies and party members are left, and whose turn it is.
+- **Battle log** — every action and its result, newest at the bottom.
+
+## A turn
+
+1. **Pick a character** — click the card, or press **Enter**/**Space** for the first one with action points.
+2. **Choose a command** with the mouse or **W/S**/arrows and **Enter**:
+   - **Attack** — the character's battle actions;
+   - **Items** — usable items from the inventory, 1 AP each;
+   - **Defend** — the character's defence action on itself;
+   - **Escape** — 70% chance; on failure the character loses 1 AP.
+3. **Choose the action.** The panel next to the menu shows the action card and what it will do:
+
+![The Hero's actions menu — Basic attack (1P), Defence (1P), Power strike (1P), Back — and the Basic attack card with the hint "Damage 12 (ATK 12 × 1,0) · cost 1 AP".](assets/ff-actions.jpg)
+
+4. **Click the target.** "Select a target · RMB / Esc — cancel" appears and the enemy cards light up:
+
+![The wolf's card highlighted in red and the hint "Select a target · RMB / Esc — cancel".](assets/ff-target.jpg)
+
+When the party has spent its action points, the enemies take their turn, then a new round starts and the points are restored.
+
+## What the log says
+
+After one basic attack and the wolf's answer:
+
+![The battle log: Hero: Basic attack → Wolf; Wolf's shield absorbed 2 · left 0; Basic attack: Hero → Wolf · -10 HP; The party is out of AP; Enemy turn · round 1; Wolf: Defence.](assets/ff-log.jpg)
+
+The hero's attack is 12. The wolf's shield of 2 took the first 2 points and was used up, so the wolf lost 10 health: 31 → 21. The wolf then used Defence and raised its shield to 4 for the next blow.
+
+## Actions
+
+The menu lists the actions the character has (see Characters Engine). FF Battle itself carries out the basic kinds:
+
+- `Attack=1.5` — damage of the attack times the number, absorbed first by the target's shield;
+- `Defence=4` — a shield on an ally;
+- `Turn=2` — stun for that many turns;
+- item use.
+
+Actions written as formulas, such as Classic RPG Rules' Power strike or Fireball, work through Battle Formulas; mana costs (`Cost=mp:4`) are spent from the character's mana.
+
+## If something goes wrong
+
+1. **The menu does not open.** The character has no action points left this round, or it is the enemies' turn.
+2. **Items is greyed out.** There are no items in the inventory that can be used in battle.
+3. **A skill does nothing.** Its values need Battle Formulas, or it is not marked as usable in battle.

docs/es.md

@@ -0,0 +1,56 @@
+# FF Battle — combates con menú de comandos
+
+FF Battle es un sistema de combate al estilo de las consolas RPG clásicas: el grupo abajo a la izquierda, los enemigos arriba y un menú de comandos — Attack, Items, Defend, Escape. Es el sistema de combate de RPG Plus. El combate en sí — el inicio, el fondo, las pantallas de victoria y derrota, la experiencia y el botín — lo pone Turn Battle Base; FF Battle es la manera de luchar del jugador.
+
+## La pantalla de combate
+
+El guerrero de RPG Plus se encuentra con un lobo en la aldea:
+
+![La pantalla de combate de FF Battle: la carta del lobo arriba (31/31, ATK 7, DEF 2), la carta pequeña del héroe abajo a la izquierda (42/42, MP 6/6, DEF 4, un punto de acción amarillo), el panel Battle arriba a la izquierda (Round 1, Enemies 1, Party 1), y a la derecha los botones de velocidad y el registro de combate.](assets/ff-start.jpg)
+
+- **Las cartas.** Cada personaje muestra la salud, el ataque y la defensa (DEF es un escudo que absorbe el daño primero), el maná si el juego lo tiene, y los puntos amarillos de acción (AP).
+- **El panel Battle** — la ronda, cuántos enemigos y miembros del grupo quedan, y de quién es el turno.
+- **El registro de combate** — cada acción y su resultado, lo más reciente abajo.
+
+## Un turno
+
+1. **Elige un personaje** — haz clic en su carta o pulsa **Enter**/**Space** para tomar al primero que tenga puntos de acción.
+2. **Elige un comando** con el ratón o con **W/S**/las flechas y **Enter**:
+   - **Attack** — las acciones de combate del personaje;
+   - **Items** — objetos usables del inventario, 1 AP cada uno;
+   - **Defend** — la acción de defensa del personaje sobre sí mismo;
+   - **Escape** — 70% de probabilidad; si falla, el personaje pierde 1 AP.
+3. **Elige la acción.** El panel junto al menú muestra la carta de acción y lo que hará:
+
+![El menú de acciones del héroe — Basic attack (1P), Defence (1P), Power strike (1P), Back — y la carta de Basic attack con la pista «Daño 12 (ATK 12 × 1,0) · coste 1 AP».](assets/ff-actions.jpg)
+
+4. **Haz clic en el objetivo.** Aparece «Selecciona un objetivo · RMB / Esc — cancelar» y las cartas enemigas se iluminan:
+
+![La carta del lobo resaltada en rojo y la pista «Selecciona un objetivo · RMB / Esc — cancelar».](assets/ff-target.jpg)
+
+Cuando el grupo gasta sus puntos de acción, los enemigos hacen su turno; después empieza una ronda nueva y los puntos se restauran.
+
+## Lo que dice el registro
+
+Tras un ataque básico y la respuesta del lobo:
+
+![El registro de combate: Hero: Basic attack → Wolf; Wolf's shield absorbed 2 · left 0; Basic attack: Hero → Wolf · -10 HP; The party is out of AP; Enemy turn · round 1; Wolf: Defence.](assets/ff-log.jpg)
+
+El ataque del héroe es 12. El escudo del lobo (2) absorbió los primeros 2 puntos y se agotó, así que el lobo perdió 10 de salud: 31 → 21. Después el lobo usó Defence y subió su escudo a 4 para el próximo golpe.
+
+## Las acciones
+
+El menú enumera las acciones que tiene el personaje (véase Characters Engine). Los tipos básicos los ejecuta el propio FF Battle:
+
+- `Attack=1.5` — el daño del ataque multiplicado por el número; lo absorbe primero el escudo del objetivo;
+- `Defence=4` — un escudo sobre un aliado;
+- `Turn=2` — aturdimiento durante ese número de turnos;
+- el uso de objetos.
+
+Las acciones escritas como fórmulas, como el Power strike o el Fireball de Classic RPG Rules, funcionan mediante Battle Formulas; los costes de maná (`Cost=mp:4`) se pagan con el maná del personaje.
+
+## Si algo sale mal
+
+1. **El menú no se abre.** El personaje se quedó sin puntos de acción en esta ronda, o es el turno de los enemigos.
+2. **Items aparece en gris.** No hay objetos en el inventario que se puedan usar en combate.
+3. **Una habilidad no hace nada.** Sus valores necesitan Battle Formulas, o no está marcada como usable en combate.

docs/ja.md

@@ -0,0 +1,56 @@
+# FF Battle —— コマンドメニューで戦う戦闘
+
+FF Battle は、古典的なコンソールRPG風のバトルシステムです。左下にパーティ、上に敵、そして Attack・Items・Defend・Escape のコマンドメニュー。RPG Plus のバトルシステムです。戦闘そのもの——開始、背景、勝利・敗北の画面、経験値と戦利品——は Turn Battle Base が担い、FF Battle はプレイヤーの戦い方を担当します。
+
+## 戦闘画面
+
+RPG Plus の戦士が村で狼に出くわします：
+
+![FF Battle の戦闘画面：上に狼のカード（31/31、ATK 7、DEF 2）、左下に英雄の小さなカード（42/42、MP 6/6、DEF 4、黄色い行動ポイントが1つ）、左上に Battle パネル（Round 1、Enemies 1、Party 1）、右側に速度ボタンと戦闘ログ。](assets/ff-start.jpg)
+
+- **カード。** キャラクターごとに、体力、攻撃と防御（DEF はダメージを最初に受け止めるシールド）、ゲームにあればマナ、そして行動ポイント（AP）の黄色い点が表示されます。
+- **Battle パネル**——ラウンド数、残りの敵とパーティメンバーの数、そして今誰のターンかを示します。
+- **戦闘ログ**——すべてのアクションとその結果を記録します。新しいものが下に追加されます。
+
+## ターンの流れ
+
+1. **キャラクターを選びます**——カードをクリックするか、**Enter**/**Space** で行動ポイントのある最初のキャラクターを選べます。
+2. **コマンドを選びます**——マウス、または **W/S**／方向キーと **Enter** で：
+   - **Attack**——キャラクターの戦闘アクション；
+   - **Items**——インベントリから使えるアイテム。それぞれ 1 AP；
+   - **Defend**——自分自身への防御アクション；
+   - **Escape**——成功率 70%。失敗するとキャラクターは 1 AP 失います。
+3. **アクションを選びます。** メニューの横のパネルにアクションカードとその効果が表示されます：
+
+![英雄のアクションメニュー——Basic attack（1P）、Defence（1P）、Power strike（1P）、Back——と、ヒント付きの Basic attack カード「ダメージ 12（ATK 12 × 1,0）· 消費 1 AP」。](assets/ff-actions.jpg)
+
+4. **ターゲットをクリックします。**「対象を選択 · 右クリック / Esc — キャンセル」というヒントが出て、敵のカードが光ります：
+
+![赤く光った狼のカードとヒント「対象を選択 · 右クリック / Esc — キャンセル」。](assets/ff-target.jpg)
+
+パーティが行動ポイントを使い切ると敵のターンになり、その後新しいラウンドが始まってポイントが回復します。
+
+## ログの読み方
+
+通常攻撃を一度と、それに対する狼の応答のあと：
+
+![戦闘ログ：Hero: Basic attack → Wolf／Wolf's shield absorbed 2 · left 0／Basic attack: Hero → Wolf · -10 HP／The party is out of AP／Enemy turn · round 1／Wolf: Defence.](assets/ff-log.jpg)
+
+英雄の攻撃は 12。狼のシールド（2）が最初の 2 点を受け止めて使い切ったため、狼の体力は 10 減って 31 → 21。その後狼は Defence を使い、次の一撃に備えてシールドを 4 まで上げます。
+
+## アクション
+
+メニューには、そのキャラクターが持つアクションが並びます（Characters Engine を参照）。基本の種類そのものは FF Battle が処理します：
+
+- `Attack=1.5`——攻撃ダメージに数値を掛けたもの。まず対象のシールドが受け止めます；
+- `Defence=4`——味方にシールドを付与；
+- `Turn=2`——そのターン数だけスタン；
+- アイテムの使用。
+
+数式で書かれたアクション（Classic RPG Rules の Power strike や Fireball など）は Battle Formulas を通して機能します。マナのコスト（`Cost=mp:4`）はキャラクターのマナから支払われます。
+
+## うまくいかないときは
+
+1. **メニューが開かない。** そのキャラクターの行動ポイントがこのラウンドでもうないか、敵のターンです。
+2. **Items がグレーになっている。** インベントリに戦闘で使えるアイテムがありません。
+3. **スキルが何もしない。** その値には Battle Formulas が必要か、戦闘で使える印が付いていません。

docs/ko.md

@@ -0,0 +1,56 @@
+# FF Battle — 커맨드 메뉴 방식의 전투
+
+FF Battle은 고전 콘솔 RPG 스타일의 전투 시스템입니다. 왼쪽 아래에 파티, 위에 적, 그리고 Attack·Items·Defend·Escape 커맨드 메뉴가 있습니다. RPG Plus의 전투 시스템이죠. 전투 자체 — 시작, 배경, 승리·패배 화면, 경험치와 전리품 — 은 Turn Battle Base가 맡고, FF Battle은 플레이어의 싸움 방식을 담당합니다.
+
+## 전투 화면
+
+RPG Plus의 전사가 마을에서 늑대를 만납니다:
+
+![FF Battle의 전투 화면: 위에 늑대의 카드(31/31, ATK 7, DEF 2), 왼쪽 아래에 영웅의 작은 카드(42/42, MP 6/6, DEF 4, 노란 행동점 하나), 왼쪽 위에 Battle 패널(Round 1, Enemies 1, Party 1), 오른쪽에 속도 버튼과 전투 로그.](assets/ff-start.jpg)
+
+- **카드.** 캐릭터마다 체력, 공격력과 방어력(DEF은 피해를 먼저 흡수하는 방어막), 게임에 있다면 마나, 그리고 행동점(AP)을 나타내는 노란 점이 표시됩니다.
+- **Battle 패널** — 라운드, 남은 적과 파티원 수, 지금 누구의 차례인지 보여줍니다.
+- **전투 로그** — 모든 행동과 그 결과를 기록하며, 최신 기록이 아래에 쌓입니다.
+
+## 한 턴의 진행
+
+1. **캐릭터를 고릅니다** — 카드를 클릭하거나 **Enter**/**Space**를 눌러 행동점이 남은 첫 캐릭터를 선택하세요.
+2. **커맨드를 고릅니다** — 마우스나 **W/S**/방향키, **Enter**로 선택하세요:
+   - **Attack** — 캐릭터의 전투 행동;
+   - **Items** — 인벤토리에서 사용할 수 있는 아이템, 각 1 AP;
+   - **Defend** — 자기 자신에게 거는 방어 행동;
+   - **Escape** — 성공 확률 70%. 실패하면 캐릭터가 1 AP를 잃습니다.
+3. **행동을 고릅니다.** 메뉴 옆 패널에 행동 카드와 그 효과가 표시됩니다:
+
+![영웅의 행동 메뉴 — Basic attack(1P), Defence(1P), Power strike(1P), Back — 와 Basic attack 카드. 힌트: "피해 12 (ATK 12 × 1,0) · 소모 1 AP".](assets/ff-actions.jpg)
+
+4. **대상을 클릭합니다.** "대상 선택 · 오른쪽 버튼 / Esc — 취소" 안내가 뜨고 적 카드가 밝게 표시됩니다:
+
+![붉게 표시된 늑대의 카드와 "대상 선택 · 오른쪽 버튼 / Esc — 취소" 안내.](assets/ff-target.jpg)
+
+파티가 행동점을 다 쓰면 적들의 차례가 되고, 이후 새 라운드가 시작되며 행동점이 회복됩니다.
+
+## 로그가 말해주는 것
+
+기본 공격 한 번과 늑대의 대답 이후:
+
+![전투 로그: Hero: Basic attack → Wolf; Wolf's shield absorbed 2 · left 0; Basic attack: Hero → Wolf · -10 HP; The party is out of AP; Enemy turn · round 1; Wolf: Defence.](assets/ff-log.jpg)
+
+영웅의 공격은 12입니다. 늑대의 방어막(2)이 처음 2점을 흡수하고 소진되어, 늑대는 체력을 10 잃고 31 → 21이 됐습니다. 이어서 늑대는 Defence를 써서 다음 공격에 대비해 방어막을 4까지 올립니다.
+
+## 행동
+
+메뉴에는 캐릭터가 가진 행동이 나열됩니다(Characters Engine 참조). 기본 유형은 FF Battle 자체가 처리합니다:
+
+- `Attack=1.5` — 공격 피해에 그 수를 곱한 값입니다. 대상의 방어막이 먼저 흡수합니다;
+- `Defence=4` — 아군에게 방어막을 겁니다;
+- `Turn=2` — 그만큼의 턴 동안 기절;
+- 아이템 사용.
+
+수식으로 쓰인 행동(Classic RPG Rules의 Power strike, Fireball 등)은 Battle Formulas를 통해 작동하며, 마나 비용(`Cost=mp:4`)은 캐릭터의 마나에서 차감됩니다.
+
+## 문제가 생겼을 때
+
+1. **메뉴가 열리지 않음.** 캐릭터의 행동점이 이번 라운드에 바닥났거나, 지금은 적의 차례입니다.
+2. **Items가 회색으로 비활성화됨.** 인벤토리에 전투에서 쓸 수 있는 아이템이 없습니다.
+3. **스킬이 아무 효과가 없음.** 수치에 Battle Formulas가 필요하거나, 전투 사용 가능 표시가 없는 스킬입니다.

docs/ru.md

@@ -0,0 +1,56 @@
+# FF Battle — бои с меню команд
+
+FF Battle — боевая система в стиле классических консольных RPG: отряд слева внизу, враги вверху и меню команд — Attack, Items, Defend, Escape. Это боевая система RPG Plus. Сам бой — начало, фон, экраны победы и поражения, опыт и добыча — берётся из Turn Battle Base, а FF Battle определяет, как именно сражается игрок.
+
+## Экран боя
+
+Воин из RPG Plus встречает волка в деревне:
+
+![Экран боя FF Battle: карта волка вверху (31/31, ATK 7, DEF 2), маленькая карта героя слева внизу (42/42, MP 6/6, DEF 4, одно жёлтое очко действий), панель Battle слева вверху (Round 1, Enemies 1, Party 1), справа — кнопки скорости и журнал боя.](assets/ff-start.jpg)
+
+- **Карты.** У каждого персонажа видны здоровье, атака и защита (DEF — щит, который поглощает урон первым), мана, если она есть в игре, и жёлтые точки очков действий (AP).
+- **Панель Battle** — номер раунда, сколько врагов и бойцов отряда осталось и чей сейчас ход.
+- **Журнал боя** — каждое действие и его результат; свежие записи внизу.
+
+## Ход
+
+1. **Выберите персонажа** — щёлкните по его карте или нажмите **Enter**/**Space**, чтобы взять первого, у кого есть очки действий.
+2. **Выберите команду** мышью или клавишами **W/S**, стрелками и **Enter**:
+   - **Attack** — боевые действия персонажа;
+   - **Items** — предметы из инвентаря, которые можно использовать; по 1 AP;
+   - **Defend** — защитное действие персонажа на самого себя;
+   - **Escape** — шанс 70%; при неудаче персонаж теряет 1 AP.
+3. **Выберите действие.** Панель рядом с меню покажет карту действия и то, что она сделает:
+
+![Меню действий героя — Basic attack (1P), Defence (1P), Power strike (1P), Back — и карта Basic attack с подсказкой «Урон 12 (ATK 12 × 1,0) · затраты 1 AP».](assets/ff-actions.jpg)
+
+4. **Щёлкните по цели.** Появится подсказка «Выберите цель · ПКМ / Esc — отмена», и карты врагов подсветятся:
+
+![Карта волка, подсвеченная красным, и подсказка «Выберите цель · ПКМ / Esc — отмена».](assets/ff-target.jpg)
+
+Когда отряд потратит очки действий, ход переходит к врагам; затем начинается новый раунд, и очки восстанавливаются.
+
+## Что говорит журнал
+
+После одной обычной атаки и ответа волка:
+
+![Журнал боя: Hero: Basic attack → Wolf; Wolf's shield absorbed 2 · left 0; Basic attack: Hero → Wolf · -10 HP; The party is out of AP; Enemy turn · round 1; Wolf: Defence.](assets/ff-log.jpg)
+
+Атака героя — 12. Щит волка (2) взял на себя первые 2 очка и исчерпался, так что волк потерял 10 здоровья: 31 → 21. Затем волк применил Defence и поднял щит до 4 перед следующим ударом.
+
+## Действия
+
+В меню перечислены действия персонажа (см. Characters Engine). Сами базовые виды действий выполняет FF Battle:
+
+- `Attack=1.5` — урон атаки, умноженный на число; первым его поглощает щит цели;
+- `Defence=4` — щит на союзнике;
+- `Turn=2` — оглушение на столько ходов;
+- использование предметов.
+
+Действия-формулы, например Power strike или Fireball из Classic RPG Rules, работают через Battle Formulas; затраты маны (`Cost=mp:4`) списываются с маны персонажа.
+
+## Если что-то пошло не так
+
+1. **Меню не открывается.** У персонажа не осталось очков действий в этом раунде либо сейчас ход врагов.
+2. **Пункт Items неактивен.** В инвентаре нет предметов, которые можно использовать в бою.
+3. **Навык ничего не делает.** Его значениям нужен Battle Formulas, либо навык не помечен как пригодный для боя.

docs/vi.md

@@ -0,0 +1,56 @@
+# FF Battle — chiến đấu bằng menu lệnh
+
+FF Battle là hệ thống chiến đấu mang phong cách RPG máy chơi game cổ điển: đội của bạn ở góc dưới bên trái, kẻ địch ở trên, cùng một menu lệnh — Attack, Items, Defend, Escape. Đây là hệ thống chiến đấu của RPG Plus. Bản thân trận chiến — khởi đầu, nền, màn hình thắng thua, kinh nghiệm và chiến lợi phẩm — do Turn Battle Base đảm nhiệm; còn FF Battle quyết định người chơi đánh thế nào.
+
+## Màn hình chiến đấu
+
+Chiến binh RPG Plus chạm trán một con sói trong làng:
+
+![Màn hình chiến đấu FF Battle: thẻ của con sói ở trên (31/31, ATK 7, DEF 2), thẻ nhỏ của anh hùng dưới trái (42/42, MP 6/6, DEF 4, một điểm hành động màu vàng), bảng Battle trên trái (Round 1, Enemies 1, Party 1), bên phải là các nút tốc độ và nhật ký chiến đấu.](assets/ff-start.jpg)
+
+- **Thẻ.** Mỗi nhân vật cho thấy máu, sát thương và phòng thủ (DEF là lớp khiên hấp thụ sát thương trước), mana nếu game có, và các chấm vàng là điểm hành động (AP).
+- **Bảng Battle** — vòng đấu, số kẻ địch và thành viên đội còn lại, và đến lượt của ai.
+- **Nhật ký chiến đấu** — ghi lại từng hành động và kết quả của nó, cái mới nhất nằm dưới cùng.
+
+## Diễn biến một lượt
+
+1. **Chọn nhân vật** — nhấp vào thẻ, hoặc nhấn **Enter**/**Space** để chọn nhân vật đầu tiên còn điểm hành động.
+2. **Chọn một lệnh** bằng chuột hoặc **W/S**/các phím mũi tên và **Enter**:
+   - **Attack** — các hành động chiến đấu của nhân vật;
+   - **Items** — vật phẩm dùng được từ túi đồ, mỗi món 1 AP;
+   - **Defend** — hành động phòng thủ của nhân vật lên chính nó;
+   - **Escape** — tỉ lệ thành công 70%; nếu hụt, nhân vật mất 1 AP.
+3. **Chọn hành động.** Bảng cạnh menu sẽ hiện thẻ hành động và hiệu ứng của nó:
+
+![Menu hành động của anh hùng — Basic attack (1P), Defence (1P), Power strike (1P), Back — và thẻ Basic attack kèm gợi ý "Sát thương 12 (ATK 12 × 1,0) · tốn 1 AP".](assets/ff-actions.jpg)
+
+4. **Nhấp vào mục tiêu.** Dòng gợi ý "Chọn mục tiêu · chuột phải / Esc — hủy" xuất hiện và các thẻ địch sáng lên:
+
+![Thẻ của con sói được tô đỏ và dòng gợi ý "Chọn mục tiêu · chuột phải / Esc — hủy".](assets/ff-target.jpg)
+
+Khi đội dùng hết điểm hành động, quân địch sẽ đến lượt hành động; sau đó một vòng mới bắt đầu và điểm được hồi lại.
+
+## Đọc nhật ký
+
+Sau một đòn đánh thường và đòn đáp trả của con sói:
+
+![Nhật ký chiến đấu: Hero: Basic attack → Wolf; Wolf's shield absorbed 2 · left 0; Basic attack: Hero → Wolf · -10 HP; The party is out of AP; Enemy turn · round 1; Wolf: Defence.](assets/ff-log.jpg)
+
+Đòn đánh của anh hùng là 12. Lớp khiên 2 điểm của sói hấp thụ phần đầu rồi cạn, nên con sói mất 10 máu: 31 → 21. Sau đó nó dùng Defence, nâng lớp khiên lên 4 để đỡ đòn tiếp theo.
+
+## Các hành động
+
+Menu liệt kê các hành động mà nhân vật có (xem Characters Engine). Còn các loại cơ bản thì FF Battle tự xử lý:
+
+- `Attack=1.5` — sát thương của đòn đánh nhân với con số; lớp khiên của mục tiêu hấp thụ trước;
+- `Defence=4` — đặt lớp khiên lên đồng đội;
+- `Turn=2` — khiến mục tiêu choáng đúng số lượt đó;
+- dùng vật phẩm.
+
+Các hành động viết bằng công thức, chẳng hạn Power strike hay Fireball của Classic RPG Rules, hoạt động thông qua Battle Formulas; chi phí mana (`Cost=mp:4`) trừ vào mana của nhân vật.
+
+## Khi có sự cố
+
+1. **Menu không mở ra.** Nhân vật đã hết điểm hành động trong vòng này, hoặc đang là lượt của quân địch.
+2. **Items bị mờ đi.** Trong túi đồ không còn vật phẩm nào dùng được trong chiến đấu.
+3. **Kỹ năng chẳng có tác dụng.** Giá trị của nó cần Battle Formulas, hoặc nó không được đánh dấu là dùng được trong chiến đấu.

docs/zh.md

@@ -0,0 +1,56 @@
+# FF Battle —— 指令菜单式战斗
+
+FF Battle 是一套经典主机 RPG 风格的战斗系统：队伍在左下角，敌人在上方，还有一个指令菜单——Attack、Items、Defend、Escape。它是 RPG Plus 的战斗系统。战斗本身——发起、背景、胜利与失败画面、经验和掉落——来自 Turn Battle Base；FF Battle 决定的是玩家的战斗方式。
+
+## 战斗画面
+
+RPG Plus 的战士在村庄里遭遇一只狼：
+
+![FF Battle 的战斗画面：狼的卡牌在上方（31/31、ATK 7、DEF 2），英雄的小卡牌在左下角（42/42、MP 6/6、DEF 4、一个黄色行动点），左上角是 Battle 面板（Round 1、Enemies 1、Party 1），右侧是倍速按钮和战斗日志。](assets/ff-start.jpg)
+
+- **卡牌。** 每个角色显示生命、攻击和防御（DEF 是优先吸收伤害的护盾）、魔力（若游戏有此设定），以及代表行动点的黄色圆点（AP）。
+- **Battle 面板**——显示回合数、敌我双方剩余数量，以及当前轮到谁行动。
+- **战斗日志**——记录每个动作及其结果，最新的在最下方。
+
+## 一个回合的流程
+
+1. **选择角色**——点击其卡牌，或按 **Enter**/**Space** 选中第一个还有行动点的角色。
+2. **选择指令**——可用鼠标，或用 **W/S**、方向键加 **Enter**：
+   - **Attack**——角色的战斗动作；
+   - **Items**——背包中可使用的物品，每件 1 AP；
+   - **Defend**——角色对自身的防御动作；
+   - **Escape**——70% 概率逃跑；失败则该角色失去 1 AP。
+3. **选择动作。** 菜单旁边的面板会显示动作卡及其效果：
+
+![英雄的动作菜单——Basic attack（1P）、Defence（1P）、Power strike（1P）、Back——以及 Basic attack 卡牌，提示为「伤害 12（ATK 12 × 1,0）· 消耗 1 AP」。](assets/ff-actions.jpg)
+
+4. **点击目标。** 屏幕上会出现「选择目标 · 鼠标右键 / Esc — 取消」的提示，敌人卡牌随之高亮：
+
+![狼的卡牌以红色高亮，提示为「选择目标 · 鼠标右键 / Esc — 取消」。](assets/ff-target.jpg)
+
+队伍用完行动点后，轮到敌人行动；随后新回合开始，行动点也会恢复。
+
+## 日志里写了什么
+
+一次普通攻击和狼的回击之后：
+
+![战斗日志：Hero: Basic attack → Wolf；Wolf's shield absorbed 2 · left 0；Basic attack: Hero → Wolf · -10 HP；The party is out of AP；Enemy turn · round 1；Wolf: Defence.](assets/ff-log.jpg)
+
+英雄的攻击为 12。狼的护盾（2）先吸收了最初的 2 点并耗尽，因此狼损失了 10 点生命：31 → 21。随后狼使用 Defence，把护盾提升到 4 以迎接下一击。
+
+## 动作类型
+
+菜单里列出角色拥有的动作（参见 Characters Engine）。而以下几种基础类型由 FF Battle 自身处理：
+
+- `Attack=1.5`——攻击伤害乘以该数值；优先被目标的护盾吸收；
+- `Defence=4`——给队友加护盾；
+- `Turn=2`——眩晕相应的回合数；
+- 使用物品。
+
+以公式书写的动作，比如 Classic RPG Rules 的 Power strike 或 Fireball，通过 Battle Formulas 生效；魔力消耗（`Cost=mp:4`）从角色的魔力中扣除。
+
+## 出问题怎么办
+
+1. **菜单打不开。** 该角色本回合的行动点已用完，或者当前是敌人的回合。
+2. **Items 呈灰色。** 背包里没有可在战斗中使用的物品。
+3. **技能没有任何效果。** 它的数值需要 Battle Formulas，或者它没有被标记为可在战斗中使用。

locale/collection_settings_en.properties

@@ -0,0 +1 @@
+collection_settings/ff = Final Fantasy battles

locale/collection_settings_es.properties

@@ -0,0 +1 @@
+collection_settings/ff = Combate Final Fantasy

locale/collection_settings_ja.properties

@@ -0,0 +1 @@
+collection_settings/ff = Final Fantasy式バトル

locale/collection_settings_ko.properties

@@ -0,0 +1 @@
+collection_settings/ff = 파이널 판타지 전투

locale/collection_settings_ru.properties

@@ -0,0 +1 @@
+collection_settings/ff = Бои Final Fantasy

locale/collection_settings_vi.properties

@@ -0,0 +1 @@
+collection_settings/ff = Chiến đấu Final Fantasy

locale/collection_settings_zh.properties

@@ -0,0 +1 @@
+collection_settings/ff = 最终幻想式战斗

locale/en.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FF Battle
+mod_ff_battle_desc = A battle system in the style of classic console RPGs: the party, the enemies and a command menu — Attack, Items, Defend, Escape. The battle of RPG Plus.

locale/es.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FF Battle
+mod_ff_battle_desc = Un sistema de combate al estilo de las consolas RPG clásicas: el grupo, los enemigos y un menú de comandos — Attack, Items, Defend, Escape. El combate de RPG Plus.

locale/ja.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FFバトル
+mod_ff_battle_desc = 古典的なコンソールRPG風のバトルシステム。パーティ、敵、そして Attack・Items・Defend・Escape のコマンドメニュー。RPG Plus の戦闘です。

locale/ko.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FF 배틀
+mod_ff_battle_desc = 고전 콘솔 RPG 스타일의 전투 시스템입니다. 파티, 적, 그리고 Attack·Items·Defend·Escape 커맨드 메뉴. RPG Plus의 전투죠.

locale/ru.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FF Battle
+mod_ff_battle_desc = Боевая система в стиле классических консольных RPG: отряд, враги и меню команд — Attack, Items, Defend, Escape. Бой игры RPG Plus.

locale/ui_en.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name = FFBattle
-mod_ff_battle_desc = Final Fantasy style battle system on top of turn_battle_base: menu-driven commands (attack/defence/item/stun), enemy and party panels, per-action animations and executors, battle HUD and log.
 
 ff_battle/menu_attack = Attack
 ff_battle/menu_items = Items

locale/ui_es.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name = FFBattle
-mod_ff_battle_desc = Sistema de combate al estilo Final Fantasy sobre turn_battle_base: órdenes por menú (atacar, defender, objeto, aturdir), paneles de enemigos y del grupo, animaciones y ejecutores por acción, HUD y registro de combate.
 
 ff_battle/menu_attack = Atacar
 ff_battle/menu_items = Objetos

locale/ui_ja.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name = FFBattle
-mod_ff_battle_desc = turn_battle_base 上の Final Fantasy 風バトルシステム：メニュー式のコマンド（攻撃／防御／アイテム／スタン）、敵とパーティのパネル、アクションごとのアニメーションと実行器、バトル HUD とログ。
 
 ff_battle/menu_attack = たたかう
 ff_battle/menu_items = アイテム

locale/ui_ko.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name = FFBattle
-mod_ff_battle_desc = turn_battle_base 위의 Final Fantasy 스타일 전투 시스템: 메뉴식 명령(공격/방어/아이템/기절), 적과 파티 패널, 액션별 애니메이션과 실행기, 전투 HUD와 로그.
 
 ff_battle/menu_attack = 공격
 ff_battle/menu_items = 아이템

locale/ui_ru.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name=FF Битва
-mod_ff_battle_desc=Боевая система в стиле Final Fantasy на платформе turn_battle_base: командное меню (атака/защита/предмет/оглушение), панели партии и врагов, анимации и исполнители действий, HUD и лог боя.
 
 ff_battle/menu_attack=Атака
 ff_battle/menu_items=Предметы

locale/ui_vi.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name = FFBattle
-mod_ff_battle_desc = Hệ thống chiến đấu phong cách Final Fantasy trên nền turn_battle_base: lệnh qua menu (tấn công/phòng thủ/vật phẩm/choáng), bảng kẻ địch và tổ đội, hoạt ảnh và bộ thực thi cho từng hành động, HUD và nhật ký chiến đấu.
 
 ff_battle/menu_attack = Tấn công
 ff_battle/menu_items = Vật phẩm

locale/ui_zh.properties

@@ -1,5 +1,3 @@
-mod_ff_battle_name = FFBattle
-mod_ff_battle_desc = 基于 turn_battle_base 的 Final Fantasy 风格战斗系统：菜单式指令（攻击/防御/物品/眩晕）、敌方和队伍面板、每个动作的动画与执行器、战斗 HUD 和日志。
 
 ff_battle/menu_attack = 攻击
 ff_battle/menu_items = 物品

locale/vi.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FF Battle
+mod_ff_battle_desc = Hệ thống chiến đấu mang phong cách RPG máy chơi game cổ điển: đội của bạn, kẻ địch và một menu lệnh — Attack, Items, Defend, Escape. Trận chiến của RPG Plus.

locale/zh.properties

@@ -0,0 +1,2 @@
+mod_ff_battle_name = FF 战斗
+mod_ff_battle_desc = 经典主机 RPG 风格的战斗系统：队伍、敌人和一个指令菜单——Attack、Items、Defend、Escape。RPG Plus 的战斗。

manifest.json

@@ -1,9 +1,9 @@
 {
   "id": "ff_battle",
-  "name": "FFBattle",
+  "name": "FF Battle",
   "version": "1.0.0",
   "author": "ct",
-  "description": "Final Fantasy style battle system on top of turn_battle_base: menu-driven commands (attack/defence/item/stun), enemy and party panels, per-action animations and executors, battle HUD and log.",
+  "description": "A battle system in the style of classic console RPGs: the party, the enemies and a command menu — Attack, Items, Defend, Escape. The battle of RPG Plus.",
   "category": "gameplay",
   "sources": [
     "src/**/*.cs"