Документация Nyxtale

Платформа NyxtaleНачало

Код и граф

Две поверхности одной рукописи: когда писать текстом, когда собирать графом.

В Studio одну и ту же сцену можно писать текстом и собирать графом. Это две поверхности одной рукописи: правка в графе видна в тексте следующей строкой, напечатанное в тексте встаёт узлом на холст.

Что показывает каждая

Текст — слова. Ритм реплик, длина, интонация. По нему работает поиск и замена, его понимает git: две версии главы сравниваются построчно.

Граф — форма. На холсте видно то, чего в тексте не видно: что ветка вдвое длиннее соседней, что три опции сходятся через один узел, что развилка ложная — все дороги ведут в одно место.

Когда что

Задача Поверхность
Диалог, описание, интонация текст
Перецепить ветку, переставить узлы граф
Посчитать концовки главы граф
Найти узел, в который ничего не ведёт граф
Правка формулировки текст

Если глава провисает, посмотрите на граф: у этого обычно структурная причина — длинный коридор без выбора или три выбора подряд без последствий между ними.

Что происходит при правке

Правка в графе переписывает только тронутый узел. Комментарии, пустые строки и разбивка абзацев в остальном файле остаются байт в байт теми же, поэтому коммит показывает изменённым один узел, а не всю главу.

Структурные операции (добавить узел, удалить, поменять порядок) печатают текст заново по общим правилам. Точечные (текст реплики, аргумент директивы, условие ветки) меняют свои символы.

Чего в графе нет

Граф показывает узлы и переходы, но не значения: сколько накопится fear на маршруте, возьмётся ли порог, доступна ли платная опция. На это отвечает бот-обход — он проходит все ветки настоящим движком.

Поэтому связный граф ещё не означает проходимую историю: первое видно глазами, второе проверяется.

Что дальше