WARDOGS는 Unreal Engine 5 기반의 헬리콥터 전투 게임입니다. 자체 조이스틱 플러그인이 모든 DirectInput 장치를 읽고, 바인딩을 설정 파일 하나에 저장합니다. 여기에는 비행 축 6개와 비행 동작이 각각 해당 장치와 함께 들어 있습니다. JoyPro는 이 부분을 프로필로 읽어 오고, HOTAS 페이지의 감도, 데드존, Enable HOTAS 스위치와 함께 다시 써넣습니다. 키보드, 마우스, 파일의 다른 모든 부분은 그대로 둡니다.
WARDOGS 기본(게임 자체 바인딩 파일)
- 지원
- 기본(게임 자체 바인딩 파일)
- 엔진 명령
engine wardogs- 바인딩 파일
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini(Unreal ini, 해시된 필드 이름)- 명령 목록 출처
- 내
GameUserSettings.ini+ JoyPro의 축 - 게임 내 테스트
- 36/36 단계 통과(2026-10-11)
- ✓ 가져오기
- ✓ 내보내기
- ✗ 키보드 바인딩
- ✗ 수정키
- ✓ PC에서 만든 명령 목록
- ✓ 게임 감시
- ✓ 축 곡선과 데드존
- ✓ 게임 조작 설정
- ✗ 게임 내 포스 피드백 설정
- ✗ 텔레메트리 기반 포스 피드백
- ✗ 텔레메트리 기록
- ✓ 가상 조이스틱 (vJoy)
- ◐ 가상 Xbox 패드
- ✓ 가상 기능
- ✓ 설정 마법사 / 자동 할당
- ✓ 조종석
- ✓ 치트 시트
- ✓ 게임 내 테스트
엔진 코드에서 생성된 지원 매트릭스 기준: 모든 게임.
#3단계로 바로 사용하기
- 모두 알아서 설정
시작 페이지에서 - 이 버튼 사용
먼저 목록을 확인 - 내 게임에 쓰기
WARDOGS는 닫아 두세요
시작 전: 게임에서 Settings > GAMEPAD > HOTAS를 한 번 연 다음 게임을 닫으세요.
그다음: Enable HOTAS가 켜져 있고, 바인딩이 HOTAS 페이지에 있습니다.
전에 WARDOGS에서 버튼을 바인딩했나요? 그렇다면 시작 페이지에서 가져온 후 빈 곳 채우기를 제안합니다. 기존 바인딩은 그대로 두고, 비어 있는 버튼에만 새 기능을 줍니다. 빠른 시작: 내 스틱 작동시키기를 참고하세요.
#JoyPro가 WARDOGS에 해 주는 일
- 가져오기: HOTAS 페이지의 바인딩이 프로필에 들어옵니다. Pitch, Roll, Yaw, 콜렉티브(Throttle), 시점 축 두 개, 비행 동작(Fire, Flares, Reload, Horn, Ping ...)이 각각의 장치에서 반전, 감도, 데드존과 함께 들어옵니다.
- 관계: 관계 하나로 WARDOGS와 다른 게임을 동시에 다룰 수 있습니다. 예를 들어 WARDOGS와 DCS 헬리콥터에서 "Collective"를 스로틀 레버에 둘 수 있습니다.
- 내보내기: JoyPro가 헬리콥터 바인딩을 게임의 설정 파일에 써넣고 Enable HOTAS를 켜서 게임이 바인딩을 사용하게 합니다.
#WARDOGS 바인딩 가져오기
- 시작을 여세요. WARDOGS 카드에서 명령 목록을 요청하면 목록 생성을 누르세요. JoyPro가 내 설정 파일과 자체 축 표로 목록을 만듭니다.
- WARDOGS 카드에서 가져오기를 누르세요. **내 프로필에 추가 (권장)**를 그대로 두세요.
- 지금 가져오기를 누르세요. 내 관계 보기를 누르면 들어온 내용이 열립니다.


#관계 만들기와 확인
관계 페이지에서 WARDOGS 동작을 다른 게임의 같은 기능과 연결하세요. 관계 흐름을 참고하세요. 그런 다음 내보내기 페이지에서 확인을 실행하세요. 게임보다 먼저, WARDOGS에서 버튼 하나가 두 가지 일을 하는 경우를 찾아 줍니다.
#WARDOGS로 내보내기
- WARDOGS를 닫으세요. 게임은 종료할 때 설정 파일 전체를 다시 쓰기 때문에, 실행 중에는 JoyPro가 써넣기를 거부합니다.
- 내보내기를 열고 WARDOGS 카드를 체크하세요.
- JoyPro에서 스틱을 설정한다면 내 장치에서 교체와 다른 장치도 지우기를 그대로 두세요. 카드의 지금 내보내기를 누르세요.


WARDOGS를 시작하고 Settings > GAMEPAD > HOTAS를 여세요. Enable HOTAS가 켜져 있고, 각 축 줄에는 장치와 축, 반전 상자, Sensitivity 및 Deadzone 슬라이더가 표시되며, 동작에는 버튼이 표시됩니다. 메뉴는 동작 버튼은 0부터, 축 절반 버튼은 1부터 세기 때문에 같은 버튼이 서로 다른 두 번호로 표시될 수 있습니다.
#WARDOGS에서 직접 할 일
- HOTAS 페이지를 한 번 여세요. 처음 내보내기 전에 해야 합니다. JoyPro는 게임의 조이스틱 부분에만 써넣는데, 파일에 아직 그 부분이 없으면 내보내기가 멈추고 게임에서 그 페이지를 열라고 안내합니다.
- Enable HOTAS가 켜져 있는 동안은 마우스와 키보드 비행이 꺼집니다. JoyPro는 바인딩을 써넣을 때마다 이 스위치를 켭니다. 직접 관리하고 싶다면 설정 > 게임의 포스 피드백 설정(게임 WARDOGS)에서 정하세요. 거기에 저장한 값이 내보낼 때마다 써넣어집니다.
- "Garage / Vendor"와 "Free Look Reset"은 아직 JoyPro 목록에 없습니다. 게임에서 한 번 바인딩한 다음 WARDOGS 카드에서 업데이트를 누르세요. JoyPro가 파일에서 찾은 동작을 추가합니다.
#자주 하는 실수
- "WARDOGS 실행 중입니다": 게임을 닫고 다시 내보내세요.
- 게임에 장치가 NOT CONNECTED로 표시됨: 게임은 VID:PID와 DirectInput 이름으로 장치를 구분합니다. 장치를 연결한 상태로 다시 내보내세요. JoyPro가 같은 VID:PID를 가진 연결된 장치와 다른 이름을 바로잡습니다.
- 똑같은 장치 두 개: WARDOGS는 둘을 구분하지 못합니다(같은 이름을 받습니다). 가상 조이스틱을 사용하거나, WARDOGS 바인딩에는 둘 중 하나만 쓰세요.
- 비행 중에 바인딩이 작동하지 않음: HOTAS 페이지에서 Enable HOTAS를 확인하세요. 꺼져 있으면 게임이 모든 조이스틱 바인딩을 무시합니다.
#JoyPro가 읽고 쓰는 파일
| 파일 | 설명 |
|---|---|
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini |
[/Script/WDJoystick.WDJoystickSettings] 섹션의 바인딩, [/Script/WDGame.WDUserSettings]에 있는 게임 전체 스위치 Enable HOTAS(bUseHOTASHelicopters)와 Self-Centering Collective(bCollectiveSelfCentering) |
...\GameUserSettings.ini.joypro-meta.json |
내보낸 바인딩에 대한 JoyPro의 데이터(관계 이름, 그룹, 튜닝), 다음 가져오기 때 다시 읽음 |
...\GameUserSettings.ini.jpbak |
처음 쓰기 전의 백업(JoyPro의 백업 저장소에도 보관) |
같은 파일과 Saved\SaveGames\EnhancedInputUserSettings.sav의 키보드 바인딩은 읽거나 쓰지 않습니다. JoyPro는 설치 폴더에서 아무것도 읽지 않습니다. 사용자의 설정 파일이 명령 목록의 출처입니다.
#WARDOGS의 내보내기 모드
게임은 동작마다 바인딩 하나를 씁니다. 모든 모드는 JoyPro 카탈로그에 있는 헬기 동작에만 작용하며, 파일의 다른 줄과 섹션은 바뀌지 않습니다.
| 모드 | 일어나는 일 |
|---|---|
| 추가만 | 바인딩은 동작의 슬롯이 비어 있고 카탈로그의 다른 동작이 그 버튼이나 축을 쓰지 않을 때만 들어갑니다. 그렇지 않으면 건너뛰고 "게임에 기록되지 않음"으로 표시합니다. 바인딩된 슬롯은 교체하지 않습니다. |
| 업데이트, 게임의 바인딩 유지 | 사용자의 바인딩이 동작의 슬롯을 차지합니다(그곳의 입력을 교체). 같은 입력에 있는 카탈로그의 다른 동작은 그 입력을 잃습니다. 동작의 두 번째 줄은 유지됩니다. |
| 업데이트, 내 프로필 우선 | 위와 같고, 추가로 동작의 여분 줄이 지워지므로 옮긴 동작이 완전히 옮겨집니다. |
| 내 장치에서 교체 | 쓰는 장치에는 카탈로그 동작에 대한 사용자의 바인딩만 남습니다. |
| + 다른 장치도 지우기 | 프로필에 바인딩이 없는 연결된 장치는 카탈로그 동작의 바인딩을 잃습니다. |
WARDOGS 바인딩이 없는 프로필을 내보내면 저장해 둔 게임 전체 설정만 씁니다.
#절대 건드리지 않는 것
- 키보드와 마우스 바인딩, 키보드 저장 파일, 조이스틱 섹션 밖의 모든 섹션(게임 전체 스위치 두 개 제외).
- JoyPro 카탈로그에 없는 동작: 그 줄은 그대로 유지됩니다.
- 연결되지 않은 장치, 가져오기에서 무시한 장치, JoyPro가 입력을 보내는 vJoy 장치.
- 바인딩 줄의 알 수 없는 필드: 그대로 유지됩니다.
#축, 감도, 데드존
- 전역: WARDOGS에는 기체나 차량 프로필이 없습니다. 바인딩은 모든 헬기에 적용됩니다.
- 축마다: 반전, Sensitivity(0.1~2.0, 1 = 변화 없음), 데드존(0~0.5). HOTAS 페이지 자체 단위로, 소수점 둘째 자리까지 반올림합니다. 가져오기는 이를 관계의 WARDOGS 튜닝으로 보관하므로 다른 게임은 각자의 곡선을 유지합니다.
- WARDOGS 값이 없으면 JoyPro가 기본 곡선에서 값을 맞춰 정합니다. 데드존은 그대로 옮기고, 감도는 포화점까지의 기울기를 따릅니다. 슬라이더의 데드존은 옮기지 않습니다. WARDOGS가 콜렉티브를 중앙 축으로 다루기 때문입니다. 곡률과 사용자 곡선은 표현할 수 없으며, 내보내기가 경고합니다.
- 게임에는 미리보기가 없고 공식도 알려져 있지 않습니다. JoyPro의 미리보기는 반전, 재조정된 데드존, 그다음 감도 곱하기, 최대 편향에서 잘림을 가정합니다(아직 확인되지 않음).
- 게임 설정: Enable HOTAS와 Self-Centering Collective(스틱 두 개 구성용: 손을 떼면 콜렉티브가 호버로 돌아감. 스로틀 레버에서는 끄세요)는 설정 > 게임의 포스 피드백 설정에 있습니다. 파일에 이미 키가 있을 때만 기록됩니다. WARDOGS에는 포스 피드백이 없습니다.
- 감시 기능: HOTAS 페이지에서 바꾼 바인딩은 게임이 종료된 뒤 감지되며, JoyPro가 받아들일지 묻습니다(감시 기능).
- HUD: WARDOGS가 실행 중일 때 HUD가 누른 버튼마다 동작 이름을 보여 줍니다.
#WARDOGS 연동의 내부
flowchart LR P["내 프로필"] --> E["engine wardogs export"] E --> S["GameUserSettings.ini"] E --> H["Enable HOTAS 켜기"] E --> M[".joypro-meta.json"] S --> G["Settings > GAMEPAD<br/>> HOTAS"] H --> G
코드: engine\Games\WardogsIntegration.cs, engine\AxisModels\Wardogs.cs(축 모델 wardogs), engine\FfbModels\Wardogs.cs(게임 전체 스위치 두 개).
- 파일: ASCII, CRLF, BOM 없음, 첫 줄
;METADATA=(Diff=true, UseCommands=true). 축 줄은 항상 여섯 개 모두, Pitch, Throttle, Roll, Yaw, LookPitch, LookYaw 순서입니다.ActionBindings=(Action=<action>,Binding=(...))는 바인딩된 동작마다 한 번이며, 새 줄은 마지막 줄 뒤에 붙습니다. 축은DeviceIdentifier=""로, 동작은 그 줄을 지워서 바인딩을 해제합니다. 실수는 소수점 여섯 자리입니다. 이름은 ASCII로 유지합니다(ASCII가 아닌 이름이 있으면 엔진이 UTF-16으로 저장함). - 필드 이름: 대부분의 필드는 해시된 토큰(
_aaaa...)입니다. JoyPro는 이를 하드코딩하지 않고, 읽을 수 있는 기준점(DeviceIdentifier,bInvert,Positive,Sensitivity,DeadZone) 옆의 위치로 각 필드를 찾으며, 구조가 바뀌면 멈춥니다. - 장치:
DeviceIdentifier="VID:PID:<DirectInput instance name>". VID와 PID는 DirectInput 제품 GUID에서 오고, 이름은 DirectInput이 보고하는 그대로이며 양 끝의 공백도 포함합니다(잘라내지 않음). 축 번호는 DIJOYSTATE2 슬롯(0 X, 1 Y, 2 Z, 3 Rx, 4 Ry, 5 Rz, 6/7 슬라이더)이고, 버튼은 0부터 셉니다. - 명령 목록:
engine wardogs refresh-db가 사용자의 설정 파일과 JoyPro의 축으로 만듭니다.engine wardogs catalog는 목록을 보여 주고,engine wardogs paths는 JoyPro가 찾는 위치를 보여 줍니다. - 가져오기 / 내보내기:
engine wardogs scan,engine wardogs import,engine wardogs export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run. - 게임 설정:
engine ffb set--device * --game Wardogs --param enableHotas=true(또는selfCenteringCollective).
#알려진 한계
- 전체 동작 목록은 알려져 있지 않습니다. JoyPro는 실제 파일에서 본 동작을 나열합니다.
- 동작으로서의 햇 방향: 인코딩이 아직 확인되지 않았습니다.
- Sensitivity와 데드존의 응답 공식은 알려져 있지 않습니다.
- 똑같은 장치는 같은 식별자를 받아 서로 충돌합니다.
- 테스트:
engine\tests\smoke\wardogs.ps1; 게임 안에서tools\e2e\games\Wardogs.ps1(바인딩),WardogsSettings.ps1(HOTAS 페이지 값),Watchdog.ps1(감시 기능).
이 게임에 대한 모든 기술 메모(저장소에서 생성됨): wardogs.md.