Add mod documentation in seven languages

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.gitignore

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

docs/en.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — the main game
+
+Cthangover is a darkly comic visual novel about Marao, a man who wakes up in an alley after a very bad night with no memory, a red rag and an old book he does not remember buying. This mod is the game's own content: its scenes, scenarios, characters, items, quests, world map, music choices and story text. Everything else — dialogues, inventory, battles, the map screen — comes from engine and mechanic mods that the game combines.
+
+Play it from **Play → Cthangover → New game**.
+
+![The first scene of a new game: Marao, in a red rag, stands in a dark alley; the narration describes his hangover. The prologue's text is currently Russian only.](assets/opening.jpg)
+
+## What you play
+
+- **The prologue.** The story begins in the alley and continues through a graveyard and along the river to an old villa. The prologue is played as a novel: lines of text, Marao's portrait and choices.
+- **The villa and the town.** After the prologue you move between places by choices: the outside of the villa, its rooms (vestibule, living room, kitchen, bedroom, workroom, basement), the town entrance and the outskirts.
+- **Survival details.** A new game starts with wolf meat and brushwood in the bag; the kitchen tracks rations and their daily consumption and lets you cook.
+- **Quests.** The journal follows the story's tasks, starting with *Awakening* and *The Old House*.
+- **The world map.** The map panel shows the district with the places you can travel to.
+- **Battles.** Fights use the card battle by default; the game can be switched to the command-style battle in its settings.
+
+![Outside the villa at midday: a mill house by a waterfall with the choices "Enter the house", "To the town" and "To the forest".](assets/villa-outside.jpg)
+
+![The kitchen: the ration counter in the top left and the choices "Leave" and "Cook".](assets/kitchen.jpg)
+
+![The world map of the northern district with the Villa and Town entrance markers.](assets/world-map.jpg)
+
+![A card battle in the town: Marao and a companion against two wolves.](assets/battle.jpg)
+
+## Language
+
+The prologue's scenarios are written in Russian and do not have translations yet, so its text appears in Russian in every interface language. The villa and town scenes, the quest journal, items and menus are translated.
+
+## How the game is assembled
+
+The game is the collection **Cthangover**. Its blocks show which mods do what:
+
+```text
+Story          cthangover_game, cthangover_murakami, cthangover_party, town_pack
+2D engine      the shell, dialogues, interactives, time and light, effects, world map
+Characters     characters and skills
+Quests         the journal
+Items          inventory, cooking
+Battle         turn-based platform + card battle (default core)
+Battle (FF)    command-style battle core (optional)
+Recruiting     recruiting defeated characters (optional)
+Live2D         animated avatars (optional)
+Interface      UI toolkit, menu, audio
+Developer tools (optional)  editors, validator, atlases, mod manager
+```
+
+- **Cthangover: Murakami** adds a separate story line and **Cthangover: Starter Party** puts Marao into the party at the start. They are part of the same game but separate mods.
+- **Town Pack** supplies the town entrance and vestibule pictures; **Music Pack** the soundtrack. This mod adds a scene-specific playlist for the town entrance.
+- The collection sets `battle.core` to `card_battle`. You can change it, or the mods of any block, in **Mods & Collections → Collections → Cthangover → Edit scheme**; your saves stay.
+
+## For authors
+
+The content lives in ordinary folders:
+
+```filestree
+cthangover_game/
+├── scenes/          one JSON per place: name, background, ambience, default scenario
+├── scenarios/       prolog/, home/, town/ and start.scenario
+├── characters/      player, enemies, skills
+├── items/           food, recipes, resources
+├── quests/          quests.json
+├── interactives/    clickable objects of the prologue scenes
+├── map/map.json     world map zones and markers
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          names, quests and scenario translations in seven languages
+```
+
+A new game starts in `start_scene`, whose scenario gives the starter items and switches to the alley:
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+To change a scene's text without editing this mod, add a scenario for the same scene in your own mod, or replace a file by shipping the same name with a dependency on `cthangover_game`.
+
+## If something goes wrong
+
+1. **The game card says it is not ready.** Use **Install missing** in **Play**, or check the scheme.
+2. **No battle starts.** The selected battle core must be included in the game.
+3. **Story text in Russian.** That is the prologue (see Language).

docs/es.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — el juego principal
+
+Cthangover es una novela visual de humor negro sobre Marao, que despierta en un callejón tras una noche pésima: sin memoria, con un trapo rojo y un libro viejo que no recuerda haber comprado. Este mod es el contenido propio del juego: sus escenas, escenarios, personajes, objetos, misiones, el mapa del mundo, la música y el texto de la historia. Todo lo demás — diálogos, inventario, combates, la pantalla del mapa — lo aportan los mods de motor y de mecánicas que el juego combina.
+
+Se juega desde **Jugar → Cthangover → Nueva partida**.
+
+![La primera escena de una partida nueva: Marao, con un trapo rojo, de pie en un callejón oscuro; la narración describe su resaca. El texto del prólogo todavía está solo en ruso.](assets/opening.jpg)
+
+## En qué consiste el juego
+
+- **El prólogo.** La historia empieza en el callejón y continúa por un cementerio y la orilla del río hasta una villa antigua. El prólogo se juega como una novela: líneas de texto, el retrato de Marao y decisiones.
+- **La villa y el pueblo.** Tras el prólogo te mueves entre lugares con decisiones: el exterior de la villa, sus habitaciones (vestíbulo, salón, cocina, dormitorio, taller y sótano), la entrada del pueblo y las afueras.
+- **Detalles de supervivencia.** Una partida nueva empieza con carne de lobo y leña en la bolsa; la cocina lleva la cuenta de las raciones y su consumo diario y permite cocinar.
+- **Misiones.** El diario sigue las tareas de la historia, empezando por *El despertar* y *La casa vieja*.
+- **El mapa del mundo.** El panel del mapa muestra el distrito con los lugares a los que puedes viajar.
+- **Combates.** Por defecto se lucha con el combate de cartas; en los ajustes del juego puedes cambiar al combate por órdenes.
+
+![El exterior de la villa al mediodía: una casa de molino junto a una cascada y las opciones "Entrar en la casa", "Al pueblo" y "Al bosque".](assets/villa-outside.jpg)
+
+![La cocina: el contador de raciones arriba a la izquierda y las opciones "Salir" y "Cocinar".](assets/kitchen.jpg)
+
+![El mapa del mundo del distrito norte con los marcadores de la villa y la entrada del pueblo.](assets/world-map.jpg)
+
+![Un combate de cartas en el pueblo: Marao y un compañero contra dos lobos.](assets/battle.jpg)
+
+## Idioma
+
+Los escenarios del prólogo están escritos en ruso y aún no tienen traducción, así que su texto aparece en ruso en cualquier idioma de la interfaz. Las escenas de la villa y el pueblo, el diario de misiones, los objetos y los menús sí están traducidos.
+
+## Cómo se monta el juego
+
+El juego es la colección **Cthangover**. Sus bloques muestran qué hace cada mod:
+
+```text
+Historia       cthangover_game, cthangover_murakami, cthangover_party, town_pack
+Motor 2D       la carcasa, diálogos, interactivos, tiempo y luz, efectos, mapa del mundo
+Personajes     personajes y habilidades
+Misiones       el diario
+Objetos        inventario, cocina
+Combate        plataforma de turnos + combate de cartas (núcleo por defecto)
+Combate (FF)   núcleo de combate por órdenes (opcional)
+Reclutamiento  reclutar personajes derrotados (opcional)
+Live2D         avatares animados (opcional)
+Interfaz       kit de UI, menú, audio
+Herramientas de desarrollo (opcional)  editores, validador, atlas, gestor de mods
+```
+
+- **Cthangover: Murakami** añade una línea argumental aparte, y **Cthangover: Starter Party** mete a Marao en el grupo desde el principio. Forman parte del mismo juego, pero son mods separados.
+- **Town Pack** aporta las imágenes de la entrada del pueblo y del vestíbulo, y **Music Pack** la banda sonora. Este mod añade una lista de reproducción propia para la escena de la entrada del pueblo.
+- La colección fija `battle.core` en `card_battle`. Puedes cambiarlo, y también los mods de cualquier bloque, en **Mods & Collections → Colecciones → Cthangover → Editar esquema**; tus partidas guardadas se conservan.
+
+## Para autores
+
+El contenido vive en carpetas normales:
+
+```filestree
+cthangover_game/
+├── scenes/          un JSON por lugar: nombre, fondo, ambiente, escenario por defecto
+├── scenarios/       prolog/, home/, town/ y start.scenario
+├── characters/      jugador, enemigos, habilidades
+├── items/           comida, recetas, recursos
+├── quests/          quests.json
+├── interactives/    objetos interactivos de las escenas del prólogo
+├── map/map.json     zonas y marcadores del mapa del mundo
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          nombres, misiones y traducciones de escenarios en siete idiomas
+```
+
+Una partida nueva empieza en `start_scene`, cuyo escenario entrega los objetos iniciales y salta al callejón:
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+Para cambiar el texto de una escena sin editar este mod, añade un escenario para la misma escena en tu propio mod, o sustituye un archivo enviando otro con el mismo nombre y una dependencia de `cthangover_game`.
+
+## Si algo falla
+
+1. **La tarjeta del juego dice que no está lista.** Usa **Instalar lo que falta** en **Jugar**, o revisa el esquema.
+2. **No empieza ningún combate.** El núcleo de combate elegido debe estar incluido en el juego.
+3. **El texto de la historia está en ruso.** Es el prólogo (ver Idioma).

docs/ja.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — メインゲーム
+
+Cthangover は、ひどい一夜を過ごしたマラオが路地で目を覚ますところから始まるブラックユーモアのビジュアルノベルです。記憶はなく、身には赤いぼろ布、手元には買った覚えのない古い本。この MOD はゲーム本体のコンテンツで、シーン、シナリオ、キャラクター、アイテム、クエスト、ワールドマップ、音楽の選択、そして物語のテキストを担います。それ以外の会話、インベントリ、戦闘、マップ画面は、ゲームが組み合わせるエンジン系・システム系 MOD の仕事です。
+
+**プレイ → Cthangover → ニューゲーム** から始めます。
+
+![ニューゲームの最初のシーン:赤いぼろ布のマラオが暗い路地に立ち、ナレーションが二日酔いを語ります。プロローグのテキストは現在ロシア語のみです。](assets/opening.jpg)
+
+## ゲームの内容
+
+- **プロローグ。** 物語は路地から始まり、墓地を経て川沿いを古い屋敷まで進みます。プロローグはノベル形式で、テキストの行、マラオのポートレート、選択肢で進みます。
+- **屋敷と街。** プロローグの後は選択肢で場所を移動します。屋敷の外観、屋敷の部屋(玄関、居間、台所、寝室、作業部屋、地下室)、街の入り口、外れ。
+- **サバイバルの要素。** ニューゲームは狼の肉と薪を背負った状態で始まります。台所では食料の在庫と一日の消費が管理され、料理もできます。
+- **クエスト。** ジャーナルが物語のタスクを追跡します。最初は「目覚め」と「古い家」です。
+- **ワールドマップ。** マップパネルには、移動先の場所とともに地区が表示されます。
+- **戦闘。** 戦闘は既定でカードバトルを使います。ゲームの設定でコマンド式バトルへ切り替えられます。
+
+![昼の屋敷の外観:滝のそばの製粉小屋と「家に入る」「街へ」「森へ」の選択肢。](assets/villa-outside.jpg)
+
+![台所:左上の食料カウンターと「出る」「料理する」の選択肢。](assets/kitchen.jpg)
+
+![北地区のワールドマップ。屋敷と街の入り口のマーカーがあります。](assets/world-map.jpg)
+
+![街でのカードバトル:マラオと仲間が二頭の狼と対峙します。](assets/battle.jpg)
+
+## 言語
+
+プロローグのシナリオはロシア語で書かれており、まだ翻訳がないため、インターフェースの言語が何であってもロシア語で表示されます。屋敷と街のシーン、クエストのジャーナル、アイテム、メニューは翻訳済みです。
+
+## ゲームの構成
+
+ゲームの正体はコレクション **Cthangover** です。各ブロックがどの MOD の担当かを示します:
+
+```text
+物語          cthangover_game, cthangover_murakami, cthangover_party, town_pack
+2D エンジン   シェル、会話、インタラクティブ、時間と光、エフェクト、ワールドマップ
+キャラクター  キャラクターとスキル
+クエスト      ジャーナル
+アイテム      インベントリ、料理
+戦闘          ターン制プラットフォーム + カードバトル(既定のコア)
+戦闘 (FF)     コマンド式バトルコア(任意)
+仲間にする    倒したキャラクターを仲間にする(任意)
+Live2D        アニメーションするアバター(任意)
+インターフェース  UI ツールキット、メニュー、オーディオ
+開発ツール (任意)  エディター、バリデーター、アトラス、MOD マネージャー
+```
+
+- **Cthangover: Murakami** は独立したストーリーラインを追加し、**Cthangover: Starter Party** は最初からマラオをパーティに入れます。どちらも同じゲームの一部ですが、別々の MOD です。
+- **Town Pack** が街の入り口と玄関の画像を、**Music Pack** がサウンドトラックを提供します。この MOD は街の入り口シーン専用のプレイリストを追加しています。
+- コレクションは `battle.core` を `card_battle` に設定します。**Mods & Collections → コレクション → Cthangover → 構成を編集** から、この設定も各ブロックの MOD も変更できます。セーブはそのまま残ります。
+
+## 作者向け
+
+コンテンツは普通のフォルダーに入っています:
+
+```filestree
+cthangover_game/
+├── scenes/          場所ごとに 1 つの JSON:名前、背景、環境音、既定のシナリオ
+├── scenarios/       prolog/、home/、town/、start.scenario
+├── characters/      プレイヤー、敵、スキル
+├── items/           食料、レシピ、素材
+├── quests/          quests.json
+├── interactives/    プロローグのシーンのクリック可能オブジェクト
+├── map/map.json     ワールドマップのゾーンとマーカー
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          7 言語分の名前・クエスト・シナリオ翻訳
+```
+
+ニューゲームは `start_scene` から始まり、そのシナリオが初期アイテムを与えて路地へ切り替えます:
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+この MOD を編集せずにシーンのテキストを変えるには、自分の MOD に同じシーン向けのシナリオを追加するか、`cthangover_game` への依存を宣言した上で同じファイル名のファイルを上書きします。
+
+## うまくいかないとき
+
+1. **ゲームカードに準備未完了と表示される。** **プレイ** の **足りないものをインストール** を使うか、構成を確認してください。
+2. **戦闘が始まらない。** 選択したバトルコアがゲームに含まれている必要があります。
+3. **物語のテキストがロシア語。** それはプロローグです(「言語」を参照)。

docs/ko.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — 메인 게임
+
+Cthangover는 형편없던 하룻밤을 보낸 마라오가 골목에서 깨어나는 이야기를 그린 블랙 코미디 비주얼 노벨입니다. 기억은 없고, 몸에는 붉은 넝마, 손에는 산 기억도 없는 낡은 책 한 권. 이 모드는 게임 자체의 콘텐츠로, 장면, 시나리오, 캐릭터, 아이템, 퀘스트, 월드 맵, 음악 선택, 그리고 이야기 텍스트를 담당합니다. 대화, 인벤토리, 전투, 맵 화면 같은 나머지 모든 것은 게임이 조합하는 엔진 모드와 메커니즘 모드가 맡습니다.
+
+**플레이 → Cthangover → 새 게임**에서 시작합니다.
+
+![새 게임의 첫 장면: 붉은 넝마를 두른 마라오가 어두운 골목에 서 있고, 나레이션이 그의 숙취를 묘사합니다. 프롤로그 텍스트는 현재 러시아어로만 제공됩니다.](assets/opening.jpg)
+
+## 게임 플레이
+
+- **프롤로그.** 이야기는 골목에서 시작해 묘지를 지나 강가를 따라 낡은 저택까지 이어집니다. 프롤로그는 소설처럼 진행됩니다: 텍스트 줄, 마라오의 초상화, 선택지.
+- **저택과 마을.** 프롤로그가 끝나면 선택지로 장소를 이동합니다. 저택 바깥, 저택의 방들(현관, 거실, 부엌, 침실, 작업실, 지하), 마을 입구, 외곽.
+- **생존 요소.** 새 게임은 가방에 늑대고기와 장작을 넣은 채 시작합니다. 부엌에서는 식량과 하루 소비량을 관리하고 요리도 할 수 있습니다.
+- **퀘스트.** 저널이 이야기의 과제를 추적합니다. 첫 과제는 ‘각성’과 ‘낡은 집’입니다.
+- **월드 맵.** 맵 패널에는 이동할 수 있는 장소와 함께 지역이 표시됩니다.
+- **전투.** 전투는 기본적으로 카드 배틀을 사용하며, 게임 설정에서 커맨드식 전투로 바꿀 수 있습니다.
+
+![한낮의 저택 바깥: 폭포 옆의 제분소 오두막과 "집에 들어간다", "마을로", "숲으로" 선택지.](assets/villa-outside.jpg)
+
+![부엌: 왼쪽 위의 식량 카운터와 "나가기", "요리하기" 선택지.](assets/kitchen.jpg)
+
+![북쪽 지역의 월드 맵. 저택과 마을 입구 마커가 표시됩니다.](assets/world-map.jpg)
+
+![마을에서 벌어지는 카드 배틀: 마라오와 동료가 두 마리의 늑대와 맞섭니다.](assets/battle.jpg)
+
+## 언어
+
+프롤로그 시나리오는 러시아어로 작성되어 아직 번역이 없기 때문에, 인터페이스 언어와 관계없이 러시아어로 표시됩니다. 저택과 마을 장면, 퀘스트 저널, 아이템, 메뉴는 번역되어 있습니다.
+
+## 게임의 구성
+
+게임의 정체는 컬렉션 **Cthangover**입니다. 각 블록이 어떤 모드의 역할인지 보여 줍니다:
+
+```text
+이야기        cthangover_game, cthangover_murakami, cthangover_party, town_pack
+2D 엔진       셸, 대화, 인터랙티브, 시간과 조명, 이펙트, 월드 맵
+캐릭터        캐릭터와 스킬
+퀘스트        저널
+아이템        인벤토리, 요리
+전투          턴제 플랫폼 + 카드 배틀(기본 코어)
+전투 (FF)     커맨드식 전투 코어(선택)
+영입          쓰러뜨린 캐릭터 영입(선택)
+Live2D        애니메이션 아바타(선택)
+인터페이스    UI 툴킷, 메뉴, 오디오
+개발 도구 (선택)  에디터, 검증기, 아틀라스, 모드 관리자
+```
+
+- **Cthangover: Murakami**는 별도의 스토리 라인을 추가하고, **Cthangover: Starter Party**는 시작부터 마라오를 파티에 넣습니다. 둘 다 같은 게임의 일부지만 별개의 모드입니다.
+- **Town Pack**은 마을 입구와 현관 그림을, **Music Pack**은 사운드트랙을 제공합니다. 이 모드는 마을 입구 장면 전용 재생 목록을 추가합니다.
+- 컬렉션은 `battle.core`를 `card_battle`로 설정합니다. **Mods & Collections → 컬렉션 → Cthangover → 구성 편집**에서 이 값을 바꾸거나 블록의 모드를 조정할 수 있으며, 저장 파일은 그대로 유지됩니다.
+
+## 모드 작성자를 위해
+
+콘텐츠는 평범한 폴더에 들어 있습니다:
+
+```filestree
+cthangover_game/
+├── scenes/          장소마다 JSON 하나: 이름, 배경, 환경음, 기본 시나리오
+├── scenarios/       prolog/, home/, town/ 및 start.scenario
+├── characters/      플레이어, 적, 스킬
+├── items/           음식, 레시피, 자원
+├── quests/          quests.json
+├── interactives/    프롤로그 장면의 클릭 가능 오브젝트
+├── map/map.json     월드 맵 구역과 마커
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          7개 언어의 이름·퀘스트·시나리오 번역
+```
+
+새 게임은 `start_scene`에서 시작하며, 이 시나리오가 초기 아이템을 지급하고 골목으로 전환합니다:
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+이 모드를 수정하지 않고 장면 텍스트를 바꾸려면 자신의 모드에 같은 장면용 시나리오를 추가하거나, `cthangover_game`에 의존성을 선언하고 같은 이름의 파일로 대체하세요.
+
+## 문제가 생겼을 때
+
+1. **게임 카드에 준비되지 않았다고 표시됩니다.** **플레이**에서 **빠진 것 설치**를 사용하거나 구성을 확인하세요.
+2. **전투가 시작되지 않습니다.** 선택한 전투 코어가 게임에 포함되어 있어야 합니다.
+3. **이야기 텍스트가 러시아어입니다.** 프롤로그이기 때문입니다(‘언어’ 참조).

docs/ru.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — основная игра
+
+Cthangover — мрачная комедийная визуальная новелла о Марао, который после очень неудачной ночи приходит в себя в переулке: без памяти, в красной тряпке и со старой книгой, которую он, по его ощущениям, не покупал. Этот мод — собственный контент игры: сцены, сценарии, персонажи, предметы, задания, карта мира, музыка и текст истории. Всё остальное — диалоги, инвентарь, бои, экран карты — дают моды-движки и моды-механики, которые игра объединяет.
+
+Игра запускается через **Играть → Cthangover → Новая игра**.
+
+![Первый кадр новой игры: Марао в красной тряпке стоит в тёмном переулке, повествование описывает его похмелье. Текст пролога пока есть только на русском.](assets/opening.jpg)
+
+## Во что вы играете
+
+- **Пролог.** История начинается в переулке, идёт через кладбище и вдоль реки до старой виллы. Пролог оформлен как новелла: строки текста, портрет Марао и варианты выбора.
+- **Вилла и город.** После пролога вы перемещаетесь между местами выбором вариантов: улица у виллы, её комнаты (прихожая, гостиная, кухня, спальня, рабочая комната, подвал), въезд в город и окраины.
+- **Детали выживания.** Новая игра начинается с волчьего мяса и хвороста в сумке; кухня ведёт учёт запасов еды и дневного расхода и позволяет готовить.
+- **Задания.** Журнал сопровождает задания сюжета, начиная с *Пробуждения* и *Старого дома*.
+- **Карта мира.** Панель карты показывает район и места, куда можно добраться.
+- **Бои.** По умолчанию стычки идут по правилам карточного боя; в настройках игры можно переключиться на бои в командном стиле.
+
+![У виллы в полдень: мельница у водопада и варианты «Войти в дом», «В город» и «В лес».](assets/villa-outside.jpg)
+
+![Кухня: счётчик провизии в левом верхнем углу и варианты «Уйти» и «Готовить».](assets/kitchen.jpg)
+
+![Карта мира северного района с метками виллы и въезда в город.](assets/world-map.jpg)
+
+![Карточный бой в городе: Марао и спутник против двух волков.](assets/battle.jpg)
+
+## Язык
+
+Сценарии пролога написаны по-русски и пока не переведены, поэтому их текст на русском в любом языке интерфейса. Сцены виллы и города, журнал заданий, предметы и меню переведены.
+
+## Как игра собрана
+
+Игра — это коллекция **Cthangover**. Её блоки показывают, какой мод за что отвечает:
+
+```text
+Сюжет          cthangover_game, cthangover_murakami, cthangover_party, town_pack
+2D-движок      оболочка, диалоги, интерактив, время и свет, эффекты, карта мира
+Персонажи      персонажи и навыки
+Задания        журнал
+Предметы       инвентарь, готовка
+Бой            платформа пошаговых боёв + карточный бой (ядро по умолчанию)
+Бой (FF)       бои в командном стиле (опционально)
+Вербовка       вербовка побеждённых персонажей (опционально)
+Live2D         анимированные аватары (опционально)
+Интерфейс      UI-набор, меню, звук
+Инструменты разработчика (опционально)  редакторы, валидатор, атласы, менеджер модов
+```
+
+- **Cthangover: Murakami** добавляет отдельную сюжетную линию, а **Cthangover: Starter Party** сразу ставит Марао в отряд. Они часть той же игры, но это отдельные моды.
+- **Town Pack** поставляет картинки въезда в город и прихожей, **Music Pack** — саундтрек. Этот мод добавляет отдельный плейлист для сцены въезда в город.
+- Коллекция выставляет `battle.core` в `card_battle`. Изменить его, как и состав любого блока, можно в **Mods & Collections → Коллекции → Cthangover → Изменить схему**; сохранения при этом остаются на месте.
+
+## Авторам модов
+
+Контент лежит в обычных папках:
+
+```filestree
+cthangover_game/
+├── scenes/          один JSON на место: имя, фон, эмбиент, сценарий по умолчанию
+├── scenarios/       prolog/, home/, town/ и start.scenario
+├── characters/      игрок, враги, навыки
+├── items/           еда, рецепты, ресурсы
+├── quests/          quests.json
+├── interactives/    кликабельные объекты сцен пролога
+├── map/map.json     зоны и метки карты мира
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          имена, задания и переводы сценариев на семь языков
+```
+
+Новая игра начинается в `start_scene`; его сценарий выдаёт стартовые предметы и переключает в переулок:
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+Чтобы изменить текст сцены, не трогая этот мод, добавьте сценарий для той же сцены в свой мод — или замените файл, положив в свой мод файл с тем же именем и объявив зависимость от `cthangover_game`.
+
+## Если что-то пошло не так
+
+1. **Карточка игры сообщает, что игра не готова.** Нажмите **Установить недостающее** в разделе **Играть** или проверьте схему.
+2. **Бой не начинается.** Выбранное боевое ядро должно входить в состав игры.
+3. **Текст истории на русском.** Это пролог (см. раздел «Язык»).

docs/vi.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — trò chơi chính
+
+Cthangover là tiểu thuyết tương tác mang màu sắc châm biếm u tối, kể về Marao — người đàn ông tỉnh dậy trong một con hẻm sau một đêm tồi tệ: mất trí nhớ, trùm lên mình mảnh vải đỏ và bên cạnh là cuốn sách cũ mà anh không nhớ mình đã mua. Mod này là nội dung riêng của trò chơi: các cảnh, kịch bản, nhân vật, vật phẩm, nhiệm vụ, bản đồ thế giới, cách chọn nhạc và văn bản câu chuyện. Mọi thứ còn lại — hội thoại, túi đồ, chiến đấu, màn hình bản đồ — do các mod engine và mod cơ chế mà trò chơi kết hợp lại đảm nhận.
+
+Chơi từ **Chơi → Cthangover → Trò chơi mới**.
+
+![Cảnh đầu tiên của ván mới: Marao quấn mảnh vải đỏ đứng trong con hẻm tối, lời kể tả cơn say của anh. Phần văn bản mở đầu hiện chỉ có tiếng Nga.](assets/opening.jpg)
+
+## Trong trò chơi có gì
+
+- **Mở đầu.** Câu chuyện bắt đầu ở con hẻm, đi qua nghĩa địa và men theo bờ sông tới một biệt thự cũ. Phần mở đầu chơi như một cuốn tiểu thuyết: từng dòng văn bản, chân dung Marao và các lựa chọn.
+- **Biệt thự và thị trấn.** Sau phần mở đầu, bạn di chuyển giữa các địa điểm bằng lựa chọn: bên ngoài biệt thự, các căn phòng trong đó (tiền sảnh, phòng khách, nhà bếp, phòng ngủ, phòng làm việc, tầng hầm), lối vào thị trấn và vùng ngoại ô.
+- **Chi tiết sinh tồn.** Ván mới bắt đầu với thịt sói và củi trong túi; nhà bếp theo dõi lượng lương thực và mức tiêu hao mỗi ngày, đồng thời cho phép nấu nướng.
+- **Nhiệm vụ.** Nhật ký theo dõi các việc của câu chuyện, bắt đầu với *Thức tỉnh* và *Ngôi nhà cũ*.
+- **Bản đồ thế giới.** Bảng bản đồ cho thấy khu vực cùng những nơi bạn có thể tới.
+- **Chiến đấu.** Các trận đánh mặc định dùng chiến đấu thẻ bài; có thể chuyển sang kiểu chiến đấu ra lệnh trong phần cài đặt của trò chơi.
+
+![Ngoài biệt thự lúc giữa trưa: ngôi nhà cối xay bên thác nước với các lựa chọn "Vào nhà", "Vào thị trấn" và "Vào rừng".](assets/villa-outside.jpg)
+
+![Nhà bếp: bộ đếm lương thực ở góc trên trái và các lựa chọn "Rời đi" và "Nấu ăn".](assets/kitchen.jpg)
+
+![Bản đồ thế giới của khu phía bắc với các mốc Biệt thự và Lối vào thị trấn.](assets/world-map.jpg)
+
+![Một trận chiến thẻ bài trong thị trấn: Marao và một người đồng hành đấu với hai con sói.](assets/battle.jpg)
+
+## Ngôn ngữ
+
+Kịch bản phần mở đầu viết bằng tiếng Nga và chưa có bản dịch, nên văn bản luôn hiện bằng tiếng Nga dù giao diện dùng ngôn ngữ nào. Các cảnh biệt thự và thị trấn, nhật ký nhiệm vụ, vật phẩm và trình đơn đã được dịch.
+
+## Trò chơi được ghép như thế nào
+
+Trò chơi là bộ sưu tập **Cthangover**. Các khối của nó cho biết mod nào đảm nhận việc gì:
+
+```text
+Cốt truyện     cthangover_game, cthangover_murakami, cthangover_party, town_pack
+Engine 2D      shell, hội thoại, tương tác, thời gian và ánh sáng, hiệu ứng, bản đồ thế giới
+Nhân vật       nhân vật và kỹ năng
+Nhiệm vụ       nhật ký
+Vật phẩm       túi đồ, nấu ăn
+Chiến đấu      nền tảng theo lượt + chiến đấu thẻ bài (lõi mặc định)
+Chiến đấu (FF) lõi chiến đấu kiểu ra lệnh (tùy chọn)
+Tuyển mộ       tuyển mộ nhân vật đã bị đánh bại (tùy chọn)
+Live2D         chân dung động (tùy chọn)
+Giao diện      bộ công cụ UI, trình đơn, âm thanh
+Công cụ phát triển (tùy chọn)  trình soạn thảo, trình kiểm tra, atlas, trình quản lý mod
+```
+
+- **Cthangover: Murakami** thêm một tuyến truyện riêng, còn **Cthangover: Starter Party** đưa Marao vào đội ngay từ đầu. Cả hai thuộc cùng một trò chơi nhưng là những mod riêng biệt.
+- **Town Pack** cung cấp hình lối vào thị trấn và tiền sảnh; **Music Pack** cung cấp nhạc nền. Mod này thêm một danh sách phát riêng cho cảnh lối vào thị trấn.
+- Bộ sưu tập đặt `battle.core` thành `card_battle`. Bạn có thể đổi giá trị này, cũng như các mod của bất kỳ khối nào, trong **Mods & Collections → Bộ sưu tập → Cthangover → Sửa sơ đồ**; các bản lưu của bạn vẫn được giữ nguyên.
+
+## Dành cho tác giả
+
+Nội dung nằm trong những thư mục bình thường:
+
+```filestree
+cthangover_game/
+├── scenes/          mỗi địa điểm một JSON: tên, nền, âm thanh nền, kịch bản mặc định
+├── scenarios/       prolog/, home/, town/ và start.scenario
+├── characters/      người chơi, kẻ địch, kỹ năng
+├── items/           đồ ăn, công thức, tài nguyên
+├── quests/          quests.json
+├── interactives/    vật thể bấm được trong các cảnh mở đầu
+├── map/map.json     vùng và mốc của bản đồ thế giới
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          tên, nhiệm vụ và bản dịch kịch bản bằng bảy ngôn ngữ
+```
+
+Ván mới bắt đầu ở `start_scene`, kịch bản của nó phát vật phẩm khởi đầu rồi chuyển sang con hẻm:
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+Muốn đổi văn bản của một cảnh mà không sửa mod này, hãy thêm một kịch bản cho chính cảnh đó vào mod của bạn, hoặc thay thế tệp bằng cách đóng gói tệp trùng tên cùng phần phụ thuộc vào `cthangover_game`.
+
+## Nếu có trục trặc
+
+1. **Thẻ trò chơi báo chưa sẵn sàng.** Dùng **Cài phần còn thiếu** trong **Chơi**, hoặc kiểm tra lại sơ đồ.
+2. **Không vào được trận chiến.** Lõi chiến đấu đã chọn phải nằm trong trò chơi.
+3. **Văn bản câu chuyện bằng tiếng Nga.** Đó là phần mở đầu (xem Ngôn ngữ).

docs/zh.md

@@ -0,0 +1,88 @@
+# Cthangover: Story — 主游戏
+
+Cthangover 是一款黑色幽默的视觉小说，讲述马劳在糟透的一夜之后在小巷里醒来：失忆、裹着一块红布、身边还有一本他根本不记得买过的旧书。本模组是游戏自身的内容：场景、剧本、角色、物品、任务、世界地图、音乐选择和故事文本。其余一切——对话、背包、战斗、地图界面——都由游戏所组合的引擎模组和玩法模组提供。
+
+从“开始游戏 → Cthangover → 新游戏”进入游戏。
+
+![新游戏的第一幕：马劳裹着红布站在昏暗的小巷里，旁白描述着他的宿醉。序章文本目前仅有俄语。](assets/opening.jpg)
+
+## 游戏内容
+
+- **序章。** 故事从小巷开始，途经墓地，再沿河岸一直走到一栋旧别墅。序章以小说方式呈现：一行行文本、马劳的立绘和各种选择。
+- **别墅与小镇。** 序章之后，你通过选项在各个地点之间移动：别墅外、别墅的各个房间（门厅、客厅、厨房、卧室、工作室、地下室）、小镇入口和郊外。
+- **生存细节。** 新游戏开始时，背包里就有狼肉和柴火；厨房会统计口粮及其每日消耗，还可以做饭。
+- **任务。** 日志记录故事中的任务，从“苏醒”和“老房子”开始。
+- **世界地图。** 地图面板显示城区中可以前往的地点。
+- **战斗。** 战斗默认采用卡牌模式；可以在游戏设置中切换为指令式战斗。
+
+![正午的别墅外：瀑布旁的磨坊小屋，以及“进屋”“去镇上”“去森林”三个选项。](assets/villa-outside.jpg)
+
+![厨房：左上角的口粮计数器和“离开”“做饭”两个选项。](assets/kitchen.jpg)
+
+![北城区的世界地图，标有别墅和小镇入口的标记。](assets/world-map.jpg)
+
+![镇中的一场卡牌战斗：马劳和一名同伴对阵两只狼。](assets/battle.jpg)
+
+## 语言
+
+序章剧本以俄语写成，尚无翻译，因此无论界面是什么语言，这部分文本都会显示俄语。别墅和小镇场景、任务日志、物品和菜单均已翻译。
+
+## 游戏的组成
+
+游戏就是合集 **Cthangover**。它的各个分组说明了每个模组的分工：
+
+```text
+剧情          cthangover_game, cthangover_murakami, cthangover_party, town_pack
+2D 引擎       外壳、对话、场景交互、时间与光照、特效、世界地图
+角色          角色和技能
+任务          日志
+物品          背包、烹饪
+战斗          回合制平台 + 卡牌战斗（默认核心）
+战斗（FF）    指令式战斗核心（可选）
+招募          招募被击败的角色（可选）
+Live2D        动态立绘（可选）
+界面          UI 组件库、菜单、音频
+开发者工具（可选）  编辑器、验证器、图集、模组管理器
+```
+
+- **Cthangover: Murakami** 增加一条独立剧情线，**Cthangover: Starter Party** 则在开局就把马劳放进队伍。它们属于同一个游戏，但彼此是独立的模组。
+- **Town Pack** 提供小镇入口和门厅的图片，**Music Pack** 提供配乐。本模组为小镇入口场景单独添加了一个播放列表。
+- 合集将 `battle.core` 设为 `card_battle`。你可以在 **Mods & Collections → 合集 → Cthangover → 编辑结构** 中修改它，也可以调整任意分组的模组；存档不会受影响。
+
+## 给模组作者
+
+内容都放在普通文件夹里：
+
+```filestree
+cthangover_game/
+├── scenes/          每个地点一个 JSON：名称、背景、环境音、默认剧本
+├── scenarios/       prolog/、home/、town/ 以及 start.scenario
+├── characters/      玩家、敌人、技能
+├── items/           食物、食谱、资源
+├── quests/          quests.json
+├── interactives/    序章场景中可点击的对象
+├── map/map.json     世界地图的区域和标记
+├── backgrounds/, avatars/, sounds/, effects/, shaders/
+└── locale/          七种语言的名称、任务和剧本翻译
+```
+
+新游戏从 `start_scene` 开始，其剧本会发放初始物品并切换到小巷：
+
+```scenario
+scene: start_scene
+priority: 0
+is_one_run: true
+---
+action item.add id=food/wolf_meat count=10
+action item.add id=resource/branches count=10
+switch_scene prolog_alley
+end
+```
+
+想在不改动本模组的情况下修改场景文本，可以在自己的模组里为同一场景添加剧本，或者声明对 `cthangover_game` 的依赖，用同名文件进行覆盖。
+
+## 出问题了怎么办
+
+1. **游戏卡片提示尚未就绪。** 在“开始游戏”中使用“安装缺失项”，或者检查合集结构。
+2. **战斗无法开始。** 所选的战斗核心必须包含在游戏中。
+3. **故事文本是俄语。** 那是序章（见“语言”一节）。

locale/en.properties

@@ -1,5 +1,5 @@
 mod_cthangover_game_name = Cthangover: Story
-mod_cthangover_game_desc = Story content of the Cthangover game: scenes, scenarios, characters, items, quests, backgrounds and the main game collection.
+mod_cthangover_game_desc = The story content of Cthangover: scenes, scenarios, characters, items, quests and the world map of Marao's very bad night. The machinery lives in engine mods.
 
 prolog/title = * A few missed moments earlier *
 prolog/line1 = Being thoroughly wasted, Marao lay peacefully in the alley.

locale/es.properties

@@ -0,0 +1,70 @@
+mod_cthangover_game_name = Cthangover: historia
+mod_cthangover_game_desc = El contenido narrativo de Cthangover: escenas, escenarios, personajes, objetos, misiones y el mapa del mundo de la pésima noche de Marao. La maquinaria vive en los mods de motor.
+
+prolog/title = * Unos cuantos momentos perdidos antes *
+prolog/line1 = Completamente hecho polvo, Marao yacía tranquilo en el callejón.
+prolog/line2 = Le habían robado hasta la camisa, le habían dado una paliza y lo habían tirado en el primer callejón.
+prolog/line4 = Los gatos le habían meado en la boca; le dolían la cabeza y el culo.
+prolog/choose_path = [¿Qué hacer?]
+prolog/opt_home = Volver a casa
+prolog/opt_alley = Revisar el callejón
+menu/version = v1.0 - 2026.01.29
+menu/resume = Continuar
+menu/saves = Partidas guardadas
+menu/settings = Ajustes
+menu/exit = Salir
+menu/newgame = Nueva partida
+ui/add_to_party = Nuevo miembro del grupo
+ui/battle/next = Terminar turno
+ui/battle/endgame = Fin
+ui/battle/endgame/to_main_menu = Menú principal
+ui/battle/victory = Victoria
+ui/battle/victory/return = Continuar
+ui/battle/exp = Experiencia
+ui/diner/rationday = Consumo diario: {0}
+ui/diner/rationmax = Las provisiones durarán {0} días
+ui/cook/cook = Cocinar
+ui/cook/close = Cerrar
+ui/cook/recipe_time = {0} minutos
+ui/cook/recipe_out = Resultado: {0}
+ui/menu/new_game = Nueva partida
+ui/menu/load = Cargar
+ui/menu/settings = Ajustes
+ui/menu/exit = Salir
+quest/awakening = El despertar
+quest/awakening/0 = Me desperté desnudo en un callejón. La cabeza me va a estallar. Mira alrededor y busca algo que ponerte.
+quest/awakening/1 = Me tapé con un trapo y cogí el libro. Entonces apareció la policía. No vale la pena discutir: a correr.
+quest/awakening/2 = Los silbatos se han callado. Estoy en el cementerio. Recupera el aliento y piensa qué hacer con el libro.
+quest/awakening/3 = Lo leí en voz alta. Estoy bastante seguro de que hice algo. ¿Pero qué exactamente?
+quest/awakening/4 = El libro empezó a hablar. Dice llamarse Al Azif. Hay que largarse de aquí.
+quest/awakening/5 = Voy por la orilla del río hacia la villa. Me esconderé por allí un tiempo.
+items/food/ration/name = Ración
+items/food/ration/desc = Una ración diaria para una persona
+items/food/wolf_meat/name = Chuleta de lobo
+items/food/wolf_meat/desc = Carne cruda de lobo
+items/resource/branches/name = Ramas
+items/resource/branches/desc = Combustible para una hoguera
+recipe/wolf_meat_to_ration/name = Ración de carne de lobo
+recipe/wolf_meat_to_ration/desc = Una receta que explica cómo cocinar bien la carne de lobo para que se pueda comer sin peligro
+characters/player/marao = Marao
+characters/enemies/wolf = Lobo
+characters/enemies/werewolf_girl = Licántropa
+characters/skills/slave_master_name = Tratante de esclavos
+characters/skills/slave_master = Permite esclavizar a un enemigo derrotado con una probabilidad base del 10 %. La manutención del esclavo corre de tu cuenta.
+characters/skills/effects/recruit = probabilidad de reclutar
+launcher/title = Ajustes
+launcher/play = Jugar
+launcher/exit = Salir
+quest/old_house = La casa vieja
+quest/awakening/tag/cloak_taken = Capa encontrada
+quest/awakening/tag/book_taken = Libro encontrado
+quest/awakening/tag/graveyard_read = Leído en voz alta
+quest/awakening/tag/azif_awake = Azif ha despertado
+quest/awakening/tag/villa_reached = Llegada a la villa
+
+mapzone/home = Villa
+mapzone/home/info = Una villa abandonada en un paraje salvaje a orillas del río
+mapzone/town_entry = Entrada de la ciudad
+mapzone/town_entry/info = La entrada norte de la ciudad
+
+# Collections (vn_starter_novel)

locale/ja.properties

@@ -0,0 +1,70 @@
+mod_cthangover_game_name = Cthangover：ストーリー
+mod_cthangover_game_desc = Cthangover のストーリーコンテンツ:シーン、シナリオ、キャラクター、アイテム、クエスト、そしてマラオの最悪の夜のワールドマップ。仕組みの部分はエンジン系 MOD が担います。
+
+prolog/title = * 少し前の、見逃したいくつかの瞬間 *
+prolog/line1 = すっかり酔いつぶれたマラオは、路地で安らかに寝転がっていた。
+prolog/line2 = 身ぐるみ剥がされ、殴られ、手近な裏路地に捨てられたのだ。
+prolog/line4 = 猫に口の中へ小便をされ、頭も尻もずきずきと痛む。
+prolog/choose_path = [どうする？]
+prolog/opt_home = 家に帰る
+prolog/opt_alley = 路地を調べる
+menu/version = v1.0 - 2026.01.29
+menu/resume = 再開
+menu/saves = セーブ
+menu/settings = 設定
+menu/exit = 終了
+menu/newgame = ニューゲーム
+ui/add_to_party = 新しい仲間
+ui/battle/next = ターン終了
+ui/battle/endgame = 終わり
+ui/battle/endgame/to_main_menu = メインメニュー
+ui/battle/victory = 勝利
+ui/battle/victory/return = 続ける
+ui/battle/exp = 経験値
+ui/diner/rationday = 1 日の消費：{0}
+ui/diner/rationmax = 食料はあと {0} 日もちます
+ui/cook/cook = 料理する
+ui/cook/close = 閉じる
+ui/cook/recipe_time = {0} 分
+ui/cook/recipe_out = 料理の結果：{0}
+ui/menu/new_game = ニューゲーム
+ui/menu/load = ロード
+ui/menu/settings = 設定
+ui/menu/exit = 終了
+quest/awakening = 目覚め
+quest/awakening/0 = 路地で裸のまま目を覚ました。頭が割れそうだ。辺りを見回して、着るものを探そう。
+quest/awakening/1 = ぼろ布で体を隠し、本をつかんだ。そこへ警察が現れた。言い争っても無駄だ——逃げろ。
+quest/awakening/2 = 笛の音がやんだ。墓地にいる。息を整えて、本をどうするか考えよう。
+quest/awakening/3 = 声に出して読んだ。何かをしてしまったのは確かだ。でも、いったい何を？
+quest/awakening/4 = 本がしゃべり出した。アル・アジフと名乗っている。ここから離れなければ。
+quest/awakening/5 = 川沿いを歩いて屋敷へ向かう。しばらくあの辺りに身を潜めよう。
+items/food/ration/name = 糧食
+items/food/ration/desc = 一人分の一日の糧食
+items/food/wolf_meat/name = 狼のカツレツ
+items/food/wolf_meat/desc = 狼の生肉
+items/resource/branches/name = 枝
+items/resource/branches/desc = 焚き火の燃料
+recipe/wolf_meat_to_ration/name = 狼肉の糧食
+recipe/wolf_meat_to_ration/desc = 狼の肉を安全に食べられるよう、正しく調理する方法を記したレシピ
+characters/player/marao = マラオ
+characters/enemies/wolf = 狼
+characters/enemies/werewolf_girl = 人狼
+characters/skills/slave_master_name = 奴隷商人
+characters/skills/slave_master = 倒した敵を基本確率 10% で奴隷にできる。奴隷の食い扶持はあなた持ち。
+characters/skills/effects/recruit = 勧誘の確率
+launcher/title = 設定
+launcher/play = プレイ
+launcher/exit = 終了
+quest/old_house = 古い家
+quest/awakening/tag/cloak_taken = マントを見つけた
+quest/awakening/tag/book_taken = 本を見つけた
+quest/awakening/tag/graveyard_read = 声に出して読んだ
+quest/awakening/tag/azif_awake = アジフが目覚めた
+quest/awakening/tag/villa_reached = 屋敷に着いた
+
+mapzone/home = 屋敷
+mapzone/home/info = 川岸の荒れ地に建つ、打ち捨てられた屋敷
+mapzone/town_entry = 町の入口
+mapzone/town_entry/info = 町の北側の入口
+
+# Collections (vn_starter_novel)

locale/ko.properties

@@ -0,0 +1,70 @@
+mod_cthangover_game_name = Cthangover: 이야기
+mod_cthangover_game_desc = Cthangover의 스토리 콘텐츠: 마라오의 형편없던 밤이 펼쳐지는 장면, 시나리오, 캐릭터, 아이템, 퀘스트, 월드 맵. 실제 동작은 엔진 모드가 담당합니다.
+
+prolog/title = * 조금 전, 놓쳐 버린 몇 순간 *
+prolog/line1 = 만취한 마라오는 골목에 평화롭게 누워 있었다.
+prolog/line2 = 그는 탈탈 털리고 얻어맞은 채 가장 가까운 뒷골목에 버려졌다.
+prolog/line4 = 고양이들이 그의 입에 오줌을 쌌고, 머리도 엉덩이도 욱신거렸다.
+prolog/choose_path = [어떻게 할까?]
+prolog/opt_home = 집으로 돌아간다
+prolog/opt_alley = 골목을 살펴본다
+menu/version = v1.0 - 2026.01.29
+menu/resume = 계속
+menu/saves = 저장
+menu/settings = 설정
+menu/exit = 나가기
+menu/newgame = 새 게임
+ui/add_to_party = 새 파티원
+ui/battle/next = 턴 종료
+ui/battle/endgame = 끝
+ui/battle/endgame/to_main_menu = 메인 메뉴
+ui/battle/victory = 승리
+ui/battle/victory/return = 계속
+ui/battle/exp = 경험치
+ui/diner/rationday = 하루 소비량: {0}
+ui/diner/rationmax = 보급품이 {0}일 동안 버팁니다
+ui/cook/cook = 요리하기
+ui/cook/close = 닫기
+ui/cook/recipe_time = {0}분
+ui/cook/recipe_out = 요리 결과: {0}
+ui/menu/new_game = 새 게임
+ui/menu/load = 불러오기
+ui/menu/settings = 설정
+ui/menu/exit = 나가기
+quest/awakening = 각성
+quest/awakening/0 = 골목에서 알몸으로 깨어났다. 머리가 깨질 것 같다. 주변을 둘러보고 입을 것을 찾자.
+quest/awakening/1 = 넝마로 몸을 가리고 책을 집어 들었다. 그때 경찰이 나타났다. 따져 봐야 소용없다 — 도망치자.
+quest/awakening/2 = 호루라기 소리가 잦아들었다. 나는 묘지에 있다. 숨을 고르고 이 책을 어떻게 할지 생각하자.
+quest/awakening/3 = 소리 내어 읽었다. 분명 뭔가를 해 버렸다. 그런데 대체 뭘?
+quest/awakening/4 = 책이 말을 하기 시작했다. 자신을 알 아지프라고 부른다. 여기서 벗어나야 한다.
+quest/awakening/5 = 강을 따라 저택으로 걸어간다. 그쪽 어딘가에서 잠시 숨어 지내자.
+items/food/ration/name = 식량
+items/food/ration/desc = 한 사람의 하루치 식량
+items/food/wolf_meat/name = 늑대 커틀릿
+items/food/wolf_meat/desc = 늑대 생고기
+items/resource/branches/name = 나뭇가지
+items/resource/branches/desc = 모닥불 연료
+recipe/wolf_meat_to_ration/name = 늑대 고기 식량
+recipe/wolf_meat_to_ration/desc = 늑대 고기를 안전하게 먹을 수 있도록 제대로 요리하는 법을 적은 레시피
+characters/player/marao = 마라오
+characters/enemies/wolf = 늑대
+characters/enemies/werewolf_girl = 늑대인간
+characters/skills/slave_master_name = 노예 상인
+characters/skills/slave_master = 쓰러뜨린 적을 기본 10% 확률로 노예로 삼을 수 있다. 노예의 부양은 당신 몫이다.
+characters/skills/effects/recruit = 영입 확률
+launcher/title = 설정
+launcher/play = 플레이
+launcher/exit = 나가기
+quest/old_house = 낡은 집
+quest/awakening/tag/cloak_taken = 망토를 찾았다
+quest/awakening/tag/book_taken = 책을 찾았다
+quest/awakening/tag/graveyard_read = 소리 내어 읽었다
+quest/awakening/tag/azif_awake = 아지프가 깨어났다
+quest/awakening/tag/villa_reached = 저택에 도착했다
+
+mapzone/home = 저택
+mapzone/home/info = 강기슭 황무지에 있는 버려진 저택
+mapzone/town_entry = 마을 입구
+mapzone/town_entry/info = 마을의 북쪽 입구
+
+# Collections (vn_starter_novel)

locale/ru.properties

@@ -1,5 +1,5 @@
 mod_cthangover_game_name = Cthangover: сюжет
-mod_cthangover_game_desc = Сюжетный контент игры Cthangover: сцены, сценарии, персонажи, предметы, квесты, фоны и коллекция основной игры.
+mod_cthangover_game_desc = Сюжетный контент Cthangover: сцены, сценарии, персонажи, предметы, задания и карта мира очень неудачной ночи Марао. Вся механика живёт в модах-движках.
 
 prolog/title = * Несколькими упущенными моментами ранее *
 prolog/line1 = Будучи изрядно набуханным, Марао мирно лежал в переулке.

locale/scenarios_es.properties

@@ -0,0 +1,22 @@
+home_outside/opt_enter = Entrar en la casa
+home_outside/opt_town = A la ciudad
+home_outside/opt_forest = Al bosque
+town_entry/opt_home = Volver a casa
+town_entry/opt_square = A la plaza
+town_outskirts/opt_home = Volver a casa
+town_outskirts/opt_forest = Al bosque
+vestibule/diner/opt_workroom = Al estudio
+vestibule/diner/opt_dinerroom = Al comedor
+vestibule/diner/opt_bedroom = Al dormitorio
+vestibule/diner/opt_cellar = Al sótano
+vestibule/diner/opt_outside = Afuera
+rooms/workroom/prompt = El estudio: aquí nadie te distraerá de tus investigaciones
+rooms/workroom/opt_exit = Salir
+rooms/bedroom/prompt = Tu dormitorio: aquí puedes dormir y recuperar fuerzas
+rooms/bedroom/opt_exit = Salir
+rooms/kitchen/prompt = Una habitación equipada como cocina
+rooms/kitchen/opt_exit = Salir
+rooms/livingroom/prompt = Sala de estar
+rooms/livingroom/opt_exit = Salir
+rooms/basement/prompt = Sótano
+rooms/basement/opt_exit = Salir

locale/scenarios_ja.properties

@@ -0,0 +1,22 @@
+home_outside/opt_enter = 家に入る
+home_outside/opt_town = 町へ
+home_outside/opt_forest = 森へ
+town_entry/opt_home = 家に帰る
+town_entry/opt_square = 広場へ
+town_outskirts/opt_home = 家に帰る
+town_outskirts/opt_forest = 森へ
+vestibule/diner/opt_workroom = 書斎へ
+vestibule/diner/opt_dinerroom = 食堂へ
+vestibule/diner/opt_bedroom = 寝室へ
+vestibule/diner/opt_cellar = 地下室へ
+vestibule/diner/opt_outside = 外へ
+rooms/workroom/prompt = 書斎。ここなら誰にも研究の邪魔をされない
+rooms/workroom/opt_exit = 出る
+rooms/bedroom/prompt = あなたの寝室。ここで眠って体力を回復できる
+rooms/bedroom/opt_exit = 出る
+rooms/kitchen/prompt = 台所として整えられた部屋
+rooms/kitchen/opt_exit = 出る
+rooms/livingroom/prompt = 居間
+rooms/livingroom/opt_exit = 出る
+rooms/basement/prompt = 地下室
+rooms/basement/opt_exit = 出る

locale/scenarios_ko.properties

@@ -0,0 +1,22 @@
+home_outside/opt_enter = 집에 들어간다
+home_outside/opt_town = 마을로
+home_outside/opt_forest = 숲으로
+town_entry/opt_home = 집으로 돌아간다
+town_entry/opt_square = 광장으로
+town_outskirts/opt_home = 집으로 돌아간다
+town_outskirts/opt_forest = 숲으로
+vestibule/diner/opt_workroom = 작업실로
+vestibule/diner/opt_dinerroom = 식당으로
+vestibule/diner/opt_bedroom = 침실로
+vestibule/diner/opt_cellar = 지하실로
+vestibule/diner/opt_outside = 밖으로
+rooms/workroom/prompt = 작업실. 여기서는 아무도 연구를 방해하지 않는다
+rooms/workroom/opt_exit = 나가기
+rooms/bedroom/prompt = 당신의 침실. 여기서 잠을 자고 기운을 회복할 수 있다
+rooms/bedroom/opt_exit = 나가기
+rooms/kitchen/prompt = 부엌으로 꾸며진 방
+rooms/kitchen/opt_exit = 나가기
+rooms/livingroom/prompt = 거실
+rooms/livingroom/opt_exit = 나가기
+rooms/basement/prompt = 지하실
+rooms/basement/opt_exit = 나가기

locale/scenarios_vi.properties

@@ -0,0 +1,22 @@
+home_outside/opt_enter = Vào nhà
+home_outside/opt_town = Đến thị trấn
+home_outside/opt_forest = Đến khu rừng
+town_entry/opt_home = Về nhà
+town_entry/opt_square = Đến quảng trường
+town_outskirts/opt_home = Về nhà
+town_outskirts/opt_forest = Đến khu rừng
+vestibule/diner/opt_workroom = Đến phòng làm việc
+vestibule/diner/opt_dinerroom = Đến phòng ăn
+vestibule/diner/opt_bedroom = Đến phòng ngủ
+vestibule/diner/opt_cellar = Xuống tầng hầm
+vestibule/diner/opt_outside = Ra ngoài
+rooms/workroom/prompt = Phòng làm việc, ở đây không ai làm phiền việc nghiên cứu của bạn
+rooms/workroom/opt_exit = Rời đi
+rooms/bedroom/prompt = Phòng ngủ của bạn, ở đây bạn có thể ngủ và hồi sức
+rooms/bedroom/opt_exit = Rời đi
+rooms/kitchen/prompt = Một căn phòng được bố trí làm bếp
+rooms/kitchen/opt_exit = Rời đi
+rooms/livingroom/prompt = Phòng khách
+rooms/livingroom/opt_exit = Rời đi
+rooms/basement/prompt = Tầng hầm
+rooms/basement/opt_exit = Rời đi

locale/scenarios_zh.properties

@@ -0,0 +1,22 @@
+home_outside/opt_enter = 进屋
+home_outside/opt_town = 去城镇
+home_outside/opt_forest = 去森林
+town_entry/opt_home = 回家
+town_entry/opt_square = 去广场
+town_outskirts/opt_home = 回家
+town_outskirts/opt_forest = 去森林
+vestibule/diner/opt_workroom = 去书房
+vestibule/diner/opt_dinerroom = 去餐厅
+vestibule/diner/opt_bedroom = 去卧室
+vestibule/diner/opt_cellar = 去地下室
+vestibule/diner/opt_outside = 出去
+rooms/workroom/prompt = 书房，在这里没人会打扰你的研究
+rooms/workroom/opt_exit = 离开
+rooms/bedroom/prompt = 你的卧室，可以在这里睡觉恢复体力
+rooms/bedroom/opt_exit = 离开
+rooms/kitchen/prompt = 一间布置成厨房的房间
+rooms/kitchen/opt_exit = 离开
+rooms/livingroom/prompt = 客厅
+rooms/livingroom/opt_exit = 离开
+rooms/basement/prompt = 地下室
+rooms/basement/opt_exit = 离开

locale/vi.properties

@@ -0,0 +1,70 @@
+mod_cthangover_game_name = Cthangover: Câu chuyện
+mod_cthangover_game_desc = Nội dung cốt truyện của Cthangover: cảnh, kịch bản, nhân vật, vật phẩm, nhiệm vụ và bản đồ thế giới của đêm tồi tệ mà Marao trải qua. Phần máy móc nằm trong các mod engine.
+
+prolog/title = * Vài khoảnh khắc bị bỏ lỡ trước đó *
+prolog/line1 = Say bí tỉ, Marao nằm yên bình trong con hẻm.
+prolog/line2 = Hắn bị trấn lột sạch, bị đánh một trận rồi bị vứt vào con hẻm sau đầu tiên.
+prolog/line4 = Lũ mèo tè vào miệng hắn, đầu và mông hắn đau nhức.
+prolog/choose_path = [Làm gì đây?]
+prolog/opt_home = Về nhà
+prolog/opt_alley = Xem xét con hẻm
+menu/version = v1.0 - 2026.01.29
+menu/resume = Tiếp tục
+menu/saves = Bản lưu
+menu/settings = Cài đặt
+menu/exit = Thoát
+menu/newgame = Trò chơi mới
+ui/add_to_party = Thành viên mới
+ui/battle/next = Kết thúc lượt
+ui/battle/endgame = Kết thúc
+ui/battle/endgame/to_main_menu = Menu chính
+ui/battle/victory = Chiến thắng
+ui/battle/victory/return = Tiếp tục
+ui/battle/exp = Kinh nghiệm
+ui/diner/rationday = Tiêu thụ mỗi ngày: {0}
+ui/diner/rationmax = Lương thực đủ dùng {0} ngày
+ui/cook/cook = Nấu ăn
+ui/cook/close = Đóng
+ui/cook/recipe_time = {0} phút
+ui/cook/recipe_out = Kết quả nấu: {0}
+ui/menu/new_game = Trò chơi mới
+ui/menu/load = Tải
+ui/menu/settings = Cài đặt
+ui/menu/exit = Thoát
+quest/awakening = Thức tỉnh
+quest/awakening/0 = Tỉnh dậy trần truồng trong một con hẻm. Đầu như muốn vỡ. Nhìn quanh — tìm thứ gì đó để mặc.
+quest/awakening/1 = Lấy một mảnh giẻ che người và chộp lấy cuốn sách. Đúng lúc đó cảnh sát xuất hiện. Cãi cũng vô ích — chạy thôi.
+quest/awakening/2 = Tiếng còi đã lắng xuống. Tôi đang ở nghĩa địa. Thở lấy hơi và nghĩ xem phải làm gì với cuốn sách.
+quest/awakening/3 = Đã đọc to nó lên. Chắc chắn tôi đã làm điều gì đó. Nhưng là gì mới được?
+quest/awakening/4 = Cuốn sách bắt đầu nói. Nó tự xưng là Al Azif. Phải rời khỏi đây thôi.
+quest/awakening/5 = Đi dọc bờ sông tới biệt thự. Tôi sẽ trốn ở đâu đó quanh đó một thời gian.
+items/food/ration/name = Khẩu phần
+items/food/ration/desc = Khẩu phần một ngày cho một người
+items/food/wolf_meat/name = Thịt sói cốt lết
+items/food/wolf_meat/desc = Thịt sói sống
+items/resource/branches/name = Cành cây
+items/resource/branches/desc = Nhiên liệu cho đống lửa trại
+recipe/wolf_meat_to_ration/name = Khẩu phần từ thịt sói
+recipe/wolf_meat_to_ration/desc = Công thức hướng dẫn cách nấu thịt sói đúng cách để ăn an toàn
+characters/player/marao = Marao
+characters/enemies/wolf = Sói
+characters/enemies/werewolf_girl = Người sói
+characters/skills/slave_master_name = Kẻ buôn nô lệ
+characters/skills/slave_master = 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.
+characters/skills/effects/recruit = tỉ lệ chiêu mộ
+launcher/title = Cài đặt
+launcher/play = Chơi
+launcher/exit = Thoát
+quest/old_house = Ngôi nhà cũ
+quest/awakening/tag/cloak_taken = Đã tìm thấy áo choàng
+quest/awakening/tag/book_taken = Đã tìm thấy cuốn sách
+quest/awakening/tag/graveyard_read = Đã đọc to
+quest/awakening/tag/azif_awake = Azif đã thức tỉnh
+quest/awakening/tag/villa_reached = Đã đến biệt thự
+
+mapzone/home = Biệt thự
+mapzone/home/info = Một biệt thự bỏ hoang nơi hoang dã bên bờ sông
+mapzone/town_entry = Lối vào thị trấn
+mapzone/town_entry/info = Lối vào phía bắc của thị trấn
+
+# Collections (vn_starter_novel)

locale/zh.properties

@@ -0,0 +1,70 @@
+mod_cthangover_game_name = Cthangover：故事
+mod_cthangover_game_desc = Cthangover 的剧情内容：场景、剧本、角色、物品、任务，以及马劳那个糟透夜晚的世界地图。具体的机器都在引擎模组里。
+
+prolog/title = * 稍早之前错过的几个瞬间 *
+prolog/line1 = 醉得一塌糊涂的马拉奥安详地躺在小巷里。
+prolog/line2 = 他被洗劫一空，挨了一顿揍，被扔进了第一条后巷。
+prolog/line4 = 猫在他嘴里撒了尿，他的脑袋和屁股都疼得要命。
+prolog/choose_path = [怎么办？]
+prolog/opt_home = 回家
+prolog/opt_alley = 查看小巷
+menu/version = v1.0 - 2026.01.29
+menu/resume = 继续
+menu/saves = 存档
+menu/settings = 设置
+menu/exit = 退出
+menu/newgame = 新游戏
+ui/add_to_party = 新的队员
+ui/battle/next = 结束回合
+ui/battle/endgame = 结束
+ui/battle/endgame/to_main_menu = 主菜单
+ui/battle/victory = 胜利
+ui/battle/victory/return = 继续
+ui/battle/exp = 经验
+ui/diner/rationday = 每日消耗：{0}
+ui/diner/rationmax = 补给可维持 {0} 天
+ui/cook/cook = 烹饪
+ui/cook/close = 关闭
+ui/cook/recipe_time = {0} 分钟
+ui/cook/recipe_out = 烹饪结果：{0}
+ui/menu/new_game = 新游戏
+ui/menu/load = 读取
+ui/menu/settings = 设置
+ui/menu/exit = 退出
+quest/awakening = 苏醒
+quest/awakening/0 = 在小巷里光着身子醒来。头疼得要裂开。看看四周——找点东西穿上。
+quest/awakening/1 = 用一块破布遮住身子，抓起了那本书。这时警察来了。没必要争辩——快跑。
+quest/awakening/2 = 哨声平息了。我在墓地。喘口气，想想该拿这本书怎么办。
+quest/awakening/3 = 把它大声念了出来。我肯定做了什么。可到底是什么？
+quest/awakening/4 = 书开口说话了。它自称阿尔·阿齐夫。该离开这里了。
+quest/awakening/5 = 沿着河岸走向别墅。在那边找个地方先躲一阵。
+items/food/ration/name = 口粮
+items/food/ration/desc = 一个人一天的口粮
+items/food/wolf_meat/name = 狼肉排
+items/food/wolf_meat/desc = 生狼肉
+items/resource/branches/name = 树枝
+items/resource/branches/desc = 篝火的燃料
+recipe/wolf_meat_to_ration/name = 狼肉口粮
+recipe/wolf_meat_to_ration/desc = 一份配方，讲述如何正确烹饪狼肉，让它可以安全食用
+characters/player/marao = 马拉奥
+characters/enemies/wolf = 狼
+characters/enemies/werewolf_girl = 狼人
+characters/skills/slave_master_name = 奴隶贩子
+characters/skills/slave_master = 能以 10% 的基础概率奴役被击败的敌人。奴隶的生计由你负担。
+characters/skills/effects/recruit = 招募几率
+launcher/title = 设置
+launcher/play = 开始游戏
+launcher/exit = 退出
+quest/old_house = 老房子
+quest/awakening/tag/cloak_taken = 找到了斗篷
+quest/awakening/tag/book_taken = 找到了书
+quest/awakening/tag/graveyard_read = 大声念出
+quest/awakening/tag/azif_awake = 阿齐夫苏醒
+quest/awakening/tag/villa_reached = 抵达别墅
+
+mapzone/home = 别墅
+mapzone/home/info = 河岸荒野中的一座废弃别墅
+mapzone/town_entry = 城镇入口
+mapzone/town_entry/info = 城镇的北入口
+
+# Collections (vn_starter_novel)

manifest.json

@@ -3,9 +3,9 @@
   "name": "Cthangover: Story",
   "version": "2.0.0",
   "author": "ct",
-  "description": "Story content of the Cthangover game: scenes, scenarios, characters, items, quests, backgrounds and the main game collection.",
+  "description": "The story content of Cthangover: scenes, scenarios, characters, items, quests and the world map of Marao's very bad night. The machinery lives in engine mods.",
   "category": "story",
-  "depends": ["shell2d_base>=1", "dialog_base>=1", "interactive_base>=1", "skills_base>=1", "map_base>=1", "ui_base>=1", "characters_base>=1", "items_base>=1", "quests_base>=1", "town_pack>=1"],
+  "depends": ["shell2d_base>=1", "dialog_base>=1", "interactive_base>=1", "skills_base>=1", "map_base>=1", "ui_base>=1", "characters_base>=1", "items_base>=1", "quests_base>=1", "town_pack>=1", "music_pack>=1"],
   "test_suites": [
     {"id": "site_shots", "activate": ["--itest=site_shots"]}
   ]

music/playlists/battle.json

@@ -1,22 +0,0 @@
-{
-  "Scene": "Battle",
-  "Musics": [
-    {
-      "MusicType": "Combat",
-      "MusicNames": [
-        "Aura of Decay",
-        "Circuit Dreams II",
-        "Crimson Echoes",
-        "Crimson Horizon",
-        "Glass Symphony",
-        "Hex Doom Cart",
-        "Iron Resonance",
-        "Iron Resonance II",
-        "Luminous Twilight",
-        "Rusty Frequencies",
-        "Skull Resonance",
-        "Venom's Embrace"
-      ]
-    }
-  ]
-}

music/playlists/default.json

@@ -1,36 +0,0 @@
-{
-  "Scene": "default",
-  "Musics": [
-    {
-      "MusicType": "Ambient",
-      "MusicNames": [
-        "Abyssal Void",
-        "Airborne Melody",
-        "Binary Prelude",
-        "Cinders of Dawn",
-        "Melancholic Journey",
-        "Nebula Pulse Echoes",
-        "Quantum Archive",
-        "Twilight Interlude"
-      ]
-    },
-    {
-      "MusicType": "Combat",
-      "MusicNames": [
-        "Aura of Decay",
-        "Circuit Dreams II",
-        "Crimson Echoes",
-        "Crimson Horizon",
-        "Glass Symphony",
-        "Hex Doom Cart",
-        "Iron Resonance",
-        "Iron Resonance II",
-        "Luminous Twilight",
-        "Rusty Frequencies",
-        "Skull Resonance",
-        "Venom's Embrace",
-		"Empty Save Room"
-      ]
-    }
-  ]
-}

test_suites/site_shots/src/SiteShotsTestInitializer.cs

@@ -32,7 +32,7 @@ namespace Cthangover.Mods.CthangoverGame.Tests
                 .Select(a => a.Substring("--shots=".Length))
                 .FirstOrDefault();
             GameLogger.Log("TEST", $"SiteShotsTestInitializer: activating site_shots, shots={shots ?? "off"}");
-            (Godot.Engine.GetMainLoop() as SceneTree)?.Root?.CallDeferred("add_child", new SiteShotsDriver(shots));
+            ModRoot.AddDeferred(new SiteShotsDriver(shots));
         }
     }
 }