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 на привязках клавиатуры; привязки джойстика модификатор не принимают.
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✗ Кривые осей и мёртвые зоныX4: только общая мёртвая зона игры и инверсии (Game settings), ничего на привязку.
- ✓ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ✓ Мастер настройки / Автоназначение
- ✓ Кабины
- ✓ Шпаргалки
- ✓ Внутриигровой тест
X Rebirth только описано
- Поддержка
- только описано
- Команда движка
- нет
- — Импорт
- — Экспорт
- — Привязки клавиатуры
- — Модификаторы
- — Список команд строится на вашем ПК
- — Наблюдатель за играми
- — Кривые осей и мёртвые зоны
- — Настройки управления игры
- — Настройки Force Feedback в игре
- — Force Feedback из телеметрии
- — Запись телеметрии
- — Виртуальный джойстик (vJoy)
- — Виртуальный геймпад Xbox
- — Виртуальные функции
- — Мастер настройки / Автоназначение
- — Кабины
- — Шпаргалки
- — Внутриигровой тест
X3 (Reunion, Terran Conflict, Albion Prelude) только описано
- Поддержка
- только описано
- Команда движка
- нет
- — Импорт
- — Экспорт
- — Привязки клавиатуры
- — Модификаторы
- — Список команд строится на вашем ПК
- — Наблюдатель за играми
- — Кривые осей и мёртвые зоны
- — Настройки управления игры
- — Настройки Force Feedback в игре
- — Force Feedback из телеметрии
- — Запись телеметрии
- — Виртуальный джойстик (vJoy)
- — Виртуальный геймпад Xbox
- — Виртуальные функции
- — Мастер настройки / Автоназначение
- — Кабины
- — Шпаргалки
- — Внутриигровой тест
Из матрицы поддержки, созданной по коду движка: все игры.
#Запуск за 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 одна мёртвая зона для всех осей всех джойстиков. Мёртвые зоны связок не записываются (экспорт сообщает об этом); задайте мёртвую зону игры в Настройки > Настройки FFB игр (выберите 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 их пока не закрепляет.
- Модификаторы джойстика не записываются: их разметка в файле пока не подтверждена.
- 64 кнопки, 8 осей и одна хатка на устройство; восемь слотов, общих с геймпадами.
- Вибрация: ползунок игры показывает значение, умноженное на 100, с отбрасыванием дробной части (21 % отображается как 20); файл хранит точное значение.
- Тесты:
engine\tests\smoke\x4.ps1(также обновление каталога); в игреtools\e2e\games\X4.ps1(привязки и матрица режимов, в собственной папке профиля) иtools\e2e\games\X4Settings.ps1(инверсии, режим РУД, настройки игры).
Все технические заметки по этой игре (созданы из репозитория): x4.md.