JoyPro2 Discord GitHub
게임

WARDOGS

표시:

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단계로 바로 사용하기

  1. 모두 알아서 설정
    시작 페이지에서
  2. 이 버튼 사용
    먼저 목록을 확인
  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 바인딩 가져오기

  1. 시작을 여세요. WARDOGS 카드에서 명령 목록을 요청하면 목록 생성을 누르세요. JoyPro가 내 설정 파일과 자체 축 표로 목록을 만듭니다.
  2. WARDOGS 카드에서 가져오기를 누르세요. **내 프로필에 추가 (권장)**를 그대로 두세요.
  3. 지금 가져오기를 누르세요. 내 관계 보기를 누르면 들어온 내용이 열립니다.
게임이 표시된 시작 페이지게임이 표시된 시작 페이지
게임이 표시된 시작 페이지 (그림은 영어로 된 앱을 보여 줍니다.)

#관계 만들기와 확인

관계 페이지에서 WARDOGS 동작을 다른 게임의 같은 기능과 연결하세요. 관계 흐름을 참고하세요. 그런 다음 내보내기 페이지에서 확인을 실행하세요. 게임보다 먼저, WARDOGS에서 버튼 하나가 두 가지 일을 하는 경우를 찾아 줍니다.

#WARDOGS로 내보내기

  1. WARDOGS를 닫으세요. 게임은 종료할 때 설정 파일 전체를 다시 쓰기 때문에, 실행 중에는 JoyPro가 써넣기를 거부합니다.
  2. 내보내기를 열고 WARDOGS 카드를 체크하세요.
  3. JoyPro에서 스틱을 설정한다면 내 장치에서 교체와 다른 장치도 지우기를 그대로 두세요. 카드의 지금 내보내기를 누르세요.
내보내기 페이지내보내기 페이지
내보내기 페이지
게임에서: WARDOGS에서 보이는 것

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
JoyPro는 GameUserSettings.ini의 조이스틱 섹션(축 6개와 비행 동작)을 쓰고, 바인딩을 쓸 때 Enable HOTAS를 켜며, 이름과 그룹은 .joypro-meta.json에 보관합니다.

코드: 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.