Enhanced Input

Create a new UInputAction asset

Creates a new UInputAction asset at the given path. Set value_type to control the action's output dimensionality (Boolean for buttons, Axis1D for triggers, Axis2D for sticks/mouse, Axis3D for spatial). Pass additional properties as JSON to configure consumption, accumulation, and other settings.

cfa create_input_action --asset-path /Game/Input/Actions/IA_Jump --value-type Boolean
cfa create_input_action --asset-path /Game/Input/Actions/IA_Move --value-type Axis2D
cfa create_input_action --asset-path /Game/Input/Actions/IA_Look --value-type Axis2D --properties '{"bConsumeInput": true}'

Read all properties, triggers, and modifiers of an Input Action

Returns the full configuration of an Input Action including its value type, all attached triggers (Hold, Pressed, Tap, etc.), and all attached modifiers (DeadZone, Negate, Scalar, etc.). Use to inspect an action before adding or removing triggers/modifiers.

cfa get_input_action --asset-path /Game/Input/Actions/IA_Jump

Set properties on an Input Action

Modifies properties on an existing Input Action. Can change the value_type or set any UPROPERTY via the properties JSON. Call save_asset after to persist changes.

cfa set_input_action_properties --asset-path /Game/Input/Actions/IA_Jump --value-type Boolean
cfa set_input_action_properties --asset-path /Game/Input/Actions/IA_Move --properties '{"bConsumeInput": false}'

Add a trigger to an Input Action

Adds a trigger directly to the Input Action asset. Triggers define when the action fires (Pressed for instant, Hold for sustained press, Tap for quick press-release, Released for key-up). Properties vary by trigger type -- e.g., Hold has HoldTimeThreshold, Tap has TapReleaseTimeThreshold. Use list_trigger_types to discover available types.

cfa add_input_action_trigger --asset-path /Game/Input/Actions/IA_Interact --trigger-type Pressed
cfa add_input_action_trigger --asset-path /Game/Input/Actions/IA_Crouch --trigger-type Hold --properties '{"HoldTimeThreshold": 0.5}'
cfa add_input_action_trigger --asset-path /Game/Input/Actions/IA_Dodge --trigger-type Tap --properties '{"TapReleaseTimeThreshold": 0.2}'

Add a modifier to an Input Action

Adds a modifier directly to the Input Action asset. Modifiers transform the input value before it reaches gameplay code (DeadZone filters noise, Negate inverts axes, Scalar multiplies values, SwizzleInputAxisValues reorders axes). Use list_modifier_types to discover available types and their properties.

cfa add_input_action_modifier --asset-path /Game/Input/Actions/IA_Look --modifier-type DeadZone --properties '{"LowerThreshold": 0.1}'
cfa add_input_action_modifier --asset-path /Game/Input/Actions/IA_Look --modifier-type Negate
cfa add_input_action_modifier --asset-path /Game/Input/Actions/IA_Move --modifier-type Scalar --properties '{"Scalar": {"X": 2.0, "Y": 2.0, "Z": 1.0}}'

Remove a trigger by index

Removes a trigger from an Input Action by its zero-based index. Use get_input_action first to see the list of triggers and their indices.

cfa remove_input_action_trigger --asset-path /Game/Input/Actions/IA_Jump --index 0

Remove a modifier by index

Removes a modifier from an Input Action by its zero-based index. Use get_input_action first to see the list of modifiers and their indices.

cfa remove_input_action_modifier --asset-path /Game/Input/Actions/IA_Look --index 1

List all UInputAction assets

Lists all UInputAction assets under the given path. Use filter to narrow results by name substring. Useful for discovering existing actions before creating new ones or setting up mapping contexts.

cfa list_input_actions
cfa list_input_actions --path /Game/Input/Actions --filter "Move"
cfa list_input_actions --recursive=false --max-results 50

Create a new UInputMappingContext asset

Creates a new Input Mapping Context asset. Mapping contexts bind keys to Input Actions and are added to players at runtime via AddMappingContext. After creation, use add_key_mapping to populate it with key-to-action bindings.

cfa create_input_mapping_context --asset-path /Game/Input/IMC_Default
cfa create_input_mapping_context --asset-path /Game/Input/IMC_Vehicle --description "Vehicle-specific controls"

Read all key mappings with triggers/modifiers

Returns the full contents of a mapping context including every key-to-action binding with their per-mapping triggers and modifiers. Each mapping entry includes its index, which you need for set_key_mapping, add_mapping_trigger, and add_mapping_modifier.

cfa get_input_mapping_context --asset-path /Game/Input/IMC_Default

Add a key-to-action mapping

Adds a key binding to a mapping context, linking a physical key to an Input Action. Optionally attach per-mapping triggers and modifiers as JSON arrays. Key names use Unreal FKey names -- use list_input_keys to discover valid key names.

cfa add_key_mapping --context-path /Game/Input/IMC_Default --action-path /Game/Input/Actions/IA_Jump --key SpaceBar
cfa add_key_mapping --context-path /Game/Input/IMC_Default --action-path /Game/Input/Actions/IA_Move --key W --modifiers '[{"type":"SwizzleInputAxisValues","properties":{"Order":"YXZ"}}]'
cfa add_key_mapping --context-path /Game/Input/IMC_Default --action-path /Game/Input/Actions/IA_Shoot --key LeftMouseButton --triggers '[{"type":"Pressed"}]'

Remove a mapping by index or action+key

Removes a key-to-action mapping from a context. Specify either the mapping index (from get_input_mapping_context output) or an action_path+key combination to identify the mapping. Using index is faster when you know it; action+key is more readable.

cfa remove_key_mapping --context-path /Game/Input/IMC_Default --index 0
cfa remove_key_mapping --context-path /Game/Input/IMC_Default --action-path /Game/Input/Actions/IA_Jump --key SpaceBar

Change key or action on existing mapping

Modifies an existing mapping in-place. Use to rebind a key or reassign which action a mapping triggers without removing and re-adding the entry (preserves any attached triggers/modifiers).

cfa set_key_mapping --context-path /Game/Input/IMC_Default --index 0 --key E
cfa set_key_mapping --context-path /Game/Input/IMC_Default --index 2 --action-path /Game/Input/Actions/IA_Interact

Add a trigger to a specific mapping

Adds a trigger to a specific key mapping within a context. Per-mapping triggers override the action-level triggers for that particular key binding. Use get_input_mapping_context to find the mapping_index.

cfa add_mapping_trigger --context-path /Game/Input/IMC_Default --mapping-index 0 --trigger-type Hold --properties '{"HoldTimeThreshold": 1.0}'
cfa add_mapping_trigger --context-path /Game/Input/IMC_Default --mapping-index 3 --trigger-type Pressed

Add a modifier to a specific mapping

Adds a modifier to a specific key mapping within a context. Per-mapping modifiers apply only to that key binding, useful for axis remapping (e.g., Negate on the S key for backward movement, SwizzleInputAxisValues on A/D for lateral).

cfa add_mapping_modifier --context-path /Game/Input/IMC_Default --mapping-index 1 --modifier-type Negate
cfa add_mapping_modifier --context-path /Game/Input/IMC_Default --mapping-index 2 --modifier-type SwizzleInputAxisValues --properties '{"Order":"YXZ"}'

Remove a trigger from a mapping

Removes a trigger from a specific key mapping by its zero-based trigger index. Use get_input_mapping_context to see the triggers on each mapping and identify the correct indices.

cfa remove_mapping_trigger --context-path /Game/Input/IMC_Default --mapping-index 0 --trigger-index 0

Remove a modifier from a mapping

Removes a modifier from a specific key mapping by its zero-based modifier index. Use get_input_mapping_context to see the modifiers on each mapping and identify the correct indices.

cfa remove_mapping_modifier --context-path /Game/Input/IMC_Default --mapping-index 1 --modifier-index 0

List all UInputMappingContext assets

Lists all UInputMappingContext assets under the given path. Use to discover existing mapping contexts before creating new ones or adding key mappings.

cfa list_input_mapping_contexts
cfa list_input_mapping_contexts --path /Game/Input --filter "Vehicle"

List all UInputTrigger subclasses with properties

Lists all available trigger types that can be used with add_input_action_trigger and add_mapping_trigger. Shows each trigger's configurable properties. Use filter to narrow results.

cfa list_trigger_types
cfa list_trigger_types --filter Hold

List all UInputModifier subclasses with properties

Lists all available modifier types that can be used with add_input_action_modifier and add_mapping_modifier. Shows each modifier's configurable properties. Use filter to narrow results.

cfa list_modifier_types
cfa list_modifier_types --filter Dead

List available FKey values (keyboard, mouse, gamepad)

Lists all valid FKey names that can be used in add_key_mapping. Filter by category (Keyboard, Mouse, Gamepad, Touch) or by name substring. Key names are case-sensitive and must match exactly when used in mappings.

cfa list_input_keys --filter "Mouse"
cfa list_input_keys --category Gamepad
cfa list_input_keys --filter "Thumb" --max-results 20