Справочник настроек
Начальный Обновлено 9 июл. 2026 г.
Questwright регистрирует три страницы в Project Settings → Plugins. Все они действуют на
уровне проекта (DefaultGame.ini) и разделяются с командой через систему контроля версий.
Единственное намеренное исключение: API-ключи здесь никогда не хранятся (они лежат в
индивидуальном, игнорируемом git ini-файле с фолбэком на переменные окружения).
Questwright Quests
Сохранение прогресса квестов. Секция конфига:
[/Script/QuestwrightRuntime.QuestwrightQuestSettings].

| Настройка | По умолчанию | Что делает |
|---|---|---|
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].

| Настройка | По умолчанию | Что делает |
|---|---|---|
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].

| Настройка | Что делает |
|---|---|
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/ вашего проекта |