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 Hat на joystick (праверана)
Спіс каманд з
табліцы назваў з X4.exe і архівы .cat/.dat
Праверка ў гульні
36/36 крокаў пройдзена (2026-10-11)
  • ✓ Імпарт
  • ✓ Экспарт
  • ✓ Прывязкі клавіятуры
  • ◐ МадыфікатарыX4: Shift/Ctrl на прывязках клавіятуры; прывязкі joystick мадыфікатара не прымаюць.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✗ Крывыя восяў і мёртвыя зоныX4: толькі агульная мёртвая зона гульні і інверсіі (Game settings), нічога на прывязку.
  • ✓ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ✓ Майстар налады / Auto Assign
  • ✓ Кабіны
  • ✓ Шпаргалкі
  • ✓ Праверка ў гульні
X Rebirth толькі апісана
Падтрымка
толькі апісана
Каманда рухавіка
няма
  • — Імпарт
  • — Экспарт
  • — Прывязкі клавіятуры
  • — Мадыфікатары
  • — Спіс каманд, пабудаваны на вашым ПК
  • — Назіральнік за гульнямі
  • — Крывыя восяў і мёртвыя зоны
  • — Налады кіравання ў гульні
  • — Налады зваротнай сувязі па сіле ў гульні
  • — Зваротная сувязь па сіле з тэлеметрыі
  • — Запіс тэлеметрыі
  • — Віртуальны joystick (vJoy)
  • — Віртуальны пульт Xbox
  • — Віртуальныя функцыі
  • — Майстар налады / Auto Assign
  • — Кабіны
  • — Шпаргалкі
  • — Праверка ў гульні
X3 (Reunion, Terran Conflict, Albion Prelude) толькі апісана
Падтрымка
толькі апісана
Каманда рухавіка
няма
  • — Імпарт
  • — Экспарт
  • — Прывязкі клавіятуры
  • — Мадыфікатары
  • — Спіс каманд, пабудаваны на вашым ПК
  • — Назіральнік за гульнямі
  • — Крывыя восяў і мёртвыя зоны
  • — Налады кіравання ў гульні
  • — Налады зваротнай сувязі па сіле ў гульні
  • — Зваротная сувязь па сіле з тэлеметрыі
  • — Запіс тэлеметрыі
  • — Віртуальны 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 або другі Hat нічога не робяць: X4 чытае 64 кнопкі, 8 восяў і адзін Hat на прыладу. 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 і throttle інвертаванымі, таму для іх JoyPro ставіць параметр, адваротны вашай інверсіі. Ён задае параметр толькі тады, калі ўсе восі JoyPro на гэтым элеменце кіравання згодныя.
  • Двухбаковы РУД ідзе за параметрам Паўзунок сувязі РУД: з Паўзунком = толькі ўперад, без Паўзунка = цэнтр азначае нулявую цягу.
  • Мёртвая зона: у X4 адна мёртвая зона для ўсіх восей усіх джойсцікаў. Мёртвыя зоны сувязей не запісваюцца (экспарт паведамляе пра гэта); задайце мёртвую зону гульні ў Налады > Налады зваротнай сувязі па сіле гульняў (выберыце X4) або праз engine ffb set. Там жа знаходзяцца адаптыўнае рулявое кіраванне, вібрацыя, аўтакрэн і рэжым пульта. Налада, якую вы там захавалі, мацнейшая за сувязі; калі яна іх перакульвае, з'яўляецца папярэджанне.
  • У X4 няма крывых і насычэння для асобных восей; няма зваротнай сувязі па сіле; няма тэлеметрыі.
  • Назіральнік: прывязку або параметр, які вы змянілі ў гульні, JoyPro заўважае пасля яе закрыцця (inputmap.xml і config.xml) і пытаецца, ці пераняць яго.
  • 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 называе джойсцік па яго слоце. Прылада без фіксаванага слота прапускаецца.

Код: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs і мадэль налад engine\FfbModels\X4.cs.

  • Слоты: прывязка называе крыніцу: INPUT_SOURCE_JOYBUTTONS (кнопкі і Hat) або 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 ...; Hat — 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 восей і адзін Hat на прыладу; восем слотаў, агульных з пультамі.
  • Вібрацыя: паўзунок гульні паказвае значэнне, памножанае на 100 і абрэзанае (21 % паказваецца як 20); файл захоўвае дакладнае значэнне.
  • Тэсты: engine\tests\smoke\x4.ps1 (у тым ліку абнаўленне каталога); у гульні tools\e2e\games\X4.ps1 (прывязкі і матрыца рэжымаў, ва ўласнай папцы профілю) і tools\e2e\games\X4Settings.ps1 (інверсіі, рэжым РУД, налады гульні).

Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): x4.md.