JoyPro2 Discord GitHub
Игри

X4: Foundations

Показване:

X4: Foundations пази назначенията ви в inputmap.xml и именува joystick по неговия слот (от 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), нищо на назначение.
  • ✓ Настройки за управление в играта
  • ✗ Настройки за обратна сила в играта
  • ✗ Обратна сила от телеметрия
  • ✗ Запис на телеметрия
  • ✓ Виртуален joystick (vJoy)
  • ◐ Виртуален Xbox геймпад
  • ✓ Виртуални функции
  • ✓ Съветник за настройка / Авто назначаване
  • ✓ Кабини
  • ✓ Бележници
  • ✓ Тест в играта
X Rebirth само описано
Поддръжка
само описано
Команда на ядрото
няма
  • — Импортиране
  • — Експортиране
  • — Назначения на клавиатурата
  • — Модификатори
  • — Списък с команди, изграден на вашия PC
  • — Следене на игри
  • — Криви на осите и мъртви зони
  • — Настройки за управление в играта
  • — Настройки за обратна сила в играта
  • — Обратна сила от телеметрия
  • — Запис на телеметрия
  • — Виртуален joystick (vJoy)
  • — Виртуален Xbox геймпад
  • — Виртуални функции
  • — Съветник за настройка / Авто назначаване
  • — Кабини
  • — Бележници
  • — Тест в играта
X3 (Reunion, Terran Conflict, Albion Prelude) само описано
Поддръжка
само описано
Команда на ядрото
няма
  • — Импортиране
  • — Експортиране
  • — Назначения на клавиатурата
  • — Модификатори
  • — Списък с команди, изграден на вашия PC
  • — Следене на игри
  • — Криви на осите и мъртви зони
  • — Настройки за управление в играта
  • — Настройки за обратна сила в играта
  • — Обратна сила от телеметрия
  • — Запис на телеметрия
  • — Виртуален joystick (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. Натиснете Импортиране сега. Виж моите връзки отваря това, което е влязло.

#Създаване и проверка на връзки

Свържете една и съща функция от игрите си с потока за връзки, после натиснете Проверка на страницата Експортиране. Дръжте назначенията си на joystick без модификатори: X4 не приема модификатор при назначение на joystick.

#Експортиране към X4

  1. Затворете X4. Играта записва inputmap.xml и config.xml, когато сесията приключи, затова JoyPro отказва да записва, докато тя работи.
  2. Отворете Експортиране и отметнете картата на X4.
  3. Оставете Замяна на моите устройства с Изчистване и на другите ми устройства, ако настройвате ръчките си в JoyPro. Натиснете Експортиране сега на картата.
В играта: Какво виждате в X4

Стартирайте играта и отворете Settings > Controls. Назначенията ви са в колоната за контролер / joystick на всеки контрол за космически полет, в слота на вашето устройство. Invert Controller / Joystick Axes показва обръщанията, които JoyPro е задал, а редовете за двупосочна газ, мъртва зона на joystick и адаптивно управление показват вашите стойности. Автоматичното завъртане и вибрацията са в настройките на играта.

#Какво правите сами в 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 броят pitch, roll и газта като обърнати, затова за тях JoyPro задава параметъра на вашето обръщане, обърнато наопаки. Задава параметър само когато всички оси на JoyPro за тази контрола са съгласни.
  • Двупосочната газ следва Плъзгач на връзката за газ: Плъзгач = само напред, без Плъзгач = центърът е нулева тяга.
  • Мъртва зона: X4 има една мъртва зона за всяка ос на всеки joystick. Мъртвите зони на връзките не се записват (експортирането го казва); задайте мъртвата зона на играта в Настройки > Настройки за обратна сила на игрите (изберете X4) или с engine ffb set. На същото място са адаптивното управление, вибрацията, автоматичното завъртане и режимът на геймпад. Настройка, която запазите там, надделява над връзките, с предупреждение, когато ги обръща.
  • В X4 няма криви или насищане за отделна ос; няма обратна сила; няма телеметрия.
  • Наблюдател: назначение или опция, които промените в играта, се забелязват след затварянето ѝ (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/>(instance 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.