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 на привязках клавиатуры; привязки джойстика модификатор не принимают.
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✗ Кривые осей и мёртвые зоны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 шага

  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 одна мёртвая зона для всех осей всех джойстиков. Мёртвые зоны связок не записываются (экспорт сообщает об этом); задайте мёртвую зону игры в Настройки > Настройки 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/>инверсии, режим РУД"]
X4 называет джойстик по его слоту. Устройство без фиксированного слота пропускается.

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