JoyPro2 Discord GitHub
게임

X4: Foundations

표시:

X4: Foundations는 바인딩을 inputmap.xml에 저장하고, 조이스틱을 이름이 아니라 슬롯(1~8)으로 구분합니다. 어떤 장치가 어떤 슬롯에 있는지는 config.xml에 있습니다. JoyPro는 우주 비행 바인딩을 프로필로 읽어 오고, X4가 장치에 고정해 둔 슬롯에 제자리로 다시 써넣습니다. X4에서는 반전과 데드존이 게임 전체에 적용되므로, JoyPro는 관계를 바탕으로 게임 전체에 대해 이 값들을 설정합니다.

X4: Foundations 기본(게임 자체 바인딩 파일)
지원
기본(게임 자체 바인딩 파일)
엔진 명령
engine x4
바인딩 파일
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + config.xml의 슬롯
게임이 읽는 입력
조이스틱 하나당 버튼 64개, 축 8개, 햇 1개를 읽음(검증됨)
명령 목록 출처
X4.exe의 이름 표와 .cat/.dat 아카이브
게임 내 테스트
36/36 단계 통과(2026-10-11)
  • ✓ 가져오기
  • ✓ 내보내기
  • ✓ 키보드 바인딩
  • ◐ 수정키X4: 키보드 바인딩에는 Shift/Ctrl을 쓸 수 있고, 조이스틱 바인딩에는 수정키를 쓸 수 없습니다.
  • ✓ PC에서 만든 명령 목록
  • ✓ 게임 감시
  • ✗ 축 곡선과 데드존X4: 게임 전체 데드존과 반전만 가능(Game settings)하며, 바인딩별 설정은 없습니다.
  • ✓ 게임 조작 설정
  • ✗ 게임 내 포스 피드백 설정
  • ✗ 텔레메트리 기반 포스 피드백
  • ✗ 텔레메트리 기록
  • ✓ 가상 조이스틱 (vJoy)
  • ◐ 가상 Xbox 패드
  • ✓ 가상 기능
  • ✓ 설정 마법사 / 자동 할당
  • ✓ 조종석
  • ✓ 치트 시트
  • ✓ 게임 내 테스트
X Rebirth 문서로만 정리됨
지원
문서로만 정리됨
엔진 명령
없음
  • — 가져오기
  • — 내보내기
  • — 키보드 바인딩
  • — 수정키
  • — PC에서 만든 명령 목록
  • — 게임 감시
  • — 축 곡선과 데드존
  • — 게임 조작 설정
  • — 게임 내 포스 피드백 설정
  • — 텔레메트리 기반 포스 피드백
  • — 텔레메트리 기록
  • — 가상 조이스틱 (vJoy)
  • — 가상 Xbox 패드
  • — 가상 기능
  • — 설정 마법사 / 자동 할당
  • — 조종석
  • — 치트 시트
  • — 게임 내 테스트
X3 (Reunion, Terran Conflict, Albion Prelude) 문서로만 정리됨
지원
문서로만 정리됨
엔진 명령
없음
  • — 가져오기
  • — 내보내기
  • — 키보드 바인딩
  • — 수정키
  • — PC에서 만든 명령 목록
  • — 게임 감시
  • — 축 곡선과 데드존
  • — 게임 조작 설정
  • — 게임 내 포스 피드백 설정
  • — 텔레메트리 기반 포스 피드백
  • — 텔레메트리 기록
  • — 가상 조이스틱 (vJoy)
  • — 가상 Xbox 패드
  • — 가상 기능
  • — 설정 마법사 / 자동 할당
  • — 조종석
  • — 치트 시트
  • — 게임 내 테스트

엔진 코드에서 생성된 지원 매트릭스 기준: 모든 게임.

초보자용

#3단계로 바로 사용하기

  1. 모두 알아서 설정
    시작 페이지에서
  2. 이 버튼 사용
    먼저 목록을 확인
  3. 내 게임에 쓰기
    X4는 닫아 두세요

시작 전: 모든 장치에 한 번 슬롯을 지정하세요. X4의 조작 설정에서 Manage Controllers/Joysticks를 여세요. 장치마다 슬롯을 지정한 다음 게임을 정상적으로 종료하세요.

그다음: 바인딩이 Settings > Controls에 있습니다.

전에 X4에서 버튼을 바인딩했나요? 그렇다면 시작 페이지에서 가져온 후 빈 곳 채우기를 제안합니다. 기존 바인딩은 그대로 두고, 비어 있는 버튼에만 새 기능을 줍니다. 빠른 시작: 내 스틱 작동시키기를 참고하세요.

#JoyPro가 X4에 해 주는 일

  • 가져오기: 스틱, 스로틀, 페달의 우주 비행 바인딩이 게임의 반전 및 스로틀 모드와 함께 프로필에 들어옵니다.
  • 관계: 관계 하나는 모든 게임에서 하나의 기능입니다. "Boost"를 X4, Elite Dangerous, Star Citizen에서 같은 버튼으로 만들 수 있습니다.
  • 내보내기: JoyPro가 inputmap.xml을 장치의 슬롯에 맞춰 제자리에서 수정합니다. 메뉴, 1인칭, 키보드, 마우스 바인딩은 그대로 남습니다.

#X4 바인딩 가져오기

  1. 시작을 여세요. X4 카드에서 명령 목록을 요청하면 목록 생성을 누르세요. JoyPro가 설치 파일에서 게임의 조작 항목을 읽어 옵니다(읽기 전용).
  2. X4 카드에서 가져오기를 누르세요. 내 프로필에 추가를 그대로 두세요. 비행 키도 JoyPro에 넣고 싶다면 키보드 키도 가져오기를 체크하세요.
  3. 지금 가져오기를 누르세요. 내 관계 보기를 누르면 들어온 내용이 열립니다.

#관계 만들기와 확인

관계 흐름으로 여러 게임의 같은 기능을 연결한 다음, 내보내기 페이지에서 확인을 누르세요. 조이스틱 바인딩에는 수정키를 쓰지 마세요. X4는 조이스틱 바인딩에 수정키를 받지 않습니다.

#X4로 내보내기

  1. X4를 닫으세요. 게임은 세션이 끝날 때 inputmap.xml과 config.xml을 쓰기 때문에, 실행 중에는 JoyPro가 써넣기를 거부합니다.
  2. 내보내기를 열고 X4 카드를 체크하세요.
  3. JoyPro에서 스틱을 설정한다면 내 장치에서 교체와 다른 장치도 지우기를 그대로 두세요. 카드의 지금 내보내기를 누르세요.
게임에서: X4에서 보이는 것

게임을 시작하고 Settings > Controls를 여세요. 바인딩은 각 우주 비행 조작의 컨트롤러/조이스틱 열에서 장치의 슬롯에 있습니다. Invert Controller / Joystick Axes에는 JoyPro가 설정한 반전이 표시되고, 양방향 스로틀, 조이스틱 데드존, 적응형 조향 항목에는 설정값이 표시됩니다. 자동 롤과 진동은 게임 설정에 있습니다.

#X4에서 직접 할 일

  • 모든 장치에 한 번 슬롯을 지정하세요. X4의 조작 설정에서 Manage Controllers/Joysticks를 열고 스틱, 스로틀, 페달마다 슬롯을 지정한 뒤 게임을 정상적으로 종료하세요. 그러면 X4가 그 장치를 config.xml에 기억합니다. 이 항목이 없는 장치는 세션마다 슬롯이 바뀌기 때문에 JoyPro가 건너뜁니다("assign the device to a slot in X4 once"). 거기서 "none"으로 설정한 장치도 건너뜁니다.
  • 내보내기 전에 장치를 연결하세요.

#자주 하는 실수

  • "X4 실행 중입니다": 게임을 종료하고 다시 내보내세요.
  • 장치가 건너뛰어짐: X4에서 슬롯에 고정되지 않은 장치입니다. Manage Controllers/Joysticks에서 지정하세요.
  • 슬롯 1의 스틱이 게임패드 동작을 함: 슬롯 1은 X4 기본 맵의 게임패드 슬롯이라서, 거기 있는 스틱은 기본 게임패드 바인딩을 물려받습니다. 내 장치에서 교체가 이를 제거합니다.
  • 64번보다 높은 버튼이나 두 번째 햇이 작동하지 않음: X4는 장치당 버튼 64개, 축 8개, 햇 1개를 읽습니다. JoyPro는 이를 넘는 바인딩을 경고와 함께 건너뜁니다.
  • 반전이 그대로 남음: 반전 하나는 그 조작에 있는 모든 장치에 적용됩니다. 관계끼리 설정이 다르거나 같은 조작에 게임패드가 바인딩되어 있으면, JoyPro는 게임의 값을 그대로 두고 경고합니다.
고급

#JoyPro가 읽고 쓰는 파일

파일 설명
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml 활성 바인딩(조종과 입력마다 <action>, <state>, <range>)과 <config> 매개변수(반전, 데드존, 양방향 스로틀, 적응형 조향). <id>는 Steam 계정의 폴더입니다.
...\X4\<id>\config.xml 장치 슬롯(<joysticks>)과 진동, 자동 롤, 게임패드 모드 같은 게임 설정. 슬롯은 읽기만 하고, 설정은 그 자리에서 편집함
...\X4\<id>\inputmap.xml.joypro-meta.json 쓴 바인딩에 대한 JoyPro의 이름, 그룹, 튜닝. 다음 가져오기에서 다시 읽습니다
inputmap.xml.jpbak, config.xml.jpbak 처음 쓰기 전의 사본, 그리고 JoyPro의 버전별 백업 저장소

파일은 텍스트로 씁니다: 선언, 줄 끝, 들여쓰기, 섹션 주석, <config>, 루트 속성, 건드리지 않은 모든 줄이 바이트 단위로 그대로 유지됩니다. 새 줄은 해당 섹션에서 조종 번호가 더 낮은 같은 종류의 마지막 항목 뒤에 들어갑니다. JoyPro는 저장된 프로필 inputmap_1.xml~inputmap_5.xml이나 세이브 파일을 건드리지 않습니다. Steam Cloud가 폴더를 동기화하지만, 어떤 파일을 동기화하는지는 아직 확인되지 않았습니다.

#X4의 내보내기 모드

충돌이란 같은 슬롯과 입력에 있는 다른 비행 조종을 말합니다. 조종의 지도용과 상세 모니터용 쌍둥이는 같은 조종으로 봅니다.

모드 inputmap.xml에서 일어나는 일
추가만 아무것도 지우지 않습니다. 다른 비행 조종이 가진 입력에 대한 바인딩은 쓰지 않고 "게임에 기록되지 않음" 표시가 붙습니다.
업데이트, 게임의 바인딩 유지 사용자의 줄은 그 조종의 다른 입력 옆에 들어갑니다. 충돌만 지워집니다.
업데이트, 내 프로필 우선 위와 같고, 추가로 바인딩한 조종은 연결된 장치의 고정된 슬롯에서 다른 줄을 잃습니다(키보드 옵션을 켜면 키보드 줄도).
내 장치에서 교체 쓰는 슬롯에서 프로필에 없는 비행 바인딩이 지워지며, 슬롯 1의 기본 게임패드 비행 바인딩도 지워집니다.
+ 다른 장치도 지우기 config.xml이 내보내기에 쓰이지 않는 연결된 장치에 고정한 슬롯도 마찬가지입니다. 고정된 장치가 없는 슬롯은 그대로 둡니다. 그 장치가 무엇인지 알 수 없기 때문입니다.

X4 메뉴는 일부 조종을 함께 바인딩합니다: "Toggle Travel Mode"는 지도 안에서도 같은 입력을 설정하고, "Dock"은 도킹 해제도 합니다. JoyPro는 그런 그룹을 메뉴와 똑같이 쓰고 지우며, 1인칭 "Interact" 쌍둥이는 절대 지우지 않습니다.

#절대 건드리지 않는 것

  • 메뉴, 지도, 1인칭, 옵션, 접근성 조종과 원형 메뉴 항목.
  • 키보드와 마우스 줄. 키보드는 키보드 옵션을 켰을 때만, 비행 조종에 대해서만 쓰며, X4 메뉴가 거부하는 키(Escape, Delete, Ctrl+X/C/V ...)는 절대 쓰지 않습니다.
  • 연결되지 않았거나 고정되지 않은 장치의 슬롯, 게임패드, 가져오기에서 무시한 장치, JoyPro가 터널링하는 vJoy 장치.
  • JoyPro가 설정하지 않는 모든 <config> 줄.

#곡선과 게임 설정

  • 적용 범위: 모든 함선에 바인딩 한 세트(우주 비행 조종)를 씁니다.
  • 반전은 조종마다 모든 장치에 공통인 값 하나입니다(invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). 관계는 DCS의 방향을 유지합니다. X4 자체 HOTAS 맵은 피치, 롤, 스로틀을 반전된 것으로 보므로, JoyPro는 이 축들에 대해 사용자의 반전을 뒤집은 값으로 매개변수를 설정합니다. 매개변수는 그 조종의 모든 JoyPro 축이 일치할 때만 설정합니다.
  • 양방향 스로틀은 스로틀 관계의 슬라이더를 따릅니다: 슬라이더 = 전진만, 슬라이더 아님 = 가운데가 추력 0.
  • 데드존: X4에는 모든 조이스틱의 모든 축에 공통인 데드존이 하나 있습니다. 관계의 데드존은 쓰지 않습니다(내보내기가 알려 줌). 게임의 데드존은 설정 > 게임의 포스 피드백 설정(X4 선택) 또는 engine ffb set으로 설정하세요. 같은 곳에 적응형 조향, 진동, 자동 롤, 게임패드 모드도 있습니다. 그곳에 저장한 설정이 관계보다 우선하며, 관계와 반대가 되면 경고가 표시됩니다.
  • X4에는 축별 곡선이나 포화가 없습니다. 포스 피드백과 텔레메트리도 없습니다.
  • 감시 기능: 게임에서 바꾼 바인딩이나 옵션은 게임이 종료된 뒤 감지되며(inputmap.xml과 config.xml), JoyPro가 받아들일지 묻습니다.
  • HUD: HUD는 프로세스로 게임을 찾아 X4 바인딩을 보여 줍니다.

#X Rebirth와 X3

X Rebirth는 X4와 같은 inputmap.xml 용어를 쓰지만, 명령 목록은 설치본에서 따로 추출해야 합니다. X3(Reunion, Terran Conflict, Albion Prelude)는 엔진이 다르고 파일 형식도 알려져 있지 않습니다. 두 게임 모두 문서만 있으며, JoyPro는 가져오거나 내보내지 않습니다.

기술 정보

#X4 연동의 내부

flowchart LR
  D["사용자의 장치<br/>(인스턴스 GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["슬롯에 고정됨:<br/>슬롯 1 ... 8"]
  C --> K["고정되지 않음 또는 비활성:<br/>건너뜀, X4에서<br/>한 번 할당하세요"]
  P["내 프로필"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>슬롯별 바인딩"]
  E --> O["게임 전체 옵션:<br/>반전, 스로틀 모드"]
X4는 조이스틱을 슬롯으로 부릅니다. 고정된 슬롯이 없는 장치는 건너뜁니다.

코드: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs, 설정 모델 engine\FfbModels\X4.cs.

  • 슬롯: 바인딩은 소스를 지정합니다: INPUT_SOURCE_JOYBUTTONS(버튼과 햇) 또는 INPUT_SOURCE_JOYAXES. 슬롯 1은 접미사가 없고, 나머지는 _2~_8입니다. config.xml은 DirectInput 인스턴스 GUID로 장치를 슬롯에 매핑하며, X4 고유 형식({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00})으로 씁니다. num 0~7이 슬롯이고, disabled="1"은 없음을 뜻합니다. JoyPro는 현재 활성 항목이 연결된 장치와 일치하는 슬롯에만 씁니다.
  • 코드: 버튼 1~11은 X4의 게임패드 이름(INPUT_XBUTTON_A ... BIGBUTTON), 12~64는 INPUT_XBUTTON_12 ...를 씁니다. 햇은 INPUT_XBUTTON_DPAD_*(8방향), 축은 INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2입니다. 범위에는 sgn이 붙지 않습니다. 키보드: _SHIFT / _CONTROL이 붙은 INPUT_KEYCODE_<DIK>.
  • 명령 목록: engine x4 refresh-db는 .cat/.dat 아카이브에서 gameoptions.lua와 영어 텍스트 페이지를, X4.exe에서 이름 표를 읽기 전용으로 읽습니다. 우주 비행 조종 128개(축 6개, 버튼 122개). 행은 "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)"처럼 표시됩니다. engine x4 catalog는 목록을 보여 주고, engine x4 paths는 찾은 파일을 보여 줍니다.
  • 가져오기 / 내보내기: engine x4 import, engine x4 scan; engine x4 export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run.
  • 게임 설정: engine ffb set --device * --game X4 --param <key>=<value>. 매개변수는 그 자리에서 편집하며, 없는 매개변수는 <config>의 마지막 줄로 추가합니다. X4 바인딩이 없는 내보내기도 저장된 설정은 씁니다.

#알려진 한계

  • 고정된 슬롯이 없는 장치는 건너뜁니다. JoyPro는 아직 직접 고정하지 않습니다.
  • 조이스틱 수정키는 쓰지 않습니다. 파일에서의 표기 방식이 아직 확인되지 않았습니다.
  • 장치당 버튼 64개, 축 8개, 햇 1개. 슬롯은 8개이며 게임패드와 공유합니다.
  • 진동: 게임의 슬라이더는 값에 100을 곱해 소수점 이하를 버린 값을 보여 줍니다(21 %가 20으로 표시). 파일에는 정확한 값이 남습니다.
  • 테스트: engine\tests\smoke\x4.ps1(카탈로그 갱신 포함); 게임 안에서 tools\e2e\games\X4.ps1(바인딩과 모드 매트릭스, 별도 프로필 폴더에서)와 tools\e2e\games\X4Settings.ps1(반전, 스로틀 모드, 게임 설정).

이 게임에 대한 모든 기술 메모(저장소에서 생성됨): x4.md.