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

Імпорт гри

Показати:

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

flowchart LR
  G["Файли керування<br/>вашої гри"] --> I["Імпорт"]
  D["Ваші підключені<br/>пристрої"] --> I
  I --> P["Ваш профіль:<br/>зв'язки, прив'язки,<br/>модифікатори, криві"]
Імпорт лише читає. Гра зберігає свої прив'язки точно такими, як вони є.
Для початківців

#Імпорт у три клацання

  1. Відкрийте Початок (перша кнопка на нижній панелі). У розділі Ваші ігри кожна гра, яку JoyPro знайшов на вашому ПК, має картку зі своїм зображенням. Натисніть Імпорт у грі, у яку граєте найчастіше.
  2. JoyPro питає, як:
    • Додати до мого профілю (рекомендовано) зберігає те, що у вас є, і додає прив'язки гри.
    • Почати знову з цієї гри замінює ваші зв'язки тим, що є в грі (JoyPro спершу зберігає копію вашого профілю).
    • Брати також клавіші клавіатури переносить і льотні команди на клавіатурі. Прив'язки пристроїв беруться завжди.
    • Для DCS: Усі мої літаки DCS або зніміть позначку й виберіть літаки.
  3. Натисніть Імпортувати зараз. За мить картка пише «Done: your profile now has 214 relations (180 bound)», а Показати мої зв'язки відкриває їх. Спершу переглянути натомість показує, що є в грі, нічого не змінюючи.
Сторінка «Початок» з вашими іграми й пристроямиСторінка «Початок» з вашими іграми й пристроями
Сторінка «Початок» з вашими іграми й пристроями (Зображення показують застосунок англійською.)

Профіль не відкрито? JoyPro створить його для вас і відтоді зберігатиме автоматично (кнопки «Зберегти» немає: кожна зміна зберігається, і її можна скасувати навіть після перезапуску).

#Що змінюється в грі?

Нічого. Імпорт лише читає файли гри. Гра зберігає свої прив'язки точно такими, як вони є, незалежно від того, чи експортуєте ви пізніше.

#Імпортуйте, потім дайте JoyPro заповнити прогалини

На сторінці «Початок» картка «Налаштувати пристрої» перелічує ігри, у яких ви самі зробили прив'язки. Імпортувати, потім заповнити прогалини спершу імпортує таку гру. Потім Заповнити прогалини зараз... ставить важливі функції на кнопки, які ще вільні. Ваші власні прив'язки залишаються. Для ігор, які вже є у вашому профілі, картка пропонує Заповнити прогалини....

#Перед першим імпортом: список команд

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

Розширені

#Параметри і що вони роблять

Параметр Типово Ефект
Додати до мого профілю / Почати знову Додати «Додати» об'єднує з відкритим профілем; «Почати знову» замінює його зв'язки після підтвердження й копіювання профілю.
Брати також клавіші клавіатури ваш останній вибір Льотні команди, прив'язані до клавіш, теж імпортуються.
Імпортувати й непідключені пристрої увімкнено Пристрої, які зараз не підключені, теж імпортуються (зручно для ручки, яку ви підключите пізніше). Вимкнено: вони пропускаються й підраховуються.
Вважати пристрої з однаковою назвою одним пристроєм увімкнено Windows час від часу дає пристрою новий ID; його старі й нові файли читаються як один пристрій на підключеному ID. Два однакові пристрої, підключені одночасно, залишаються окремими.
Включити типові (DCS, форма для експертів) увімкнено Кожна стандартна прив'язка, активна в DCS для імпортованого пристрою, теж імпортується, тож імпорт, а за ним експорт «Замінити» + «Очистити й інші» залишає DCS таким, яким він був. Ваші власні прив'язки перемагають стандартну на тому самому вході.
Імпортувати інверсію / повзунок / кривизну / мертву зону / насичення (форма для експертів) вимк. Бере значення, задані в грі, для прив'язок, які JoyPro не експортував сам. Прив'язка, яку експортував JoyPro, отримує своє налаштування назад і без цього.
DCS: ігнорувати літаки *_easy вимк. Спрощені (easy) копії літаків не враховуються.

Експертний імпорт (сторінка «Початок», під картками, і сторінка «Розширені») пропонує всі параметри рушія для кожної гри з кнопками Сканувати (попередній перегляд), Імпорт і Експорт. Кожен вибір запам'ятовується для наступного імпорту.

#Назви, групи й модифікатори повертаються

Файл гри містить лише пристрій, вхід і, можливо, криву. Експорт JoyPro зберігає власні дані поруч із ним, а імпорт читає їх назад:

Гра Дані JoyPro Відновлюється
DCS <aircraft>\joystick\<device>.jp, modifiers.lua назва зв'язку, групи (по порядку), модифікатори з назвами, інверсія, повзунок, мертва зона, насичення, крива
IL-2 Great Battles data\input\jp.actions назва, групи, псевдонім, модифікатори, точне налаштування
Ігри з реєстру (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json назва, групи, псевдонім, модифікатори, налаштування
Star Citizen actionmaps.jp назви

Перемагає поточний стан гри: криву, яку ви змінили в DCS після експорту, буде збережено. Прив'язки, які JoyPro ніколи не експортував, отримують назву з дії гри та групи DCS, IL2 або GENERATED + гра.

#Два запобіжники

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

Імпорт ніколи не записує в теку гри. Що він читає:

  • DCS: прив'язки кожного літака й пристрою, ваші модифікатори, а з «Включити типові» — прив'язки, які DCS має за замовчуванням для кожного пристрою.
  • IL-2 Great Battles / Korea: key mapping і відгуки осей.
  • Star Citizen: прив'язки клавіш гілки (LIVE, PTU ...), разом із прив'язками джойстика гри за замовчуванням на js1.
  • Ігри з піхотою чи технікою (War Thunder, Arma, Reforger, WARDOGS ...): лише льотні дії; усе інше ігнорується, а не видаляється.
  • MSFS: профілі введення симулятора (версія Steam або Microsoft Store) і, на запит, пресети симулятора за замовчуванням.

Пристрої, яких гра не може розрізнити (два пристрої однієї моделі в деяких іграх), і прив'язки до половини осі (Elite) пропускаються й називаються в результаті.

Технічні подробиці

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

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Він викликає AskAboutUnexportedChangesAsync (рушій sync pending), підтверджує «Почати знову» і зберігає копію профілю (BackupProfileBeforeChange("before-import")), а потім викликає імпорт гри: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync або ImportRegistryGameAsync. Спершу переглянути запускає те саме зі scan (PreviewImportWizardAsync) і відкриває панель «Вивід».
  2. Рушій. Для DCS: engine dcs import [--path <Saved Games\DCS>] --merge --include-defaults [--plane <a> --plane <b>] --include-keyboard true|false --ignore-easy-planes false --only-connected false --merge-same-name true. Імпортер читає кожен файл пристрою, зіставляє пристрій за його GUID екземпляра DirectInput і назвою, зіставляє кожен id команди зі списком команд гри (DB\<game> у %LOCALAPPDATA%\JoyPro2\GameData) і будує один зв'язок на кожну функцію та вхід. Виправлення під час завантаження (--load-corrections, --correction-mode) переназначають перейменовані id команд з оцінкою впевненості.
  3. Профіль. Зв'язки об'єднуються за назвою і за однаковим входом; модифікатори створюються з modifiers.lua (DCS) або з налаштувань Shift гри. Профіль зберігається атомарно, і кожне збереження стає версією в <data>\ProfileHistory (скасування працює й після перезапуску).
  4. Спостерігач. Імпорт гри без запису синхронізації записує файли гри, тож зміни, які ви потім зробите в грі, буде помічено (<data>\Sync\<game>.json).

#Файли, які він читає

Гра Файли
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua і modifiers.lua, а також чисті профілі, які JoyPro створив з вашої інсталяції DCS
IL-2 Great Battles / Korea data\input\*.actions і відгуки осей
Star Citizen actionmaps.xml відповідної гілки
MSFS віддалена папка Steam або збереження Microsoft Store

Параметри GUI як параметри рушія: «Додати» — --merge, клавіатура — --include-keyboard true, непідключені пристрої — --only-connected false, однакова назва — --merge-same-name true, спрощені літаки — --ignore-easy-planes true. Запобіжник для ще не експортованих змін — engine sync pending.

Команди рушія: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import і engine <game> import для кожної гри з реєстру (наприклад engine warthunder import, engine msfs2024 import). Правила повторного імпорту: повторний імпорт. Тести: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.