Справочник настроек

Начальный Обновлено 9 июл. 2026 г.

Содержание

Questwright регистрирует три страницы в Project Settings → Plugins. Все они действуют на уровне проекта (DefaultGame.ini) и разделяются с командой через систему контроля версий. Единственное намеренное исключение: API-ключи здесь никогда не хранятся (они лежат в индивидуальном, игнорируемом git ini-файле с фолбэком на переменные окружения).

Questwright Quests

Сохранение прогресса квестов. Секция конфига: [/Script/QuestwrightRuntime.QuestwrightQuestSettings].

Project Settings → Plugins → Questwright Quests

НастройкаПо умолчаниюЧто делает
Auto Load Progress (bAutoLoadProgress)Вкл.Загружает сохранённый прогресс при старте квестового компонента игрока (на стороне сервера). Также восстанавливает прогресс при смене карты, когда PlayerState пересоздаётся.
Auto Save Policy (AutoSavePolicy)On any changeКогда прогресс автосохраняется. Manual: никогда (вы вызываете SaveProgress()). On quest state change: только переходы жизненного цикла (принятие / завершение / отказ / провал). On any change: также переходы шагов, засчитывание целей и флаги. Сохранения объединяются: серия изменений в одном кадре стоит одну запись.
Save On End Play (bSaveOnEndPlay)Вкл.Страховочный сброс на диск при завершении работы компонента (выход / смена карты / логаут). Отключите вместе с Manual для полностью ручного сохранения.
Save Provider Class (SaveProviderClass)NoneБэкенд хранилища (C++-класс, реализующий IQuestwrightSaveProvider). None = встроенный провайдер на слотах USaveGame. См. Сохранения и мультиплеер.

Автоматическое сохранение включается только для квестовых компонентов, принадлежащих PlayerState (штатная схема развёртывания). Компоненты на обычных акторах остаются полностью в ручном режиме сохранения/загрузки.

Questwright Dialogue

Темп диалогов в рантайме. Секция конфига: [/Script/QuestwrightRuntime.QuestwrightDialogueSettings].

Project Settings → Plugins → Questwright Dialogue

НастройкаПо умолчаниюЧто делает
Advance Mode (AdvanceMode)ManualКак продвигаются реплики. Manual: после каждой реплики ждём клика, темп задаёт читатель. Auto: реплики проигрываются и продвигаются сами после озвучки; ввода ждут только выборы (кинематографичный темп).
Auto Advance Buffer Seconds (AutoAdvanceBufferSeconds)0.4Режим Auto: дополнительная пауза в секундах после озвучки реплики перед переходом дальше, небольшой вдох между репликами.
Auto Advance No Voice Seconds (AutoAdvanceNoVoiceSeconds)2.5Режим Auto: сколько остаётся на экране реплика без озвучки, чтобы текст успели прочитать.

Оба значения режима Auto доступны для редактирования только когда Advance Mode установлен в Auto.

Questwright Studio

Культуры локализации и конфигурация озвучки для каждой культуры. Обычно они редактируются через вкладки Localization и Voice, а не вручную. Секция конфига: [/Script/QuestwrightStudio.QuestwrightStudioSettings].

Project Settings → Plugins → Questwright Studio

НастройкаЧто делает
Build Cultures (BuildCultures)Набор культур, которые собирает проект (например en, ru). Первая запись служит фолбэком исходной культуры, когда квест не объявляет собственную source_culture. Пусто = авторинг в одной культуре.
Voice By Culture (VoiceByCulture)Конфигурация озвучки по культурам; ключом служит код культуры. Каждая запись содержит TTS-провайдера (например OmniVoice, ElevenLabs), модель провайдера, подсказку формата вывода (например wav_24000) и назначения голосов говорящим (ключ говорящего → id голоса у провайдера).

Чего нет в Project Settings

ЗначениеГде живёт
API-ключи ElevenLabs / Claude / OpenAIИндивидуальный ini (игнорируется git) + фолбэк на переменные окружения, например QW_ELEVENLABS_KEY
Контент квестов, цепочки, приоритетыСами файлы .quest.yaml; скрытого манифеста нет
Сгенерированные ассетыПапка /Game/Questwright/Generated/ вашего проекта