Dialogue Parameters Reference

Every script handler in Golarion Chronicles reads its configuration from callInfo.ScriptParams, a dictionary of key-value pairs supplied by the dialogue toolset. This document catalogues every parameter name, which handler consumes it, and what it does.

Parameters are case-sensitive. Missing parameters resolve to an empty string (""), so handlers that expect a value will silently no-op if the key is absent.

Quest Handlers

All three quest handlers live in src/Quests/QuestFunctions.cs.

q_startquestat (Action)

Starts a quest for the player when a reply is selected.

Example:

Script: q_startquestat
STARTQUEST: q_foreignquarter
GIVEITEM1: wand_acidsplash

q_finishquestat (Action)

Completes a quest, awards rewards, and updates parent progress.

Example:

Script: q_finishquestat
QUESTRESREF: q_sewerscout

q_queststatusaw (Condition)

Returns true/false to show or hide a dialogue option. This is the primary gating script for all quest-related dialogue. Parameters are evaluated in a fixed priority order; the first applicable check wins.

Modern contract (preferred)

State meanings:

• ABSENT — the player has never started this quest. Option shows only before acceptance.
• READY — the quest is at 100% progress but not yet turned in. Option shows for turn-in.
• FINISHED — the quest has been completed and rewarded. Option shows post-completion.
• INPROGRESS — the quest has been started but is below 100%. Option shows while active.

Legacy parameters (still functional, superseded by QUESTSTATE)

These are checked in order after the modern contract. If any legacy parameter is present, it takes precedence over QUESTSTATE:

Modifier parameters

These can be combined with any of the above:

Example (modern):

Script: q_queststatusaw
QUESTRESREF: q_sewerscout
QUESTSTATE: ABSENT

Example (with parent gate):

Script: q_queststatusaw
QUESTRESREF: q_sewerscout
QUESTSTATE: ABSENT
QUESTINPROGRESS: q_foreignquarter

Venture Captain Handlers

Live in src/Quests/cv_venturecapsc.cs.

cv_venturecapsc (Condition)

Dynamic paginated quest list builder for Venture Captain NPCs. Replaces static dialogue nodes with a database-driven list.

The handler reads the speaker's CONVERSATION local variable to identify which quest pool to query, then filters by:

• Speaker tag matching one of the faction columns (sovereigncourt, libertysedge, theexchange) in gc_quests.quests.
• Player level ±2 (with a special exception: level-12 writs show for level-10 players).
• Excludes quests already marked FINISHED in the player's queststatus JSON.

cv_venturecat (Action)

Handles pagination and quest selection from the dynamic list.

| Parameter | None | Reads the current node text to determine action: [Next Page], [Previous Page], "Thank you for checking.", or a quest display name (starts the quest dialogue). |

cv_setfaction (Action)

Assigns a faction to the player.

cv_gethasfaction (Condition)

Checks whether the player's faction matches the parameter.

Speaker-to-faction mapping:

• GlorianaMorilla → sovereigncourt
• AaqiralHakam → theexchange
• ColsonMaldris → libertysedge

Generic Dialogue Helpers

cv_nwnxdialog (Condition)

Generic paginated list dialog. Same pattern as cv_venturecapsc but without quest-specific filtering.

Reads the speaker's CONVERSATION local variable to select the list source. Currently stubbed (returns null list).

cv_nwnxaction (Action)

Pagination handler for cv_nwnxdialog. No parameters.

cv_startdlg (Action)

Chains into another dialogue file from the current conversation.

cv_openstore (Action)

Opens the merchant window associated with the NPC.

The actual store is resolved from the NPC's MERCHANT_RESREF local variable.

cv_openinventory (Action)

Force-opens a specific inventory container by tag.

Character Setup

cv_charsetup (Condition)

Paginated character setup menu shown at level 5.

cv_csetupat (Action)

Handles selections from the character setup menu. Opens NUI windows based on the selected action text. No parameters beyond NODE_ID (inherited from the condition).

cv_setschool (Action)

Sets a wizard's opposed school.

cv_setdomain (Action)

Replaces a cleric's second domain.

Aeon Stone / Influence Shop

cv_aeonstart (Condition)

Paginated aeon stone purchase/influence shop menu.

Reads the speaker's CONVERSATION local variable or creature's DialogResRef to determine the shop type.

cv_aeonaction (Action)

Handles aeon stone purchases and influence shop navigation. No explicit parameters; dispatches on the current node text.

cv_scrollmaker (Action)

Opens the influence scroll crafting NUI window. No parameters. Uses callInfo.ObjectSelf as the shopkeeper reference.

cv_potionmaker (Action)

Opens the influence potion crafting NUI window. No parameters. Uses callInfo.ObjectSelf as the shopkeeper reference.

Rumors

cv_pickrumor (Condition)

Injects a random rumor into the dialogue node text.

| Parameter | None | Reads the speaker's RUMOR_TYPE local variable (default "low"). Queries gc_rumors.rumors table for a random entry of that type and replaces the placeholder text "rumortext" with the result. |

Transportation

cv_ferryman (Action)

Teleports the party to a waypoint for a gold fee.

cv_fishingrod (Action)

Creates a fishing rod in the player's inventory. No parameters.

Out-of-Character / Utility

ooc_teleport (Trigger)

Handles the OOC door trigger. Redirects characters with incomplete setup to the IC portal. No parameters.

enforcelegalchar (ELC Callback)

Validates character legality on save/load. No dialogue parameters; reads engine validation failure data directly.

cv_djinnattacked (Event)

Called when a djinn merchant is damaged. Spawns a respawn timer. No parameters.

Map / World Transition

worldtransition (Trigger)

Handles world map transitions. No dialogue parameters.

mapabsalom (Trigger)

Specific Absalom map transition handler. No dialogue parameters.

destroymodulate (Trigger)

Destroys modulated objects on transition. No dialogue parameters.

mapclick (Trigger)

World map click handler. No dialogue parameters.

cv_worldmapparty (Action)

Party management from the world map. No parameters.

onentermap / onexitmap (Triggers)

Map enter/exit event hooks. No dialogue parameters.

Quick-Reference: Which Handler Goes Where

JSON Structure Reminder

In .dlg.json files, parameters appear as key-value pairs inside:

• ConditionParams on reply references (for Active/condition scripts)
• ActionParams on replies (for action scripts)

Both use the same flat dictionary format:

{
  "type": "dictionary",
  "value": {
    "QUESTRESREF": { "type": "string", "value": "q_sewerscout" },
    "QUESTSTATE": { "type": "string", "value": "ABSENT" }
  }
}

Integer parameters (like NODE_ID, LEVEL, MARKUP, MARKDOWN) use the same structure with a numeric string value.