JoyPro2 Discord GitHub
Основні сценарії

Експорт у ваші ігри

Показати:

Експорт — це крок, після якого ваші ручки керування працюють у грі. JoyPro записує ваші зв'язки й прив'язки у файли налаштувань керування кожної гри — ті самі файли, які зберігає власне меню керування гри. Під час польоту у фоні нічого не працює: після експорту гра, як завжди, читає власні файли.

flowchart LR
  C["1 Перевірка<br/>(необов'язково)"] --> M["2 Вибір способу<br/>(4 варіанти)"]
  M --> G["3 Позначте ігри,<br/>Експортувати позначені ігри"]
  G --> W["Спершу резервна копія,<br/>потім записуються<br/>файли гри"]
Крок 1 лише дивиться; він ніколи не зупиняє експорт. «Скасувати останній експорт» на картці гри повертає її файли. В ігри лише для Xbox нічого не записується: вони використовують «Старт» на сторінці «Віртуальний joystick».
Для початківців

#Експорт у три кроки

Відкрийте Експорт на панелі внизу. Сторінка складається з трьох пронумерованих карток згори донизу:

Сторінка «Експорт»: перевірка, спосіб, ігриСторінка «Експорт»: перевірка, спосіб, ігри
Сторінка «Експорт»: перевірка, спосіб, ігри (Зображення показують застосунок англійською.)
  1. Перевірте свій профіль. Натисніть Перевірити зараз. JoyPro шукає те, що піде не так у грі, наприклад кнопку, яка робить дві речі в тому самому літаку. Виправте знайдене (одне клацання на проблему) або залиште; перевірка ніколи не блокує експорт. Див. перевірку.
  2. Як JoyPro записує в ігри. Виберіть один із чотирьох варіантів. Якщо не впевнені, залиште перший: Замінити на моїх пристроях з позначеним Очистити й інші мої пристрої. Тоді ваші ручки керування роблять саме те, що каже ваш профіль, і нічого більше.
  3. Експорт в ігри. Кожна гра, для якої у вашому профілі є прив'язки, отримує картку зі своїм зображенням. Позначте ігри й натисніть Експортувати позначені ігри або натисніть Експортувати зараз на одній картці.

Спершу закрийте гру. Ігри записують свої файли керування під час виходу, тому JoyPro відмовляється експортувати в гру, яка працює, і повідомляє вам про це.

#Який варіант мені підходить?

Вибір Вибирайте, коли Що відбувається з власними прив'язками гри
Замінити на моїх пристроях Ви налаштовуєте свої ручки керування саме в JoyPro На пристроях вашого профілю залишаються лише ваші прив'язки (для літаків, які ви експортуєте).
Оновити, зберегти прив'язки гри Ви також прив'язуєте щось у самій грі й хочете це зберегти Ваші прив'язки додаються; прив'язка гри видаляється лише там, де вона стоїть на кнопці, яку ви використовуєте для чогось іншого.
Оновити, мій профіль головніший Як і попередній варіант, але ви перенесли дії на інші кнопки в JoyPro Як вище, і кожна дія, яку ви прив'язуєте, втрачає в грі свої інші кнопки, тож перенесення справді переносить.
Лише додати Ви пробуєте JoyPro вперше Нічого не видаляється. Якщо гра вже використовує кнопку для чогось іншого, вашу прив'язку пропускають, і перевірка вам про це скаже.

Очистити й інші мої пристрої (прапорець під варіантами): підключені пристрої, які не мають прив'язок у вашому профілі, втрачають свої прив'язки в експортованих літаках. Залиште його позначеним, якщо хочете почати з чистого аркуша, і зніміть позначку, якщо використовуєте другий пристрій лише в самій грі.

#Безпечно за задумом

  • Перш ніж JoyPro змінить файл гри, він копіює його в резервну копію. Кожна картка має Скасувати останній експорт: це повертає файли точно такими, якими вони були, байт у байт.
  • Перший експорт у гру, яка вже має власні прив'язки, один раз питає: «Спершу імпортувати?». Виберіть Спершу імпортувати, якщо хочете зберегти те, що зробили в грі, або Усе одно експортувати, щоб це замінити.
  • Пристрої, які не підключені, зберігають свої прив'язки. Прив'язки вашої миші й геймпада ніколи не зачіпаються.

#Що ви помітите в грі

Запустіть гру й відкрийте її меню керування: ваші прив'язки там, у стовпці кожного пристрою, під назвами, які використовує гра. У DCS вони показуються для кожного літака; у Star Citizen — для кожної дії корабля; в IL-2 — у Key mapping. Розділ У грі нижче описує всі типи ігор.

#Інші способи, якими ваші прив'язки потрапляють у гру

Спосіб Що він робить
Записати в мою гру (швидке налаштування) Експорт швидкого налаштування. Він записує ігри, які налаштував, з тією самою резервною копією. Див. Швидкий старт.
Несправжній контролер (віртуальний геймпад Xbox) В ACE COMBAT 8 і Hell Let Loose: Vietnam нічого не записується. Їхній експорт про це повідомляє. Ваша ручка керування керує несправжнім контролером, поки ввімкнено Старт. Див. Ігри лише для Xbox.
Наколінний планшет DCS Не експорт прив'язок: сторінка для кожного літака, яка в кабіні перелічує, що роблять ваші кнопки. Див. планшет.
Розширені

#Режими докладно

«Той самий вхід» означає той самий пристрій, ту саму кнопку чи вісь і ті самі модифікатори в тому самому літаку (або кораблі, техніці), якщо гра зберігає прив'язки для кожного літака. Кожен режим працює лише в літаках експорту.

Лише додати Оновити, зберегти Оновити, профіль головніший Замінити
Ваші прив'язки записуються там, де вхід вільний описано описано описано
Прив'язка гри на вході, який ви використовуєте для іншої дії зберігається; ваша прив'язка не записується й позначається видаляється видаляється видаляється
Прив'язка гри для тієї самої дії на іншому вході (після перенесення) збережено зберігається (дія на обох входах) видаляється видаляється на записаних пристроях
Інші прив'язки гри на ваших пристроях збережено збережено збережено видаляються
Стандартні прив'язки гри на ваших пристроях збережено збережено зберігаються, якщо не займають одну з ваших дій видаляються
Підключені пристрої без прив'язок у профілі збережено збережено ваші дії з них видаляються зберігаються, якщо не позначено Очистити й інші мої пристрої
Непідключені пристрої, миша, геймпад ніколи не змінюються ніколи не змінюються ніколи не змінюються ніколи не змінюються
Клавіатура лише з параметром клавіатури лише з параметром клавіатури лише з параметром клавіатури лише з параметром клавіатури
Літаки, яких немає в експорті ніколи не змінюються ніколи не змінюються ніколи не змінюються ніколи не змінюються (DCS: якщо не ввімкнено параметр «втрачають прив'язки DCS за замовчуванням і в решті літаків»)

Очистити й інші мої пристрої не використовується з «Лише додати». З іншими режимами воно очищає підключені пристрої, яких профіль не використовує, в експортованих літаках (DCS: також їхні стандартні прив'язки DCS). Пристрої, які імпорт ігнорує, і пристрій vJoy, у який JoyPro передає входи, ніколи не очищаються.

Починаючи з 2.5.0, типовий вибір — Замінити на моїх пристроях + Очистити й інші мої пристрої (як у JoyPro 1). Режим, який ви вибрали самі, запам'ятовується.

#Коротко: одна ваша прив'язка, чотири режими

Режим Гра використовує вашу кнопку для чогось іншого Ваша дія має в грі інші кнопки Інші підключені пристрої
Замінити на моїх пристроях Та прив'язка видаляється; ваша записується Видаляються на записаних пристроях Зберігаються, якщо не позначено Очистити й інші мої пристрої
Оновити, мій профіль головніший Та прив'язка видаляється; ваша записується Видалено Ваші дії з них видаляються
Оновити, зберегти прив'язки гри Та прив'язка видаляється; ваша записується Зберігаються: дія на обох Збережено
Лише додати Зберігається; ваша не записується й позначається Збережено Збережено

#Параметри для кожної гри

У розділі Параметри та шляхи (для досвідчених):

  • DCS: список Літаки... на картці DCS (записуються лише позначені літаки); DCS: зберегти типові клавіші клавіатури (увімкнено); мої пристрої втрачають прив'язки DCS за замовчуванням і в решті літаків (вимкнено).
  • Star Citizen: SC: зберегти типові клавіші клавіатури, віддавати перевагу локальному порядку.
  • Інші ігри: поле Пробний запуск, яке показує, що зміниться, нічого не записуючи.
  • Шляхи: інша тека Saved Games чи конфігурації для кожної гри; Власні шляхи й ігноровані пристрої для цього профілю дає відкритому профілю власні замість тих, що на ПК.

#Позначки: «Не записано в гру»

«Лише додати» (і будь-який режим, коли гра не має вільного місця для ще одного входу, наприклад Elite Dangerous із двома входами на дію) пропускає деякі прив'язки. Профіль запам'ятовує кожну разом із дією гри, яка займає вхід, і датою; Перевірка показує картку для кожної позначки з Експортувати з 'Оновити', щоб замінити, Перенести на іншу кнопку і Залишити як є. Кожен експорт замінює позначки своєї гри й літаків, тож позначка зникає, коли пізніший експорт записує прив'язку.

#Збережені налаштування

Режим, прапорець Очистити й інші, параметри для кожної гри й шляхи зберігаються в налаштуваннях JoyPro; ігри й літаки DCS, які ви позначили самі, зберігаються для кожного профілю. «Замінити» і «Очистити й інші» питають перед кожним експортом (у Налаштування > Підтвердження це питання можна вимкнути).

#Після експорту

  • Скасувати останній експорт на картці відновлює найновішу резервну копію цієї гри. Повний список — у розділі Резервні копії конфігурацій ігор унизу сторінки «Експорт».
  • Експорт записує файли гри для спостерігача за іграми: власний експорт JoyPro ніколи потім не питає «перенести зміни?»; зміна, яку ви потім зробите в грі, — питає (спостерігач).
  • JoyPro зберігає власні дані поруч із файлом гри, тож пізніший імпорт повертає назви зв'язків, групи, модифікатори й криві (повторний імпорт).

#У грі

Що гравець побачить після експорту, залежить від типу гри. Усі ігри нижче дотримуються тих самих правил: JoyPro записує лише дії зі свого списку команд, відмовляється записувати, поки гра працює, спершу робить резервну копію файлів і ніколи не вгадує пристрій чи дію, яку не може зіставити (він пропускає їх із попередженням).

У грі: Авіасимулятори: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro бере на себе пристрої, у які записує. Із Замінити всі інші прив'язки цих пристроїв зникають в експортованих літаках, а з Очистити й інші очищуються й інші підключені пристрої (у DCS — також їхні прив'язки DCS за замовчуванням).

  • DCS World: в Options > Controls виберіть літак: ваші прив'язки — у стовпці пристрою, видалені прив'язки за замовчуванням показуються порожніми клітинками, ваші модифікатори — у списку модифікаторів. Змінюються лише позначені літаки. JoyPro записує лише відмінності від прив'язок DCS за замовчуванням, як це робить сама DCS.
  • IL-2 Great Battles: Settings > Key mapping показує ваші прив'язки й відгуки осей. Рядки миші й рядки, яких JoyPro не знає, залишаються.
  • IL-2 Korea: профіль key mapping «General».
  • Falcon BMS: лаунчер створює файл клавіш і розподіл осей під час наступного Launch, тож запускайте BMS через лаунчер.
  • MSFS 2024 / 2020: у Controls пристрій показує пресет JoyPro.
  • X-Plane 11 / 12: Settings > Joystick показує призначення.
У грі: Ігри з піхотою, технікою чи меню: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro зачіпає лише льотні дії (літак, гелікоптер, космічний корабель). Ваші прив'язки для ходіння пішки, техніки й меню залишаються байт у байт. Замінити й Очистити й інші звільняють лише ті льотні дії, які JoyPro знає.

  • Star Citizen: Options > Keybindings показує дії корабля на ваших джойстиках (js1, js2, ...). Із Замінити або Очистити й інші власні прив'язки джойстика гри за замовчуванням на js1 вимикаються, коли js1 записується або не використовується.
  • War Thunder: «Елементи керування» показують прив'язки літаків; керування танками й кораблями не змінюється.
  • Arma 3 / Arma 2: налаштування клавіш профілю; змінюються лише дії літаків і гелікоптерів.
У грі: Космічні ігри: Elite Dangerous, X4: Foundations
  • Elite Dangerous зберігає два входи на дію (Primary і Secondary). Прив'язка без вільного місця отримує позначку «Не записано» з «Перенести на іншу кнопку» або «Залишити як є». Прив'язки для ходіння пішки й SRV залишаються.
  • X4: налаштування введення гри; змінюються лише дії кораблів, внесені до каталогу.
У грі: Ігри, які читають один пристрій або лише контролер Xbox
  • Ігри, налаштовані на vJoy (ігри, які читають лише кілька пристроїв): експорт записує прив'язки на пристрій vJoy. Поки ви граєте, JoyPro копіює на нього ваші ручки керування, а HidHide ховає ваші справжні пристрої лише від цієї гри. Гра бачить один пристрій, на якому є все. Див. Віртуальний joystick.
  • Ігри лише для Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam): нічого не записується, і експорт про це повідомляє. Ваша ручка керування керує несправжнім контролером (віртуальним геймпадом Xbox), поки ввімкнено Старт. HidHide не потрібен. Див. Грати в гру лише для Xbox з HOTAS.
Технічні подробиці

#Як це працює всередині

Один експорт від клацання до записаних файлів:

# Хто Що відбувається
1 Ви Натисніть Експортувати позначені ігри на сторінці «Експорт».
2 JoyPro Питає рушій про гру (profile game-state --game <id>): імпортована, експортована, має прив'язки.
3 JoyPro Питає вас, коли потрібно: перший експорт («Спершу імпорт?») або режим, що видаляє прив'язки (Налаштування > Підтвердження).
4 Рушій Запускає <game> export --mode <m> --nuke-untouched-devices <b> ...: відмовляється, поки гра працює, робить резервну копію кожного файлу (GameBackups і .jpbak) і записує лише дії з каталогу.
5 Рушій Зберігає запис синхронізації (відбиток і базовий стан) та позначки експорту, потім відповідає: записано, пропущено, SkippedTakenInputs.
6 JoyPro Картка гри показує «Експортовано: 14:02», і кнопка Скасувати останній експорт готова.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) викликають AskAboutFirstExportAsync (engine profile game-state) і ConfirmRiskyExportAsync, потім ExportGameAsync вибирає експортер картки: dcs, il2, starcitizen або гру з реєстру. Команда будується з налаштувань сторінки, наприклад RunDcsExportAsync: engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Кожен виклик рушія проходить через одне місце, RunEngineAsync, з --profile і --status true (поступ і «Скасувати» в області зайнятості), послідовно, тож дві команди ніколи не записують одночасно.
  2. Рушій. engine\Program.cs спрямовує dcs / il2 / starcitizen до їхніх експортерів, а кожну іншу гру — до Games.GameRegistry (один GameIntegration на гру). DCS: EngineDcsExport.Modes.cs обчислює для кожного файлу пристрою прив'язки, активні в DCS (чистий профіль мінус removed, плюс added і changed), вирішує, які мають бути активні, і записує лише справжні відмінності від стандартних.
  3. Безпека. GameExportSafety.BackupBeforeOverwrite копіює кожен файл у <file>.jpbak і у версійне сховище резервних копій (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ з manifest.json; зберігаються 30 найновіших наборів на гру). Ігри з реєстру (Nuclear Option) отримують знімок значень, які вони можуть змінити. Файл, який створює експорт, записується як «не існував», тож відновлення знову його видаляє.
  4. Потім. Запис синхронізації (<data>\Sync\<game>.json: розмір, час і SHA-256 для кожного файлу та хеш кожної прив'язки) змушує спостерігача мовчати про власну зміну JoyPro. ExportSkippedBinds.cs заповнює SkippedTakenInputs; команда експорту перетворює їх на позначки профілю. Історія профілю зберігає контрольну точку перед кожним експортом.

#Файли, які отримує кожна гра

Гра Файли
DCS World для кожного літака й пристрою Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, .jp поруч із ним, modifiers.lua літака
IL-2 Great Battles data\input\global.actions (нові рядки в кінці, порядок зберігається), відгук осей, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS User\Config\Setup.v100.* {GUID}.xml лаунчера для кожного пристрою
MSFS 2024 / 2020 профілі введення (2024: пакет пресетів joypro-input-profiles у теці Community і профілі Steam)
X-Plane 11 / 12 налаштування joystick в Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml і actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Ігри з реєстру їхній файл конфігурації й <config>.joypro-meta.json

Позначки незаписаних прив'язок: engine export-marks list, engine export-marks dismiss. Налаштування: export-settings.json (ModeChosenByUser); типовий режим рушія без --mode — merge-overwrite.

#Кожен режим у командному рядку

Вибір у GUI Параметри рушія
Замінити на моїх пристроях + Очистити й інші мої пристрої (типово) --mode clean --nuke-untouched-devices true
Замінити на моїх пристроях --mode clean --nuke-untouched-devices false
Оновити, мій профіль головніший (+ Очистити й інші) --mode merge-overwrite --nuke-untouched-devices true|false
Оновити, зберегти прив'язки гри (+ Очистити й інші) --mode merge --nuke-untouched-devices true|false
Лише додати --mode add (nuke не використовується)

Для кожної гри: engine dcs export, engine il2 export, engine starcitizen export і engine <game> export для кожної гри з реєстру (наприклад engine warthunder export, engine msfs2024 export, engine xplane12 export; кожна приймає --mode, --dry-run, --include-keyboard і --nuke-untouched-devices). Скасування: engine backups restore. Тести: engine\tests\smoke\dcsexportmodes.ps1 (кожен режим, повний цикл, скасування байт у байт) і engine\tests\smoke\roundtrip.ps1 (імпорт, clean + nuke, повторний імпорт залишає гру такою, якою вона була).