Data Tables

Create a new Data Table with a chosen row struct

Creates a Data Table asset whose rows use the given row struct. The row struct must be a valid table row, a C++ struct deriving from FTableRowBase or a Blueprint (User Defined) struct, exactly what the editor's 'Pick Row Structure' dialog lists. Pass either a struct name (e.g. "ItemData") or a full path (e.g. "/Script/Jiggify.ItemData"). Use list_data_table_row_structs to discover valid structs. Auto-saves.

cfa create_data_table --asset-path /Game/Data/DT_Items --row-struct "ItemData"

Search structs usable as Data Table row structures (ranked best-match first)

Enumerates structs that can back a Data Table, C++ structs deriving from FTableRowBase plus Blueprint (User Defined) structs, matching the editor's 'Pick Row Structure' dialog. Results are RANKED by relevance to filter (exact name > prefix > substring in name > match in path) and the BEST max_results are returned, so 'top 5 matching Item' returns the 5 closest matches, not an arbitrary 5. The response includes total_matches and truncated so you know if more exist. Omit filter to list all (use a larger max_results). Use the chosen name/path as create_data_table's row_struct.

cfa list_data_table_row_structs --filter "Item" --max-results 5

Get all rows from a Data Table

Returns every row in a Data Table with all field values. Use get_data_table_schema first to understand column types.

cfa get_data_table_rows --data-table-path /Game/Data/DT_Items

Get a single row by name

Returns one row from a Data Table by its row name. More efficient than get_data_table_rows when you only need one row.

cfa get_data_table_row --data-table-path /Game/Data/DT_Items --row-name "IronOre"

Get column names and types from row struct

Returns the struct definition behind a Data Table: column names, types, and default values. Always call this before adding or updating rows to understand the expected field types.

cfa get_data_table_schema --data-table-path /Game/Data/DT_Items

Add a new row with optional initial data

Adds a new row to a Data Table. The data parameter is a JSON string of field name-value pairs matching the table's schema. Auto-saves the table.

cfa add_data_table_row --data-table-path /Game/Data/DT_Items --row-name "CopperOre" --data '{"DisplayName":"Copper Ore","StackSize":100,"ItemForm":"Solid"}'

Update specific fields on an existing row

Updates one or more fields on an existing Data Table row. Only the fields specified in data are modified; other fields keep their current values. Auto-saves.

cfa update_data_table_row --data-table-path /Game/Data/DT_Items --row-name "IronOre" --data '{"StackSize":200}'

Delete a row by name

Removes a row from a Data Table. Auto-saves. Cannot be undone.

cfa delete_data_table_row --data-table-path /Game/Data/DT_Items --row-name "OldItem"

Rename a row in-place

Changes the name of an existing Data Table row while preserving all its data and order. Auto-saves.

cfa rename_data_table_row --data-table-path /Game/Data/DT_Items --old-row-name "Item1" --new-row-name "IronIngot"

Copy a row under a new name

Creates a copy of an existing row with a new name, keeping all field values identical. Useful for creating similar items with minor variations.

cfa duplicate_data_table_row --data-table-path /Game/Data/DT_Items --source-row-name "IronOre" --new-row-name "CopperOre"