Blueprint nodes

Every node the plugin adds to the Blueprint editor, grouped the way they appear in the node menu under Data Table Extensions. The nodes work in gameplay Blueprints and editor tools, in the editor and in packaged games on Windows, macOS, and Linux. They run on the game thread, so they cannot be used in thread-safe animation functions.

Callable nodes have execution pins. Pure nodes have none and run when a connected node reads their output. Pin names match the editor. Most nodes return row names; read the rows with the standard Get Data Table Row node or the Read nodes.

For which node to use for a task, start with the User manual.

Before you start#

Shared pins#

Nodes that read a table share these pins. The entries below list them again only where a node differs.

Check Success before using a result. A query that matches nothing still succeeds; check the length of the returned array.

Pins that must be connected#

The Blueprint does not compile while one of these inputs is unconnected:

• every array input, such as Conditions, Excluded Row Names, Row Names, Input Rows, A, and B. Connect an empty Make Array when you have nothing to pass;
• Options on Query Data Table Rows. Connect Make Query Options;
• the Text Value pin of Get Data Table Row Names By Text Field and Make Text Filter Condition. Connect a Text variable or a literal Text node.

String, Name, number, vector, and Random Stream pins can be typed into or left unconnected.

Rules shared by every node#

Which field types each node accepts, how paths are written, how values are compared, and how Use Cache refreshes are described once in the Feature reference.

Error messages#

Error Message holds one of these texts when Success is false. Parts in angle brackets are filled in by the node with the path, field, or row concerned. The Output Log also shows a warning for missing rows and invalid paths.

When a node fails, its outputs are cleared: arrays are emptied, counts are 0, and read values return to their defaults. The single random-pick nodes are the exception: on Input collection is empty. their Row Name can keep an earlier value, so always branch on Success.

Filter nodes#

One callable node per field type. Each compares a single field against a value and returns the names of the matching rows, in table order. Use Query Data Table Rows for several conditions.

Inputs: Data Table, Property Path, Compare Op, the value pin, and Use Cache. Outputs: Matching Row Names, Success, and Error Message. A type mismatch is reported only when the table has at least one row.

Query nodes#

Combine several conditions, filter by a numeric range, or find the first match. The condition-based nodes take an array of Data Table Filter Condition values, built with the pure Make … Filter Condition nodes and Make Array.

Query Data Table Rows#

Callable · Menu: Data Table Extensions › Query

Returns every row that matches the conditions, with the number of matches. This is the recommended node for filtering on more than one field.

• Excluded rows are skipped before any condition is checked. Their names are matched ignoring case, and names not in the table are ignored.
• AND stops checking a row at its first failing condition; OR stops at the first passing one. A condition whose type does not fit its field therefore fails the query only when a row actually checks it.

Make Query Options#

Pure · Menu: Data Table Extensions › Query

Builds the Options input for Query Data Table Rows.

Make … Filter Condition#

Pure · Menu: Data Table Extensions › Query

One node per field type. Each builds a single condition for Query Data Table Rows, Find First Matching Row Name, and the matching random nodes. Inputs: Property Path, Comparison, Value. Output: Return Value, a Data Table Filter Condition. The comparison and field rules are the same as for the filter nodes.

Get Data Table Row Names By Int Range#

Callable · Menu: Data Table Extensions › Query

Returns rows whose integer field lies between two values. Get Data Table Row Names By Float Range is the same node for float fields, with Float bounds.

A Min Value above Max Value succeeds with no rows. The field type is checked before any row is read, so a mismatch fails even on an empty table.

Count Rows In Int Range#

Callable · Menu: Data Table Extensions › Query

Counts rows whose integer field lies between two values, without returning their names. Count Rows In Float Range is the float version. The bounds work as on the range nodes above, including Include Min and Include Max defaulting to off.

Find First Matching Row Name#

Callable · Menu: Data Table Extensions › Query

Returns the first row, in table order, that matches the conditions, and stops there. It never uses the cache and has no exclusions input.

Clear Query Cache#

Callable · Menu: Data Table Extensions › Query

Forgets remembered query results for every table. Use it after switching the game language if you filter Text fields.

Invalidate Cache For Data Table#

Callable · Menu: Data Table Extensions › Query

Forgets remembered query results for one table. Use it after C++ code changes row data directly. Does nothing when no table is connected.

Read nodes#

Read a field from one row, from a list of rows, or from every row. Each node exists once for every supported value type. Row names are matched ignoring case.

Get … Property From Data Table Row#

Callable · Menu: Data Table Extensions › Read

Reads one field from one row. Inputs: Data Table, Row Name, Property Path. Outputs: Value, Success, Error Message. On failure, Value returns to its default, such as 0, empty text, or a zero vector.

Get … Property For Rows#

Callable · Menu: Data Table Extensions › Read

Reads the same field from each row in Row Names, for the same value types as the single-row node, such as Get Float Property For Rows. Inputs: Data Table, Row Names (must be connected), Property Path. Outputs: Values, Success, Error Message. Each entry of Values holds a Row Name and its Value.

The result follows the order of Row Names, repeating duplicates. It is all or nothing: one missing row fails the node and empties Values. An empty Row Names array succeeds with no values.

Get … Property For All Rows#

Callable · Menu: Data Table Extensions › Read

Reads the same field from every row, in table order, for the same value types, such as Get Int Property For All Rows. Inputs: Data Table, Property Path. Outputs: Values, Success, Error Message. An empty table succeeds with no values.

Inspect nodes#

Discover which fields a table has and what type each one is. Use them when you build a path or choose a typed node. The Is … nodes return false instead of reporting an error.

Get Leaf Property Paths#

Callable · Menu: Data Table Extensions › Inspect

Lists every field the plugin can read, with nested structs expanded to any depth, in declaration order. Engine value types such as Vector or Transform are listed as one entry each; their components, such as Location.Z, also work as paths but are not listed. Arrays, maps, sets, and references are left out.

Get Property Type At Path#

Callable · Menu: Data Table Extensions › Inspect

Returns the value category of a field.

Get Property Type Name At Path#

Callable · Menu: Data Table Extensions › Inspect

Returns the engine's name for the field's type, such as IntProperty, DoubleProperty for a Blueprint Float, StrProperty, NameProperty, TextProperty, BoolProperty, Enum(…) with the enum's name, or Struct(…) with the struct's name, such as Struct(Vector).

Is Property Numeric#

Pure · Menu: Data Table Extensions › Inspect

True only for Int and Float fields.

Is Property Enum#

Pure · Menu: Data Table Extensions › Inspect

True for enum fields.

Is Property Struct#

Pure · Menu: Data Table Extensions › Inspect

True only for the generic Struct category: your own structs and engine structs the plugin does not compare directly.

Get Enum Entries At Path#

Callable · Menu: Data Table Extensions › Inspect

Lists the entry names of the enum a field uses, in declaration order. These are the names used in code, not the display names: Blueprint enums return NewEnumerator0, NewEnumerator1, and so on. Hidden entries are included; entries whose names end in _MAX, in any capitalization, are left out.

Get Supported Comparison Operators For Path#

Callable · Menu: Data Table Extensions › Inspect

Lists the comparisons a field supports, written without spaces: Equal, NotEqual, Less, LessOrEqual, Greater, GreaterOrEqual, Contains, StartsWith, EndsWith.

Get Property Paths By Type#

Callable · Menu: Data Table Extensions › Inspect

Lists the paths of one value category, from the same list as Get Leaf Property Paths.

Get Numeric Property Paths#

Callable · Menu: Data Table Extensions › Inspect

Lists every Int and Float path.

Get Enum Property Paths#

Callable · Menu: Data Table Extensions › Inspect

Lists every enum path.

Get Child Property Paths For Struct Path#

Callable · Menu: Data Table Extensions › Inspect

Lists every field inside a struct field, at all depths, prefixed with the path you typed. It works on engine value types too: Location returns Location.X, Location.Y, and Location.Z.

Stats nodes#

Summarize one field across the whole table. String, Name, and Text values that differ only in letter case count as the same value; the first spelling is kept.

Get Distinct … Values At Path#

Callable · Menu: Data Table Extensions › Stats

Returns each different value in a field once. Inputs: Data Table, Property Path. Outputs: Values, Success, Error Message. An empty table succeeds with no values. Names ending in a number sort by that number, so Item_2 comes before Item_10.

Count Distinct Values At Path#

Callable · Menu: Data Table Extensions › Stats

Counts how many different values a field has. Supports Int, Float, String, Name, Text, Bool, and Enum fields. An empty table returns 0.

Get Min Numeric Value At Path#

Callable · Menu: Data Table Extensions › Stats

Returns the smallest value of an Int or Float field. Get Max Numeric Value At Path, Get Average Numeric Value At Path, and Get Sum Numeric Value At Path return the largest value, the mean, and the total. All four fail on an empty table.

Get … Value Counts At Path#

Callable · Menu: Data Table Extensions › Stats

Returns each different value with the number of rows that use it. Inputs: Data Table, Property Path, Sort By Count Descending. Outputs: Counts, Success, Error Message. Each entry of Counts holds a Value and its Count.

By default, entries are sorted by value, ascending, and Boolean lists false before true. With Sort By Count Descending on, the most common value comes first, with ties sorted by value. Only values that occur are listed.

Validation nodes#

Check a table for data problems, or check that a row or path exists before you use it.

Find Rows With Duplicate Value At Path#

Callable · Menu: Data Table Extensions › Validation

Returns every row whose value is shared with another row, including the first occurrence. Supports String, Name, Text, Bool, Enum, Int, and Float fields; text is compared ignoring case. Rows are grouped by value, in the order each value first appears: for rows A = x, B = y, C = x, D = y the result is A, C, B, D.

Find Rows With Empty String Or Name At Path#

Callable · Menu: Data Table Extensions › Validation

Returns rows whose String, Name, or Text field is empty, in table order. A String is empty only when it has no characters, so a value of spaces is not empty; a Name is empty when it is None; a Text is empty when its displayed text is empty.

Does Data Table Have Row#

Pure · Menu: Data Table Extensions › Validation

True when the table contains the row. The name is matched ignoring case.

Does Data Table Have Property Path#

Pure · Menu: Data Table Extensions › Validation

True when the row structure has a field at the path, even one other nodes cannot use, such as an array. Validate Path Across Data Table does exactly the same; neither checks individual rows.

Utility nodes#

Work with arrays of row names: combine lists, trim them, page through them, shuffle them, or sort them. Names are matched ignoring case. Only the sort-by-path nodes need a table.

Union Row Names#

Pure · Menu: Data Table Extensions › Utility

All of A, including its own repeats, followed by the names from B that A does not have.

Intersect Row Names#

Pure · Menu: Data Table Extensions › Utility

Names present in both lists, once each, in A's order.

Subtract Row Names#

Pure · Menu: Data Table Extensions › Utility

Names in A that are not in B, in A's order, keeping A's repeats.

Remove Duplicate Row Names#

Pure · Menu: Data Table Extensions › Utility

Keeps the first occurrence of each name.

Take First N Row Names#

Pure · Menu: Data Table Extensions › Utility

The first Count names. A negative Count returns nothing; a Count larger than the list returns everything.

Skip First N Row Names#

Pure · Menu: Data Table Extensions › Utility

Everything after the first Count names. A negative Count returns everything; a Count larger than the list returns nothing.

Take Page Row Names#

Callable · Menu: Data Table Extensions › Utility

Returns one page of a paged list, plus the number of pages.

Shuffle Row Names#

Callable · Menu: Data Table Extensions › Utility

Returns the names in a random order, keeping repeats.

Seeded Shuffle Row Names#

Callable · Menu: Data Table Extensions › Utility

Shuffles repeatably: the same list and seed always give the same order. The result depends on the order of the list you pass in.

Take Random N Row Names#

Callable · Menu: Data Table Extensions › Utility

Picks Count different names at random, after removing repeats. A Count of 0 or less returns nothing; a Count larger than the list returns every name in random order.

Take Seeded Random N Row Names#

Callable · Menu: Data Table Extensions › Utility

Repeatable version of Take Random N Row Names. The result depends on the order of the list you pass in.

Sort Row Names Alphabetically#

Pure · Menu: Data Table Extensions › Utility

Sorts the names themselves A to Z, ignoring case and removing repeats. Names ending in a number sort by that number.

Sort Rows By Int Path#

Callable · Menu: Data Table Extensions › Utility

Sorts row names by a field's value. Sort Rows By Float Path, Sort Rows By Name Path, Sort Rows By String Path, and Sort Rows By Text Path sort by fields of those types. There is no Enum or Bool sort.

Ties are ordered by row name, A to Z. Repeated input rows are kept, and a missing row fails the sort. String and Name values sort ignoring case. Text sorts by displayed text, ignoring case, without language-specific rules, so accented letters come after Z.

Random nodes#

Pick rows at random from a whole table or from the rows that match conditions. See Random rewards for examples.

Get Random Row Name#

Callable · Menu: Data Table Extensions › Random

One row, each with an equal chance. Fails on an empty table. Get Seeded Random Row Name adds a Random Stream input.

Get Random Row Names#

Callable · Menu: Data Table Extensions › Random

Several different rows. A Count larger than the table returns every row, shuffled. A Count of 0 or less, or an empty table, returns an empty list with Success true. Get Seeded Random Row Names adds a Random Stream input; for the same seed, a larger Count keeps the smaller Count's picks and adds more.

Get Random Matching Row Name#

Callable · Menu: Data Table Extensions › Random

One row chosen from the rows that match the conditions. Fails with Input collection is empty. when nothing matches. Get Seeded Random Matching Row Name adds a Random Stream input.

Get Weighted Random Row Name#

Callable · Menu: Data Table Extensions › Random

One row, where rows with a larger weight are more likely. Get Seeded Weighted Random Row Name adds a Random Stream input.

A negative weight counts as 0. A zero-weight row is never picked while any row has a positive weight. When every weight is 0, each row has an equal chance.

Get Weighted Random Matching Row Name#

Callable · Menu: Data Table Extensions › Random

Applies the conditions first, then makes a weighted pick among the matching rows. Get Seeded Weighted Random Matching Row Name adds a Random Stream input.

Seeded nodes#

• Every seeded node leaves your Random Stream unchanged, so calling a node twice with the same stream gives the same result. For a different pick each time, change the seed, or ask for several rows in one call.
• An unconnected stream uses seed 0.
• Seeded weighted nodes give the same result for the same seed regardless of row order, across sessions and machines.
• Seeded Shuffle Row Names and Take Seeded Random N Row Names depend on the order of the list you pass in.

Deprecated nodes#

These nodes still work in existing graphs but are hidden from the node menu. They behave like Query Data Table Rows; replace them when you next edit the graph.

Structures and enumerations#

Types you meet on node pins. Use Break on a structure pin to read its members.

Data Table Filter Condition#

One condition. Build it with a Make … Filter Condition node rather than by hand: the node sets Property Path, Value Type, the comparison, and the value that belong together. A hand-made condition whose Value Type stays Unknown fails the query.

Data Table Query Options#

Options for Query Data Table Rows.

Row and value pairs#

Returned in the Values array of the For Rows and For All Rows read nodes. Each has a Row Name and a Value of the node's type.

Value counts#

Returned in the Counts array of the Value Counts nodes. Each has a Value and a Count.

Comparisons#

The choices offered by Compare Op and Comparison pins.

Value categories#

Returned by Get Property Type At Path and accepted by Get Property Paths By Type.