docs: explain ambient scenarios and shared expressions

Describe independent ambient executions and their editing/debugging through npc_barks_base. Extend localized guidance on expressions_base calculations.

docs/en.md

@@ -101,3 +101,9 @@ Scenarios of all mods are collected together. A mod adds a story to someone else
 ## Shared expressions
 
 Numeric expressions are supplied by `expressions_base`. Use `set money=rnd(3,5)` or `cset total "1+2+${money}"`; reuse `${money}` in localized text and action parameters. `set name value` still stores a literal string. See the [Expression Engine guide](../../expressions_base/docs/en.md) for syntax, strict assignments and mod-defined strategies.
+
+## Concurrent background scenarios
+
+`channel: ambient` runs through `npc_barks_base` outside the modal dialog queue. Each execution has its own variables, waits, roles and debugger. Scenario Editor validates/saves the source and F5 previews its buffer. Studio → Background lists definitions and runs; pause, step, breakpoints and clock advance target one execution.
+
+[npc_barks_base](../../npc_barks_base/docs/en.md)

docs/es.md

@@ -97,3 +97,13 @@ Los escenarios de todos los mods se reúnen en un mismo conjunto. Un mod añade
 2. **La línea aparece en otro idioma.** Falta la clave `key=` en los archivos `locale` del mod para ese idioma, y se muestra el texto entrecomillado.
 3. **Una respuesta no lleva a ninguna parte.** La etiqueta tras `->` debe existir en el mismo archivo, escrita con dos puntos (`:bar`).
 4. **Una `action` no hace nada.** El mod dueño de la acción no forma parte del juego (el registro dice que la acción "is not registered") o hay un nombre de parámetro equivocado: compáralo con la acción en el editor de escenarios de Editor Tools.
+
+## Escenarios de fondo simultáneos
+
+`channel: ambient` usa `npc_barks_base` fuera del diálogo modal. Cada ejecución conserva sus variables, esperas, roles y depurador. Scenario Editor valida y guarda; F5 prueba el búfer. Studio → Background muestra definiciones y ejecuciones, con pausa, pasos, puntos de ruptura y reloj independientes.
+
+[npc_barks_base](../../npc_barks_base/docs/en.md)
+
+## Expresiones compartidas
+
+`expressions_base` aporta los cálculos: `set money=rnd(3,5)` guarda un entero inclusivo, `cset total "1+2+${money}"` calcula una expresión. `set name value` conserva texto literal. Los errores detienen el diálogo antes de las acciones dependientes. Véase la [guía del motor de expresiones](../../expressions_base/docs/en.md) para la sintaxis y las extensiones.

docs/ja.md

@@ -97,3 +97,13 @@ save_allowed: true
 2. **台詞が別の言語で表示される。** その言語の翻訳キー `key=` が mod の `locale` ファイルになく、引用したテキストがそのまま表示されています。
 3. **選択肢がどこにも行かない。** `->` の後のラベルは、同じファイル内にコロン付き（`:bar`）で存在しなければなりません。
 4. **`action` が何もしない。** アクションを持つ mod がゲームに含まれていない（ログに "is not registered" と出ます）か、パラメーター名が間違っています。Editor Tools のシナリオエディターで該当アクションと見比べてください。
+
+## 並行する背景シナリオ
+
+`channel: ambient` は `npc_barks_base` によりモーダル会話の外で実行されます。変数、待機、役割、デバッガーは実行ごとに独立します。シナリオエディターは検証と保存、F5 はバッファーの試行を行います。Studio → Background では定義と実行を選び、個別に一時停止、ステップ、ブレークポイント、時計を操作できます。
+
+[npc_barks_base](../../npc_barks_base/docs/en.md)
+
+## 共通の式
+
+`expressions_base` が計算を提供します。`set money=rnd(3,5)` は両端を含む整数、`cset total "1+2+${money}"` は式の結果を保存します。`set name value` は文字列のままです。誤りがあれば後続のアクションの前に会話を停止します。構文と拡張は[式エンジンのガイド](../../expressions_base/docs/en.md)を参照してください。

docs/ko.md

@@ -97,3 +97,13 @@ save_allowed: true
 2. **대사가 다른 언어로 표시됩니다.** 해당 언어의 번역 키 `key=`가 mod의 `locale` 파일에 없어서 따옴표 안의 텍스트가 그대로 보입니다.
 3. **선택지가 어디로도 이어지지 않습니다.** `->` 뒤의 레이블은 같은 파일 안에 콜론을 붙여(`:bar`) 존재해야 합니다.
 4. **`action`이 아무것도 하지 않습니다.** 액션을 소유한 mod가 게임에 없거나(로그에 "is not registered"라고 기록됨), 매개변수 이름이 틀렸습니다. Editor Tools의 시나리오 편집기에서 해당 액션과 비교해 보세요.
+
+## 동시 배경 시나리오
+
+`channel: ambient`는 `npc_barks_base`를 통해 모달 대화 밖에서 실행됩니다. 각 실행의 변수, 대기, 역할, 디버거는 독립적입니다. 시나리오 편집기에서 검증하고 저장하며 F5로 버퍼를 미리 실행합니다. Studio → Background에서 정의와 실행을 선택해 개별 일시 정지, 단계 실행, 중단점, 시계를 제어합니다.
+
+[npc_barks_base](../../npc_barks_base/docs/en.md)
+
+## 공통 표현식
+
+`expressions_base`가 계산을 제공합니다. `set money=rnd(3,5)`는 양 끝을 포함한 정수, `cset total "1+2+${money}"`는 식의 결과를 저장합니다. `set name value`는 문자열을 그대로 저장합니다. 오류가 나면 의존 액션 전에 대화를 멈춥니다. 문법과 확장은 [표현식 엔진 가이드](../../expressions_base/docs/en.md)를 참고하세요.

docs/ru.md

@@ -101,3 +101,9 @@ save_allowed: true
 ## Общие выражения
 
 Вычисления предоставляет `expressions_base`. `set money=rnd(3,5)` выбирает целое число; `cset total "1+2+${money}"` вычисляет выражение. `${money}` используется в локализованном тексте и параметрах действий. `set имя значение` сохраняет строку как раньше. Синтаксис и расширение стратегиями описаны в [руководстве движка выражений](../../expressions_base/docs/ru.md).
+
+## Параллельные фоновые сценарии
+
+`channel: ambient` запускается через `npc_barks_base` вне основной очереди диалогов. У каждого исполнения свои переменные, ожидания, роли и отладчик. Редактор проверяет и сохраняет исходник; F5 запускает буфер. Студия → Фоновые показывает исходники и исполнения: пауза, шаг, точки останова и часы относятся к выбранному исполнению.
+
+[npc_barks_base](../../npc_barks_base/docs/ru.md)

docs/vi.md

@@ -97,3 +97,13 @@ Kịch bản của mọi mod được gom chung với nhau. Một mod thêm câu
 2. **Câu thoại hiện sai ngôn ngữ.** Thiếu khóa `key=` trong các tệp `locale` của mod cho ngôn ngữ đó; văn bản trong ngoặc kép được hiển thị thay thế.
 3. **Lựa chọn dẫn đến hư không.** Nhãn sau `->` phải tồn tại trong cùng tệp, viết kèm dấu hai chấm (`:bar`).
 4. **`action` không làm gì cả.** Mod sở hữu hành động không có trong game (log ghi hành động "is not registered"), hoặc tên tham số sai — hãy so với hành động trong trình soạn thảo kịch bản của Editor Tools.
+
+## Kịch bản nền đồng thời
+
+`channel: ambient` chạy qua `npc_barks_base` ngoài hàng đợi hội thoại modal. Mỗi lần chạy có biến, chờ, vai trò và trình gỡ lỗi riêng. Scenario Editor kiểm tra/lưu; F5 chạy thử bộ đệm. Studio → Background liệt kê định nghĩa và lần chạy; tạm dừng, bước, điểm dừng và đồng hồ chỉ tác động lần chạy được chọn.
+
+[npc_barks_base](../../npc_barks_base/docs/en.md)
+
+## Biểu thức dùng chung
+
+`expressions_base` cung cấp phép tính: `set money=rnd(3,5)` lưu số nguyên gồm hai đầu mút, `cset total "1+2+${money}"` tính biểu thức. `set name value` vẫn lưu chuỗi nguyên văn. Lỗi dừng hội thoại trước hành động phụ thuộc. Xem [hướng dẫn bộ biểu thức](../../expressions_base/docs/en.md) về cú pháp và mở rộng.

docs/zh.md

@@ -97,3 +97,13 @@ save_allowed: true
 2. **台词显示成了别的语言。** 该语言的翻译键 `key=` 在 mod 的 `locale` 文件里缺失，于是显示引号里的原文。
 3. **选项跳了个空。** `->` 后面的标签必须存在于同一文件中，并带冒号（`:bar`）。
 4. **`action` 没有反应。** 动作所属的 mod 不在游戏内（日志提示动作 "is not registered"），或者参数名写错——与 Editor Tools 剧本编辑器中的动作对照一下。
+
+## 并发背景剧本
+
+`channel: ambient` 由 `npc_barks_base` 在模态对话队列之外执行。每次执行都有独立变量、等待、角色和调试器。剧本编辑器验证并保存，F5 预览当前缓冲区。Studio → Background 分别列出定义与执行；暂停、单步、断点和时钟只针对选中的执行。
+
+[npc_barks_base](../../npc_barks_base/docs/en.md)
+
+## 共享表达式
+
+`expressions_base` 提供计算：`set money=rnd(3,5)` 保存含端点的随机整数，`cset total "1+2+${money}"` 计算表达式。`set name value` 仍保存字面文本。错误会在后续依赖动作执行前停止对话。语法及扩展见[表达式引擎指南](../../expressions_base/docs/en.md)。