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 хет на joystick (перевірено)
- Список команд з
- таблиці назв з
X4.exeта архіви.cat/.dat - Внутрішньоігровий тест
- 36/36 кроків пройдено (2026-10-11)
- ✓ Імпорт
- ✓ Експорт
- ✓ Прив'язки клавіатури
- ◐ МодифікаториX4: Shift/Ctrl на прив'язках клавіатури; прив'язки joystick модифікатора не приймають.
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✗ Криві осей і мертві зониX4: лише загальна мертва зона гри та інверсії (Game settings), нічого на прив'язку.
- ✓ Налаштування керування гри
- ✗ Налаштування Force Feedback у грі
- ✗ Force Feedback з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
X Rebirth лише описано
- Підтримка
- лише описано
- Команда рушія
- немає
- — Імпорт
- — Експорт
- — Прив'язки клавіатури
- — Модифікатори
- — Список команд, створений на вашому ПК
- — Спостерігач за іграми
- — Криві осей і мертві зони
- — Налаштування керування гри
- — Налаштування Force Feedback у грі
- — Force Feedback з телеметрії
- — Запис телеметрії
- — Віртуальний joystick (vJoy)
- — Віртуальний геймпад Xbox
- — Віртуальні функції
- — Майстер налаштування / Auto Assign
- — Кабіни
- — Шпаргалки
- — Внутрішньоігровий тест
X3 (Reunion, Terran Conflict, Albion Prelude) лише описано
- Підтримка
- лише описано
- Команда рушія
- немає
- — Імпорт
- — Експорт
- — Прив'язки клавіатури
- — Модифікатори
- — Список команд, створений на вашому ПК
- — Спостерігач за іграми
- — Криві осей і мертві зони
- — Налаштування керування гри
- — Налаштування Force Feedback у грі
- — Force Feedback з телеметрії
- — Запис телеметрії
- — Віртуальний joystick (vJoy)
- — Віртуальний геймпад Xbox
- — Віртуальні функції
- — Майстер налаштування / Auto Assign
- — Кабіни
- — Шпаргалки
- — Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
тримайте X4 закритою
До: один раз дайте кожному пристрою слот. У налаштуваннях керування X4 відкрийте Manage Controllers/Joysticks. Призначте кожен пристрій слоту, потім вийдіть із гри звичайним способом.
Потім: ваші прив'язки — в Settings > Controls.
Ви вже прив'язували кнопки в X4 раніше? Тоді сторінка «Початок» пропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаються, а нові завдання отримують лише вільні кнопки. Див. Швидкий старт: як змусити мою ручку керування працювати.
#Що JoyPro робить для X4
- Імпорт: прив'язки космічного польоту ваших ручок керування, важелів газу й педалей потрапляють у ваш профіль разом з інверсіями й режимом газу гри.
- Зв'язки: один зв'язок — це одна функція в усіх іграх. «Boost» може бути тією самою кнопкою в X4, Elite Dangerous і Star Citizen.
- Експорт: JoyPro редагує
inputmap.xmlна місці, у слотах ваших пристроїв. Прив'язки меню, ходіння від першої особи, клавіатури й миші залишаються.
#Імпорт ваших прив'язок X4
- Відкрийте Початок. Якщо картка X4 просить список команд, натисніть Створити список: JoyPro зчитує керування гри з вашої інсталяції (лише читання).
- Натисніть Імпорт на картці X4. Залиште Додати до мого профілю. Позначте Брати також клавіші клавіатури, якщо хочете мати в JoyPro й свої льотні клавіші.
- Натисніть Імпортувати зараз. Показати мої зв'язки відкриває те, що надійшло.
#Створення й перевірка зв'язків
Об'єднайте ту саму функцію ваших ігор за допомогою процесу роботи зі зв'язками, потім натисніть Перевірити на сторінці «Експорт». Залишайте прив'язки джойстика без модифікаторів: X4 не приймає модифікатор у прив'язці джойстика.
#Експорт в X4
- Закрийте X4. Гра записує
inputmap.xmlіconfig.xmlнаприкінці сеансу, тому JoyPro відмовляється записувати, поки вона працює. - Відкрийте Експорт і позначте картку X4.
- Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої, якщо ви налаштовуєте свої ручки в JoyPro. Натисніть Експортувати зараз на картці.
Запустіть гру й відкрийте 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 осей і один хет на пристрій. 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 записує й видаляє такі групи так само, як меню, і ніколи не видаляє двійника «Interact» від першої особи.
#Що ніколи не змінюється
- Керування меню, мапи, від першої особи, параметрів і доступності; пункти радіального меню.
- Рядки клавіатури й миші; клавіатура записується лише з параметром клавіатури, лише для керування польотом, ніколи з клавішами, які меню X4 відхиляє (Escape, Delete, Ctrl+X/C/V ...).
- Слоти непідключених або незакріплених пристроїв, геймпади, пристрої, ігноровані імпортом, і пристрій vJoy, у який JoyPro передає входи.
- Кожен рядок
<config>, який JoyPro не задає.
#Криві й налаштування гри
- Деталізація: один набір прив'язок для всіх кораблів (керування космічним польотом).
- Інверсії — одне значення на керування для всіх пристроїв (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). Ваш зв'язок зберігає напрямок DCS; власні карти HOTAS у X4 вважають тангаж, крен і газ інвертованими, тож для них JoyPro ставить параметр як вашу інверсію навпаки. Він задає параметр лише тоді, коли всі осі JoyPro на цьому керуванні узгоджуються. - Двонапрямний газ залежить від параметра Повзунок зв'язку газу: Повзунок = лише вперед, без Повзунка = центр — нульова тяга.
- Мертва зона: X4 має одну мертву зону для всіх осей усіх joystick. Мертві зони зв'язків не записуються (експорт про це повідомляє); задайте мертву зону гри в Налаштування > Налаштування force feedback ігор (виберіть X4) або через
engine ffb set. Там само є адаптивне кермування, вібрація, автокрен і режим геймпада. Налаштування, яке ви там зберігаєте, перемагає зв'язки, з попередженням, коли воно їх обертає. - У X4 немає кривих чи насичення для окремих осей; немає Force Feedback; немає телеметрії.
- Спостерігач: прив'язку чи параметр, які ви змінили в грі, помічено після її закриття (
inputmap.xmlіconfig.xml), і JoyPro питає, чи перенести їх. - HUD: HUD знаходить гру за її процесом і показує ваші прив'язки X4.
#X Rebirth і X3
X Rebirth використовує ті самі слова inputmap.xml, що й X4, але її список команд потребував би власного видобування з інсталяції. 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/>пропускається, призначте його<br/>один раз у X4"] P["Ваш профіль"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>прив'язки для кожного слота"] E --> O["параметри для всієї гри:<br/>інверсії, режим газу"]
Код: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs і модель налаштувань engine\FfbModels\X4.cs.
- Слоти: прив'язка називає джерело:
INPUT_SOURCE_JOYBUTTONS(кнопки й хет) абоINPUT_SOURCE_JOYAXES, без суфікса для слота 1 і з_2до_8для інших.config.xmlзіставляє пристрої зі слотами за GUID екземпляра DirectInput, записаним у власній формі 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_*(вісім напрямків); осі —INPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Діапазони не отримуютьsgn. Клавіатура:INPUT_KEYCODE_<DIK>з_SHIFT/_CONTROL. - Список команд:
engine x4 refresh-dbчитаєgameoptions.luaі сторінку англійського тексту з архівів.cat/.datта таблиці назв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 поки що не закріплює їх сам.
- Модифікатори joystick не записуються: їхня розмітка у файлі ще не підтверджена.
- 64 кнопки, 8 осей і один хет на пристрій; вісім слотів, спільних із геймпадами.
- Вібрація: повзунок гри показує значення, помножене на 100 й обрізане (21 % показується як 20); файл зберігає точне значення.
- Тести:
engine\tests\smoke\x4.ps1(також оновлення каталогу); у гріtools\e2e\games\X4.ps1(прив'язки й матриця режимів, у власній теці профілю) іtools\e2e\games\X4Settings.ps1(інверсії, режим газу, налаштування гри).
Усі технічні примітки до цієї гри (створено з репозиторію): x4.md.