Instellingenreferentie

Beginner Laatst bijgewerkt 9 jul 2026

Op deze pagina

Questwright registreert drie pagina’s onder Project Settings → Plugins. Ze werken allemaal op projectniveau (DefaultGame.ini) en worden via versiebeheer met je team gedeeld, met één bewuste uitzondering: API-sleutels worden hier nooit bewaard (die staan in een ini per gebruiker, buiten git gehouden, met een omgevingsvariabele als fallback).

Questwright Quests

Het bewaren van questvoortgang. Configsectie: [/Script/QuestwrightRuntime.QuestwrightQuestSettings].

Project Settings → Plugins → Questwright Quests

InstellingStandaardWat het doet
Auto Load Progress (bAutoLoadProgress)AanLaadt de bewaarde voortgang wanneer het questcomponent van een speler start (aan de serverkant). Herstelt de voortgang ook bij map travel, waar de PlayerState opnieuw wordt aangemaakt.
Auto Save Policy (AutoSavePolicy)On any changeWanneer voortgang automatisch wordt opgeslagen. Manual betekent nooit (je roept zelf SaveProgress() aan); On quest state change slaat alleen op bij overgangen in de levenscyclus (accepteren / voltooien / weigeren / mislukken); On any change slaat daarnaast op bij stapovergangen, bijgeschreven doelen en vlaggen. Opslagacties worden samengevoegd: een reeks wijzigingen binnen hetzelfde frame kost één schrijfactie.
Save On End Play (bSaveOnEndPlay)AanEen laatste wegschrijfactie voor de zekerheid wanneer het component End Play bereikt (afsluiten / travel / uitloggen). Zet dit samen met Manual uit voor volledig handmatig bewaren.
Save Provider Class (SaveProviderClass)NoneBackend voor de opslag (C++-klasse die IQuestwrightSaveProvider implementeert). None = de ingebouwde provider op basis van USaveGame-slots. Zie Opslaan & multiplayer.

Automatisch bewaren treedt alleen in werking voor questcomponenten die eigendom zijn van een PlayerState (de standaard uitrol). Componenten op kale actors blijven volledig handmatig opslaan en laden.

Questwright Dialogue

Het tempo van dialogen tijdens runtime. Configsectie: [/Script/QuestwrightRuntime.QuestwrightDialogueSettings].

Project Settings → Plugins → Questwright Dialogue

InstellingStandaardWat het doet
Advance Mode (AdvanceMode)ManualHoe regels doorlopen. Manual wacht na elke regel op een klik (de lezer bepaalt het tempo). Auto laat regels spelen en na de voice-over vanzelf doorgaan; alleen keuzes wachten op invoer (filmisch tempo).
Auto Advance Buffer Seconds (AutoAdvanceBufferSeconds)0.4Auto-modus: extra seconden die na de voice-over van een regel worden aangehouden voordat er wordt doorgegaan, een kleine adempauze tussen regels.
Auto Advance No Voice Seconds (AutoAdvanceNoVoiceSeconds)2.5Auto-modus: hoe lang een regel zonder voice-over in beeld blijft, zodat de tekst nog te lezen is.

Beide waarden voor de Auto-modus zijn alleen bewerkbaar wanneer Advance Mode op Auto staat.

Questwright Studio

De culturen voor lokalisatie en de voice-configuratie per cultuur, normaal gesproken bewerkt via de tabbladen Localization en Voice in plaats van met de hand. Configsectie: [/Script/QuestwrightStudio.QuestwrightStudioSettings].

Project Settings → Plugins → Questwright Studio

InstellingWat het doet
Build Cultures (BuildCultures)De set culturen die het project bouwt (bijvoorbeeld en, ru). De eerste vermelding is de fallback voor de broncultuur wanneer een quest geen eigen source_culture opgeeft. Leeg = schrijven in één cultuur.
Voice By Culture (VoiceByCulture)Voice-configuratie per cultuur, met de cultuurcode als sleutel. Elke vermelding bevat de TTS-provider (bijvoorbeeld OmniVoice, ElevenLabs), een model van die provider, een hint voor het outputformaat (bijvoorbeeld wav_24000) en de stemtoewijzing per spreker (sleutel van de spreker → id van de stem bij de provider).

Wat er niet in Project Settings staat

WaardeWaar het staat
API-sleutels van ElevenLabs / Claude / OpenAIIni per gebruiker (buiten git) + fallback via de omgeving, bijvoorbeeld QW_ELEVENLABS_KEY
Questcontent, ketens, prioriteitenDe .quest.yaml-bestanden zelf; er is geen verborgen manifest
Gegenereerde assetsDe map /Game/Questwright/Generated/ van je project