Curves

Create a Curve asset (float, vector, or linear color)

Creates a Curve asset of the chosen type: float (CurveFloat, one value sub-curve), vector (CurveVector, x/y/z sub-curves), or linear_color (CurveLinearColor, r/g/b/a sub-curves). The curve starts empty; add keys with set_curve_keys. For an Ease Curve Library (UE 5.7+) use create_data_asset with class_name EaseCurveLibrary instead, it is a plain data asset.

cfa create_curve --asset-path /Game/Curves/C_Speed --curve-type float

Read a curve asset's keys, settings, and ranges

Returns each sub-curve's keys (time, value, interp, tangents), pre/post infinity extrapolation, and the asset's time/value ranges. Pass eval_times to also evaluate the curve at given times (handy for verifying results). Pass as_json true to get the engine's own full-fidelity JSON export instead, which round-trips through import_curve.

cfa get_curve --asset-path /Game/Curves/C_Speed --eval-times '[0, 0.5, 1]'

Write keys on one sub-curve of a curve asset

Writes keys on one sub-curve: value (float curves), x/y/z (vector), or r/g/b/a (linear color). Mode replace (default) rebuilds the sub-curve from the given keys; merge updates-or-adds by time and leaves other keys alone. Each key: time and value required, plus optional interp (cubic default, linear, constant), tangent_mode (auto default, smart_auto, user, break; explicit arrive/leave tangent slopes apply with user/break), and weighted tangents (weight_mode + weights). Also sets pre/post infinity extrapolation and the no-keys default value.

cfa set_curve_keys --asset-path /Game/Curves/C_Speed --keys '[{"time":0,"value":0},{"time":1,"value":100,"interp":"linear"}]'

Delete keys from one sub-curve

Deletes keys from one sub-curve by their times (nearest key within a small tolerance), or clears the whole sub-curve with all=true.

cfa delete_curve_keys --asset-path /Game/Curves/C_Speed --times '[0.5]'

Replace a curve asset's data from JSON or CSV

Replaces the whole curve from text data using the engine's own importers. Format json takes the engine curve JSON (exactly what get_curve --as-json returns, full fidelity including tangents). Format csv takes rows of time,value (one value column per sub-curve: 1 for float, 3 for vector, 4 for linear color); CSV keys import as linear.

cfa import_curve --asset-path /Game/Curves/C_Speed --format csv --data '0,0\n1,100'

Create a Curve Table (or Composite Curve Table)

Creates an empty Curve Table. Whether it stores rich curves (per-key interpolation, like the Cubic option in the editor dialog) or simple curves (one interpolation per row, the Linear/Constant options) is fixed by the FIRST row added, pass curve_type on set_curve_table_row, or by import_curve_table's interp. With composite true it creates a Composite Curve Table that stacks the given parent tables instead.

cfa create_curve_table --asset-path /Game/Curves/CT_Damage

Read a curve table's rows and keys

Returns the table mode (rich, simple, or empty) and its rows with key counts. Filter narrows rows by name substring; include_keys adds per-key data; eval_times evaluates each matched row at the given times. Pass export json or csv to instead get the whole table in the engine's export format (round-trips through import_curve_table).

cfa get_curve_table --asset-path /Game/Curves/CT_Damage --include-keys --eval-times '[1, 10]'

Add or update one curve table row

Adds or updates one row (curve) in a curve table. While the table is EMPTY, curve_type picks rich (per-key interpolation, extrapolation) or simple (one interpolation for the whole row via interp); after that the table's mode applies to every row, an engine rule. Mode replace (default) rebuilds the row from the given keys; merge updates-or-adds by time. Rich rows take the same key objects as set_curve_keys.

cfa set_curve_table_row --asset-path /Game/Curves/CT_Damage --row-name Turret --keys '[{"time":1,"value":10},{"time":10,"value":250}]'

Delete a row from a curve table

Deletes one row (curve) from a curve table by name.

cfa delete_curve_table_row --asset-path /Game/Curves/CT_Damage --row-name Turret

Rename a row in a curve table

Renames one row (curve) in a curve table, keeping all of its keys.

cfa rename_curve_table_row --asset-path /Game/Curves/CT_Damage --row-name Turret --new-name HeavyTurret

Replace ALL rows of a curve table from CSV or JSON

Rebuilds the whole curve table from text using the engine's own importers, exactly like importing in the editor. CSV: first row is a header whose columns are key times, each following row is name,value,value... JSON: the engine's curve table JSON (what get_curve_table --export json returns). interp picks how keys import: linear or constant produce simple curves, cubic produces rich curves. This REPLACES all existing rows.

cfa import_curve_table --asset-path /Game/Curves/CT_Damage --format csv --data 'Name,1,10\nTurret,10,250'

Create a Curve Atlas from linear color curves

Creates a Curve Atlas (CurveLinearColorAtlas), a texture whose rows are gradients baked from CurveLinearColor assets, for use with the CurveAtlasRowParameter material node. Width sets the texture width (per-curve sample count). Curves can be added now or later with set_curve_atlas.

cfa create_curve_atlas --asset-path /Game/Curves/CA_Gradients --width 256 --gradient-curves /Game/Curves/C_Heat,/Game/Curves/C_Cool

Edit a Curve Atlas (resize, add/remove/replace curves)

Edits a Curve Atlas: width resizes the texture, add_curves appends gradient rows, remove_curves removes them, and set_curves replaces the entire list in one go (do not combine set_curves with add/remove). Textures rebuild and dependent materials refresh automatically, the same path the editor's details panel uses.

cfa set_curve_atlas --asset-path /Game/Curves/CA_Gradients --add-curves /Game/Curves/C_Toxic