@vnejs/docs 0.2.1

package/scenario.guide/point-and-click.md

@@ -0,0 +1,35 @@
+# Point-and-click: % point-and-click
+
+Hotspot-выбор на фоне. UI — view-плагин; ветки — как у choose.
+
+```vne
+% point-and-click
+  % point-and-click.option {lupa} 25 25
+    hided: $ flag pac_1
+    $ flag pac_1
+    "Нашли предмет."
+    $ point-and-click repeat
+  % point-and-click.option {pencil} 50 50
+    hided: $ flag pac_2
+    $ flag pac_2
+    "Другая точка."
+    $ point-and-click repeat
+"Все точки осмотрены — сценарий продолжается."
+```
+
+## Команды
+
+| Синтаксис | Смысл |
+|-----------|--------|
+| `% point-and-click` | Открыть режим; собрать `.option` |
+| `% point-and-click.option {icon} x y` | Hotspot: иконка + координаты |
+| `$ point-and-click repeat` | Вернуться к ближайшему `% point-and-click` выше |
+
+`x` / `y` — числа (проценты/координаты UI — по конвенции игры). `{icon}` — id иконки из медиа.
+
+Props `hided:` / `disabled:` — как у choose.
+
+## См. также
+
+- [`../plugins/scenario/point_and_click.md`](../plugins/scenario/point_and_click.md)
+- View: [`../plugins/views.scenario/point_and_click.md`](../plugins/views.scenario/point_and_click.md)

package/scenario.guide/qte-random.md

@@ -0,0 +1,51 @@
+# QTE и random
+
+## % qte
+
+Quick Time Event по id из параметров игры (`PARAMS.QTE.ITEMS`).
+
+```vne
+% qte door_lock
+  "Успех — тело indented-блока"
+"Провал или после блока — следующая строка"
+```
+
+| Исход | Поведение |
+|-------|-----------|
+| Success | `curLine` на первую строку внутри блока |
+| Fail / неизвестный id | Пропуск indented-блока |
+
+UI — [`../plugins/views.scenario/qte.md`](../plugins/views.scenario/qte.md).
+
+### QTE на опции choose
+
+Нужен compatibility choose↔qte в бандле:
+
+```vne
+% choose
+  % choose.option "Рискнуть"
+    qte: easy
+    "Успех QTE"
+  % choose.option "Сдаться" | qte-fallback
+    "Прямой выбор или fail QTE"
+```
+
+Keyword `| qte-fallback` помечает ветку при провале.
+
+## % random
+
+Случайно выбирает одну из вложенных `% random.option`:
+
+```vne
+% random
+  % random.option
+    "Ветка A"
+  % random.option
+    "Ветка B"
+```
+
+## См. также
+
+- [`../plugins/scenario/qte.md`](../plugins/scenario/qte.md)
+- [`../plugins/scenario/random.md`](../plugins/scenario/random.md)
+- [choose.md](./choose.md)

package/scenario.guide/vars.md

@@ -0,0 +1,67 @@
+# Переменные: flag и counter
+
+## flag — булевы флаги
+
+```vne
+$ flag seen
+$ flag seen set
+$ flag seen unset
+$ flag seen unset | global
+```
+
+| Форма | Смысл |
+|-------|--------|
+| `$ flag <name>` | Установить (set) |
+| `$ flag <name> set` | Явный set |
+| `$ flag <name> unset` | Снять |
+| `\| global` | Глобальный (между прохождениями / слотами — по правилам vars) |
+
+### Условный блок `% flag`
+
+```vne
+% flag testsFlags1
+  "Тело выполнится, если флаг установлен"
+% flag testsFlags5 unset
+  "Тело, если флаг снят"
+% flag testsFlags1 | global
+  "Проверка глобального флага"
+```
+
+## counter — числа
+
+```vne
+$ counter n ++
+$ counter n --
+$ counter n += 2
+$ counter n -= 2
+$ counter n = 10
+$ counter n ++ | global
+```
+
+Операции изменения: `++`, `--`, `+=`, `-=`, `=`.
+
+### Условный блок `% counter`
+
+```vne
+% counter n > 0
+  "…"
+% counter n === 10 | global
+  "…"
+```
+
+Сравнения: `>`, `>=`, `===`, `!==`, `<`, `<=`.
+
+### В props опций
+
+```vne
+% choose.option "+1"
+  disabled: $ counter n > 0 | global
+  $ counter n ++ | global
+% choose.option "Обнулить"
+  hided: $ counter n === 0 | global
+  $ counter n = 0 | global
+```
+
+## См. также
+
+- [`../plugins/vars/flags.md`](../plugins/vars/flags.md), [`counters.md`](../plugins/vars/counters.md)

package/scenario.guide/views.md

@@ -0,0 +1,65 @@
+# UI и экраны
+
+## interface (ADV / UI сценария)
+
+```vne
+$ interface show
+$ interface hide
+$ interface view adv
+```
+
+Действия: `show`, `hide`, `view` (режим/вид интерфейса — значение из игры, часто `adv`).
+
+## Экраны
+
+```vne
+$ intro
+$ mainmenu
+$ credits show
+$ credits hide
+$ settings.defaults
+```
+
+| Команда | Смысл |
+|---------|--------|
+| `$ intro` | Интро-экран |
+| `$ mainmenu` | Главное меню |
+| `$ credits show` / `hide` | Титры |
+| `$ settings.defaults` | Сброс/дефолты настроек (по плагину) |
+
+Точный момент вызова (из `init`, из меню) задаёт сценарий игры.
+
+## video / comment / achievement
+
+```vne
+$ video play {cutscene/01}
+$ comment "Подсказка игроку" 5000
+$ achievement unlock some_id
+$ achievement lock some_id
+```
+
+| Модуль | Действия |
+|--------|----------|
+| `video` | `play` |
+| `comment` | текст + опционально длительность; `hide` |
+| `achievement` | `lock`, `unlock` |
+
+## wallet / time / date
+
+Реже в диалогах, но есть в каталоге команд:
+
+```vne
+$ wallet add …
+$ wallet set …
+$ wallet reset
+$ time add …
+$ time set …
+$ date add …
+$ date set …
+```
+
+## См. также
+
+- [`../plugins/views.scenario/interface.md`](../plugins/views.scenario/interface.md)
+- Screens: [`../plugins/views.screens/`](../plugins/views.screens/)
+- [`../plugins/views/video.md`](../plugins/views/video.md), [`comment.md`](../plugins/views/comment.md), [`achievement.md`](../plugins/views/achievement.md)