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. Saves the asset on success. All or nothing: an invalid value_type or any refused property fails the call and changes nothing.

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 (InputTriggerPressed for instant, InputTriggerHold for sustained press, InputTriggerTap for quick press-release, InputTriggerReleased for key-up). trigger_type is the trigger class name, with or without the U prefix; list_trigger_types lists them. Properties vary by trigger type -- e.g., InputTriggerHold has HoldTimeThreshold, InputTriggerTap has TapReleaseTimeThreshold. An unknown type or a refused property fails the call, lists the valid types, and adds nothing.

cfa add_input_action_trigger --asset-path /Game/Input/Actions/IA_Interact --trigger-type InputTriggerPressed
cfa add_input_action_trigger --asset-path /Game/Input/Actions/IA_Crouch --trigger-type InputTriggerHold --properties '{"HoldTimeThreshold": 0.5}'
cfa add_input_action_trigger --asset-path /Game/Input/Actions/IA_Dodge --trigger-type InputTriggerTap --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 (InputModifierDeadZone filters noise, InputModifierNegate inverts axes, InputModifierScalar multiplies values, InputModifierSwizzleAxis reorders axes). modifier_type is the modifier class name, with or without the U prefix; list_modifier_types lists them with their properties. An unknown type or a refused property fails the call, lists the valid types, and adds nothing.

cfa add_input_action_modifier --asset-path /Game/Input/Actions/IA_Look --modifier-type InputModifierDeadZone --properties '{"LowerThreshold": 0.1}'
cfa add_input_action_modifier --asset-path /Game/Input/Actions/IA_Look --modifier-type InputModifierNegate
cfa add_input_action_modifier --asset-path /Game/Input/Actions/IA_Move --modifier-type InputModifierScalar --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. Reports total, returned and truncated.

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 of {"type": class name, "properties": {...}}. Key names use Unreal FKey names -- use list_input_keys to discover valid key names. All or nothing: an invalid key, or any trigger or modifier entry with a missing or unknown type or a refused property, fails the call, lists every bad entry, and maps nothing.

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":"InputModifierSwizzleAxis","properties":{"Order":"YXZ"}}]'
cfa add_key_mapping --context-path /Game/Input/IMC_Default --action-path /Game/Input/Actions/IA_Shoot --key LeftMouseButton --triggers '[{"type":"InputTriggerPressed"}]'

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. An action+key pair the context does not map fails the call and lists the keys that action does have.

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. trigger_type is the trigger class name (list_trigger_types); an unknown type or a refused property fails the call and adds nothing.

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

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., InputModifierNegate on the S key for backward movement, InputModifierSwizzleAxis on A/D for lateral). modifier_type is the modifier class name (list_modifier_types); an unknown type or a refused property fails the call and adds nothing.

cfa add_mapping_modifier --context-path /Game/Input/IMC_Default --mapping-index 1 --modifier-type InputModifierNegate
cfa add_mapping_modifier --context-path /Game/Input/IMC_Default --mapping-index 2 --modifier-type InputModifierSwizzleAxis --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. Reports total, returned and truncated.

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, Analog, Digital; any other category is an error) or by name substring. Key names are case-sensitive and must match exactly when used in mappings. Reports total, returned and truncated.

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