JoyPro2 Discord GitHub
Игри

X-Plane 12 / 11

Показване:

X-Plane пази назначенията на всички ваши устройства в един файл с предпочитания в своята инсталация: „употреба“ на ос (pitch, throttle, flaps ...) за всяка хардуерна ос, команда за всеки бутон и незадължителни криви на реакция. JoyPro чете този файл в профила ви, свързва го с другите ви игри във връзки и го записва обратно, като променя само редовете за полет, които управлява. X-Plane 12 и X-Plane 11 са две игри в JoyPro, всяка със собствена инсталация, списък с команди и настройки; двете могат да са инсталирани една до друга.

X-Plane 12 директно (собствени файлове с назначения)
Поддръжка
директно (собствени файлове с назначения)
Команда на ядрото
engine xplane12
Файл с назначения
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (по редове)
Входове, които играта чете
чете 160 бутона, 25 оси, 1 хат на джойстик (проверено)
Списък с команди от
Resources\plugins\Commands.txt
Тест в играта
33/33 успешни стъпки (2026-10-11)
  • ✓ Импортиране
  • ✓ Експортиране
  • ✗ Назначения на клавиатурата
  • ✗ Модификатори
  • ✓ Списък с команди, изграден на вашия PC
  • ✓ Следене на игри
  • ✓ Криви на осите и мъртви зони
  • ✓ Настройки за управление в играта
  • ◐ Настройки за обратна сила в игратаX-Plane 12: само превключвателят „control-loaded axes“ за всяко устройство, за ръчки с обратна сила; симулаторът няма собствени ефекти на обратна сила за ръчката (само плъгини).
  • ✗ Обратна сила от телеметрия
  • ✓ Запис на телеметрия
  • ✓ Виртуален joystick (vJoy)
  • ◐ Виртуален Xbox геймпад
  • ✓ Виртуални функции
  • ✓ Съветник за настройка / Авто назначаване
  • ✓ Кабини
  • ✓ Бележници
  • ✓ Тест в играта
X-Plane 11 директно (собствени файлове с назначения)
Поддръжка
директно (собствени файлове с назначения)
Команда на ядрото
engine xplane11
Файл с назначения
като X-Plane 12
Входове, които играта чете
чете 160 бутона, 25 оси, 1 хат на джойстик (проверено)
Списък с команди от
Resources\plugins\Commands.txt
  • ✓ Импортиране
  • ✓ Експортиране
  • ✗ Назначения на клавиатурата
  • ✗ Модификатори
  • ✓ Списък с команди, изграден на вашия PC
  • ✓ Следене на игри
  • ✓ Криви на осите и мъртви зони
  • ✓ Настройки за управление в играта
  • ✗ Настройки за обратна сила в играта
  • ✗ Обратна сила от телеметрия
  • ✓ Запис на телеметрия
  • ✓ Виртуален joystick (vJoy)
  • ◐ Виртуален Xbox геймпад
  • ✓ Виртуални функции
  • ✓ Съветник за настройка / Авто назначаване
  • ✓ Кабини
  • ✓ Бележници
  • ✗ Тест в играта

От матрицата за поддръжка, генерирана от кода на ядрото: всички игри.

За начинаещи

#Подкарайте го в 3 стъпки

  1. Настрой всичко вместо мен
    на страницата Начало
  2. Използвай тези бутони
    първо разгледайте списъка
  3. Запиши в моята игра
    дръжте X-Plane затворен

Преди: стартирайте X-Plane веднъж със свързани устройства, после излезте.

После: калибрирайте устройствата си в X-Plane (Settings > Joystick). Назначенията ви се показват и там.

Назначавали ли сте вече бутони в X-Plane? Тогава страницата Начало предлага Импортиране, после запълване на празнините. Назначенията ви остават, а само свободните бутони получават нови задачи. Вижте Бърз старт: моята ръчка да заработи.

#Какво прави JoyPro за X-Plane

  • Импортиране: употребите на осите, командите на бутоните, флаговете за обръщане и кривите на реакция на вашите устройства влизат в профила ви.
  • Връзки: една връзка е една функция във всички ваши игри („Gear“ в X-Plane, MSFS и DCS на един и същ бутон). Командите за полет на X-Plane идват от собствения му Commands.txt.
  • Експортиране: JoyPro записва предпочитанията за joystick на версията, която експортирате. X-Plane показва назначенията ви в Settings > Joystick.

#Импортиране на назначенията ви от X-Plane

  1. Отворете Начало. Картата на X-Plane 12 (или X-Plane 11) показва снимката на играта. Ако иска списък с команди, натиснете Изграждане на списъка: JoyPro чете Resources\plugins\Commands.txt на инсталирания X-Plane.
  2. Натиснете Импортиране на картата и изберете Добавяне към моя профил (X-Plane няма назначения за клавиатура в този файл).
  3. Натиснете Импортиране сега. Виж моите връзки отваря това, което е влязло.
Страницата Начало с вашите игриСтраницата Начало с вашите игри
Страницата Начало с вашите игри (Снимките показват приложението на английски.)

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

На страницата Връзки командата или оста от X-Plane на една връзка стои до същата функция в другите ви игри. Използвайте потока за връзки, за да ги свържете, после натиснете Проверка сега на страницата Експортиране (Проверката).

#Експортиране към X-Plane

  1. Затворете X-Plane. Той презаписва предпочитанията си, когато прозорецът с настройки се затвори и когато излиза. Двете версии работят като X-Plane.exe, затова JoyPro отказва, докато някоя от тях работи.
  2. Отворете Експортиране. Всяка инсталирана версия има собствена карта.
  3. Оставете Замяна на моите устройства с Изчистване и на другите ми устройства, ако настройвате устройствата си в JoyPro. Натиснете Експортиране сега на картата.
В играта: Какво виждате в X-Plane

Стартирайте X-Plane и отворете Settings > Joystick, после изберете устройството си. Всяка ос показва употребата, която JoyPro е записал, бутоните показват своите команди, а Edit Response Curve на една ос показва точките и интерполацията, които JoyPro е записал.

#Какво правите сами в X-Plane

  • Стартирайте X-Plane веднъж със свързани устройства, после излезте. Версия, която никога не е била стартирана, още няма файл с предпочитания. При първото стартиране се лети обучението, а X-Plane записва предпочитанията си за joystick, когато излиза.
  • Калибрирайте в X-Plane. Калибрирането и нулевата зона остават на X-Plane (Settings > Joystick); JoyPro никога не ги записва.
  • Командите на плъгини и самолети не са в списъка на JoyPro: назначете ги в X-Plane, JoyPro не ги докосва.

#Чести грешки

  • Една ос не прави нищо („Multiple axes assigned to yaw“): X-Plane пренебрегва употреба, която две свързани оси споделят. Експортирането предупреждава; Изчистване и на другите ми устройства или Замяна изчиства другата ос.
  • Газта работи наобратно: X-Plane сам обръща осите на газта. JoyPro записва обръщането ви непроменено, затова оставете обръщането изключено, освен ако лостът ви наистина не върви в другата посока.
  • Крива, която сте направили в X-Plane, се промени: в режимите Актуализиране и при Само добавяне тя остава, когато настройката в JoyPro е линейна (с предупреждение); „моят профил печели“ и Замяна записват кривата на JoyPro.
За напреднали

#Файлове, които JoyPro чете и записва

Файл Какво е това
<install>\Output\preferences\X-Plane Joystick Settings.prf текущите назначения на всички устройства (по редове)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf запазени профили за управление, същият формат
<file>.joypro.json, <file>.joypro-meta.json входовете и кривите, които JoyPro е записал; имена, групи и настройки на осите за следващото импортиране
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt където инсталаторът на X-Plane изброява инсталациите си (само за четене)

X-Plane Keys.prf (клавиатура) никога не се докосва. Версия, инсталирана от Steam и никога не стартирана, се намира в папката си в Steam. Друга папка се задава в Настройки > Игри.

#Режимите на експортиране в X-Plane

Режим Какво става в X-Plane
Само добавяне Само свободни входове. Назначение на вход с друга употреба или команда не се записва и се изброява; употреба на ос, която X-Plane има на друга ос, остава там (предупреждение).
Актуализиране, назначенията на играта се запазват Заменя другата употреба или команда на вашия вход и запазва всичко останало; употребата на ос се премества (X-Plane пренебрегва употреба, която две оси споделят).
Актуализиране, моят профил печели Освобождава и другите оси и бутони на свързаните устройства, които носят употреба или команда, която назначавате, заедно с техните криви.
Замяна на моите устройства Освобождава и всяка друга полетна ос и команда на устройствата, които записвате.
+ Изчистване и на другите ми устройства Свързаните устройства, които не записвате, губят полетните си употреби и команди.

#Какво никога не се докосва

  • Слотовете на устройства, които не са свързани, игнорираните при импортиране устройства и устройството vJoy, през което JoyPro прекарва входовете.
  • Осите за изглед, камера, VR и потребителски команди, командите на плъгини и самолети, клавиатурата.
  • Ключовете за калибриране (_joy_center, _joy_null, суровите данни от калибрирането), _eq_pfc_* и всеки друг ред.

#Криви и настройки

  • Ниво на детайл: един файл за всички самолети (X-Plane може да свързва самолети с профили за управление; JoyPro записва файловете, които намери).
  • Криви на реакция (модел на оста xplane): произволен брой опорни точки с LINEAR, CATMULL_ROM или CUBIC_AVG и фиксираните обхвати на осите за газ, витло и смес (beta, feather, cutoff, FADEC ...). Крива по подразбиране става опорни точки; непроменена крива запазва байтовете си. Настройката може да се зададе за една версия или за двете (family:xplane).
  • Обръщане: _joy_rev_axis, вашето обръщане без промяна (X-Plane обръща газовете сам).
  • Настройки на играта (Настройки > Настройки за обратна сила на игрите): реакция на управлението по pitch, roll и yaw; в X-Plane 12 и осите на втория пилот и „control-loaded axes“ за ръчки с обратна сила; в X-Plane 11 стабилизиращата добавка; и в двете фиксираните позиции на задкрилките. Променят се само редове, които файлът вече има.
  • Обратна сила: X-Plane няма собствена; само превключвателят control-loaded.
  • Запис на телеметрия: от UDP изхода за данни на X-Plane (порт 49000), с позиция, така че е възможен запис за Tacview.
  • Наблюдател: промените в предпочитанията се забелязват след затварянето на X-Plane (наблюдателят).
Технически подробности

#Отвътре: интеграцията с X-Plane

flowchart LR
  P["Вашият профил<br/>(връзки + назначения)"] --> E["engine xplane12 export<br/>(или xplane11)"]
  D["Слотове на устройствата<br/>VID:PID + HID път"] --> E
  E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"]
  E --> C["control profiles /<br/>Name - Joysticks.prf"]
  J --> G["X-Plane: Settings > Joystick"]
  C --> G
Всяка версия на X-Plane има собствен файл с предпочитания. Калибрирането и нулевата зона остават на X-Plane.

Код: engine\Games\XPlaneIntegration.cs (по една инстанция за версия), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (профилите от преди разделянето на две версии се мигрират при зареждане).

  • Редове: _joy_AXIS_use<i> (код на употреба), _joy_rev_axis<i>, _joy_BUTN_use<i> (път на командата, sim/none/none = свободен), axis_response_curve<i>. Глобални индекси: ос = слот × 25 + ос, бутон = слот × 160 + бутон.
  • Устройства: слотове _joy_unique_id<slot> VID:<dec>PID:<dec>; при еднакви устройства пътят на HID интерфейса в DirectInput трябва да е равен на _joy_location<slot>. Бутоните са бутоните на устройството, после първият хат като 8 бутона по часовниковата стрелка от горе; другите хатове не се свързват. Четат се по 160 бутона и 25 оси на устройство.
  • Кодове на употреба: от 0 до 66 и в двете версии; X-Plane 12 добавя газ 9, pitch/roll/yaw/спирачки/носово колело на втория пилот и двете спирачки на колелата. Кодовете от 74 до 77 и осите за изглед не са в каталога.
  • Списък с команди: engine xplane12 refresh-db / engine xplane11 refresh-db: таблицата с оси на версията плюс групите полетни команди от Commands.txt (sim/flight_controls, engines, autopilot, lights ...; не sim/view, operation, replay ...).
  • Импортиране / експортиране: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), същото за engine xplane11 export. Първо резервно копие в .jpbak.
  • Настройки и криви: engine ffb set --game XPlane12, engine binds tuning set --scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1, engine binds tuning preview (измерено в X-Plane 12.4.3 с точност до 0.0001).

#Известни ограничения

  • Значението на кодовете на употреба от 74 до 77; редът на осите в HID спрямо DirectInput е изведен косвено.
  • Control Sensitivity на X-Plane без крива не е в прегледа.
  • X-Plane 11 е проверен само спрямо инсталираните си файлове; проверката в менюто на играта предстои.
  • Тестове: engine\tests\smoke\xplane.ps1; в играта (X-Plane 12) назначенията и кривите на реакция преминаха 33 от 33 стъпки; tools\e2e\games\XPlaneCurves.ps1 проверява всяка ос спрямо прегледа на JoyPro.

Всички технически бележки за тази игра (генерирани от хранилището): xplane.md.