Blueprint Structs and Enums

Create a Blueprint enum with its entries

Creates a Blueprint enum (UserDefinedEnum) through the engine's own factory, then adds the entries in order with their tooltips, the description and the bitflags setting. Entry names are display names: unique, and checked before anything is added. The asset is saved. validate_enum checks it.

cfa create_enum --asset-path /Game/Data/E_MoveMode --json '{"entries":["Walk",{"name":"Run","tooltip":"Full speed"},"Crouch"],"description":"How the hero moves"}'

Read a Blueprint enum's entries

Lists each entry's display name, internal name (what Blueprints store), value and tooltip, with the description and bitflags setting.

cfa get_enum --asset-path /Game/Data/E_MoveMode

Edit a Blueprint enum's entries, description and bitflags

Applies operations in order, as the enum editor does: add (with an optional tooltip), rename (the display name; Blueprints keep working because they store the internal name), remove, move (to a final index) and tooltip. Every operation is checked first against the list as the earlier ones leave it, so one bad operation changes nothing. Entries are found by display or internal name.

cfa set_enum --asset-path /Game/Data/E_MoveMode --json '{"ops":[{"add":"Sprint","tooltip":"Faster than run"},{"rename":"Crouch","to":"Sneak"},{"move":"Sprint","index":0},{"remove":"Walk"}]}'

Check a Blueprint enum with a verdict

Fails on no entries, empty or repeated names, or more than 32 entries in a bitflags enum; warns on entries still carrying a default name.

cfa validate_enum --asset-path /Game/Data/E_MoveMode

Create a Blueprint struct (UserDefinedStruct), optionally with members

Creates a Blueprint struct asset. Optionally define all members in one atomic call via the members array (each entry: name + the same type fields as add_blueprint_struct_variable, plus default_value/tooltip). New structs are seeded with one default bool member; when you supply members that seed is removed automatically. Auto-saves.

cfa create_blueprint_struct --asset-path /Game/Data/S_Loot --members '[{"name":"ItemId","variable_type":"name"},{"name":"Count","variable_type":"int","default_value":1},{"name":"Icon","variable_type":"softobject","type_path":"/Script/Engine.Texture2D"}]'

Add a member variable to a Blueprint struct

Adds one member variable of any supported type to a Blueprint struct. Supports object/class refs, TSoftObjectPtr/TSoftClassPtr/TSubclassOf, structs (incl. InstancedStruct), enums, and array/set/map containers. Auto-saves and recompiles the struct.

cfa add_blueprint_struct_variable --asset-path /Game/Data/S_Loot --name "DropChance" --variable-type float --default-value 0.5

Rename, retype, re-default, or re-tooltip a struct member

Edits an existing member identified by name or guid. Provide new_name to rename, the type fields to retype, default_value to change the default, and/or tooltip. Only the fields you pass are changed. Auto-saves and recompiles.

cfa set_blueprint_struct_variable --asset-path /Game/Data/S_Loot --name "Count" --default-value 5

Remove a member from a Blueprint struct

Removes a member identified by name or guid. A struct must keep at least one member, so the last one cannot be removed. Auto-saves and recompiles.

cfa remove_blueprint_struct_variable --asset-path /Game/Data/S_Loot --name "DropChance"

List a Blueprint struct's members (name, type, default, tooltip)

Returns every member of a Blueprint struct in order: name, guid, human-readable type, default value, and tooltip. Use before editing to see what exists.

cfa describe_blueprint_struct --asset-path /Game/Data/S_Loot

Search Blueprint structs in the project (ranked best-match first)

Lists Blueprint struct assets, RANKED by relevance to filter (exact > prefix > substring in name > match in path); the BEST max_results are returned. Response includes total_matches and truncated so a cap is never silent. Omit filter to list all under path.

cfa list_blueprint_structs --filter "Loot" --max-results 5