1 dialogue quest localization handoff
forgejo-actions edited this page 2026-07-11 10:33:50 +00:00

Dialogue, Quest, And Localization Handoff

Purpose

This workflow explains how narrative-facing edits move from dialogue drafts and quest workbench changes into runtime catalogs, trigger repairs, quest projections, and localization extraction. Use it when a dialogue branch, quest objective, trigger choice, or localized line changes behavior across editor and runtime.

Steps

  1. Author dialogue and quest changes through their editor surfaces or source catalogs.
  2. Save drafts into the dialogue catalog and keep aggregate dialogue output generated by its owner path.
  3. Use quest hookup and trigger repair tools when dialogue choices create quest flags, accept actions, or turn-in behavior.
  4. Run validation to catch broken ids, missing quest references, and unresolved event or localization keys.
  5. Run authoring bake so quest projection and localization extraction caches reflect the current story content.

Expected Outputs

Dialogue edits should appear in the saved catalog and aggregate catalog. Quest edits should update quest_catalog.json and the baked quest projection. Localization extraction should include dialogue, quest, UI, game-data, and scene cutscene strings, plus validation issues for missing or conflicting localization data.

Common Mistakes

Do not leave a dialogue editor draft unsaved and expect bake to see it. Do not create quest flags in dialogue without running hookup repair or validation. Do not edit aggregate dialogue or localization cache output directly. Do not assume a trigger preview proves quest projection bake is current.

Recovery Paths

If a choice does not fire the expected quest behavior, inspect the dialogue catalog, trigger repair output, and quest hookup report. If localization extraction reports missing keys, fix authored text or key ownership and rerun bake. If runtime quest state differs from editor preview, rebuild quest projection and check gameplay action audit for the authoritative result.