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 хет по joystick (проверено)
Список на команди од
табелите со имиња во X4.exe и архивите .cat/.dat
Тест во играта
36/36 чекори поминати (2026-10-11)
  • ✓ Увези
  • ✓ Извоз
  • ✓ Доделби на тастатура
  • ◐ МодификаториX4: Shift/Ctrl на доделбите за тастатура; доделбите за joystick не примаат модификатор.
  • ✓ Список на команди изграден на вашиот PC
  • ✓ Следење на игри
  • ✗ Криви и мртви зони на оскиX4: само општата мртва зона на играта и превртувањата (Game settings), ништо по доделба.
  • ✓ Поставки за контроли на играта
  • ✗ Поставки за force feedback во играта
  • ✗ Force feedback од телеметрија
  • ✗ Снимање на телеметрија
  • ✓ Виртуелен joystick (vJoy)
  • ◐ Виртуелен Xbox контролер
  • ✓ Виртуелни функции
  • ✓ Волшебник за поставување / Auto Assign
  • ✓ Кокпити
  • ✓ Потсетници
  • ✓ Тест во играта
X Rebirth само документирано
Поддршка
само документирано
Команда на моторот
нема
  • — Увези
  • — Извоз
  • — Доделби на тастатура
  • — Модификатори
  • — Список на команди изграден на вашиот PC
  • — Следење на игри
  • — Криви и мртви зони на оски
  • — Поставки за контроли на играта
  • — Поставки за force feedback во играта
  • — Force feedback од телеметрија
  • — Снимање на телеметрија
  • — Виртуелен joystick (vJoy)
  • — Виртуелен Xbox контролер
  • — Виртуелни функции
  • — Волшебник за поставување / Auto Assign
  • — Кокпити
  • — Потсетници
  • — Тест во играта
X3 (Reunion, Terran Conflict, Albion Prelude) само документирано
Поддршка
само документирано
Команда на моторот
нема
  • — Увези
  • — Извоз
  • — Доделби на тастатура
  • — Модификатори
  • — Список на команди изграден на вашиот PC
  • — Следење на игри
  • — Криви и мртви зони на оски
  • — Поставки за контроли на играта
  • — Поставки за 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. Притиснете Увези сега. Види ги моите релации го отвора она што влезе.

#Изградете и проверете релации

Спојте ја истата функција од вашите игри со текот на релации, потоа притиснете Провери на страницата Извоз. Оставете ги вашите 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 и адаптивно управување ги покажуваат вашите вредности. Auto-roll и вибрациите се во поставките на играта.

#Што правите сами во 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>) и поставките на играта како вибрации, auto-roll и режим за гејмпад; се читаат за местата, се уредуваат на истото место за поставките
...\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. Мртвите зони на релациите не се запишуваат (извозот го кажува тоа); поставете ја мртвата зона на играта во Поставки > Поставки за force feedback на игрите (изберете X4) или со engine ffb set. На истото место се наоѓаат адаптивното управување, вибрациите, auto-roll и режимот за гејмпад. Поставка што ја зачувате таму победува над релациите, со предупредување кога ги обратува.
  • Нема криви по оска или сатурација во 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/>(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.