Flowchart Controller

The Flowchart Controller plugin allows flowcharts to be controlled in event sheets.

Some of the common uses of the plugin include the following:

Create instances of flowcharts using the Start flowchart or Start flowchart (by name) actions.
Use the Set flowchart action to set an existing flowchart instance as the current one, affecting which flowchart other actions, conditions and expressions act upon.
Use the Go to actions to traverse a flowchart.
Use the Node entered and Node exited triggers to perform other project-specific actions depending on the current state of a flowchart.
Query information from the current node of the current flowchart using expressions.

Flowchart instances

Use the Start flowchart action to create an instance of a flowchart. This is essentially the current state of a flowchart, including the current node. Sometimes only one instance of a flowchart is necessary, which is simpler to use. However it is possible to create multiple instances of the same flowchart, and have each instance track its current node separately. This allows for more advanced uses, such as having every instance of a Sprite object have its own flowchart instance and be able to proceed through the flowchart independently, rather than sharing one flowchart state for all Sprite objects.

The End flowchart action is the counterpart of Start flowchart, and destroys a flowchart instance so it no longer consumes memory.

Flowchart Controller Conditions

On any flowchart entered: Triggered when any flowchart is entered. This will happen after using the Set Flowchart action or after using one of the actions to start a new flowchart and using the parameter to immediately set it as the current one.
On any node entered: Triggered when any node is entered in the current flowchart.
On tagged node entered: Triggered when a node with the specified tag is entered in the current flowchart.
On any node entered in flowchart: Triggered when any node is entered in a flowchart with the specified tag.
On tagged node entered in flowchart: Triggered when a node with the specified tag is entered in a flowchart with the specified tag.
On any flowchart exited: Triggered when any flowchart is exited.
On any node exited: Triggered when any node in the current flowchart is exited.
On tagged node exited: Triggered when a node with the specified tag in the current flowchart is exited.
On any node exited in flowchart: Triggered when any node in the specified flowchart is exited.
On tagged node exited in flowchart: Triggered when a node with the specified tag in the specified flowchart is exited.
Is at start node: Check if the current flowchart is at the start node.
Is at start node in flowchart: Check if the specified flowchart is at the start node.
Has flowchart: Check if a flowchart with the specified tag was already created by either Start flowchart or Start flowchart (by name).

Note this is false if the flowchart was already released by End flowchart or End flowchart by tag actions.
Compare output count: Compare the output count of the current node in the current flowchart.
Compare output name: Compare the output name in the current node of the current flowchart, using an index to choose the output.
Compare output value: Compare the output value in the current node of the current flowchart, using an index or name to choose the output.
Compare node tag: Compare the tag of the current node in the current flowchart.
Compare flowchart tag: Compare the tag of the current flowchart.
Has output: Check if the current node of the current flowchart has an output, using an index or a name to choose the output.
Output name match regex: Check if an output's name in the current node of the current flowchart matches a regular expression, using an index to choose the output.
Output value match regex: Check if an output's value in the current node of the current flowchart matches a regular expression, using an index or name to choose the output.
For Each Output: Run a loop for each output in the current node of the current flowchart.

Flowchart Controller Actions

Start flowchart
Start flowchart (by name): Starts a new flowchart instance. Use the Start node tag parameter so the flowchart starts in that node, if left empty the flowchart's starting node set in the editor is used. The Flowchart tag parameter assigns the flowchart instance a tag to later identify it elsewhere in the event sheet. The Set as current parameter is a shortcut to immediately set the new flowchart as the current one.
Set flowchart: Set the flowchart with the specified tag as the current one. All actions, conditions and expressions used after this will refer to the specified flowchart, except for the case a tag is provided to get information from a specific flowchart instance other than the current one.
End flowchart: Release the current flowchart.
End flowchart by tag: Release the flowchart with the specified tag.
Reset flowchart: Reset the current flowchart, making the default initial node the current one.
Reset flowchart by tag: Reset the specified flowchart, making the default initial node the current one in that flowchart.
Go to next node: Go to the next node, using an index or a name to choose the output to follow.
Go to node: Go to an abrbitrary node in the current flowchart using a tag to find it.
Go to previous node: Go to the previous node of the current flowchart.
Go to parent node: Go to the parent node of the current node in the current flowchart, using an index or a tag to find the parent node. If the node only has one parent the action will just move the flowchart to that node.

Flowchart Controller Expressions

FlowchartTag: Return the tag of the current flowchart.
NodeTag: Return the tag of the current node in the current flowchart.
OutputCount: Return the output count of the current node in the current flowchart.
OutputNameAt(Index): Return the output name at the specified index in the current node of the current flowchart.
OutputValue(IndexOrName): Return the output value at the specified index or name in the current node of the current flowchart.
ParentCount: Return the parent count of the current node in the current flowchart.
ParentTag(ParentIndex): Return the parent node tag of the current node in the current flowchart, specifying a parent index.
ParentIndex(ParentTag): Return the parent node index of the current node in the current flowchart, specifying a parent tag.
TagInFlowchart(FlowchartTag): Return the tag of the current node in the specified flowchart.
OutputCountInFlowchart(FlowchartTag): Return the output count of the current node in the specified flowchart.
OutputNameAtInFlowchart(Index, FlowchartTag): Return the output name at the specified index in the current node of the specified flowchart.
OutputValueInFlowchart(IndexOrName, FlowchartTag): Return the output value at the specified index or name in the current node of the specified flowchart.
ParentCountInFlowchart(FlowchartTag): Return the parent count of the current node in the specified flowchart.
ParentTagInFlowchart(ParentIndex, FlowchartTag): Return the parent tag of the current node in the specified flowchart using an index to pick the parent.
ParentIndexInFlowchart(ParentTag, FlowchartTag): Return the parent index of the current node in the specified flowchart using a tag to pick the parent.
CurOutputName: Return the current output name in a For Each Output loop.
CurOutputValue: Return the current output value in a For Each Output loop.