Add mod documentation in seven languages

.gitignore

@@ -12,6 +12,7 @@ obj/
 gen/
 obj/
 bin/
+art_sources/
 
 *.tres~
 *.tscn~

docs/en.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — who the player begins with
+
+This small mod gives a new game of Cthangover its starting state: Marao in the party and the skill Slave Trader in the skill collection. It holds only this code; the character and the skill themselves are data of the base game and of the skills engine.
+
+## What a new player has
+
+The character panel at the very start of Cthangover — one party member, Marao, with two actions and a free slot:
+
+![The Character actions panel: Party 1, Marao (template 2, HP 16/16, AP 1, ATK 5, DEF 0) with Basic attack and Defence, and an empty third slot.](assets/party.jpg)
+
+The skills panel — one skill, Slave Trader:
+
+![The Skills panel: the collection holds one Epic passive skill, Slave Trader, "+10% recruitment chance", with the description "Gives the ability to enslave a defeated enemy with a base chance of 10%. The upkeep of the slave falls on your shoulders." and the collection effect +10% recruitment chance.](assets/skills.jpg)
+
+Slave Trader is what lets the player capture defeated enemies (see Recruiting): without it no enemy can join.
+
+## When it runs
+
+- When the game's mods are ready, the mod adds the character `Marao` to the party and grants the skill `slave_master`.
+- Every time a **new game** starts it does the same again, because a new game first clears the party.
+- Loading a save replaces the party and skills with the saved ones. Both steps can run more than once safely: Marao is not added twice and the skill is not granted twice.
+
+## Changing the start
+
+- Another mod can add more starting characters the same way: a C# initializer that adds its characters to the party when the mods are ready.
+- To start without Marao or without the skill, leave this mod out of the game's collection and seed the party in your own mod.
+
+## Known problems
+
+- The Slave Trader card has no picture: the skill's image is missing.
+- The card and its description promise "+10% recruitment chance", but no code reads that bonus; the capture roll uses only the enemy's own chance.

docs/es.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — con quién empieza el jugador
+
+Este mod pequeño da a una partida nueva de Cthangover su estado inicial: Marao en el grupo y la habilidad Tratante de esclavos en la colección de habilidades. Solo contiene ese código; el personaje y la habilidad en sí son datos del juego base y del motor de habilidades.
+
+## Qué tiene un jugador nuevo
+
+El panel de personajes al comienzo de Cthangover: un miembro del grupo, Marao, con dos acciones y un hueco libre:
+
+![El panel de acciones del personaje: Grupo 1, Marao (plantilla 2, HP 16/16, PA 1, ATK 5, DEF 0) con Ataque básico y Defensa, y un tercer hueco vacío.](assets/party.jpg)
+
+El panel de habilidades: una sola habilidad, Tratante de esclavos:
+
+![El panel de habilidades: la colección tiene una habilidad pasiva épica, Tratante de esclavos, "+10 % de probabilidad de reclutar", con la descripción "Permite esclavizar a un enemigo derrotado con una probabilidad base del 10 %. La manutención del esclavo corre de tu cuenta." y el efecto de colección +10 % de probabilidad de reclutar.](assets/skills.jpg)
+
+Tratante de esclavos es lo que permite al jugador capturar enemigos derrotados (ver Recruiting): sin él ningún enemigo puede unirse.
+
+## Cuándo actúa
+
+- Cuando los mods del juego están listos, el mod añade el personaje `Marao` al grupo y concede la habilidad `slave_master`.
+- Cada vez que empieza una **partida nueva** lo hace otra vez, porque una partida nueva primero vacía el grupo.
+- Cargar una partida guardada sustituye el grupo y las habilidades por los guardados. Ambos pasos pueden ejecutarse más de una vez sin problema: Marao no se añade dos veces ni la habilidad se concede dos veces.
+
+## Cómo cambiar el inicio
+
+- Otro mod puede añadir más personajes iniciales igual: un inicializador en C# que añade sus personajes al grupo cuando los mods están listos.
+- Para empezar sin Marao o sin la habilidad, deja este mod fuera de la colección del juego y siembra el grupo en tu propio mod.
+
+## Problemas conocidos
+
+- La carta de Tratante de esclavos no tiene imagen: falta la imagen de la habilidad.
+- La carta y su descripción prometen "+10 % de probabilidad de reclutar", pero ningún código lee ese bono; la tirada de captura usa solo la probabilidad propia del enemigo.

docs/ja.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — プレイヤーの最初の仲間
+
+この小さな MOD は、Cthangover のニューゲームに初期状態を与えます:パーティに入ったマラオと、スキルコレクションに入ったスキル「奴隷商人」です。入っているのはこのコードだけで、キャラクターとスキルそのものはベースゲームとスキルエンジンのデータです。
+
+## 新しいプレイヤーの手元にあるもの
+
+Cthangover 冒頭のキャラクターパネル — パーティメンバーはマラオ一人、アクション二つと空きスロット一つ:
+
+![キャラクターアクションパネル:パーティ 1、マラオ(テンプレート 2、HP 16/16、AP 1、ATK 5、DEF 0)に「通常攻撃」と「防御」、3 つ目のスロットは空き。](assets/party.jpg)
+
+スキルパネル — スキルは一つ、奴隷商人:
+
+![スキルパネル:コレクションにはエピックのパッシブスキル「奴隷商人」が一つ、「勧誘の確率 +10%」、説明は「倒した敵を基本確率 10% で奴隷にできる。奴隷の食い扶持はあなた持ち。」、コレクション効果は勧誘の確率 +10%。](assets/skills.jpg)
+
+奴隷商人があるからこそ、プレイヤーは倒した敵を捕らえられます(Recruiting を参照):これがなければ敵は誰も加わりません。
+
+## いつ動くか
+
+- ゲームの MOD が揃うと、この MOD はキャラクター `Marao` をパーティに加え、スキル `slave_master` を与えます。
+- **ニューゲーム**を始めるたびに同じことを繰り返します。ニューゲームはまずパーティを空にするからです。
+- セーブのロードはパーティとスキルを保存済みのものへ置き換えます。どちらの処理も複数回走っても安全です。マラオが二重に追加されることも、スキルが二重に与えられることもありません。
+
+## 初期状態を変えるには
+
+- 別の MOD も同じやり方で初期キャラクターを増やせます:MOD が揃ったときに自分のキャラクターをパーティへ加える C# の初期化子です。
+- マラオやスキルなしで始めたいなら、この MOD をゲームのコレクションに入れず、自分の MOD でパーティを用意します。
+
+## 既知の問題
+
+- 奴隷商人のカードに画像がありません:スキルの画像が欠けています。
+- カードと説明は「勧誘の確率 +10%」をうたっていますが、このボーナスを読むコードは存在せず、捕獲判定は敵自身の確率だけを使います。

docs/ko.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — 플레이어의 시작 멤버
+
+이 작은 모드는 Cthangover 새 게임의 시작 상태를 만들어 줍니다: 파티에 들어간 마라오, 그리고 스킬 컬렉션의 ‘노예 상인’. 여기에는 이 코드만 들어 있고, 캐릭터와 스킬 자체는 기본 게임과 스킬 엔진의 데이터입니다.
+
+## 새 플레이어가 가진 것
+
+Cthangover 맨 처음의 캐릭터 패널 — 파티 멤버는 마라오 한 명, 행동 두 개와 빈 슬롯 하나:
+
+![캐릭터 행동 패널: 파티 1, 마라오(템플릿 2, HP 16/16, AP 1, ATK 5, DEF 0)에 기본 공격과 방어가 있고 세 번째 슬롯은 비어 있음.](assets/party.jpg)
+
+스킬 패널 — 스킬은 하나, 노예 상인:
+
+![스킬 패널: 컬렉션에는 에픽 패시브 스킬 ‘노예 상인’이 하나, “영입 확률 +10%”, 설명은 “쓰러뜨린 적을 기본 10% 확률로 노예로 삼을 수 있다. 노예의 부양은 당신 몫이다.”, 컬렉션 효과는 영입 확률 +10%.](assets/skills.jpg)
+
+노예 상인이 있어야 플레이어가 쓰러뜨린 적을 포획할 수 있습니다(Recruiting 참조): 이 스킬이 없으면 그 누구도 파티에 합류하지 못합니다.
+
+## 언제 작동하나
+
+- 게임의 모드가 준비되면 이 모드는 캐릭터 `Marao`를 파티에 추가하고 스킬 `slave_master`를 부여합니다.
+- **새 게임**이 시작될 때마다 같은 일을 다시 합니다. 새 게임은 먼저 파티를 비우기 때문입니다.
+- 저장 파일을 불러오면 파티와 스킬이 저장된 것으로 교체됩니다. 두 단계는 여러 번 실행되어도 안전합니다: 마라오가 두 번 추가되거나 스킬이 두 번 부여되지 않습니다.
+
+## 시작을 바꾸려면
+
+- 다른 모드도 같은 방식으로 시작 캐릭터를 더 추가할 수 있습니다: 모드가 준비되면 자기 캐릭터를 파티에 넣는 C# 초기화기입니다.
+- 마라오나 스킬 없이 시작하려면 이 모드를 게임의 컬렉션에서 빼고, 자기 모드에서 파티를 꾸리세요.
+
+## 알려진 문제
+
+- 노예 상인 카드에 그림이 없습니다: 스킬 이미지가 빠져 있습니다.
+- 카드와 설명은 “영입 확률 +10%”를 약속하지만, 이 보너스를 읽는 코드는 없습니다. 포획 판정은 오직 적 자신의 확률만 사용합니다.

docs/ru.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — с кого начинается игра
+
+Этот маленький мод задаёт стартовое состояние новой игры Cthangover: Марао в отряде и навык «Работорговец» в коллекции навыков. Внутри только этот код; сам персонаж и сам навык — данные базовой игры и движка навыков.
+
+## Что есть у нового игрока
+
+Панель персонажей в самом начале Cthangover — один член отряда, Марао, с двумя действиями и свободным слотом:
+
+![Панель действий персонажа: Отряд 1, Марао (шаблон 2, HP 16/16, OD 1, ATK 5, DEF 0) с действиями «Обычная атака» и «Защита» и пустым третьим слотом.](assets/party.jpg)
+
+Панель навыков — один навык, «Работорговец»:
+
+![Панель навыков: в коллекции один эпический пассивный навык «Работорговец», «+10% к шансу вербовки», с описанием «Даёт возможность взять в рабство поверженного врага с базовым шансом в 10%. Содержание раба ложится на твои плечи.» и эффектом коллекции +10% к шансу вербовки.](assets/skills.jpg)
+
+«Работорговец» — то, что позволяет игроку захватывать побеждённых врагов (см. мод Recruiting): без него в отряд никто не попадёт.
+
+## Когда мод срабатывает
+
+- Когда моды игры готовы, мод добавляет персонажа `Marao` в отряд и выдаёт навык `slave_master`.
+- Каждый запуск **новой игры** повторяет это заново: новая игра сперва очищает отряд.
+- Загрузка сохранения заменяет отряд и навыки на сохранённые. Оба шага безопасно выполняются и повторно: Марао не добавится дважды, навык не выдастся дважды.
+
+## Как изменить старт
+
+- Другой мод может добавить стартовых персонажей тем же способом: инициализатор на C#, который при готовности модов добавляет своих персонажей в отряд.
+- Чтобы начать без Марао или без навыка, исключите этот мод из коллекции игры и заселите отряд в собственном моде.
+
+## Известные проблемы
+
+- У карты «Работорговца» нет картинки: изображение навыка отсутствует.
+- Карта и её описание обещают «+10% к шансу вербовки», но ни один код этот бонус не читает: бросок захвата использует только собственный шанс врага.

docs/vi.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — nhân vật khởi đầu của người chơi
+
+Mod nhỏ này tạo trạng thái khởi đầu cho một ván mới của Cthangover: Marao trong tổ đội và kỹ năng Kẻ buôn nô lệ trong bộ sưu tập kỹ năng. Bên trong chỉ có mã này; bản thân nhân vật và kỹ năng là dữ liệu của trò chơi gốc và của engine kỹ năng.
+
+## Người chơi mới có gì
+
+Bảng nhân vật ngay lúc đầu của Cthangover — một thành viên tổ đội, Marao, với hai hành động và một ô trống:
+
+![Bảng hành động nhân vật: Đội 1, Marao (mẫu 2, HP 16/16, AP 1, ATK 5, DEF 0) với Tấn công thường và Phòng thủ, ô thứ ba trống.](assets/party.jpg)
+
+Bảng kỹ năng — một kỹ năng, Kẻ buôn nô lệ:
+
+![Bảng kỹ năng: bộ sưu tập có một kỹ năng bị động huyền thoại, Kẻ buôn nô lệ, “+10% tỉ lệ chiêu mộ”, mô tả “Cho phép biến kẻ thù bị đánh bại thành nô lệ với tỉ lệ cơ bản 10%. Việc nuôi nô lệ do bạn lo.”, hiệu ứng bộ sưu tập +10% tỉ lệ chiêu mộ.](assets/skills.jpg)
+
+Kẻ buôn nô lệ chính là thứ cho phép người chơi bắt giữ kẻ địch bị đánh bại (xem Recruiting): thiếu nó thì không kẻ địch nào gia nhập được.
+
+## Khi nào chạy
+
+- Khi các mod của trò chơi đã sẵn sàng, mod thêm nhân vật `Marao` vào tổ đội và trao kỹ năng `slave_master`.
+- Mỗi lần bắt đầu **trò chơi mới**, nó làm lại việc đó, vì trò chơi mới trước tiên dọn sạch tổ đội.
+- Tải bản lưu sẽ thay tổ đội và kỹ năng bằng những gì đã lưu. Cả hai bước chạy nhiều lần cũng an toàn: Marao không bị thêm hai lần và kỹ năng không bị trao hai lần.
+
+## Muốn đổi phần khởi đầu
+
+- Mod khác có thể thêm nhân vật khởi đầu theo cùng cách: một bộ khởi tạo bằng C# thêm nhân vật của mình vào tổ đội khi các mod sẵn sàng.
+- Để bắt đầu không có Marao hay kỹ năng, bỏ mod này khỏi bộ sưu tập của trò chơi và tự dựng tổ đội trong mod của bạn.
+
+## Vấn đề đã biết
+
+- Thẻ Kẻ buôn nô lệ không có hình: ảnh của kỹ năng bị thiếu.
+- Thẻ và mô tả hứa “+10% tỉ lệ chiêu mộ”, nhưng không có mã nào đọc thêm chỉ số này; lượt gieo bắt giữ chỉ dùng tỉ lệ của chính kẻ địch.

docs/zh.md

@@ -0,0 +1,31 @@
+# Cthangover: Starter Party — 玩家的初始伙伴
+
+这个小模组为 Cthangover 的新游戏提供初始状态：队伍中的马劳，以及技能收藏里的“奴隶贩子”。它只包含这段代码；角色和技能本身则是基础游戏和技能引擎的数据。
+
+## 新玩家一开始有什么
+
+Cthangover 开局时的角色面板——队伍里只有马劳一人，带两个动作和一个空位：
+
+![角色动作面板：队伍 1，马劳（模板 2，HP 16/16，AP 1，ATK 5，DEF 0），动作为“普通攻击”和“防御”，第三个栏位为空。](assets/party.jpg)
+
+技能面板——只有一个技能“奴隶贩子”：
+
+![技能面板：收藏中有一个史诗级被动技能“奴隶贩子”，“+10% 招募几率”，描述为“能以 10% 的基础概率奴役被击败的敌人。奴隶的生计由你负担。”，收藏效果为 +10% 招募几率。](assets/skills.jpg)
+
+“奴隶贩子”正是玩家捕获被击败敌人的手段（见 Recruiting 模组）：没有它，任何敌人都无法加入。
+
+## 什么时候生效
+
+- 游戏的模组就绪后，模组把角色 `Marao` 加入队伍，并授予技能 `slave_master`。
+- 每次开始**新游戏**都会再执行一遍，因为新游戏会先清空队伍。
+- 读取存档会用存档内容替换队伍和技能。这两个步骤重复执行也安全：马劳不会被加两次，技能也不会被授予两次。
+
+## 想改初始配置
+
+- 其他模组可以用同样的方式添加更多初始角色：一个 C# 初始化器，在模组就绪时把自己的角色加进队伍。
+- 想在没有马劳或没有该技能的情况下开局，就不要把这个模组放进游戏合集，改在自己的模组里组建队伍。
+
+## 已知问题
+
+- “奴隶贩子”卡片没有图片：技能图像缺失。
+- 卡片及其描述承诺“+10% 招募几率”，但没有任何代码读取这个加成；捕获判定只使用敌人自身的几率。

locale/en.properties

@@ -1,2 +1,2 @@
 mod_cthangover_party_name = Cthangover: Starter Party
-mod_cthangover_party_desc = Seeds the default starter party (Marao) and the slave_master skill after mod resources are ready, and restores it on NewGameStartedEvent. Split out of cthangover_game so the base content mod stays pure content.
+mod_cthangover_party_desc = Gives a new game of Cthangover its starting state: Marao in the party and the Slave Trader skill. Only code — the data lives in the base game and the skills engine.

locale/es.properties

@@ -0,0 +1,2 @@
+mod_cthangover_party_name = Cthangover: grupo inicial
+mod_cthangover_party_desc = Da a una partida nueva de Cthangover su estado inicial: Marao en el grupo y la habilidad Tratante de esclavos. Solo código: los datos viven en el juego base y el motor de habilidades.

locale/ja.properties

@@ -0,0 +1,2 @@
+mod_cthangover_party_name = Cthangover：初期パーティ
+mod_cthangover_party_desc = Cthangover のニューゲームに初期状態を与えます:パーティに入ったマラオとスキル「奴隷商人」。コードのみで、データはベースゲームとスキルエンジン側にあります。

locale/ko.properties

@@ -0,0 +1,2 @@
+mod_cthangover_party_name = Cthangover: 시작 파티
+mod_cthangover_party_desc = Cthangover의 새 게임에 시작 상태를 부여합니다: 파티에 들어간 마라오와 스킬 ‘노예 상인’. 코드만 있고 데이터는 기본 게임과 스킬 엔진에 있습니다.

locale/ru.properties

@@ -1,2 +1,2 @@
 mod_cthangover_party_name = Cthangover: стартовая партия
-mod_cthangover_party_desc = Выдаёт стартовую партию (Марао) и умение slave_master после готовности ресурсов модов и восстанавливает её на событии новой игры. Вынесено из cthangover_game, чтобы базовый контент-мод оставался чистым контентом.
+mod_cthangover_party_desc = Задаёт стартовое состояние новой игры Cthangover: Марао в отряде и навык Работорговец. Только код — данные живут в базовой игре и движке навыков.

locale/vi.properties

@@ -0,0 +1,2 @@
+mod_cthangover_party_name = Cthangover: Tổ đội khởi đầu
+mod_cthangover_party_desc = Tạo trạng thái khởi đầu cho ván mới của Cthangover: Marao trong tổ đội và kỹ năng Kẻ buôn nô lệ. Chỉ có mã — dữ liệu nằm trong trò chơi gốc và engine kỹ năng.

locale/zh.properties

@@ -0,0 +1,2 @@
+mod_cthangover_party_name = Cthangover：初始队伍
+mod_cthangover_party_desc = 为 Cthangover 的新游戏提供初始状态：队伍中的马劳和“奴隶贩子”技能。只有代码——数据都在基础游戏和技能引擎里。

manifest.json

@@ -3,7 +3,7 @@
   "name": "Cthangover: Starter Party",
   "version": "1.0.0",
   "author": "ct",
-  "description": "Seeds the default starter party (Marao) and the slave_master skill after mod resources are ready, and restores it on NewGameStartedEvent. Split out of cthangover_game so the base content mod stays pure content (scenes/dialogs/quests/data) with no C# gameplay logic.",
+  "description": "Gives a new game of Cthangover its starting state: Marao in the party and the Slave Trader skill. Only code — the data lives in the base game and the skills engine.",
   "category": "engine, library",
   "sources": [
     "src/**/*.cs"