@vnejs/docs 0.2.65 → 0.2.66

package/scenario.guide/qte-random.md

@@ -1,50 +1,50 @@
-# QTE и random
+# QTE and random
 
 ## % qte
 
-Quick Time Event по id из параметров игры (`PARAMS.QTE.ITEMS`).
+A quick time event by id from the game params (`PARAMS.QTE.ITEMS`).
 
 ```vne
 % qte door_lock
-  "Успех — тело indented-блока"
-"Провал или после блока — следующая строка"
+  "Success — the indented body"
+"Fail, or after the block — the next line"
 ```
 
-| Исход                 | Поведение                               |
-| --------------------- | --------------------------------------- |
-| Success               | `curLine` на первую строку внутри блока |
-| Fail / неизвестный id | Пропуск indented-блока                  |
+| Result            | Behavior                                           |
+| ----------------- | -------------------------------------------------- |
+| Success           | `curLine` moves to the first line inside the block |
+| Fail / unknown id | Skip the indented block                            |
 
-UI — [`../plugins/views.scenario/qte.md`](../plugins/views.scenario/qte.md).
+The UI is [`../plugins/views.scenario/qte.md`](../plugins/views.scenario/qte.md).
 
-### QTE на опции choose
+### QTE on a choose option
 
-Нужен compatibility choose↔qte в бандле:
+The bundle needs choose↔qte compatibility:
 
 ```vne
 % choose
-  % choose.option "Рискнуть"
+  % choose.option "Take the risk"
     qte: easy
-    "Успех QTE"
-  % choose.option "Сдаться" | qte-fallback
-    "Прямой выбор или fail QTE"
+    "QTE success"
+  % choose.option "Give up" | qte-fallback
+    "A direct pick, or a failed QTE"
 ```
 
-Keyword `| qte-fallback` помечает ветку при провале.
+The keyword `| qte-fallback` marks the branch used on failure.
 
 ## % random
 
-Случайно выбирает одну из вложенных `% random.option`:
+Picks one nested `% random.option` at random:
 
 ```vne
 % random
   % random.option
-    "Ветка A"
+    "Branch A"
   % random.option
-    "Ветка B"
+    "Branch B"
 ```
 
-## См. также
+## See also
 
 - [`../plugins/scenario/qte.md`](../plugins/scenario/qte.md)
 - [`../plugins/scenario/random.md`](../plugins/scenario/random.md)

package/scenario.guide/vars.md

@@ -1,6 +1,6 @@
-# Переменные: flag и counter
+# Variables: flag and counter
 
-## flag — булевы флаги
+## flag — boolean flags
 
 ```vne
 $ flag seen
@@ -9,25 +9,25 @@ $ flag seen unset
 $ flag seen unset | global
 ```
 
-| Форма                 | Смысл                                                         |
-| --------------------- | ------------------------------------------------------------- |
-| `$ flag <name>`       | Установить (set)                                              |
-| `$ flag <name> set`   | Явный set                                                     |
-| `$ flag <name> unset` | Снять                                                         |
-| `\| global`           | Глобальный (между прохождениями / слотами — по правилам vars) |
+| Form                  | Meaning                                                  |
+| --------------------- | -------------------------------------------------------- |
+| `$ flag <name>`       | Set the flag                                             |
+| `$ flag <name> set`   | Set the flag explicitly                                  |
+| `$ flag <name> unset` | Clear the flag                                           |
+| `\| global`           | Global (across playthroughs / slots — by the vars rules) |
 
-### Условный блок `% flag`
+### Conditional block `% flag`
 
 ```vne
 % flag testsFlags1
-  "Тело выполнится, если флаг установлен"
+  "The body runs when the flag is set"
 % flag testsFlags5 unset
-  "Тело, если флаг снят"
+  "The body runs when the flag is clear"
 % flag testsFlags1 | global
-  "Проверка глобального флага"
+  "Check a global flag"
 ```
 
-## counter — числа
+## counter — numbers
 
 ```vne
 $ counter n ++
@@ -38,9 +38,9 @@ $ counter n = 10
 $ counter n ++ | global
 ```
 
-Операции изменения: `++`, `--`, `+=`, `-=`, `=`.
+Change ops: `++`, `--`, `+=`, `-=`, `=`.
 
-### Условный блок `% counter`
+### Conditional block `% counter`
 
 ```vne
 % counter n > 0
@@ -49,19 +49,19 @@ $ counter n ++ | global
   "…"
 ```
 
-Сравнения: `>`, `>=`, `===`, `!==`, `<`, `<=`.
+Comparisons: `>`, `>=`, `===`, `!==`, `<`, `<=`.
 
-### В props опций
+### In option props
 
 ```vne
 % choose.option "+1"
   disabled: $ counter n > 0 | global
   $ counter n ++ | global
-% choose.option "Обнулить"
+% choose.option "Reset"
   hided: $ counter n === 0 | global
   $ counter n = 0 | global
 ```
 
-## См. также
+## See also
 
 - [`../plugins/vars/flags.md`](../plugins/vars/flags.md), [`counters.md`](../plugins/vars/counters.md)

package/scenario.guide/views.md

@@ -1,6 +1,6 @@
-# UI и экраны
+# UI and screens
 
-## interface (ADV / UI сценария)
+## interface (ADV / scenario UI)
 
 ```vne
 $ interface show
@@ -8,9 +8,9 @@ $ interface hide
 $ interface view adv
 ```
 
-Действия: `show`, `hide`, `view` (режим/вид интерфейса — значение из игры, часто `adv`).
+Actions: `show`, `hide`, `view` (the interface mode or view — a game value, often `adv`).
 
-## Экраны
+## Screens
 
 ```vne
 $ intro
@@ -21,34 +21,34 @@ $ credits hide
 $ settings.defaults
 ```
 
-| Команда                   | Смысл                                        |
-| ------------------------- | -------------------------------------------- |
-| `$ intro`                 | Интро-экран                                  |
-| `$ disclaimer show <id>`  | Дисклеймер (title/text/accept по id из locs) |
-| `$ mainmenu`              | Главное меню                                 |
-| `$ credits show` / `hide` | Титры                                        |
-| `$ settings.defaults`     | Сброс/дефолты настроек (по плагину)          |
+| Command                   | Meaning                                        |
+| ------------------------- | ---------------------------------------------- |
+| `$ intro`                 | Intro screen                                   |
+| `$ disclaimer show <id>`  | Disclaimer (title/text/accept by id from locs) |
+| `$ mainmenu`              | Main menu                                      |
+| `$ credits show` / `hide` | Credits                                        |
+| `$ settings.defaults`     | Reset settings to defaults (by the plugin)     |
 
-Точный момент вызова (из `init`, из меню) задаёт сценарий игры.
+The game scenario decides when to call these (from `init`, from a menu).
 
 ## video / comment / achievement
 
 ```vne
 $ video play {cutscene/01}
-$ comment "Подсказка игроку" 5000
+$ comment "A hint for the player" 5000
 $ achievement unlock some_id
 $ achievement lock some_id
 ```
 
-| Модуль        | Действия                                 |
-| ------------- | ---------------------------------------- |
-| `video`       | `play`                                   |
-| `comment`     | текст + опционально длительность; `hide` |
-| `achievement` | `lock`, `unlock`                         |
+| Module        | Actions                                |
+| ------------- | -------------------------------------- |
+| `video`       | `play`                                 |
+| `comment`     | text plus an optional duration; `hide` |
+| `achievement` | `lock`, `unlock`                       |
 
 ## wallet / time / date
 
-Реже в диалогах, но есть в каталоге команд:
+Less common in dialogue, but present in the command catalog:
 
 ```vne
 $ wallet add …
@@ -60,7 +60,7 @@ $ date add …
 $ date set …
 ```
 
-## См. также
+## See also
 
 - [`../plugins/views.scenario/interface.md`](../plugins/views.scenario/interface.md)
 - Screens: [`../plugins/views.screens/`](../plugins/views.screens/)