Settings reference

Beginner Last updated Jul 9, 2026

On this page

Questwright registers three pages under Project Settings → Plugins. All of them are project-level (DefaultGame.ini), shared with your team through version control, with one deliberate exception: API keys are never stored here (they live in a per-user, git-ignored ini with an environment-variable fallback).

Questwright Quests

Persistence of quest progress. Config section: [/Script/QuestwrightRuntime.QuestwrightQuestSettings].

Project Settings → Plugins → Questwright Quests

SettingDefaultWhat it does
Auto Load Progress (bAutoLoadProgress)OnLoads stored progress when a player’s quest component starts (server-side). Also restores progress across map travel, where the PlayerState is recreated.
Auto Save Policy (AutoSavePolicy)On any changeWhen progress is autosaved. Manual means never (you call SaveProgress()); On quest state change saves on lifecycle transitions only (accept / complete / decline / fail); On any change also saves on step advances, objective credits and flags. Saves are coalesced: a burst of same-frame changes costs one write.
Save On End Play (bSaveOnEndPlay)OnA belt-and-braces flush when the component ends play (quit / travel / logout). Disable together with Manual for fully manual persistence.
Save Provider Class (SaveProviderClass)NoneStorage backend (C++ class implementing IQuestwrightSaveProvider). None = the built-in USaveGame-slot provider. See Saving & multiplayer.

Auto-persistence engages only for quest components owned by a PlayerState (the shipped deployment). Components on bare actors keep fully manual save/load.

Questwright Dialogue

Runtime dialogue pacing. Config section: [/Script/QuestwrightRuntime.QuestwrightDialogueSettings].

Project Settings → Plugins → Questwright Dialogue

SettingDefaultWhat it does
Advance Mode (AdvanceMode)ManualHow lines advance. Manual waits for a click after every line (reader-paced). Auto lets lines play and advance on their own after the voice-over; only choices wait for input (cinematic pacing).
Auto Advance Buffer Seconds (AutoAdvanceBufferSeconds)0.4Auto mode: extra seconds held after a line’s voice-over before advancing, a small breath between lines.
Auto Advance No Voice Seconds (AutoAdvanceNoVoiceSeconds)2.5Auto mode: how long a line with no voice-over stays on screen so the text is still readable.

Both auto-mode values are only editable when Advance Mode is set to Auto.

Questwright Studio

Localization cultures and the per-culture voice configuration, normally edited through the Localization and Voice tabs rather than by hand. Config section: [/Script/QuestwrightStudio.QuestwrightStudioSettings].

Project Settings → Plugins → Questwright Studio

SettingWhat it does
Build Cultures (BuildCultures)The set of cultures the project builds (e.g. en, ru). The first entry is the source-culture fallback when a quest doesn’t declare its own source_culture. Empty = single-culture authoring.
Voice By Culture (VoiceByCulture)Per-culture voice configuration, keyed by culture code. Each entry holds the TTS Provider (e.g. OmniVoice, ElevenLabs), a provider Model, an Output format hint (e.g. wav_24000) and the per-speaker voice assignments (speaker key → provider voice id).

What is not in Project Settings

ValueWhere it lives
ElevenLabs / Claude / OpenAI API keysPer-user ini (git-ignored) + env fallback, e.g. QW_ELEVENLABS_KEY
Quest content, chains, prioritiesThe .quest.yaml files themselves; there is no hidden manifest
Generated assetsYour project’s /Game/Questwright/Generated/ folder