Custom Button TEST (Flowgraph Node)

Overview

• Node Name: Custom Button TEST
• Category: once_instant
• File: extensions/flowgraph/nodes/ui/customButtonTEST.lua
• Status: TEST node - experimental/example

Demonstrates how to create custom UI buttons that trigger flowgraph actions via guihooks and core_flowgraphManager callbacks.

Pin Schema

Output Pins

Dependencies

• core_input_bindings

How It Works

1. _executionStarted() - Sets open = false.
2. workOnce() - Sends button data to the UI via guihooks.trigger('CustomFGButtons', data).
3. Each button entry contains a name and a fun string - a Lua command that calls back into the node:

   core_flowgraphManager.getManagerByID(mgrId).graphs[graphId].nodes[nodeId]:buttonPushed("btn_1")

4. buttonPushed(action) - Sets the matching output pin to true and all others to false.
5. _executionStopped() / onNodeReset() - Closes the dialogue by sending an empty button list.
6. closeDialogue() - Triggers guihooks.trigger('CustomFGButtons', {}) to hide all custom buttons.

Callback Pattern

The key pattern here is generating a Lua command string that the UI can execute to call back into a specific flowgraph node:

function C:getCmd(action)
  return 'core_flowgraphManager.getManagerByID('..self.mgr.id
    ..').graphs['..self.graph.id
    ..'].nodes['..self.id
    ..']:buttonPushed("'..action..'")'
end

Example Usage

-- This is a test/example node showing the custom button pattern.
-- For production use, prefer the simpleButton or createButton nodes.
-- The pattern is useful when you need fully custom UI button behavior.
guihooks.trigger('CustomFGButtons', {
  { name = "Click me!", fun = callbackCommand }
})

Previously Undocumented (Added by Audit)

• C:openDialogue() - Function handling openDialogue logic

See Also

• Medal / Auto Medal (Flowgraph Node) - Related reference
• Clear Messages (Flowgraph Node) - Related reference
• Context Translation (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide