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 крокі
- Наладзіць усё за мяне
на старонцы «Старт» - Выкарыстаць гэтыя кнопкі
спачатку паглядзіце спіс - Запісаць у маю гульню
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 або другі 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/>інверсіі, рэжым РУД"]
Код: 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.