diff --git a/docs/assets/party.jpg b/docs/assets/party.jpg new file mode 100644 index 0000000..0b51f11 Binary files /dev/null and b/docs/assets/party.jpg differ diff --git a/docs/assets/skills.jpg b/docs/assets/skills.jpg new file mode 100644 index 0000000..327acd3 Binary files /dev/null and b/docs/assets/skills.jpg differ diff --git a/docs/en.md b/docs/en.md new file mode 100644 index 0000000..e561451 --- /dev/null +++ b/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. diff --git a/docs/es.md b/docs/es.md new file mode 100644 index 0000000..ccec50d --- /dev/null +++ b/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. diff --git a/docs/ja.md b/docs/ja.md new file mode 100644 index 0000000..9c94346 --- /dev/null +++ b/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%」をうたっていますが、このボーナスを読むコードは存在せず、捕獲判定は敵自身の確率だけを使います。 diff --git a/docs/ko.md b/docs/ko.md new file mode 100644 index 0000000..c2e7bb0 --- /dev/null +++ b/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%”를 약속하지만, 이 보너스를 읽는 코드는 없습니다. 포획 판정은 오직 적 자신의 확률만 사용합니다. diff --git a/docs/ru.md b/docs/ru.md new file mode 100644 index 0000000..b98f4ea --- /dev/null +++ b/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% к шансу вербовки», но ни один код этот бонус не читает: бросок захвата использует только собственный шанс врага. diff --git a/docs/vi.md b/docs/vi.md new file mode 100644 index 0000000..42105d2 --- /dev/null +++ b/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. diff --git a/docs/zh.md b/docs/zh.md new file mode 100644 index 0000000..3cdc85c --- /dev/null +++ b/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% 招募几率”,但没有任何代码读取这个加成;捕获判定只使用敌人自身的几率。 diff --git a/locale/en.properties b/locale/en.properties index 20c1428..ee1546f 100644 --- a/locale/en.properties +++ b/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. diff --git a/locale/es.properties b/locale/es.properties index 73de2ac..5decf00 100644 --- a/locale/es.properties +++ b/locale/es.properties @@ -1,2 +1,2 @@ mod_cthangover_party_name = Cthangover: grupo inicial -mod_cthangover_party_desc = Crea el grupo inicial por defecto (Marao) y la habilidad slave_master cuando los recursos de los mods están listos, y lo restaura con NewGameStartedEvent. Separado de cthangover_game para que el mod de contenido base siga siendo solo contenido. +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. diff --git a/locale/ja.properties b/locale/ja.properties index 79afc81..338c228 100644 --- a/locale/ja.properties +++ b/locale/ja.properties @@ -1,2 +1,2 @@ mod_cthangover_party_name = Cthangover:初期パーティ -mod_cthangover_party_desc = MOD のリソースが揃った後に既定の初期パーティ(Marao)と slave_master スキルを用意し、NewGameStartedEvent で元に戻します。基本コンテンツ MOD を純粋なコンテンツに保つため cthangover_game から分離されています。 +mod_cthangover_party_desc = Cthangover のニューゲームに初期状態を与えます:パーティに入ったマラオとスキル「奴隷商人」。コードのみで、データはベースゲームとスキルエンジン側にあります。 diff --git a/locale/ko.properties b/locale/ko.properties index 7edec8d..7ed9065 100644 --- a/locale/ko.properties +++ b/locale/ko.properties @@ -1,2 +1,2 @@ mod_cthangover_party_name = Cthangover: 시작 파티 -mod_cthangover_party_desc = 모드 리소스가 준비되면 기본 시작 파티(Marao)와 slave_master 스킬을 만들고 NewGameStartedEvent 때 복원합니다. 기본 콘텐츠 모드가 순수한 콘텐츠로 남도록 cthangover_game에서 분리되었습니다. +mod_cthangover_party_desc = Cthangover의 새 게임에 시작 상태를 부여합니다: 파티에 들어간 마라오와 스킬 ‘노예 상인’. 코드만 있고 데이터는 기본 게임과 스킬 엔진에 있습니다. diff --git a/locale/ru.properties b/locale/ru.properties index 97d8b84..a8b7e1c 100644 --- a/locale/ru.properties +++ b/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: Марао в отряде и навык Работорговец. Только код — данные живут в базовой игре и движке навыков. diff --git a/locale/vi.properties b/locale/vi.properties index f197bfc..e7103b0 100644 --- a/locale/vi.properties +++ b/locale/vi.properties @@ -1,2 +1,2 @@ mod_cthangover_party_name = Cthangover: Tổ đội khởi đầu -mod_cthangover_party_desc = Tạo tổ đội khởi đầu mặc định (Marao) và kỹ năng slave_master khi tài nguyên mod đã sẵn sàng, và khôi phục nó khi có NewGameStartedEvent. Được tách khỏi cthangover_game để mod nội dung cơ bản chỉ chứa nội dung. +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. diff --git a/locale/zh.properties b/locale/zh.properties index 6ae5611..0348f91 100644 --- a/locale/zh.properties +++ b/locale/zh.properties @@ -1,2 +1,2 @@ mod_cthangover_party_name = Cthangover:初始队伍 -mod_cthangover_party_desc = 在模组资源就绪后建立默认初始队伍(Marao)和 slave_master 技能,并在 NewGameStartedEvent 时恢复。从 cthangover_game 中拆分出来,使基础内容模组保持纯内容。 +mod_cthangover_party_desc = 为 Cthangover 的新游戏提供初始状态:队伍中的马劳和“奴隶贩子”技能。只有代码——数据都在基础游戏和技能引擎里。 diff --git a/manifest.json b/manifest.json index c246aea..24323ee 100644 --- a/manifest.json +++ b/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"