.kfpg Graph file with a StartNode, DialogueNodes and an EndNode. Files live under Resources/{languageEnglishName}/{folderName}/{langCode}.{fileName}.kfpg.
A complete graph
The rest of this page documents each node type in detail.
Node Types
Meta Node
Handles language and reading direction for the file. Used by Parley at load time and and used for UI layout decisions.
LanguageID
required
The language this file is authored in. See LanguageID.
TextDirection
required
Reading direction.
LTR or RTL. See TextDirection.MetaData
default:"Fallback MetaData"
The MetaData for the current file. Connected to a
MetaData utility node.Start Node
Marks the beginning of the file, and handles metadata.
Ports
MetaData
default:"Fallback MetaData"
The MetaData for the current file. Connected to a
MetaData utility node.output
required
The output connection for the next node.
Dialogue Node
Spoken dialogue. The most common node type. Plain dialogue
With flags
Ports
input
required
The input connection from the previous node.
int
default:"0"
Number of flags on the current node.
string
required
Who’s talking.
string
How they feel.
string
required
What they say.
output
required
The output connection for the next node.
string
The flag
X to be set.Choice Node
A dialogue node that presents the player with options. Same as a Dialogue Node but with aChoices list. When Choices is populated, NextNode on the parent is ignored and is prefered to not be set as it is semantically incorrent. The player’s selection determines the next node.
input
required
The input connection from the previous node.
string
required
Who’s prompting the choice.
string
Optional emotion tag.
string
required
The prompt itself.
int
default:"2"
Branch Node
A utility node that routes to one of two targets based on flag state. Branch nodes have no speaker or text. They’re invisible at runtime, used for control flow.
input
required
The input connection from the previous node.
int
default:"0"
Number of flags on the current node.
string
required
Flag
X that must be set for the True branch.output
required
Node to advance to when all flags are set.
output
required
Node to advance to otherwise.
False back to an earlier node in the conversation to create a loop.
End Node
Marks the beginning of the file, and handles metadata.
Ports
input
required
The input connection from the previous node.