Add mod documentation in seven languages

docs/en.md

@@ -0,0 +1,52 @@
+# Scenario Studio — debugging and editing scenarios while the game runs
+
+Scenario Studio is a dock beside the running game that shows which scenario is playing and which line is on the screen. It can pause the dialog, step through it line by line, stop at breakpoints, move the next line, restart a scenario with the game's state rolled back, and change the scenario on the spot — and then shows the change in the game at once.
+
+It has two modes: **Novice** shows the story moment in plain blocks; **Author** shows the scenario text with line numbers.
+
+## Opening it
+
+A game that includes the Developer Tools toolset (mechanic *Scenario Studio*) has a **Studio** button — the quill — on its toolbar. The launch flag `--studio` opens the dock at start. The pictures below are from the Cthangover kitchen; edits went into a test layer, never into the game's own files.
+
+## Novice mode
+
+![The kitchen with the Studio dock on the right in Novice mode: scene home_kitchen, scenario home_kitchen_cooking, a layer badge; under "On screen now" the line "New line" and the question "A room equipped as a kitchen"; the answers Leave (goes to scene home_vestibule), Cook (action toggle_cooking_workbench) and New answer, each with "Choose where" and Edit; buttons "+ Line before the question" and "+ Answer"; the box "This change affects" with the target layer, and Apply at the bottom.](assets/studio-novice.jpg)
+
+The **Now** tab shows the moment on the screen: the line, the question and every answer with where it leads. **Edit** changes a text, **Choose where** changes where an answer leads (a label, another scene, the end), **+ Line** and **+ Answer** add to the moment. Every change shows in **This change affects** which mod or layer it will be written to.
+
+## Author mode, pausing and breakpoints
+
+![The dock in Author mode: Pause, Step, Continue, Resources and Restart on the transport bar; the scenario text of home_kitchen with line 6 — the select "A room fitted out as a kitchen" — marked by a red breakpoint dot and the ▶ marker of the current line; under it "after line 9" with + Line, + Choice, + Go to scene, and the target layer my_studio.](assets/dock-breakpoint.jpg)
+
+- **Pause** holds the dialog before its next line; **Step** runs one line; **Continue** goes on.
+- A click in the margin sets a **breakpoint**: the dialog stops before that line.
+- Dragging the **▶** marker to another line makes that line run next.
+- **+ Line**, **+ Choice**, **+ Go to scene** add after the current line; **Edit text** edits the whole scenario.
+
+## Apply and restart
+
+**Apply** writes the changes and restarts the scenario. Here a line "New line" was added before the question; after Apply it is on the screen:
+
+![The dock after Apply: on screen now "New line", the status "Applied to "my_studio": scenario restarted with rollback".](assets/dock-applied.jpg)
+
+**Restart** offers: the scenario again without rollback, the scenario again **with state rollback** (flags, items, the clock and the rest are put back as they were when the scenario started), the scene again, or continuing from the current label.
+
+## Inspecting state
+
+![The State tab: "Values can be changed to test another branch", the clock with day 24 and hour 23:00.](assets/dock-state.jpg)
+
+The **State** tab shows the game state grouped by owner: the clock, the variables of the running dialog, the quests the scenario refers to, the inventory and which scenarios already ran. Variables, item counts and quest status can be changed (Enter writes them into the game) to try another branch. **Scene** lists the scenarios of the current scene, **Map** shows the scenes and the ways between them (and where to drop new backgrounds), and **Log** records what happened:
+
+![The Log tab: entered home_kitchen, home_kitchen_cooking started, the edit "+6 → my_studio", restarts, "breakpoint, line 6", "next line moved to 5", "checkpoint in home_kitchen".](assets/dock-log.jpg)
+
+## Where changes are written
+
+- A mod installed as a folder can be changed in place.
+- Otherwise changes go to the game's **studio layer** (`user://studio/<game>`), which wins over every mod and leaves the mods untouched. The layer can be exported as a new mod, which is then added to the game's collection.
+- **Resources** re-reads backgrounds dropped into a mod or into the layer's `backgrounds/` folder while the game runs; a new scene can then be made on such a background from the Map tab.
+
+## If something goes wrong
+
+1. **There is no Studio button.** The game's collection does not include the studio; add the Developer Tools toolset or launch with `--studio`.
+2. **Step does nothing.** The dialog waits for an answer: pick one first.
+3. **Other players do not see a change.** Changes in the studio layer stay in this game on this computer; export the layer as a mod to share them.

docs/es.md

@@ -0,0 +1,52 @@
+# Scenario Studio — depura y edita escenarios con el juego en marcha
+
+Scenario Studio es un panel acoplado junto al juego en marcha que muestra qué escenario se está reproduciendo y qué línea hay en pantalla. Puede pausar el diálogo, avanzar línea a línea, detenerse en puntos de ruptura, mover la siguiente línea, reiniciar un escenario con el estado del juego revertido y cambiar el escenario al vuelo — y enseguida muestra el cambio en el juego.
+
+Tiene dos modos: **Principiante** muestra el momento de la historia en bloques sencillos; **Autor** muestra el texto del escenario con números de línea.
+
+## Cómo abrirlo
+
+Un juego que incluye el conjunto Developer Tools (la mecánica *Scenario Studio*) tiene un botón **Estudio** — la pluma — en su barra de herramientas. La opción de arranque `--studio` abre el panel nada más empezar. Las capturas de abajo son de la cocina de Cthangover; las ediciones se hicieron en una capa de prueba, nunca en los archivos del propio juego.
+
+## Modo Principiante
+
+![La cocina con el panel Estudio a la derecha en modo Principiante: escena home_kitchen, escenario home_kitchen_cooking, una insignia de capa; bajo «En pantalla ahora» la línea «Nueva línea» y la pregunta «Una habitación acondicionada como cocina»; las respuestas Salir (va a la escena home_vestibule), Cocinar (acción toggle_cooking_workbench) y una respuesta nueva, cada una con «Elige adónde» y Editar; los botones «+ Línea antes de la pregunta» y «+ Respuesta»; la caja «Este cambio afecta a» con la capa de destino, y Aplicar abajo.](assets/studio-novice.jpg)
+
+La pestaña **Ahora** muestra el momento en pantalla: la línea, la pregunta y cada respuesta con adónde lleva. **Editar** cambia un texto, **Elige adónde** cambia a dónde conduce una respuesta (una etiqueta, otra escena, el final), **+ Línea** y **+ Respuesta** añaden al momento. Cada cambio muestra en **Este cambio afecta a** en qué mod o capa se escribirá.
+
+## Modo Autor, pausa y puntos de ruptura
+
+![El panel en modo Autor: Pausa, Paso, Continuar, Recursos y Reiniciar en la barra de transporte; el texto del escenario de home_kitchen con la línea 6 — el select «Una habitación acondicionada como cocina» — marcada con un punto rojo de ruptura y el marcador ▶ de la línea actual; debajo, «tras la línea 9» con + Línea, + Elección, + Ir a escena, y la capa de destino my_studio.](assets/dock-breakpoint.jpg)
+
+- **Pausa** detiene el diálogo antes de su siguiente línea; **Paso** ejecuta una línea; **Continuar** sigue.
+- Un clic en el margen pone un **punto de ruptura**: el diálogo se detiene antes de esa línea.
+- Arrastrar el marcador **▶** a otra línea hace que esa línea sea la siguiente en ejecutarse.
+- **+ Línea**, **+ Elección**, **+ Ir a escena** añaden tras la línea actual; **Editar texto** edita el escenario entero.
+
+## Aplicar y reiniciar
+
+**Aplicar** escribe los cambios y reinicia el escenario. Aquí se añadió una línea «Nueva línea» antes de la pregunta; tras aplicar, ya está en pantalla:
+
+![El panel tras aplicar: en pantalla ahora «Nueva línea», el estado «Aplicado a «my_studio», escenario reiniciado con reversión».](assets/dock-applied.jpg)
+
+**Reiniciar** ofrece: el escenario de nuevo sin reversión, el escenario de nuevo **revirtiendo el estado** (las marcas, los objetos, el reloj y el resto vuelven a como estaban cuando empezó el escenario), la escena de nuevo, o continuar desde la etiqueta actual.
+
+## Inspeccionar el estado
+
+![La pestaña Estado: «Los valores se pueden cambiar para probar otra rama», el reloj con día 24 y hora 23:00.](assets/dock-state.jpg)
+
+La pestaña **Estado** muestra el estado del juego agrupado por dueño: el reloj, las variables del diálogo en curso, las misiones a las que remite el escenario, el inventario y qué escenarios ya se ejecutaron. Variables, cantidades de objetos y estado de misiones se pueden cambiar (Intro los escribe en el juego) para probar otra rama. **Escena** lista los escenarios de la escena actual, **Mapa** muestra las escenas y los caminos entre ellas (y dónde soltar fondos nuevos), y **Registro** apunta lo que ocurrió:
+
+![La pestaña Registro: entrada en home_kitchen, home_kitchen_cooking empezado, la edición «+6 → my_studio», reinicios, «punto de ruptura, línea 6», «siguiente línea movida a 5», «punto de control en home_kitchen».](assets/dock-log.jpg)
+
+## Dónde se escriben los cambios
+
+- Un mod instalado como carpeta se puede cambiar en el sitio.
+- Si no, los cambios van a la **capa de estudio** del juego (`user://studio/<game>`), que gana a todos los mods y los deja intactos. La capa se puede exportar como un mod nuevo, que luego se añade a la colección del juego.
+- **Recursos** vuelve a leer los fondos soltados en un mod o en la carpeta `backgrounds/` de la capa mientras el juego corre; sobre ese fondo se puede crear después una escena nueva desde la pestaña Mapa.
+
+## Si algo sale mal
+
+1. **No hay botón de Estudio.** La colección del juego no incluye el estudio; añade el conjunto Developer Tools o arranca con `--studio`.
+2. **Paso no hace nada.** El diálogo espera una respuesta: elige una primero.
+3. **Otros jugadores no ven un cambio.** Los cambios de la capa de estudio se quedan en este juego en este ordenador; exporta la capa como mod para compartirlos.

docs/ja.md

@@ -0,0 +1,52 @@
+# Scenario Studio — ゲームの実行中にシナリオをデバッグし、その場で編集する
+
+Scenario Studio は、実行中のゲームの脇に開くドックで、いまどのシナリオが再生され、どの行が画面に出ているかを示します。ダイアログを一時停止し、一行ずつステップ実行し、ブレークポイントで止め、次の行を付け替え、ゲームの状態を巻き戻してシナリオを再開始し、その場でシナリオを書き換えられます——そして変更はすぐにゲームの中に現れます。
+
+モードは二つ。**初心者**モードは物語の瞬間をシンプルなブロックで示し、**作者**モードは行番号付きのシナリオテキストを示します。
+
+## 開き方
+
+Developer Tools ツールセットを含むゲーム（メカニクス *Scenario Studio*）には、ツールバーに**スタジオ**ボタン——羽根ペン——があります。起動フラグ `--studio` を付けると、開始時にドックが開きます。以下の画像は Cthangover の台所でのものです。編集はテストレイヤーに入れてあり、ゲーム本来のファイルには触れていません。
+
+## 初心者モード
+
+![台所と、右側に初心者モードのスタジオドック: シーン home_kitchen、シナリオ home_kitchen_cooking、レイヤーのバッジ。「いま画面に」の下に行「新しい行」と質問「台所として整えられた部屋」、回答は「出る」（シーン home_vestibule へ）、「料理する」（行動 toggle_cooking_workbench）、新しい回答の三つで、それぞれ「行き先を選ぶ」と「編集」付き。ボタン「+ 質問の前に行」「+ 回答」。下部に「この変更が影響するもの」（目標レイヤー）と「適用」。](assets/studio-novice.jpg)
+
+**現在**タブは画面の瞬間を示します: 行、質問、そして各行き先付きの回答すべて。**編集**はテキストを直し、**行き先を選ぶ**は回答の行き先（ラベル、別のシーン、終わり）を変え、**+ 行**と**+ 回答**はその瞬間に足します。変更ごとに、**この変更が影響するもの**にどの MOD かレイヤーに書かれるかが表示されます。
+
+## 作者モード、一時停止、ブレークポイント
+
+![作者モードのドック: トランスポートバーに「一時停止」「ステップ」「続行」「リソース」「再開始」。home_kitchen のシナリオテキストの 6 行目——select「台所として整えられた部屋」——に赤いブレークポイントの点と現在行の ▶ マーカー。その下に「9 行目のあと」と「+ 行」「+ 選択肢」「+ シーンへ移動」、そして目標レイヤー my_studio。](assets/dock-breakpoint.jpg)
+
+- **一時停止**は次の行の前でダイアログを止め、**ステップ**は一行だけ実行し、**続行**はそのまま進めます。
+- 余白をクリックすると**ブレークポイント**が付きます: ダイアログはその行の前で止まります。
+- **▶** マーカーを別の行へドラッグすると、その行が次に実行されます。
+- **+ 行**、**+ 選択肢**、**+ シーンへ移動**は現在行のあとに追加し、**テキストを編集**はシナリオ全体を編集します。
+
+## 適用と再開始
+
+**適用**は変更を書き込み、シナリオを再開始します。ここでは質問の前に「新しい行」を足しました。適用後、それが画面に出ています:
+
+![適用後のドック: 画面には「新しい行」、状態は「「my_studio」に適用し、巻き戻してシナリオを再開始した」。](assets/dock-applied.jpg)
+
+**再開始**では選べます: ロールバックなしでもう一度、**状態を巻き戻して**もう一度（フラグ、持ち物、時計などがシナリオ開始時の状態へ戻ります）、シーンを入り直す、現在のラベルから続ける。
+
+## 状態の確認
+
+![状態タブ: 「値を変えて別の分岐を試せます」、時計は 24 日 23:00。](assets/dock-state.jpg)
+
+**状態**タブはゲームの状態を持ち主ごとに示します: 時計、進行中のダイアログの変数、シナリオが参照するクエスト、インベントリ、そしてどのシナリオがすでに実行されたか。変数、持ち物の数、クエストの状態は変えられ（Enter でゲームに書き込まれます）、別の分岐を試せます。**シーン**タブは現在のシーンのシナリオ一覧、**マップ**はシーンとその間の経路（新しい背景のドロップ先）を示し、**ログ**は何が起きたかを記録します:
+
+![ログタブ: home_kitchen に入った、home_kitchen_cooking が始まった、編集「+6 → my_studio」、再開始、「ブレークポイント、6 行目」、「次の行を 5 へ移動」、「home_kitchen のチェックポイント」。](assets/dock-log.jpg)
+
+## 変更の書き込み先
+
+- フォルダーとしてインストールされた MOD は、その場で書き換えられます。
+- それ以外の変更は、ゲームの**スタジオレイヤー**（`user://studio/<game>`）に入ります。レイヤーはどの MOD よりも優先され、MOD には触れません。レイヤーは新しい MOD として書き出せ、それをゲームのコレクションに追加します。
+- **リソース**は、ゲームの実行中に MOD やレイヤーの `backgrounds/` フォルダーへ置かれた背景を読み直します。その背景からなら、マップタブから新しいシーンを作れます。
+
+## うまくいかないとき
+
+1. **スタジオボタンがない。** そのゲームのコレクションにスタジオが入っていません。Developer Tools ツールセットを追加するか、`--studio` を付けて起動してください。
+2. **ステップが何もしない。** ダイアログが回答を待っています: 先に一つ選んでください。
+3. **他のプレイヤーに変更が見えない。** スタジオレイヤーの変更は、この PC のこのゲームの中にとどまります。共有するにはレイヤーを MOD として書き出してください。

docs/ko.md

@@ -0,0 +1,52 @@
+# Scenario Studio — 게임 실행 중에 시나리오를 디버그하고 편집하기
+
+Scenario Studio는 실행 중인 게임 옆에 열리는 도크로, 지금 어떤 시나리오가 재생되고 어떤 줄이 화면에 있는지 보여 줍니다. 대화를 일시 정지하고, 한 줄씩 진행하고, 중단점에서 멈추고, 다음 줄을 옮기고, 게임 상태를 되돌려 시나리오를 다시 시작하고, 그 자리에서 시나리오를 바꿀 수 있습니다 — 그리고 변경은 곧바로 게임에 나타납니다.
+
+모드는 두 가지입니다. **초보자** 모드는 이야기 장면을 단순한 블록으로 보여 주고, **작성자** 모드는 줄 번호가 붙은 시나리오 텍스트를 보여 줍니다.
+
+## 열기
+
+Developer Tools 도구 모음이 들어 있는 게임(메커니즘 *Scenario Studio*)에는 도구 모음에 **스튜디오** 버튼 — 깃펜 — 이 있습니다. 실행 플래그 `--studio`를 붙이면 시작할 때 도크가 열립니다. 아래의 그림은 Cthangover의 주방에서 찍은 것으로, 편집은 테스트 레이어에 기록되었고 게임 자체 파일은 건드리지 않았습니다.
+
+## 초보자 모드
+
+![주방과 오른쪽의 초보자 모드 스튜디오 도크: 장면 home_kitchen, 시나리오 home_kitchen_cooking, 레이어 배지. "지금 화면에" 아래에 줄 "새 줄"과 질문 "주방으로 꾸며진 방", 답변으로 나가기(장면 home_vestibule로), 요리하기(동작 toggle_cooking_workbench), 새 답변이 있고 각각에 갈 곳 선택과 편집이 붙어 있습니다. "+ 질문 앞에 줄"과 "+ 답변" 버튼, 아래쪽에 "이 변경이 영향을 주는 곳"(대상 레이어)과 적용.](assets/studio-novice.jpg)
+
+**지금** 탭은 화면의 장면을 보여 줍니다: 줄, 질문, 그리고 각 답변이 어디로 이어지는지. **편집**은 텍스트를 바꾸고, **갈 곳 선택**은 답변의 행선지(레이블, 다른 장면, 끝)를 바꾸며, **+ 줄**과 **+ 답변**은 그 장면에 더합니다. 변경마다 **이 변경이 영향을 주는 곳**에 어느 모드나 레이어에 기록될지 표시됩니다.
+
+## 작성자 모드, 일시 정지, 중단점
+
+![작성자 모드의 도크: 전송 막대에 일시 정지, 한 단계, 계속, 리소스, 다시 시작. home_kitchen의 시나리오 텍스트에서 6번째 줄 — select "주방으로 꾸며진 방" — 에 빨간 중단점과 현재 줄의 ▶ 표시가 있습니다. 그 아래 "9번째 줄 뒤"에 + 줄, + 선택지, + 장면으로 이동, 그리고 대상 레이어 my_studio.](assets/dock-breakpoint.jpg)
+
+- **일시 정지**는 다음 줄 앞에서 대화를 멈추고, **한 단계**는 한 줄만 실행하며, **계속**은 계속 진행합니다.
+- 여백을 클릭하면 **중단점**이 생깁니다: 대화가 그 줄 앞에서 멈춥니다.
+- **▶** 표시를 다른 줄로 끌면 그 줄이 다음에 실행됩니다.
+- **+ 줄**, **+ 선택지**, **+ 장면으로 이동**은 현재 줄 뒤에 더하고, **텍스트 편집**은 시나리오 전체를 편집합니다.
+
+## 적용과 다시 시작
+
+**적용**은 변경을 기록하고 시나리오를 다시 시작합니다. 여기서는 질문 앞에 "새 줄"을 추가했습니다. 적용 후 화면에 나타납니다:
+
+![적용 후의 도크: 화면에는 "새 줄", 상태는 ""my_studio"에 적용, 되돌려서 시나리오를 다시 시작함".](assets/dock-applied.jpg)
+
+**다시 시작**은 선택지를 제공합니다: 되돌리지 않고 시나리오 다시, **상태를 되돌려** 다시(플래그, 아이템, 시계 등이 시나리오가 시작했을 때의 상태로 돌아갑니다), 장면 다시, 현재 레이블에서 계속하기.
+
+## 상태 살펴보기
+
+![상태 탭: "값을 바꿔 다른 분기를 시험할 수 있습니다", 시계는 24일 23:00.](assets/dock-state.jpg)
+
+**상태** 탭은 게임 상태를 소유자별로 보여 줍니다: 시계, 진행 중인 대화의 변수, 시나리오가 참조하는 퀘스트, 인벤토리, 그리고 어떤 시나리오가 이미 실행됐는지. 변수, 아이템 개수, 퀘스트 상태는 바꿀 수 있고(Enter가 게임에 기록합니다), 이를 통해 다른 분기를 시험할 수 있습니다. **장면** 탭은 현재 장면의 시나리오를, **지도** 탭은 장면과 그 사이의 길(그리고 새 배경을 놓을 곳)을 보여 주고, **로그**는 무슨 일이 있었는지 기록합니다:
+
+![로그 탭: home_kitchen에 들어감, home_kitchen_cooking 시작, 편집 "+6 → my_studio", 다시 시작들, "중단점, 6번째 줄", "다음 줄을 5로 이동", "home_kitchen의 체크포인트".](assets/dock-log.jpg)
+
+## 변경이 기록되는 곳
+
+- 폴더로 설치된 모드는 그 자리에서 바꿀 수 있습니다.
+- 그 외의 변경은 게임의 **스튜디오 레이어**(`user://studio/<game>`)로 갑니다. 레이어는 모든 모드보다 우선하며 모드 자체는 건드리지 않습니다. 레이어는 새 모드로 내보낼 수 있고, 이를 게임 컬렉션에 추가하면 됩니다.
+- **리소스**는 게임이 실행되는 동안 모드나 레이어의 `backgrounds/` 폴더에 넣은 배경을 다시 읽습니다. 그런 배경 위로는 지도 탭에서 바로 새 장면을 만들 수 있습니다.
+
+## 문제가 생겼을 때
+
+1. **스튜디오 버튼이 없습니다.** 게임 컬렉션에 스튜디오가 들어 있지 않습니다. Developer Tools 도구 모음을 추가하거나 `--studio`로 실행하세요.
+2. **한 단계가 아무것도 하지 않습니다.** 대화가 답변을 기다리고 있습니다: 먼저 하나 고르세요.
+3. **다른 플레이어에게 변경이 보이지 않습니다.** 스튜디오 레이어의 변경은 이 컴퓨터의 이 게임에만 남습니다. 공유하려면 레이어를 모드로 내보내세요.

docs/ru.md

@@ -0,0 +1,52 @@
+# Scenario Studio — отладка и правка сценариев прямо во время игры
+
+Scenario Studio — это панель рядом с запущенной игрой, которая показывает, какой сценарий играет и какая строка сейчас на экране. Она умеет ставить диалог на паузу, идти по нему строка за строкой, останавливаться на точках останова, переносить следующую строку, перезапускать сценарий с откатом состояния игры и менять сценарий на ходу — и тут же показывает изменения в игре.
+
+Режима два: **Новичок** показывает сюжетный момент простыми блоками, **Автор** — текст сценария с номерами строк.
+
+## Как открыть
+
+У игры, в которую входит набор Developer Tools (механика *Scenario Studio*), на панели инструментов есть кнопка **Студия** — перо. Флаг запуска `--studio` открывает панель сразу при старте. Снимки ниже сделаны на кухне Cthangover; правки уходили в тестовый слой, а не в файлы самой игры.
+
+## Режим «Новичок»
+
+![Кухня с панелью «Студия» справа в режиме «Новичок»: сцена home_kitchen, сценарий home_kitchen_cooking, значок слоя; под «Сейчас на экране» реплика «Новая реплика» и вопрос «Комната оборудованная под кухню»; ответы «Выйти» (ведёт в сцену home_vestibule), «Готовить» (действие toggle_cooking_workbench) и новый ответ, у каждого — «Выбрать, куда» и «Изменить»; кнопки «+ Реплика до вопроса» и «+ Вариант ответа»; блок «Изменение затронет» с целевым слоем и кнопка «Применить» внизу.](assets/studio-novice.jpg)
+
+Вкладка **Сейчас** показывает момент на экране: реплику, вопрос и все ответы с тем, куда каждый ведёт. **Изменить** правит текст, **Выбрать, куда** меняет, куда ведёт ответ (метка, другая сцена, конец), **+ Реплика** и **+ Вариант ответа** добавляют к моменту. У каждой правки блок **Изменение затронет** показывает, в какой мод или слой она попадёт.
+
+## Режим «Автор», пауза и точки останова
+
+![Панель в режиме «Автор»: на транспортной панели «Пауза», «Шаг», «Дальше», «Ресурсы» и «Перезапуск»; текст сценария home_kitchen, где строка 6 — select «Комната оборудованная под кухню» — отмечена красной точкой останова и маркером ▶ текущей строки; под ней «после строки 9» с кнопками «+ Реплика», «+ Выбор», «+ Переход в сцену» и целевым слоем my_studio.](assets/dock-breakpoint.jpg)
+
+- **Пауза** задержит диалог перед следующей строкой; **Шаг** выполнит одну строку; **Дальше** продолжит.
+- Клик на поле слева ставит **точку останова**: диалог остановится перед этой строкой.
+- Перетаскивание маркера **▶** на другую строку назначает её следующей.
+- **+ Реплика**, **+ Выбор**, **+ Переход в сцену** добавляют после текущей строки; **Править текст** правит весь сценарий.
+
+## Применение и перезапуск
+
+**Применить** записывает правки и перезапускает сценарий. Здесь перед вопросом добавлена реплика «Новая реплика»; после применения она на экране:
+
+![Панель после применения: на экране «Новая реплика», статус «Применено в «my_studio», сценарий перезапущен с откатом».](assets/dock-applied.jpg)
+
+**Перезапуск** предлагает: прогнать сценарий заново без отката, прогнать заново **с откатом состояния** (флаги, предметы, часы и остальное вернутся к тому, как было при старте сценария), заново войти в сцену или продолжить с текущей метки.
+
+## Осмотр состояния
+
+![Вкладка «Состояние»: «Значения можно менять, чтобы попробовать другую ветку», часы — день 24, время 23:00.](assets/dock-state.jpg)
+
+Вкладка **Состояние** показывает состояние игры по владельцам: часы, переменные идущего диалога, задания, на которые ссылается сценарий, инвентарь и какие сценарии уже выполнялись. Переменные, количество предметов и статус заданий можно менять (Enter записывает их в игру), чтобы попробовать другую ветку. Вкладка **Сцена** перечисляет сценарии текущей сцены, **Карта** показывает сцены и пути между ними (и куда бросать новые фоны), а **Журнал** записывает, что происходило:
+
+![Вкладка «Журнал»: вход в home_kitchen, старт home_kitchen_cooking, правка «+6 → my_studio», перезапуски, «точка останова, строка 6», «следующая строка перенесена на 5», «контрольная точка в home_kitchen».](assets/dock-log.jpg)
+
+## Куда пишутся изменения
+
+- Мод, установленный папкой, можно менять на месте.
+- Иначе правки уходят в **слой студии** игры (`user://studio/<game>`), который главнее любого мода и не трогает сами моды. Слой можно выгрузить в новый мод, который затем добавляется в коллекцию игры.
+- **Ресурсы** перечитывает фоны, брошенные во время игры в мод или в папку `backgrounds/` слоя; после этого на таком фоне можно завести новую сцену прямо со вкладки «Карта».
+
+## Если что-то пошло не так
+
+1. **Кнопки «Студия» нет.** В коллекцию игры не входит студия — добавьте набор Developer Tools или запустите с `--studio`.
+2. **«Шаг» ничего не делает.** Диалог ждёт ответ: сначала выберите его.
+3. **Другие игроки не видят правку.** Изменения в слое студии остаются в этой игре на этом компьютере; выгрузите слой как мод, чтобы поделиться.

docs/vi.md

@@ -0,0 +1,52 @@
+# Scenario Studio — gỡ lỗi và chỉnh sửa kịch bản khi trò chơi đang chạy
+
+Scenario Studio là một bảng gắn bên cạnh trò chơi đang chạy, cho biết kịch bản nào đang chơi và dòng nào đang hiện trên màn hình. Nó có thể tạm dừng hội thoại, đi từng dòng một, dừng ở điểm ngắt, dịch dòng tiếp theo, khởi động lại kịch bản với trạng thái game được hoàn lại, và sửa kịch bản ngay tại chỗ — rồi lập tức hiện thay đổi trong game.
+
+Nó có hai chế độ: **Người mới** hiển thị khoảnh khắc câu chuyện bằng các khối đơn giản; **Tác giả** hiển thị văn bản kịch bản với số dòng.
+
+## Mở nó
+
+Trò chơi có bộ Developer Tools (cơ chế *Scenario Studio*) sẽ có nút **Xưởng** — cây bút lông — trên thanh công cụ. Cờ khởi động `--studio` mở bảng ngay khi bắt đầu. Các hình dưới đây chụp từ căn bếp của Cthangover; các chỉnh sửa được ghi vào một lớp thử nghiệm, không đụng tới tệp của game.
+
+## Chế độ Người mới
+
+![Căn bếp với bảng Xưởng bên phải ở chế độ Người mới: cảnh home_kitchen, kịch bản home_kitchen_cooking, huy hiệu lớp; dưới "Đang trên màn hình" là dòng "Dòng mới" và câu hỏi "Một căn phòng được biến thành bếp"; các câu trả lời Rời đi (chuyển tới cảnh home_vestibule), Nấu ăn (hành động toggle_cooking_workbench) và một câu trả lời mới, mỗi cái có "Chọn nơi đến" và Sửa; các nút "+ Dòng trước câu hỏi" và "+ Câu trả lời"; hộp "Thay đổi này ảnh hưởng đến" với lớp đích, và Áp dụng ở dưới.](assets/studio-novice.jpg)
+
+Thẻ **Hiện tại** hiển thị khoảnh khắc trên màn hình: dòng, câu hỏi và từng câu trả lời cùng nơi nó dẫn tới. **Sửa** đổi một đoạn văn bản, **Chọn nơi đến** đổi nơi một câu trả lời dẫn tới (một nhãn, cảnh khác, hay kết thúc), **+ Dòng** và **+ Câu trả lời** thêm vào khoảnh khắc. Mỗi thay đổi đều cho biết trong **Thay đổi này ảnh hưởng đến** rằng nó sẽ được ghi vào mod hay lớp nào.
+
+## Chế độ Tác giả, tạm dừng và điểm ngắt
+
+![Bảng ở chế độ Tác giả: Tạm dừng, Từng bước, Tiếp tục, Tài nguyên và Khởi động lại trên thanh điều khiển; văn bản kịch bản của home_kitchen với dòng 6 — câu select "Một căn phòng được biến thành bếp" — được đánh dấu chấm đỏ điểm ngắt và ký hiệu ▶ của dòng hiện tại; bên dưới là "sau dòng 9" với + Dòng, + Lựa chọn, + Đến cảnh, và lớp đích my_studio.](assets/dock-breakpoint.jpg)
+
+- **Tạm dừng** giữ hội thoại trước dòng tiếp theo; **Từng bước** chạy một dòng; **Tiếp tục** chơi tiếp.
+- Bấm vào lề là đặt một **điểm ngắt**: hội thoại dừng trước dòng đó.
+- Kéo ký hiệu **▶** sang dòng khác sẽ khiến dòng đó chạy tiếp theo.
+- **+ Dòng**, **+ Lựa chọn**, **+ Đến cảnh** thêm vào sau dòng hiện tại; **Sửa văn bản** sửa cả kịch bản.
+
+## Áp dụng và khởi động lại
+
+**Áp dụng** ghi các thay đổi và chạy lại kịch bản. Ở đây một dòng "Dòng mới" được thêm trước câu hỏi; sau khi áp dụng nó đã hiện trên màn hình:
+
+![Bảng sau khi áp dụng: trên màn hình là "Dòng mới", trạng thái "Đã áp dụng cho "my_studio", kịch bản được khởi động lại và hoàn trạng thái".](assets/dock-applied.jpg)
+
+**Khởi động lại** đưa ra các lựa chọn: chạy lại kịch bản không hoàn trạng thái, chạy lại **có hoàn trạng thái** (cờ, vật phẩm, đồng hồ và mọi thứ trở lại như khi kịch bản bắt đầu), vào lại cảnh, hay tiếp tục từ nhãn hiện tại.
+
+## Xem trạng thái
+
+![Thẻ Trạng thái: "Có thể đổi các giá trị để thử nhánh khác", đồng hồ chỉ ngày 24 giờ 23:00.](assets/dock-state.jpg)
+
+Thẻ **Trạng thái** hiển thị trạng thái game theo từng chủ sở hữu: đồng hồ, các biến của hội thoại đang chạy, các nhiệm vụ mà kịch bản nhắc tới, túi đồ và những kịch bản đã chạy. Biến, số lượng vật phẩm và trạng thái nhiệm vụ có thể đổi (Enter ghi chúng vào game) để thử nhánh khác. **Cảnh** liệt kê các kịch bản của cảnh hiện tại, **Bản đồ** cho thấy các cảnh và đường đi giữa chúng (và nơi thả phông nền mới), còn **Nhật ký** ghi lại những gì đã xảy ra:
+
+![Thẻ Nhật ký: vào home_kitchen, home_kitchen_cooking bắt đầu, chỉnh sửa "+6 → my_studio", các lần khởi động lại, "điểm ngắt, dòng 6", "dòng tiếp theo chuyển tới 5", "điểm kiểm tra trong home_kitchen".](assets/dock-log.jpg)
+
+## Thay đổi được ghi vào đâu
+
+- Mod cài dưới dạng thư mục có thể được sửa trực tiếp.
+- Nếu không, thay đổi sẽ vào **lớp xưởng** của game (`user://studio/<game>`), lớp này thắng mọi mod và không đụng tới các mod. Lớp có thể được xuất thành mod mới, rồi thêm vào bộ sưu tập của game.
+- **Tài nguyên** đọc lại các phông nền thả vào mod hoặc vào thư mục `backgrounds/` của lớp trong khi game chạy; sau đó có thể tạo cảnh mới trên phông nền đó ngay từ thẻ Bản đồ.
+
+## Khi có trục trặc
+
+1. **Không có nút Xưởng.** Bộ sưu tập của game không chứa xưởng; hãy thêm bộ Developer Tools hoặc chạy với `--studio`.
+2. **Từng bước không làm gì.** Hội thoại đang chờ một câu trả lời: hãy chọn một cái trước.
+3. **Người chơi khác không thấy thay đổi.** Thay đổi trong lớp xưởng chỉ ở lại game này trên máy này; hãy xuất lớp thành mod để chia sẻ.

docs/zh.md

@@ -0,0 +1,52 @@
+# Scenario Studio — 游戏运行时调试与编辑剧本
+
+Scenario Studio 是一个停靠在运行中游戏旁边的面板，会显示当前播放的是哪个剧本、屏幕上正停在哪一行。它可以暂停对话、逐行单步执行、停在断点上、挪动下一行、带着回滚的游戏状态重启剧本，还能当场修改剧本——并且立刻把改动呈现到游戏里。
+
+它有两种模式：**新手**模式用简单的块面呈现剧情时刻；**作者**模式显示带行号的剧本文本。
+
+## 打开方式
+
+包含 Developer Tools 工具集的游戏（机制 *Scenario Studio*）工具栏上有一个**工作室**按钮——羽毛笔。启动参数 `--studio` 会在开局时直接打开面板。下面的截图来自 Cthangover 的厨房；编辑都写进了测试层，没有碰游戏自己的文件。
+
+## 新手模式
+
+![厨房场景，右侧是新手模式下的工作室面板：场景 home_kitchen、剧本 home_kitchen_cooking、一个层徽标；「当前画面」下方是台词「新台词」和问题「一间布置成厨房的房间」；回答有「离开」（前往场景 home_vestibule）、「做饭」（动作 toggle_cooking_workbench）和「新回答」，每项都带「选择去向」和「编辑」；按钮「+ 在问题前加台词」和「+ 回答」；底部是「此修改影响」框（显示目标层）和「应用」。](assets/studio-novice.jpg)
+
+**现在**标签页显示屏幕上的时刻：台词、问题和每个回答的去向。**编辑**修改文本，**选择去向**修改一个回答指向哪里（某个标签、另一个场景或结尾），**+ 台词**和**+ 回答**往这个时刻里添加内容。每处修改都会在**此修改影响**里显示将写入哪个模组或哪一层。
+
+## 作者模式：暂停与断点
+
+![作者模式下的面板：传输栏上有「暂停」「单步」「继续」「资源」「重启」；home_kitchen 的剧本文本中，第 6 行——select「一间布置成厨房的房间」——标着红色断点和当前行的 ▶ 标记；下方是「第 9 行之后」，带「+ 台词」「+ 选项」「+ 前往场景」和目标层 my_studio。](assets/dock-breakpoint.jpg)
+
+- **暂停**让对话停在下一行之前；**单步**执行一行；**继续**照常往下走。
+- 在边栏点一下即可设置**断点**：对话会在那一行之前停下。
+- 把 **▶** 标记拖到另一行，就能让那一行成为下一行。
+- **+ 台词**、**+ 选项**、**+ 前往场景**添加在当前行之后；**编辑文本**编辑整个剧本。
+
+## 应用与重启
+
+**应用**会写入改动并重启剧本。这里在问题前加了一行「新台词」；应用之后它已经显示在画面上：
+
+![应用后的面板：画面上是「新台词」，状态为「已应用到"my_studio"，剧本已回滚并重启」。](assets/dock-applied.jpg)
+
+**重启**提供几种选择：不带回滚地重跑剧本、**带状态回滚**重跑（标记、物品、时钟等都会回到剧本开始时的样子）、重进场景，或从当前标签继续。
+
+## 检查状态
+
+![状态标签页：「可以修改数值来尝试其他分支」，时钟显示第 24 天 23:00。](assets/dock-state.jpg)
+
+**状态**标签页按归属分组显示游戏状态：时钟、正在进行的对话的变量、剧本引用到的任务、背包，以及哪些剧本已经运行过。变量、物品数量和任务状态都可以修改（按 Enter 写入游戏），以便尝试其他分支。**场景**列出当前场景的剧本，**地图**显示各场景及其间的通路（以及可以把新背景拖放到的位置），**日志**记录发生的事情：
+
+![日志标签页：进入 home_kitchen、home_kitchen_cooking 启动、修改「+6 → my_studio」、多次重启、「断点，第 6 行」、「下一行移到 5」、「home_kitchen 中的检查点」。](assets/dock-log.jpg)
+
+## 改动写到哪里
+
+- 以文件夹形式安装的模组可以就地修改。
+- 否则改动会进入游戏的**工作室层**（`user://studio/<game>`），它的优先级高于所有模组，且不会碰模组本身。这一层可以导出为新模组，再加入游戏的合集中。
+- **资源**会重新读取游戏运行时拖入模组或层的 `backgrounds/` 文件夹的背景；之后可以在「地图」标签页直接用这样的背景新建场景。
+
+## 出问题了怎么办
+
+1. **没有工作室按钮。** 游戏的合集没包含工作室；添加 Developer Tools 工具集，或用 `--studio` 启动。
+2. **单步没有反应。** 对话正在等待回答：先选一个。
+3. **其他玩家看不到改动。** 工作室层里的修改只留在这台电脑的这个游戏里；把层导出为模组即可分享。