사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/gamedev-skills/awesome-gamedev-agent-skills --skill unreal-enhanced-input시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Unreal Enhanced Input
Wire UE5 player input with data assets: Input Actions say what the player wants, Mapping Contexts say which keys produce it, modifiers shape the value and triggers decide when it fires. Targets UE 5.8, where Enhanced Input is the default and legacy axis/action mappings are deprecated.
When to use
- Adding or fixing movement, look, jump or fire input; creating
IA_/IMC_assets; applying
modifiers and triggers; adding or swapping mapping contexts at runtime.
- Binding actions in C++ (
UEnhancedInputComponent::BindAction) or Blueprint event nodes. - Building a key-rebinding menu with Enhanced Input User Settings.
When not to use:* engine-neutral input architecture, buffering and rebinding policy → input-systems. The Pawn or Character class and module setup → unreal-cpp-gameplay. Coyote time and jump buffering → platformer.
Workflow
- Read the project. Check
EngineAssociation, find existingIA_*/IMC_*assets, and
grep -rn "AddMappingContext\|BindAction\|InputComponent" Source to see where input is already set up. Extend that path rather than adding a second one. C++ binding needs "EnhancedInput" in the module's *.Build.cs.
- One Input Action per intent with the right Value Type:
Digital (bool)for buttons,
Axis1D (float) for triggers or throttle, Axis2D (Vector2D) for move and look.
- Map keys in an IMC. For WASD into one Axis2D action: W plain, S with Negate, D plain,
A with Negate, and Swizzle Input Axis Values on W and S so they drive Y. Add Dead Zone on sticks. Triggers (Pressed, Released, Hold, Tap) go on the action or on one mapping.
- Add the context for the local player through `UEnhancedInputLocalPlayerSubsystem::
AddMappingContext(IMC, Priority) at a point where the pawn is possessed on the owning client: PawnClientRestart` on the pawn, or the PlayerController.
- Bind by trigger event.
Triggeredfor continuous values (move, look),Startedand
Completed for press and release (jump). Read the value with the Get<T>() that matches the Value Type.
- Remapping: enable User Settings and give each remappable mapping a Player Mappable Key
Settings name; details in the reference.
- Check it (see Verify).
Patterns
Add the context and bind (C++ Character)
void AMyCharacter::PawnClientRestart()
{
Super::PawnClientRestart(); // runs on the owning client after possession
if (APlayerController* PC = Cast<APlayerController>(GetController()))
if (ULocalPlayer* LP = PC->GetLocalPlayer())
if (auto* Subsystem = LP->GetSubsystem<UEnhancedInputLocalPlayerSubsystem>())
Subsystem->AddMappingContext(DefaultMappingContext, /*Priority*/ 0);
}
void AMyCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
Super::SetupPlayerInputComponent(PlayerInputComponent);
// Don't name the parameter InputComponent: that shadows AActor::InputComponent.
if (auto* EIC = Cast<UEnhancedInputComponent>(PlayerInputComponent))
{
EIC->BindAction(MoveAction, ETriggerEvent::Triggered, this, &AMyCharacter::Move);
EIC->BindAction(JumpAction, ETriggerEvent::Started, this, &ACharacter::Jump);
EIC->BindAction(JumpAction, ETriggerEvent::Completed, this, &ACharacter::StopJumping);
}
}
void AMyCharacter::Move(const FInputActionValue& Value)
{
const FVector2D Axis = Value.Get<FVector2D>(); // IA_Move is Axis2D
AddMovementInput(GetActorForwardVector(), Axis.Y);
AddMovementInput(GetActorRightVector(), Axis.X);
}Blueprint equivalent
Event Possessed (or the PlayerController's BeginPlay)
-> Get Controller -> Cast To PlayerController -> Get Local Player
-> Enhanced Input Local Player Subsystem -> Add Mapping Context (IMC_Default, 0)
EnhancedInputAction IA_Move (Triggered) -> Action Value X/Y -> Add Movement InputVerify
Say which of these you ran.
- Compile the module (
Build.bat/Build.shas inunreal-cpp-gameplay) and fix errors;
a missing EnhancedInput dependency shows up here as unresolved symbols.
- Validate assets:
UnrealEditor-Cmd <Project>.uproject -run=DataValidation -unattended. - Regression test (optional but cheap once written): a functional test in a test map can
inject an action with the subsystem's input injection functions (for example InjectInputForAction) and assert the pawn moved. Run it with UnrealEditor-Cmd <Project>.uproject -ExecCmds="Automation RunTest Project.Functional Tests;Quit" -unattended -nullrhi -ReportExportPath="<dir>" (swap -nullrhi for -RenderOffscreen if the map needs a renderer).
- Ask the user to start PIE, open the console, run
showdebug enhancedinput, press the
keys in question and report which contexts are active, their priorities and the action values. Input.+key <Key> injects a key press from the console when no device is handy. For multiplayer bugs, ask them to repeat it on a client window.
Gotchas
- No input at all: the context was never added, it was added before the pawn had a local
player, or a UI-only input mode is set (SetInputMode with UI only).
- Works in single player, dead on a client or after respawn: the context was added in
BeginPlay before possession, so GetController() was null. Add it in PawnClientRestart or the PlayerController.
- `Get<FVector2D>()` is always zero: the action's Value Type isn't Axis2D.
- Fires every frame:
Triggeredrepeats while held with the default Down trigger; use
Started/Completed, or a Pressed or Tap trigger.
- A key works in one mode and not another: a higher-priority context maps the same key and
consumes it. Adjust priorities or RemoveMappingContext when leaving the mode.
- Combo trigger corrupts or misfires: it is deprecated in 5.8 as unreliable. Build combos
with your own sequence logic on Started events.
- Boolean action bound to touch stays true after release (before 5.8): touch keys carry
the screen position as their value, and older versions evaluated that instead of the pressed state. 5.8 fixed it; on older engines bind touch to Started/Completed.
- Rebinding edits the IMC asset: that changes the default for everyone and isn't saved per
player. Use User Settings (see the reference).
References
- Read
references/cpp-setup.mdfor a complete third-person Character (header, source,
Build.cs, the IMC asset checklist) and the runtime rebinding steps with UEnhancedInputUserSettings.
- Epic docs: Enhanced Input,
Related skills
input-systems: engine-neutral input design and rebinding policy.unreal-cpp-gameplay: the Character, PlayerController and module setup.game-ui-uxwithunreal-blueprints: menus that use these actions.
Version notes
Last verified: 2026-11-11.
- Current release: UE 5.8 (5.8.4 hotfix, October 2026); UE 5.9 is in Preview.
- 5.8: Common UI and Enhanced Input are unified (no duplicate input data assets) with a new
Input Debugger; the Combo trigger is deprecated; boolean actions on touch keys now follow the pressed state; triggers and modifiers keep their state when mappings are rebuilt.
- Sources: UE 5.8 release notes,