Устройство проекта

Moirai объединяет три части:

• VN Studio -- редактор, в котором автор создаёт проект, сцены, ресурсы и логику;
• Moirai Engine -- движок, который исполняет события, условия и переходы истории;
• плеер -- среда, в которой игрок проходит готовую историю.

Автор работает главным образом в Studio. Понимание устройства проекта помогает безопасно переносить его, организовать работу команды и быстрее находить ошибки.

Рабочая папка

Каждый проект находится в отдельной папке внутри выбранной рабочей папки. Studio хранит данные в нескольких файлах и каталогах:

Проект/
|-- project.json
|-- scenes.json
|-- characters.json
|-- locations.json
`-- assets/
    |-- audio/
    `-- images/
        |-- backgrounds/
        |-- characters/
        `-- textures/

project.json содержит общие данные проекта, включая его название и стартовую сцену. В scenes.json находятся сцены и связи графа. Отдельные файлы персонажей и локаций позволяют Studio хранить их независимо от сценарных событий. Каталог assets/ содержит добавленные медиафайлы.

Открывайте и изменяйте эти данные через интерфейс Studio. Ручное редактирование JSON или перенос файлов в Проводнике может нарушить связи между сценами и ресурсами.

Подробнее о выборе папки, импорте и экспорте -- в разделе Рабочая папка и проекты.

Ресурсы

Ресурсы -- это материалы, которые используются в сценах: изображения, фоны, портреты, текстуры, музыка и звуки. Сначала добавьте их в раздел Ресурсы, а затем выберите в настройках персонажа, локации или события сцены.

Так один и тот же файл можно использовать в нескольких эпизодах. Например, фон локации применяется в разных диалоговых сценах, а один звуковой эффект -- в нескольких событиях.

Сцены и события

Сцена -- отдельный фрагмент прохождения: диалог, экран телефона, комикс, карта, QTE и другой формат. Внутри сцены расположены её события или элементы. Их порядок определяет последовательность показа.

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

Смотрите также: Виды сцен, Диалоговая сцена и Граф истории.

Названия и технические ID

У объектов проекта есть внутренние идентификаторы, которые нужны движку для хранения связей. Они не являются авторскими названиями и не должны ограничивать язык работы.

В интерфейсе называйте сцены, персонажей, локации и переменные так, как удобно команде: по-русски, по-китайски, на другом языке или с любыми Unicode-символами. Главное -- выбирать понятные и различимые названия, особенно если проект большой.

Переменные и условия

Переменные хранят решения игрока и другие значения, от которых зависит история. В Studio есть глобальные переменные для всей истории и локальные переменные для одной сцены. У переменной задаются тип и начальное значение.

Условия проверяют значения переменных внутри сцены и на переходах графа. Это позволяет показывать разные реплики, открывать маршруты и вести игрока к разным финалам.

Подробности -- в разделе Добавляем ветвление.

Экспорт

Формат .vnproject -- переносимый архив проекта с его данными и ресурсами. Используйте его для резервной копии, передачи или импорта в Studio на другом компьютере. Обычный ZIP-архив подходит для хранения копии рабочей папки.

Инструкция: Экспорт и резервные копии.