From 1b6771fbe2af6ff94df8b7d19d923bb1028b67e7 Mon Sep 17 00:00:00 2001 From: iisaev Date: Thu, 29 Oct 2026 09:26:06 +0100 Subject: [PATCH] Add mod documentation in seven languages --- docs/assets/bar.jpg | Bin 0 -> 61948 bytes docs/assets/edit-town-scenario.jpg | Bin 0 -> 47334 bytes docs/assets/new-choice.jpg | Bin 0 -> 15180 bytes docs/assets/town.jpg | Bin 0 -> 48320 bytes docs/en.md | 123 +++++++++++++++++++++++++++++ docs/es.md | 123 +++++++++++++++++++++++++++++ docs/ja.md | 123 +++++++++++++++++++++++++++++ docs/ko.md | 123 +++++++++++++++++++++++++++++ docs/ru.md | 123 +++++++++++++++++++++++++++++ docs/vi.md | 123 +++++++++++++++++++++++++++++ docs/zh.md | 123 +++++++++++++++++++++++++++++ locale/en.properties | 2 +- locale/es.properties | 2 +- locale/ja.properties | 2 +- locale/ko.properties | 2 +- locale/ru.properties | 2 +- locale/vi.properties | 2 +- locale/zh.properties | 2 +- manifest.json | 2 +- 19 files changed, 869 insertions(+), 8 deletions(-) create mode 100644 docs/assets/bar.jpg create mode 100644 docs/assets/edit-town-scenario.jpg create mode 100644 docs/assets/new-choice.jpg create mode 100644 docs/assets/town.jpg create mode 100644 docs/en.md create mode 100644 docs/es.md create mode 100644 docs/ja.md create mode 100644 docs/ko.md create mode 100644 docs/ru.md create mode 100644 docs/vi.md create mode 100644 docs/zh.md diff --git a/docs/assets/bar.jpg b/docs/assets/bar.jpg new file mode 100644 index 0000000000000000000000000000000000000000..e36687e1acd50431b8f69a6dd176698c8527ba83 GIT binary patch literal 61948 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%0A+F1|u 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 literal 0 HcmV?d00001 diff --git a/docs/assets/edit-town-scenario.jpg b/docs/assets/edit-town-scenario.jpg new file mode 100644 index 0000000000000000000000000000000000000000..a1b2d04e74658e5f117b74378eaa9784c99b7af7 GIT binary patch literal 47334 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

{P$*ex@WhReImyVlnoy>lncj;v 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 AGXMYp literal 0 HcmV?d00001 diff --git a/docs/assets/new-choice.jpg b/docs/assets/new-choice.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5743da18d1657e6f0a8d4c13761adfb543b16c39 GIT binary patch literal 15180 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 Z@qaFeMgV+T8lVn&5=p?5z4~Y2{{isMuX6wZ literal 0 HcmV?d00001 diff --git a/docs/en.md b/docs/en.md new file mode 100644 index 0000000..00f4b01 --- /dev/null +++ b/docs/en.md @@ -0,0 +1,123 @@ +# My Novel — the starting point for your own visual novel + +My Novel is the smallest complete visual novel in the game: an evening town, a bar and a home, connected by choices. It has no characters, items or battles — only scenes, short scenario files and their translations. It is meant to be copied: rename it, then grow your own story from these three places. + +Play it from **Play → My Novel → New game**. It is the content of the **My Novel** game (collection `novel_template`). + +![The bar in My Novel: the bar background with the line "The bar is warm and noisy, but there is nothing to do here tonight."](assets/bar.jpg) + +## What it contains + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json town entrance, the game starts here +│ ├── my_novel_bar.json bar with its ambient sound +│ └── my_novel_home.json home vestibule +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties mod name and description + └── scenarios_.properties translations of the scenario lines +``` + +The pictures and the bar sound are not in this mod: they come from **Town Pack**, so the template stays small and shows how a game reuses shared content. The music comes from **Music Pack**; the engine mods are the 2D Shell, Dialog Engine and Audio Engine. + +## How the story flows + +The town is the hub. Every visit shows the same choice; the bar and the home each lead back. + +```text + ┌────────────────────┐ + │ my_novel_town │ (start) + │ "Where to go?" │ + └──┬──────────────┬──┘ + Go into the bar Go back home + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ Back to the town ─┘ +``` + +![The town entrance in My Novel, the first scene, with the line "Evening town. The street lamps are already lit and a cool draught runs along the cobbles."](assets/town.jpg) + +A scene file names the background and the ambient sound: + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +The scenario with the same scene name runs when the scene is entered: + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +The English text is written directly in the scenario. Each `key=` names the line's translation in `locale/scenarios_.properties`, for example the Spanish one: + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## Make it your own + +1. **Copy and rename the mod.** Name it after your game with the `_game` suffix, for example `harbor_game`. Change the folder name and `id` in `manifest.json` to the same value, and rename the `mod_my_novel_game_name` / `_desc` keys in `locale/*.properties` to `mod_harbor_game_name` / `_desc`. +2. **Make a game for it.** In **Mods & Collections → Collections**, open My Novel's scheme and press **Duplicate**, then replace `my_novel_game` with your mod in the **Story** block. The entry scene is set in the collection (`"entry": { "scene": "my_novel_town" }`). +3. **Rename the scenes** if you like: the scene's `name`, its file, the `scene:` header of its scenario and every `switch_scene` that leads to it must match. +4. **Keep or replace the art.** Leave `town_pack` in `depends` to keep the town, or add your own `backgrounds/` and `sounds/` and point `defaultBackground` / `defaultAmbient` at them. + +## A first change: add a place + +This is a real session in the editors, run inside My Novel with the Editor Tools mod added. The scene editor created a `my_novel_park` scene, and one option plus one label were typed into the town's scenario: + +![The scenario editor with my_novel_town.scenario open: a new line `option "Go to the park" -> :park` and a new block `:park / switch_scene my_novel_park / end`; the status bar says the file was saved.](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +After saving, the town immediately offers the new way, and choosing it opens the new scene: + +![The town's choice now has three options: Go into the bar, Go to the park, Go back home.](assets/new-choice.jpg) + +To get the editors in your own game, add the **Editor Tools** mod to it in the scheme, or launch the game for one session with them: + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +A new line without `key=` shows its literal text in every language; add a key and translations when the story is ready to be translated. + +## If something does not work + +1. **A choice leads nowhere.** The `switch_scene` name must equal the target scene's `name`, including case. +2. **A scene has no text.** Its scenario's `scene:` header must name that scene. +3. **The text is English in another language.** The line has no `key=`, or the key is missing in that language's `scenarios_.properties`. +4. **A black background.** The background name is misspelt, or the mod that has the picture is not in `depends`. diff --git a/docs/es.md b/docs/es.md new file mode 100644 index 0000000..5bcd357 --- /dev/null +++ b/docs/es.md @@ -0,0 +1,123 @@ +# My Novel — el punto de partida para tu propia novela visual + +My Novel es la novela visual completa más pequeña del proyecto: un pueblo al atardecer, un bar y una casa, unidos por decisiones. No tiene personajes, objetos ni combates: solo escenas, archivos de escenario breves y sus traducciones. Está pensado para copiarse: renómbralo y haz crecer tu propia historia desde estos tres lugares. + +Se juega desde **Jugar → My Novel → Nueva partida**. Es el contenido del juego **My Novel** (colección `novel_template`). + +![El bar de My Novel: el fondo del bar con la línea «El bar es cálido y ruidoso, pero esta noche aquí no hay nada que hacer.».](assets/bar.jpg) + +## Qué contiene + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json entrada del pueblo, el juego empieza aquí +│ ├── my_novel_bar.json el bar con su sonido ambiental +│ └── my_novel_home.json el vestíbulo de la casa +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties nombre y descripción del mod + └── scenarios_.properties traducciones de las líneas del escenario +``` + +Las imágenes y el sonido del bar no están en este mod: vienen de **Town Pack**, para que la plantilla siga siendo pequeña y muestre cómo un juego reutiliza contenido compartido. La música viene de **Music Pack**; los mods de motor son la Carcasa 2D, el motor de diálogos y el motor de audio. + +## Cómo fluye la historia + +El pueblo es el centro. Cada visita muestra la misma decisión; el bar y la casa siempre llevan de vuelta. + +```text + ┌────────────────────┐ + │ my_novel_town │ (inicio) + │ "¿Adónde ir?" │ + └──┬──────────────┬──┘ + Entrar en el bar Volver a casa + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ Volver a la ciudad ─┘ +``` + +![La entrada del pueblo en My Novel, la primera escena, con la línea «La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines.».](assets/town.jpg) + +El archivo de la escena nombra el fondo y el sonido ambiental: + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +El escenario con el mismo nombre de la escena se ejecuta al entrar en ella: + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +El texto en inglés está escrito directamente en el escenario. Cada `key=` nombra la traducción de la línea en `locale/scenarios_.properties`; por ejemplo, la española: + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## Hazlo tuyo + +1. **Copia y renombra el mod.** Ponle el nombre de tu juego con el sufijo `_game`, por ejemplo `harbor_game`. Cambia el nombre de la carpeta y el `id` de `manifest.json` al mismo valor, y renombra las claves `mod_my_novel_game_name` / `_desc` de `locale/*.properties` a `mod_harbor_game_name` / `_desc`. +2. **Crea un juego para él.** En **Mods & Collections → Colecciones**, abre el esquema de My Novel y pulsa **Duplicar**; después sustituye `my_novel_game` por tu mod en el bloque **Historia**. La escena de entrada se fija en la colección (`"entry": { "scene": "my_novel_town" }`). +3. **Renombra las escenas** si quieres: el `name` de la escena, su archivo, la cabecera `scene:` de su escenario y cada `switch_scene` que lleve a ella deben coincidir. +4. **Conserva o sustituye el arte.** Deja `town_pack` en `depends` para quedarte con el pueblo, o añade tus propios `backgrounds/` y `sounds/` y apunta a ellos con `defaultBackground` / `defaultAmbient`. + +## Un primer cambio: añade un lugar + +Esta es una sesión real en los editores, hecha dentro de My Novel con el mod Editor Tools añadido. El editor de escenas creó una escena `my_novel_park`, y en el escenario del pueblo se teclearon una opción y una etiqueta: + +![El editor de escenarios con my_novel_town.scenario abierto: la línea nueva `option "Go to the park" -> :park` y el bloque nuevo `:park / switch_scene my_novel_park / end`; la barra de estado dice que el archivo se guardó.](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +Tras guardar, el pueblo ofrece de inmediato el nuevo camino, y elegirlo abre la escena nueva: + +![La decisión del pueblo ahora tiene tres opciones: Entrar en el bar, Go to the park, Volver a casa.](assets/new-choice.jpg) + +Para tener los editores en tu propio juego, añádele el mod **Editor Tools** en el esquema, o lanza el juego por una sesión con ellos: + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +Una línea nueva sin `key=` muestra su texto literal en todos los idiomas; añade una clave y traducciones cuando la historia esté lista para traducirse. + +## Si algo no funciona + +1. **Una decisión no lleva a ninguna parte.** El nombre del `switch_scene` debe ser igual al `name` de la escena destino, mayúsculas incluidas. +2. **Una escena no tiene texto.** La cabecera `scene:` de su escenario debe nombrar esa escena. +3. **El texto sale en inglés en otro idioma.** La línea no tiene `key=`, o la clave falta en el `scenarios_.properties` de ese idioma. +4. **Fondo negro.** El nombre del fondo está mal escrito, o el mod que tiene la imagen no está en `depends`. diff --git a/docs/ja.md b/docs/ja.md new file mode 100644 index 0000000..379251a --- /dev/null +++ b/docs/ja.md @@ -0,0 +1,123 @@ +# My Novel — 自分のビジュアルノベルの出発点 + +My Novel はプロジェクトでいちばん小さな完成したビジュアルノベルです。夕暮れの町、バー、家が選択肢でつながっています。キャラクターもアイテムも戦闘もなく、あるのはシーン、短いシナリオファイル、その翻訳だけ。コピーされることを前提としたモッドです。名前を変えて、この三つの場所から自分の物語を育ててください。 + +**プレイ → My Novel → ニューゲーム** から始めます。**My Novel** ゲーム(コレクション `novel_template`)のコンテンツです。 + +![My Novel のバー:バーの背景と「バーは暖かくにぎやかだが、今夜ここですることは何もない。」の行。](assets/bar.jpg) + +## 中身 + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json 町の入り口。ゲームはここから始まる +│ ├── my_novel_bar.json 環境音付きのバー +│ └── my_novel_home.json 家の玄関 +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties MOD の名前と説明 + └── scenarios_.properties シナリオの各行の翻訳 +``` + +画像とバーの音はこの MOD には入っていません。**Town Pack** から来るので、テンプレートは小さなまま、ゲームが共有コンテンツを再利用するようすを見せられます。音楽は **Music Pack** から。エンジン MOD は 2D シェル、会話エンジン、オーディオエンジンです。 + +## 物語の流れ + +町が中心です。訪れるたびに同じ選択肢が現れ、バーも家も必ず戻ってきます。 + +```text + ┌────────────────────┐ + │ my_novel_town │ (開始) + │ 「どこへ行く？」 │ + └──┬──────────────┬──┘ + バーに入る 家に帰る + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ 町に戻る ─┘ +``` + +![My Novel の最初のシーンである町の入り口と、「夕暮れの町。街灯はもうともり、石畳を涼しい風が吹き抜けていく。」の行。](assets/town.jpg) + +シーンのファイルは背景と環境音を指名します: + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +シーンと同じ名前のシナリオは、そのシーンに入ったときに再生されます: + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +英語のテキストはシナリオに直接書かれています。各 `key=` はその行の翻訳を `locale/scenarios_.properties` で指名します。たとえばスペイン語では: + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## 自分のものにする + +1. **MOD をコピーして名前を変える。** 自分のゲームの名前に `_game` 接尾辞を付けたものにします。たとえば `harbor_game`。フォルダー名と `manifest.json` の `id` を同じ値に変え、`locale/*.properties` のキー `mod_my_novel_game_name` / `_desc` を `mod_harbor_game_name` / `_desc` に変えます。 +2. **ゲームを作る。** **Mods & Collections → コレクション** で My Novel の構成を開いて **複製** を押し、**ストーリー** ブロックの `my_novel_game` を自分の MOD に置き換えます。開始シーンはコレクションで指定します(`"entry": { "scene": "my_novel_town" }`)。 +3. **シーンの名前を変える(任意)。** シーンの `name`、そのファイル、シナリオの `scene:` ヘッダー、そこへ通じるすべての `switch_scene` が一致していなければなりません。 +4. **アートを保つか置き換える。** 町を残すなら `depends` に `town_pack` を残します。自分の `backgrounds/` と `sounds/` を追加し、`defaultBackground` / `defaultAmbient` をそちらへ向けてもかまいません。 + +## 最初の変更:場所を一つ追加する + +これはエディターでの実際の作業です。My Novel に Editor Tools MOD を追加した状態で行いました。シーンエディターがシーン `my_novel_park` を作り、町のシナリオに選択肢を一つとラベルを一つ打ち込みました: + +![my_novel_town.scenario を開いたシナリオエディター:新しい行 `option "Go to the park" -> :park` と新しいブロック `:park / switch_scene my_novel_park / end`。ステータスバーはファイルが保存されたと伝えています。](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +保存すると、町はすぐに新しい道を示し、選ぶと新しいシーンが開きます: + +![町の選択肢は今や三つ:バーに入る、Go to the park、家に帰る。](assets/new-choice.jpg) + +自分のゲームでエディターを使うには、構成で **Editor Tools** MOD を追加するか、一ゲーム分だけそれらと一緒に起動します: + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +`key=` のない新しい行はどの言語でもリテラルのテキストを表示します。物語を翻訳する準備ができたら、キーと翻訳を追加してください。 + +## うまくいかないとき + +1. **選択肢がどこにも行かない。** `switch_scene` の名前は、大文字小文字を含めて対象シーンの `name` と一致しなければなりません。 +2. **シーンにテキストがない。** そのシナリオの `scene:` ヘッダーが、そのシーンの名前を指している必要があります。 +3. **別の言語でテキストが英語のまま。** 行に `key=` がないか、その言語の `scenarios_.properties` にキーがありません。 +4. **背景が真っ暗。** 背景名のつづりが間違っているか、画像を持つ MOD が `depends` に入っていません。 diff --git a/docs/ko.md b/docs/ko.md new file mode 100644 index 0000000..7fdf0a2 --- /dev/null +++ b/docs/ko.md @@ -0,0 +1,123 @@ +# My Novel — 나만의 비주얼 노벨의 출발점 + +My Novel은 프로젝트에서 가장 작은 완성된 비주얼 노벨입니다. 저녁의 마을, 바, 집이 선택지로 이어져 있습니다. 캐릭터도 아이템도 전투도 없고, 장면과 짧은 시나리오 파일, 그 번역만 있을 뿐입니다. 이 모드는 복제하기 위해 만들어졌습니다. 이름을 바꾸고, 이 세 장소에서 나만의 이야기를 키우세요. + +**플레이 → My Novel → 새 게임**에서 시작합니다. **My Novel** 게임(컬렉션 `novel_template`)의 콘텐츠입니다. + +![My Novel의 바: 바 배경과 “바는 따뜻하고 시끌벅적하지만, 오늘 밤 여기서 할 일은 없다.” 줄.](assets/bar.jpg) + +## 들어 있는 것 + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json 마을 입구, 게임이 여기서 시작됨 +│ ├── my_novel_bar.json 자체 환경음이 있는 바 +│ └── my_novel_home.json 집 현관 +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties 모드 이름과 설명 + └── scenarios_.properties 시나리오 줄의 번역 +``` + +그림과 바 소리는 이 모드에 없습니다. **Town Pack**에서 오기 때문에, 템플릿은 작게 유지되면서 게임이 공유 콘텐츠를 재사용하는 방식을 보여 줍니다. 음악은 **Music Pack**에서 옵니다. 엔진 모드는 2D 셸, 대화 엔진, 오디오 엔진입니다. + +## 이야기가 흐르는 방식 + +마을이 중심입니다. 방문할 때마다 같은 선택지가 나타나고, 바와 집은 언제나 돌아가는 길로 이어집니다. + +```text + ┌────────────────────┐ + │ my_novel_town │ (시작) + │ “어디로 갈까?” │ + └──┬──────────────┬──┘ + 바에 들어간다 집으로 돌아간다 + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ 마을로 돌아간다 ─┘ +``` + +![My Novel의 첫 장면인 마을 입구와 “저녁의 마을. 가로등은 벌써 켜졌고, 시원한 바람이 자갈길을 따라 분다.” 줄.](assets/town.jpg) + +장면 파일은 배경과 환경음을 지정합니다: + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +장면과 같은 이름의 시나리오는 그 장면에 들어설 때 실행됩니다: + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +영어 텍스트는 시나리오에 직접 쓰여 있습니다. 각 `key=`는 그 줄의 번역을 `locale/scenarios_.properties`에서 가리킵니다. 예를 들어 스페인어는: + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## 내 것으로 만들기 + +1. **모드를 복제하고 이름을 바꾸십시오.** 게임 이름에 `_game` 접미사를 붙여 지으세요. 예: `harbor_game`. 폴더 이름과 `manifest.json`의 `id`를 같은 값으로 바꾸고, `locale/*.properties`의 키 `mod_my_novel_game_name` / `_desc`를 `mod_harbor_game_name` / `_desc`로 바꾸십시오. +2. **게임을 만드십시오.** **Mods & Collections → 컬렉션**에서 My Novel의 구성을 열고 **복제**를 누른 뒤, **스토리** 블록의 `my_novel_game`을 내 모드로 바꾸십시오. 시작 장면은 컬렉션에서 정합니다(`"entry": { "scene": "my_novel_town" }`). +3. **장면 이름을 바꾸십시오(선택).** 장면의 `name`, 그 파일, 시나리오의 `scene:` 헤더, 그곳으로 이어지는 모든 `switch_scene`이 일치해야 합니다. +4. **아트를 유지하거나 교체하십시오.** 마을을 그대로 두려면 `depends`에 `town_pack`을 남기세요. 아니면 자신의 `backgrounds/`와 `sounds/`를 추가하고 `defaultBackground` / `defaultAmbient`가 그쪽을 가리키게 하세요. + +## 첫 번째 변경: 장소 추가하기 + +이것은 편집기에서의 실제 세션입니다. My Novel에 Editor Tools 모드를 추가한 상태에서 진행했습니다. 장면 편집기가 `my_novel_park` 장면을 만들고, 마을 시나리오에 선택지 하나와 라벨 하나를 입력했습니다: + +![my_novel_town.scenario가 열린 시나리오 편집기: 새 줄 `option "Go to the park" -> :park`과 새 블록 `:park / switch_scene my_novel_park / end`. 상태 표시줄은 파일이 저장되었다고 알립니다.](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +저장하면 마을이 곧바로 새 길을 내놓고, 그것을 고르면 새 장면이 열립니다: + +![마을의 선택지는 이제 세 개: 바에 들어간다, Go to the park, 집으로 돌아간다.](assets/new-choice.jpg) + +자신의 게임에서 편집기를 쓰려면 구성에서 **Editor Tools** 모드를 추가하거나, 한 세션 동안 그것들과 함께 게임을 실행하세요: + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +`key=` 없는 새 줄은 모든 언어에서 글자 그대로의 텍스트를 보여 줍니다. 이야기를 번역할 준비가 되면 키와 번역을 추가하세요. + +## 잘 안 될 때 + +1. **어떤 선택지가 아무 데도 가지 않습니다.** `switch_scene`의 이름은 대소문자까지 대상 장면의 `name`과 같아야 합니다. +2. **장면에 텍스트가 없습니다.** 그 시나리오의 `scene:` 헤더가 바로 그 장면의 이름을 가리켜야 합니다. +3. **다른 언어에서 텍스트가 영어입니다.** 줄에 `key=`가 없거나, 그 언어의 `scenarios_.properties`에 키가 없습니다. +4. **검은 배경.** 배경 이름의 철자가 틀렸거나, 그림을 가진 모드가 `depends`에 없습니다. diff --git a/docs/ru.md b/docs/ru.md new file mode 100644 index 0000000..fdb19fa --- /dev/null +++ b/docs/ru.md @@ -0,0 +1,123 @@ +# My Novel — отправная точка для вашей собственной визуальной новеллы + +My Novel — самая маленькая законченная визуальная новелла в проекте: вечерний город, бар и дом, связанные выборами. Здесь нет персонажей, предметов и боёв — только сцены, короткие файлы сценариев и их переводы. Мод задуман как образец для копирования: переименуйте его и вырастите собственную историю из этих трёх мест. + +Запускается через **Играть → My Novel → Новая игра**. Это контент игры **My Novel** (коллекция `novel_template`). + +![Бар в My Novel: фон бара и строка «В баре тепло и шумно, но сегодня здесь нечего делать.».](assets/bar.jpg) + +## Что внутри + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json въезд в город, игра начинается здесь +│ ├── my_novel_bar.json бар со своим фоновым звуком +│ └── my_novel_home.json прихожая дома +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties имя и описание мода + └── scenarios_.properties переводы строк сценария +``` + +Картинок и звука бара в этом моде нет: они берутся из **Town Pack**, чтобы шаблон оставался маленьким и показывал, как игра переиспользует общий контент. Музыка — из **Music Pack**; моды-движки здесь — 2D-оболочка, диалоговый движок и звуковой движок. + +## Как течёт история + +Город — центр. Каждый визит показывает один и тот же выбор; бар и дом каждый раз ведут обратно. + +```text + ┌────────────────────┐ + │ my_novel_town │ (старт) + │ «Куда пойти?» │ + └──┬──────────────┬──┘ + Зайти в бар Вернуться домой + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ Вернуться в город ─┘ +``` + +![Въезд в город в My Novel — первая сцена — и строка «Вечерний город. Фонари уже горят, по мостовой тянет прохладой.».](assets/town.jpg) + +Файл сцены называет фон и фоновый звук: + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +Сценарий с тем же именем, что у сцены, запускается при входе в неё: + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +Английский текст написан прямо в сценарии. Каждый `key=` называет перевод строки в `locale/scenarios_.properties`, например испанский: + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## Сделайте её своей + +1. **Скопируйте и переименуйте мод.** Назовите его по своей игре с суффиксом `_game`, например `harbor_game`. Папку и поле `id` в `manifest.json` смените на одно и то же значение, а ключи `mod_my_novel_game_name` / `_desc` в `locale/*.properties` — на `mod_harbor_game_name` / `_desc`. +2. **Сделайте для него игру.** В **Mods & Collections → Коллекции** откройте схему My Novel и нажмите **Дублировать**, затем в блоке «Сюжет» замените `my_novel_game` на свой мод. Стартовая сцена задаётся в коллекции (`"entry": { "scene": "my_novel_town" }`). +3. **Переименуйте сцены**, если хотите: имя сцены в поле `name`, её файл, заголовок `scene:` её сценария и каждый `switch_scene`, который туда ведёт, должны совпадать. +4. **Оставьте или замените графику.** Оставьте `town_pack` в `depends`, чтобы сохранить город, — или добавьте собственные `backgrounds/` и `sounds/` и направьте `defaultBackground` / `defaultAmbient` на них. + +## Первое изменение: добавьте место + +Это настоящая сессия в редакторах, запущенная внутри My Novel с подключённым модом Editor Tools. Редактор сцен создал сцену `my_novel_park`, а в сценарий города вписали один вариант и одну метку: + +![Редактор сценариев с открытым my_novel_town.scenario: новая строка `option "Go to the park" -> :park` и новый блок `:park / switch_scene my_novel_park / end`; строка состояния сообщает, что файл сохранён.](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +После сохранения город сразу предлагает новый путь, и выбор открывает новую сцену: + +![Выбор в городе теперь из трёх вариантов: Зайти в бар, Go to the park, Вернуться домой.](assets/new-choice.jpg) + +Чтобы редакторы были в вашей игре, добавьте в её схему мод **Editor Tools** или запустите игру на один сеанс с ними: + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +Новая строка без `key=` показывает свой буквальный текст на любом языке; добавьте ключ и переводы, когда история будет готова к переводу. + +## Если что-то не работает + +1. **Выбор ведёт в никуда.** Имя в `switch_scene` должно совпадать с полем `name` целевой сцены, включая регистр. +2. **У сцены нет текста.** Заголовок `scene:` её сценария должен называть именно эту сцену. +3. **На другом языке текст английский.** У строки нет `key=`, либо ключ отсутствует в `scenarios_.properties` этого языка. +4. **Чёрный фон.** Имя фона написано с ошибкой, или мод с картинкой не указан в `depends`. diff --git a/docs/vi.md b/docs/vi.md new file mode 100644 index 0000000..6627b81 --- /dev/null +++ b/docs/vi.md @@ -0,0 +1,123 @@ +# My Novel — điểm khởi đầu cho tiểu thuyết tương tác của riêng bạn + +My Novel là tiểu thuyết tương tác hoàn chỉnh nhỏ nhất trong dự án: một thị trấn lúc chiều tối, một quán bar và một ngôi nhà, nối với nhau bằng các lựa chọn. Nó không có nhân vật, vật phẩm hay chiến đấu — chỉ có cảnh, những tệp kịch bản ngắn và bản dịch của chúng. Mod được làm ra để copy: đổi tên nó, rồi nuôi lớn câu chuyện của riêng bạn từ ba địa điểm này. + +Chơi từ **Chơi → My Novel → Trò chơi mới**. Đây là nội dung của trò chơi **My Novel** (bộ sưu tập `novel_template`). + +![Quán bar trong My Novel: nền quán bar với dòng “Quán bar ấm áp và ồn ào, nhưng tối nay chẳng có gì để làm ở đây.”.](assets/bar.jpg) + +## Bên trong có gì + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json lối vào thị trấn, trò chơi bắt đầu ở đây +│ ├── my_novel_bar.json quán bar với âm thanh nền riêng +│ └── my_novel_home.json tiền sảnh ngôi nhà +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties tên và mô tả mod + └── scenarios_.properties bản dịch các dòng kịch bản +``` + +Hình ảnh và âm thanh quán bar không nằm trong mod này: chúng đến từ **Town Pack**, để mẫu vẫn nhỏ gọn và cho thấy một trò chơi tái sử dụng nội dung chung thế nào. Nhạc đến từ **Music Pack**; các mod engine là Vỏ 2D, engine hội thoại và engine âm thanh. + +## Câu chuyện chảy thế nào + +Thị trấn là điểm trung chuyển. Mỗi lần ghé lại thấy cùng một lựa chọn; quán bar và ngôi nhà đều dẫn đường quay về. + +```text + ┌────────────────────┐ + │ my_novel_town │ (bắt đầu) + │ "Đi đâu đây?" │ + └──┬──────────────┬──┘ + Vào quán bar Về nhà + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ Quay lại thị trấn ─┘ +``` + +![Lối vào thị trấn trong My Novel, cảnh đầu tiên, với dòng “Thị trấn lúc chiều tối. Đèn đường đã sáng và một làn gió mát lùa dọc những viên đá lát.”.](assets/town.jpg) + +Tệp cảnh nêu tên nền và âm thanh nền: + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +Kịch bản trùng tên với cảnh sẽ chạy khi bước vào cảnh đó: + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +Văn bản tiếng Anh được viết ngay trong kịch bản. Mỗi `key=` gọi tên bản dịch của dòng đó trong `locale/scenarios_.properties`, ví dụ bản tiếng Tây Ban Nha: + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## Biến nó thành của bạn + +1. **Copy và đổi tên mod.** Đặt theo tên trò chơi của bạn với hậu tố `_game`, ví dụ `harbor_game`. Đổi tên thư mục và `id` trong `manifest.json` thành cùng một giá trị, và đổi các khóa `mod_my_novel_game_name` / `_desc` trong `locale/*.properties` thành `mod_harbor_game_name` / `_desc`. +2. **Làm cho nó một trò chơi.** Trong **Mods & Collections → Bộ sưu tập**, mở sơ đồ của My Novel và bấm **Nhân bản**, rồi thay `my_novel_game` bằng mod của bạn trong khối **Câu chuyện**. Cảnh mở đầu được đặt trong bộ sưu tập (`"entry": { "scene": "my_novel_town" }`). +3. **Đổi tên các cảnh** nếu muốn: `name` của cảnh, tệp của nó, dòng đầu `scene:` trong kịch bản của nó và mọi `switch_scene` dẫn tới nó phải khớp nhau. +4. **Giữ hoặc thay phần hình ảnh.** Giữ `town_pack` trong `depends` để giữ nguyên thị trấn, hoặc thêm `backgrounds/` và `sounds/` của riêng bạn rồi trỏ `defaultBackground` / `defaultAmbient` vào đó. + +## Thay đổi đầu tiên: thêm một địa điểm + +Đây là một buổi làm việc thật trong trình soạn thảo, chạy bên trong My Novel với mod Editor Tools được thêm vào. Trình soạn cảnh đã tạo cảnh `my_novel_park`, và một lựa chọn cùng một nhãn được gõ vào kịch bản của thị trấn: + +![Trình soạn kịch bản đang mở my_novel_town.scenario: dòng mới `option "Go to the park" -> :park` và khối mới `:park / switch_scene my_novel_park / end`; thanh trạng thái báo tệp đã được lưu.](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +Sau khi lưu, thị trấn lập tức đưa ra lối mới, và chọn nó sẽ mở cảnh mới: + +![Lựa chọn của thị trấn giờ có ba mục: Vào quán bar, Go to the park, Về nhà.](assets/new-choice.jpg) + +Để có trình soạn thảo trong trò chơi của riêng bạn, thêm mod **Editor Tools** vào sơ đồ, hoặc khởi động trò chơi một phiên cùng chúng: + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +Dòng mới không có `key=` hiện văn bản nguyên văn trong mọi ngôn ngữ; thêm khóa và bản dịch khi câu chuyện sẵn sàng để dịch. + +## Khi không hoạt động + +1. **Một lựa chọn không dẫn đi đâu.** Tên trong `switch_scene` phải bằng `name` của cảnh đích, kể cả chữ hoa chữ thường. +2. **Một cảnh không có văn bản.** Dòng đầu `scene:` trong kịch bản của nó phải gọi đúng tên cảnh đó. +3. **Văn bản hiện tiếng Anh ở ngôn ngữ khác.** Dòng đó không có `key=`, hoặc khóa thiếu trong `scenarios_.properties` của ngôn ngữ đó. +4. **Nền đen thui.** Tên nền viết sai chính tả, hoặc mod đang giữ bức hình không có trong `depends`. diff --git a/docs/zh.md b/docs/zh.md new file mode 100644 index 0000000..f37d9b3 --- /dev/null +++ b/docs/zh.md @@ -0,0 +1,123 @@ +# My Novel — 你自己的视觉小说起点 + +My Novel 是项目中最小的完整视觉小说：傍晚的小镇、一家酒吧和一处住宅，由选项连接起来。它没有角色、物品和战斗——只有场景、简短的剧本文件和它们的翻译。它生来就是供人复制的：改个名字，然后从这三个地点生长出你自己的故事。 + +从“开始游戏 → My Novel → 新游戏”进入。它是 **My Novel** 游戏（合集 `novel_template`）的内容。 + +![My Novel 中的酒吧：酒吧背景和一行文本“酒吧里温暖又喧闹，但今晚在这里没什么可做的。”.](assets/bar.jpg) + +## 里面有什么 + +```filestree +my_novel_game/ +├── manifest.json +├── scenes/ +│ ├── my_novel_town.json 城镇入口，游戏从这里开始 +│ ├── my_novel_bar.json 酒吧，带自己的环境音 +│ └── my_novel_home.json 住宅门厅 +├── scenarios/ +│ ├── my_novel_town.scenario +│ ├── my_novel_bar.scenario +│ └── my_novel_home.scenario +└── locale/ + ├── en.properties 模组名称和描述 + └── scenarios_.properties 剧本各行的翻译 +``` + +图片和酒吧的环境音都不在这个模组里：它们来自 **Town Pack**，这样模板才保持小巧，也示范了游戏如何复用共享内容。音乐来自 **Music Pack**；引擎模组是 2D 外壳、对话引擎和音频引擎。 + +## 故事的流向 + +小镇是枢纽。每次到访都显示同样的选择；酒吧和住宅各自通向返回的路。 + +```text + ┌────────────────────┐ + │ my_novel_town │ （起点） + │ “去哪儿？” │ + └──┬──────────────┬──┘ + 走进酒吧 回家 + ▼ ▼ + ┌──────────────┐ ┌──────────────┐ + │ my_novel_bar │ │ my_novel_home│ + └──────┬───────┘ └──────┬───────┘ + └─ 回到小镇 ─┘ +``` + +![My Novel 的城镇入口，也就是第一幕，配文“傍晚的小镇。路灯已经亮起，一阵凉风沿着石板路吹过。”.](assets/town.jpg) + +场景文件写明背景和环境音： + +```json +{ + "name": "my_novel_bar", + "defaultBackground": "bar/bar", + "defaultAmbient": "bar/bar_ambient" +} +``` + +与场景同名的剧本会在进入该场景时运行： + +```scenario +scene: my_novel_town +priority: 10 +--- +# The town is the hub: every visit shows the same choice. +text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro +select "Where to go?" key=my_novel/town/prompt +option "Go into the bar" key=my_novel/town/opt_bar -> :bar +option "Go back home" key=my_novel/town/opt_home -> :home + +:bar +switch_scene my_novel_bar +end + +:home +switch_scene my_novel_home +end +``` + +英文文本直接写在剧本里。每个 `key=` 指向该行在 `locale/scenarios_.properties` 中的翻译，比如西班牙语： + +```properties +my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines. +``` + +## 把它变成你的 + +1. **复制并重命名模组。** 用你的游戏名加 `_game` 后缀命名，例如 `harbor_game`。把文件夹名和 `manifest.json` 里的 `id` 改成同一个值，并把 `locale/*.properties` 中的键 `mod_my_novel_game_name` / `_desc` 改成 `mod_harbor_game_name` / `_desc`。 +2. **为它建一个游戏。** 在 **Mods & Collections → 合集** 中打开 My Novel 的结构并按 **复制**，然后在“故事”分组里把 `my_novel_game` 换成你的模组。入口场景在合集中设置（`"entry": { "scene": "my_novel_town" }`）。 +3. **按需重命名场景：** 场景的 `name`、它的文件、其剧本的 `scene:` 头以及每一个通向它的 `switch_scene` 都必须一致。 +4. **保留或替换美术。** 想保留小镇，就把 `town_pack` 留在 `depends` 里；或者添加自己的 `backgrounds/` 和 `sounds/`，并让 `defaultBackground` / `defaultAmbient` 指向它们。 + +## 第一处修改：添加一个地点 + +这是一次真实的编辑器操作，在 My Novel 里加入 Editor Tools 模组后进行。场景编辑器创建了 `my_novel_park` 场景，再在小镇剧本里敲入一个选项和一个标签： + +![打开 my_novel_town.scenario 的剧本编辑器：新增一行 `option "Go to the park" -> :park` 和一个新块 `:park / switch_scene my_novel_park / end`；状态栏显示文件已保存。](assets/edit-town-scenario.jpg) + +```scenario +option "Go to the park" -> :park + +:park +switch_scene my_novel_park +end +``` + +保存之后，小镇立刻给出新的去路，选择它就会打开新场景： + +![小镇的选择现在有三个选项：走进酒吧、Go to the park、回家。](assets/new-choice.jpg) + +想在自己的游戏里用上编辑器，可以在结构中加入 **Editor Tools** 模组，或者带着它们启动一次游戏： + +```text +godot --path . -- --game=novel_template --new --with-mods=editor_tools +``` + +没有 `key=` 的新行在任何语言下都显示字面文本；等故事准备好翻译时，再加键和译文。 + +## 如果不奏效 + +1. **某个选择哪儿也到不了。** `switch_scene` 的名字必须等于目标场景的 `name`，大小写也要一致。 +2. **某个场景没有文本。** 它剧本的 `scene:` 头必须写这个场景的名字。 +3. **别的语言下文本是英文。** 这一行没有 `key=`，或者该语言的 `scenarios_.properties` 里缺这个键。 +4. **背景全黑。** 背景名字拼错了，或者拥有这张图的模组不在 `depends` 里。 diff --git a/locale/en.properties b/locale/en.properties index 6fd29f8..56e082c 100644 --- a/locale/en.properties +++ b/locale/en.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = My Novel -mod_my_novel_game_desc = The novel template's own scenes and scenarios: a town with a bar and a home, connected by scene switches. Backgrounds and sound come from the town pack. +mod_my_novel_game_desc = The novel template's content: an evening town, a bar and a home connected by choices. Copy it, rename it and grow your own story from these three places. diff --git a/locale/es.properties b/locale/es.properties index b9d2187..768ae37 100644 --- a/locale/es.properties +++ b/locale/es.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = Mi novela -mod_my_novel_game_desc = Las escenas y escenarios propios de la plantilla de novela: una ciudad con un bar y una casa, unidos por cambios de escena. Los fondos y el sonido vienen del paquete de la ciudad. +mod_my_novel_game_desc = El contenido de la plantilla de novela: un pueblo al atardecer, un bar y una casa unidos por decisiones. Cópialo, renómbralo y haz crecer tu propia historia desde estos tres lugares. diff --git a/locale/ja.properties b/locale/ja.properties index 8d400b6..bd3a718 100644 --- a/locale/ja.properties +++ b/locale/ja.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = マイノベル -mod_my_novel_game_desc = ノベルテンプレート独自のシーンとシナリオ：バーと家のある町を、シーン切り替えでつないでいます。背景と音は町パックのものです。 +mod_my_novel_game_desc = ノベルテンプレートのコンテンツ:選択肢でつながった夕暮れの町、バー、家。コピーして名前を変え、この三つの場所から自分の物語を育てましょう。 diff --git a/locale/ko.properties b/locale/ko.properties index 2be32e2..6713981 100644 --- a/locale/ko.properties +++ b/locale/ko.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = 마이 노벨 -mod_my_novel_game_desc = 노벨 템플릿 자체의 장면과 시나리오: 바와 집이 있는 마을을 장면 전환으로 연결합니다. 배경과 소리는 마을 팩에서 가져옵니다. +mod_my_novel_game_desc = 노벨 템플릿의 콘텐츠: 선택지로 이어진 저녁의 마을, 바, 집. 복제하고 이름을 바꿔 이 세 장소에서 나만의 이야기를 키우세요. diff --git a/locale/ru.properties b/locale/ru.properties index f0e9942..35470e4 100644 --- a/locale/ru.properties +++ b/locale/ru.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = Моя новелла -mod_my_novel_game_desc = Собственные сцены и сценарии шаблона новеллы: город с баром и домом, связанные переходами между сценами. Фоны и звук берутся из городского пака. +mod_my_novel_game_desc = Контент шаблона новеллы: вечерний город, бар и дом, связанные выборами. Скопируйте, переименуйте — и вырастите свою историю из этих трёх мест. diff --git a/locale/vi.properties b/locale/vi.properties index d121c3e..c5052d3 100644 --- a/locale/vi.properties +++ b/locale/vi.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = Tiểu thuyết của tôi -mod_my_novel_game_desc = Các cảnh và kịch bản riêng của mẫu tiểu thuyết: một thị trấn có quán bar và ngôi nhà, nối với nhau bằng chuyển cảnh. Phông nền và âm thanh lấy từ gói thị trấn. +mod_my_novel_game_desc = Nội dung của mẫu tiểu thuyết: thị trấn chiều tối, quán bar và ngôi nhà nối nhau bằng các lựa chọn. Copy nó, đổi tên, rồi nuôi lớn câu chuyện của riêng bạn từ ba địa điểm này. diff --git a/locale/zh.properties b/locale/zh.properties index b78a908..23d50fa 100644 --- a/locale/zh.properties +++ b/locale/zh.properties @@ -1,2 +1,2 @@ mod_my_novel_game_name = 我的小说 -mod_my_novel_game_desc = 小说模板自己的场景和剧本：一座有酒吧和住宅的城镇，通过场景切换相连。背景和声音来自城镇素材包。 +mod_my_novel_game_desc = 小说模板的内容：傍晚的小镇、一家酒吧和一处住宅，由选项相连。复制它、改个名，就从这三个地点生长出你自己的故事。 diff --git a/manifest.json b/manifest.json index 04fa158..46fa970 100644 --- a/manifest.json +++ b/manifest.json @@ -3,7 +3,7 @@ "name": "My Novel", "version": "1.0.0", "author": "ct", - "description": "The novel template's own content: a town where you can go into a bar or back home, and a way back from both. Only scenes, scenarios and text; backgrounds and sound come from town_pack. Rename it after your game (_game) and grow your story from here.", + "description": "The novel template's content: an evening town, a bar and a home connected by choices. Copy it, rename it and grow your own story from these three places.", "category": "story", "depends": ["shell2d_base>=1", "dialog_base>=1", "audio_base>=1", "town_pack>=1", "music_pack>=1"] }