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 хет на 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 кроки

  1. Налаштувати все за мене
    на сторінці «Початок»
  2. Використати ці кнопки
    спершу перегляньте список
  3. Записати в мою гру
    тримайте X4 закритою

До: один раз дайте кожному пристрою слот. У налаштуваннях керування X4 відкрийте Manage Controllers/Joysticks. Призначте кожен пристрій слоту, потім вийдіть із гри звичайним способом.

Потім: ваші прив'язки — в Settings > Controls.

Ви вже прив'язували кнопки в X4 раніше? Тоді сторінка «Початок» пропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаються, а нові завдання отримують лише вільні кнопки. Див. Швидкий старт: як змусити мою ручку керування працювати.

#Що JoyPro робить для X4

  • Імпорт: прив'язки космічного польоту ваших ручок керування, важелів газу й педалей потрапляють у ваш профіль разом з інверсіями й режимом газу гри.
  • Зв'язки: один зв'язок — це одна функція в усіх іграх. «Boost» може бути тією самою кнопкою в X4, Elite Dangerous і Star Citizen.
  • Експорт: JoyPro редагує inputmap.xml на місці, у слотах ваших пристроїв. Прив'язки меню, ходіння від першої особи, клавіатури й миші залишаються.

#Імпорт ваших прив'язок 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 осей і один хет на пристрій. 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/>інверсії, режим газу"]
X4 називає joystick за його слотом. Пристрій без фіксованого слота пропускається.

Код: 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.