JoyPro2 Discord GitHub
Основни процеси

Експортиране към вашите игри

Показване:

Експортирането е стъпката, която кара ръчките ви да работят в играта. JoyPro записва вашите връзки и назначения във файловете с настройки на управлението на всяка игра — същите файлове, които записва собственото меню Controls на играта. Докато летите, нищо не работи на заден план: след експортирането играта чете собствените си файлове както винаги.

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.
Kneeboard в DCS Не е експортиране на назначения: страница за всеки самолет, която изброява какво правят бутоните ви, в кабината. Вижте kneeboard.
За напреднали

#Режимите в подробности

„Същият вход“ означава същото устройство, същия бутон или ос и същите модификатори, в същия самолет (или кораб, превозно средство), когато играта пази назначения за всеки самолет. Всеки режим работи само в самолетите на експортирането.

Само добавяне Актуализиране, запазване Актуализиране, профилът печели Замяна
Вашите назначения записват се там, където входът е свободен описани описани описани
Назначение на играта на вход, който използвате за друго действие запазва се; вашето назначение не се записва и се отбелязва премахва се премахва се премахва се
Назначение на играта за същото действие на друг вход (след преместване) запазено запазва се (действието е и на двата входа) премахва се премахва се на записаните устройства
Други назначения на играта на вашите устройства запазено запазено запазено премахват се
Стойности по подразбиране на играта на вашите устройства запазено запазено запазват се, освен ако не носят някое от вашите действия премахват се
Свързани устройства без назначения в профила запазено запазено вашите действия се премахват от тях запазват се, освен при Изчистване и на другите ми устройства
Устройства, които не са свързани, мишка, геймпад никога не се докосват никога не се докосват никога не се докосват никога не се докосват
Клавиатура само с опцията за клавиатура само с опцията за клавиатура само с опцията за клавиатура само с опцията за клавиатура
Самолети, които не са в експортирането никога не се докосват никога не се докосват никога не се докосват никога не се докосват (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: профилът за клавиши „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 показва действията на кораба на вашите joystick-и (js1, js2, ...). При Замяна или Изчистване и на другите собствените назначения по подразбиране на играта за joystick на js1 се изключват, когато js1 е записан или не се използва.
  • War Thunder: Controls показва назначенията за самолети; контролите за танкове и кораби не се променят.
  • 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, повторното импортиране оставя играта каквато беше).