Skip to content

Конфигурация

Конфигурация движка хранится в нескольких скриптовых ассетах, расположенных в папке Assets/NaninovelData/Resources/Naninovel/Configuration. Они автоматически генерируются при первом открытии соответствующих меню конфигурации в редакторе Unity.

Используйте Naninovel -> Configuration или Edit -> Project Settings -> Naninovel для доступа к меню конфигурации.

Обратите внимание, что все меню конфигурации поддерживают функцию пресетов Unity ↗. Это может помочь в создании нескольких пресетов конфигурации при подготовке сборок для различных целевых платформ (например, мобильных, standalone, консольных и т.д.).

cover

Можно изменять объекты конфигурации во время выполнения, добавлять новые пользовательские конфигурации и изменить способ доступа к объектам во время выполнения (например, считывать конфигурацию из JSON файлы, хранящихся на удаленном устройстве); см. руководство по пользовательским настройкам для получения дополнительной информации.

NOTE

Данная информация о конфигурации актуальна для Naninovel v1. 10 ↗.

Аудио

СвойствоЗначение по умолчаниюОписание
Audio LoaderAudio- (Addressable, Project)Отвечает за конфигурацию загрузчика ресурсов, используемого при работе с аудиоресурсами (BGM и SFX).
Voice LoaderVoice- (Addressable, Project)Отвечает за конфигурацию загрузчика ресурсов, используемого при работе с аудиоресурсами голосовой озвучки.
Default Master Volume1Уровень звукового мастер-канала при первом запуске игры.
Default Bgm Volume1Уровень канала BGM при первом запуске игры.
Default Sfx Volume1Уровень канала SFX при первом запуске игры.
Default Voice Volume1Уровень канала голосовой озвучки при первом запуске игры.
Enable Auto VoicingFalseПри включении параметра каждая команда PrintText будет пытаться проиграть голосовой клип из VoiceResourcesPrefix/ScriptName/LineIndex.ActionIndex.
Voice Overlap PolicyPrevent OverlapДиктует принципы обработки одновременно воспроизводящихся голосов:
• Allow Overlap – одновременно звучащие голоса будут воспроизводиться без ограничений.
• Prevent Overlap — предотвращает одновременное воспроизведение путем остановки воспроизводимого в данный момент голосового клипа перед воспроизведением нового.
• Prevent Character Overlap – предотвращает одновременное воспроизведение голосовых клипов для персонажа; голоса разных персонажей (автоматическое озвучивание) и любое количество команд @voice могут быть воспроизведены одновременно.
Custom Audio MixerNullАудиомикшер для контроля аудиогрупп. По умолчанию использует стандартный, если никакого иного не предоставлено.
Master Volume Handle NameMaster VolumeИмя обработчика микшера (предоставленный параметр) для управления уровнем мастер-канала.
Bgm Group PathMaster/BGMПуть к группе микшера для управления уровнем BGM канала.
Bgm Volume Handle NameBGM VolumeИмя обработчика микшера (предоставленный параметр) для управления уровнем BGM канала.
Sfx Group PathMaster/SFXПуть к группе микшера для управления уровнем SFX канала.
Sfx Volume Handle NameSFX VolumeИмя обработчика микшера (предоставленный параметр) для управления уровнем SFX канала.
Voice Group PathMaster/VoiceПуть к группе микшера для управления уровнем канала голосовой озвучки.
Voice Volume Handle NameVoice VolumeИмя обработчика микшера (предоставленный параметр) для управления уровнем канала озвучки.

Фоны

СвойствоЗначение по умолчаниюОписание
Default MetadataObject RefМетаданные, используемые по умолчанию при создании фоновых акторов, и пользовательские метаданные для созданного актора с неуказанным ID.
MetadataObject RefМетаданные, используемые при создании фоновых акторов с конкретным ID.
Scene Origin(0.5, 0.0)Исходная точка, используемая для отсчета при позиционировании актеров в сцене.
Z Offset100Начальное смещение по оси Z (глубина) акторов относительно камеры, установленное при создании акторов.
Z Step0.1Расстояние по оси Z, установленное между акторами при их создании; используется для предотвращения проблем наложения.
Default EasingLinearФункция смягчения, используемая по умолчанию для всех анимаций модификации актора (изменение внешности, положения, оттенка и пр.).
Auto Show On ModifyTrueСледует ли автоматически выводить (показывать) актора при выполнении команд модификации.

Камера

СвойствоЗначение по умолчаниюОписание
Reference Resolution(1920, 1080)Эталонное разрешение используется для оценки правильных размеров рендеринга, чтобы спрайтовые ассеты (например, фоны и персонажи) были правильно расположены на сцене. Как правило, должно быть установлено в значение, равное разрешению фоновых текстур, которые вы используете в игре.
Auto Correct Ortho SizeTrueСледует ли автоматически корректировать ортогональный размер кадра на основе текущего соотношения сторон дисплея, чтобы обеспечить правильное расположение фонов и персонажей.
Default Ortho Size5.35Ортогональный размер, устанавливаемый по умолчанию при отключенной автоматической коррекции.
Initial Position(0.0, 0.0, -10.0)Исходное положение камеры в пространстве.
OrthographicTrueДолжна ли камера по умолчанию рендерить в ортогональном (включен) или перспективном (отключен) режиме. Не имеет эффекта, когда назначается пользовательский префаб камеры.
Custom Camera PrefabNullПрефаб с компонентом камеры, используемой для рендеринга. Будет использоваться стандартный, если иного не указано. Если вы хотите настроить некоторые свойства камеры (цвет фона, FOV, HDR и т.д.) или добавить сценарии постобработки, создайте префаб с необходимой настройкой камеры и назначьте данный префаб этому полю.
Use UI CameraTrueСледует ли визуализировать пользовательский интерфейс в отдельной камере. Это позволит использовать раздельные конфигурации для основной камеры и камеры UI и предотвратить влияние эффектов постобработки (изображения) на пользовательский интерфейс за счет незначительных ресурсных расходов на рендеринг.
Custom UI Camera PrefabNullПрефаб с компонентом камеры, используемой для рендеринга пользовательского интерфейса. Будет использоваться стандартный, если иного не указано. Не имеет никакого эффекта, если параметр UseUICamera отключен.
Default EasingLinearФункция смягчения, используемая по умолчанию для всех модификаций камеры (изменение масштаба, положение, поворот и пр.).
Thumbnail Resolution(240, 140)Разрешение, в котором будут захвачены миниатюры для превью в слотах сохранения.
Hide UI In ThumbnailsFalseИгнорировать ли слой интерфейса при захвате миниатюр.

Персонажи

СвойствоЗначение по умолчаниюОписание
Auto Arrange On AddTrueСледует ли равномерно распределять персонажей по оси X при добавлении нового персонажа без заданной позиции.
Default MetadataObject RefМетаданные, используемые по умолчанию при создании акторов персонажей; пользовательские метаданные для созданного актора без указанного ID.
MetadataObject RefМетаданные, используемые при создании акторов персонажей с определенными ID.
Avatar LoaderCharacter Avatars- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для ресурсов текстур аватаров персонажей.
Scene Origin(0.5, 0.0)Исходная точка отсчета при позиционировании акторов в сцене.
Z Offset50Начальное смещение по оси Z (глубина) акторов относительно камеры, установленное при создании акторов.
Z Step0.1Расстояние по оси Z, установленное между акторами при их создании; используется для предотвращения проблем наложения.
Default EasingSmooth StepФункция смягчения, используемая по умолчанию для всех анимаций модификации актора (изменение внешности, положения, оттенка и пр.).
Auto Show On ModifyTrueСледует ли автоматически выводить (показывать) актора при выполнении команд модификации.

Обработчики вариантов выбора

СвойствоЗначение по умолчаниюОписание
Default Handler IdButton ListID обработчика выбора, используемое по умолчанию.
Default MetadataObject RefМетаданные, используемые по умолчанию при создании акторов обработчиков; пользовательские метаданные для созданного актора без указанного ID.
MetadataObject RefМетаданные, используемые при создании акторов обработчиков с определенными ID.
Default EasingLinearФункция смягчения, используемая по умолчанию для всех анимаций модификации актора (изменение внешности, положения, оттенка и пр.).
Auto Show On ModifyTrueСледует ли автоматически выводить (показывать) актора при выполнении команд модификации.

Пользовательские переменные

СвойствоЗначение по умолчаниюОписание
Predefined VariablesObject RefСписок переменных для инициализации по умолчанию. Глобальные переменные (имена которых начинаются с G_ или g_) инициализируются при первом запуске приложения, а другие – при каждом сбросе состояния.

Движок

СвойствоЗначение по умолчаниюОписание
Generated Data PathNaninovel DataОтносительный (к каталогу данных приложения) путь для хранения автоматически сгенерированных ассетов.
Override Objects LayerFalseСледует ли назначать определенный слой всем объектам движка. Камера движка будет использовать слой для обрезной маски. Используйте это, чтобы изолировать объекты Naninovel от визуализации другими камерами.
Objects Layer0Если включен параметр Override Objects Layer, указанный слой будет присвоен всем объектам движка.
Async Exception Log TypeErrorТип лога для исключений, связанных с UniTask.
Initialize On Application LoadTrueСледует ли автоматически инициализировать движок при запуске приложения.
Show Initialization UITrueПоказывать ли UI загрузки во время инициализации движка.
Custom Initialization UINullUI для отображения во время инициализации движка (если он включен). Будет использован стандартный, если иного не указано.
Show Title UITrueСледует ли автоматически отображать UI титульного экрана (главное меню) после инициализации движка. Вы можете изменить пользовательский интерфейс титульного экрана с помощью функции настройки пользовательского интерфейса (см. онлайн-руководство для получения дополнительной информации).
Enable Development ConsoleTrueНужно ли включать консоль разработки.
Toggle Console KeyBack QuoteКлавиша, используемая для доступа к консоли разработки. Вы также можете включать консоль с помощью нескольких (3 или более) касаний при использовании сенсорных экранов.

Ввод

СвойствоЗначение по умолчаниюОписание
Spawn Event SystemTrueСледует ли создавать систему событий при инициализации.
Custom Event SystemNullПрефаб с компонентом EventSystem, который будет создаваться для обработки входящих данных. Будет создан стандартный, если иного не указано.
Spawn Input ModuleTrueСледует ли создавать модуль ввода при инициализации.
Custom Input ModuleNullПрефаб с компонентом InputModule, который будет создаваться для ввода данных. Будет создан стандартный, если иного не указано.
Touch Frequency Limit0.1Ограничивает частоту регистрируемых вводных команд, в секундах.
Process Legacy BindingsTrueСледует ли обрабатывать устаревшие вводные привязки. Отключите его, если вы используете новую систему ввода Unity и не хотите, чтобы устаревшие привязки работали в дополнение к действиям ввода.
BindingsObject RefПривязки для обработки вводных данных.

Локализация

СвойствоЗначение по умолчаниюОписание
LoaderLocalization- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для ресурсов локализации.
Source LocaleEnЛокаль исходных ресурсов проекта (языка, на котором были созданы ресурсы проекта).
Default LocaleNullЛокаль, используемая по умолчанию при первом запуске игры. Будет использована Source Locale, если иная не указана.

Управляемый текст

СвойствоЗначение по умолчаниюОписание
LoaderText- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для управляемых текстовых документов.

Видеоролики

СвойствоЗначение по умолчаниюОписание
LoaderMovies- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для ресурсов видеороликов.
Skip On InputTrueСледует ли пропускать воспроизведение ролика при нажатии пользователем клавиши команды cancel.
Skip FramesTrueМожно ли пропускать кадры, чтобы догнать текущее время.
Fade Duration1Время в секундах для плавного появления/затухания перед началом/окончанием воспроизведения ролика.
Custom Fade TextureNullТекстура для появления/затухания. Будет использована простая черная, если иная не задана.
Play Intro MovieFalseСледует ли автоматически воспроизводить интро-ролик после инициализации движка и перед отображением главного меню.
Intro Movie NameNullПуть к ресурсу интро-ролика.

Провайдер ресурсов

СвойствоЗначение по умолчаниюОписание
Resource PolicyStaticДиктует политику загрузки и выгрузки ресурсов во время выполнения скрипта:
• Статическая — все ресурсы, необходимые для выполнения сценария, предварительно загружаются при запуске воспроизведения (маскируются загрузочным экраном) и выгружаются только после завершения воспроизведения сценария. Эта политика используется по умолчанию и рекомендуется для большинства случаев.
• Динамическая — во время выполнения сценария предварительно загружаются только ресурсы, необходимые для выполнения следующих команд количеством, указанным в Dynamic Policy Steps, а все неиспользуемые ресурсы немедленно выгружаются. Используйте этот режим при работе с платформами со строгими ограничениями памяти и невозможностью правильно организовать сценарии Naninovel. При загрузке ресурсов в фоновом режиме во время игры могут наблюдаться сбои.
Dynamic Policy Steps25определяя количество команд скрипта для предварительной загрузки, когда включена динамическая политика ресурсов.
Optimize Loading PriorityTrueПонижает приоритет потока фоновой загрузки Unity, чтобы предотвратить сбои при загрузке ресурсов во время воспроизведения.
Log Resource LoadingFalseСледует ли выводить операции загрузки ресурсов на экране загрузки.
Enable Build ProcessingTrueСледует ли регистрировать пользовательский обработчик воспроизведения для обработки ресурсов, назначенных в качестве ресурсов Naninovel.

Предупреждение: чтобы эта настройка вступила в силу, необходимо перезапустить редактор Unity.
Use AddressablesTrueПри установке адресируемой системы ассетов включение этого свойства оптимизирует этап обработки ассетов, уменьшая время загрузки.
Auto Build BundlesTrueСледует ли автоматически создавать адресируемые пакеты ассетов при создании плеера. Не имеет эффекта, когда Use Addressables отключено.
Allow Addressable In EditorFalseСледует ли использовать адресируемый провайдер в редакторе. Включите его, если вы вручную назначаете ресурсы с помощью адресации, а не назначаете их менеджерам ресурсов Naninovel. Имейте в виду, что включение этого может вызвать проблемы, когда ресурсы как назначаются в диспетчере ресурсов, так и регистрируются с помощью адресации, после чего переименовываются или дублируются.
Extra LabelsNullАдресируемый провайдер будет работать только с ассетами, которые имеют назначенные метки в дополнение к метке Naninovel. Может использоваться для фильтрации ассетов, используемых движком, на основе пользовательских критериев (например, HD и SD текстуры).
Local Root Path%DATA%/ResourcesКорневой путь, используемый для локального провайдера ресурсов. Это может быть абсолютный путь к папке, в которой находятся ресурсы, или относительный путь с одним из доступных источников:
• %DATA% — папка игровых данных на целевом устройстве (UnityEngine.Application.dataPath).
• %PDATA% – каталог постоянных данных на целевом устройстве (UnityEngine.Application.persistentDataPath).
• %STREAM% - папка StreamingAssets (UnityEngine.Application.streamingAssetsPath).
• %SPECIAL{F}% - специальная папка ОС (где F – значение из System.Environment.SpecialFolder).
Project Root PathNaninovelПуть относительно папок Resources, в которых находятся специфические для Naninovel ассеты.
Google Drive Root PathResourcesКорневой путь, используемый для провайдера ресурсов Google Drive.
Google Drive Request Limit2Максимум допустимых одновременных запросов при обращении к API Google Drive.
Google Drive Caching PolicySmartПолитика кэша, используемая при загрузке ресурсов. Smart попытается использовать Changes API, чтобы проверить наличие изменений на диске. PurgeAllOnInit повторно загрузит все ресурсы при инициализации провайдера.

Плеер сценариев

СвойствоЗначение по умолчаниюОписание
Skip Time Scale10Шкала ускорения времени в режиме пропуска (быстрой перемотки вперед).
Min Auto Play Delay3Минимум секунд ожидания перед выполнением следующей команды в режиме авточтения.
Show Debug On InitFalseНужно ли показывать окно отладки плеера при инициализации движка.

Сценарии

СвойствоЗначение по умолчаниюОписание
LoaderScripts- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для ресурсов сценариев Naninovel.
Initialization ScriptNullИмя сценария, воспроизводимого сразу после инициализации движка.
Title ScriptNullИмя сценария, воспроизводимого при отображении титульного экрана. Может использоваться для настройки сцены титульного экрана (фон, музыка и т.д.).
Start Game ScriptNullИмя сценария, воспроизводимого при запуске новой игры. Будет использован первый доступный, если иного не указано.
Auto Add ScriptsTrueСледует ли автоматически добавлять созданные сценарии Naninovel к ресурсам.
Hot Reload ScriptsTrueСледует ли повторно загружать измененные (как с помощью визуального, так и внешнего редакторов) сценарии и применять изменения во время воспроизведения без перезапуска.
Count Total CommandsFalseСледует ли вычислять количество команд, существующих во всех доступных сценариях Naninovel при инициализации сервиса. Если вы не используете свойство TotalCommandsCount диспетчера сценариев и функцию CalculateProgress в выражениях сценариев Naninovel, отключите данное свойство, чтобы сократить время инициализации движка.
Enable Visual EditorTrueСледует ли открывать визуальный редактор сценариев при выборе файла сценария.
Hide Unused ParametersTrueСледует ли скрывать неназначенные параметры командных строк, когда строка не под курсором или не выбрана.
Insert Line KeySpaceГорячая клавиша для отображения окна Insert Line, когда выбран визуальный редактор. Установите значение None, чтобы отключить.
Insert Line ModifierControlМодификатор для Insert Line Key. Установите значение None, чтобы отключить.
Save Script KeySГорячая клавиша для сохранения (сериализации) отредактированного сценария, когда выбран визуальный редактор. Установите значение None, чтобы отключить.
Save Script ModifierControlМодификатор для Save Script Key. Установите значение None, чтобы отключить.
Editor Page Length1000Сколько строк сценария должно быть отображено на одной странице визуального редактора.
Editor Custom Style SheetNullПозволяет изменять стандартный стиль визуального редактора.
Graph OrientationHorizontalСтроить график вертикально или же горизонтально.
Graph Auto Align Padding(10.0, 0.0)Добавление отступов для каждого узла при выполнении автоматического выравнивания.
Graph Custom Style SheetNullПозволяет изменять стандартный стиль графика сценария.
Enable Community ModdingFalseСледует ли разрешить добавление внешних сценариев Naninovel в сборку.
External LoaderScripts- (Local)Конфигурация загрузчика ресурсов, используемого для ресурсов внешних сценариев Naninovel.
Enable NavigatorTrueСледует ли инициализировать навигатор сценариев для просмотра доступных сценариев Naninovel.
Show Navigator On InitFalseСледует ли показывать навигатор сценариев Naninovel, когда инициализирован менеджер сценариев.
Navigator Sort Order900Порядок сортировки UI навигатора сценариев.

Создание экземпляров

СвойствоЗначение по умолчаниюОписание
LoaderSpawn- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для создаваемых экземпляров ресурсов.

Состояние

СвойствоЗначение по умолчаниюОписание
Save Folder NameSavesПапка (сохранений), которая будет создана в папке игровых данных.
Default Settings Slot IdSettingsИмя файла настроек сохранения.
Default Global Slot IdGlobal SaveИмя файла глобального сохранения.
Save Slot MaskGame Save{0:000}Формат названия слотов сохранения.
Quick Save Slot MaskGame Quick Save{0:000}Формат названия слотов быстрого сохранения.
Save Slot Limit99Максимум слотов сохранения.
Quick Save Slot Limit18Максимум слотов быстрого сохранения.
Binary Save FilesTrueСледует ли сжимать и хранить сохраненные файлы в виде двоичных файлов (.nson) вместо текстовых файлов (.json). Это значительно уменьшит размер файлов и затруднит их редактирование (чтобы предотвратить читерство), но будет потреблять больше памяти и ресурсов ЦП при сохранении и загрузке.
Load Start Delay0.3Ожидание в секундах перед началом операции загрузки; используется для завершения анимации предварительной загрузки до того, как возникнут какие-либо связанные с загрузкой сбои.
Reset On GotoTrueСледует ли сбрасывать состояние сервисов движка и выгружать (утилизировать) ресурсы при загрузке другого сценария при исполнении команды @goto. Рекомендуется оставить этот параметр включенным, чтобы предотвратить проблемы с утечкой памяти. Если вы решите отключить эту опцию, вы все равно сможете сбрасывать состояние и выгружать ресурсы вручную в любое время с помощью команды @resetState.
Enable State RollbackTrueСледует ли включить функцию отката, позволяющую игроку перемотать сценарий назад.
State Rollback Steps1024Количество снимков состояния, сохраняемых во время выполнения; определяет, как далеко назад может быть выполнен откат (перемотка назад). Увеличение этого значения будет потреблять больше памяти.
Saved Rollback Steps128Количество снимков состояния для сериализации (сохранения) в слотах сохранения; определяет, как далеко назад может быть выполнен откат после загрузки сохраненной игры. Увеличение этого значения приведет к увеличению файлов сохранений.
Game State HandlerNaninovel.IO Game State Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=nullРеализация, ответственная за де-/сериализацию локального (специфичного для игровой сессии) состояния игры; см. руководство State Management о том, как добавить пользовательские обработчики сериализации.
Global State HandlerNaninovel.IO Global State Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=nullРеализация, ответственная за де-/сериализацию глобального состояния игры; см. руководство State Management о том, как добавить пользовательские обработчики сериализации.
Settings State HandlerNaninovel.IO Settings Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=nullРеализация, ответственная за де-/сериализацию игровых настроек; см. руководство State Management о том, как добавить пользовательские обработчики сериализации.

Текстовые принтеры

СвойствоЗначение по умолчаниюОписание
Default Printer IdDialogueID текстового принтера, используемого по умолчанию.
Max Reveal Delay0.06Ограничение задержки (в секундах) при выводе (печати) текстовых сообщений. Конкретная скорость вывода устанавливается через message speed в настройках игры; это значение определяет доступный диапазон (чем выше значение, тем ниже скорость вывода).
Max Auto Wait Delay0.02Ограничение задержки (в секундах) на каждый печатный символ во время ожидания продолжения в режиме авточтения. Конкретная задержка устанавливается с помощью auto delay в настройках игры; это значение определяет доступный диапазон.
Scale Auto WaitTrueСледует ли масштабировать время ожидания в режиме авточтения по скорости вывода, установленной в командах вывода.
Default MetadataObject RefМетаданные, используемые по умолчанию при создании акторов текстовых принтеров, и пользовательские метаданные для созданного актора с неуказанным ID.
MetadataObject RefМетаданные, используемые при создании акторов с указанными ID.
Scene Origin(0.5, 0.0)Исходная точка отсчета при позиционировании акторов в сцене.
Z Offset100Начальное смещение по оси Z (глубина) акторов относительно камеры, установленное при создании акторов.
Z Step0.1Расстояние по оси Z, установленное между акторами при их создании; используется для предотвращения проблем наложения.
Default EasingLinearФункция смягчения, используемая по умолчанию для всех анимаций модификации актора (изменение внешности, положения, оттенка и пр.).
Auto Show On ModifyFalseСледует ли автоматически выводить (показывать) актора при выполнении команд модификации.

Пользовательский интерфейс

СвойствоЗначение по умолчаниюОписание
LoaderUI- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для ресурсов UI.
Objects Layer5Слой, назначаемый для элементов UI, создаваемых движком. Используется для обрезки при использовании функции UI toogle UI.
Render ModeScreen Space CameraРежим визуализации, применяемый для всех управляемых элементов UI.
Sorting Offset1Смещение сортировки, применяемое для всех управляемых элементов UI.

Разблокируемые ресурсы

СвойствоЗначение по умолчаниюОписание
LoaderUnlockables- (Addressable, Project)Конфигурация загрузчика ресурсов, используемого для разблокируемых ресурсов.