Импортирането чете настройките на управлението, които играта е запазила, и ги превръща в профил на JoyPro: по една връзка за всяка функция с нейния бутон или ос. Това е най-бързото начало: всичко, което вече сте настроили в игрите си, влиза, и оттам нататък JoyPro го пази на едно място.
flowchart LR G["Файловете с контроли<br/>на играта ви"] --> I["Импортиране"] D["Свързаните ви<br/>устройства"] --> I I --> P["Вашият профил:<br/>връзки, назначения,<br/>модификатори, криви"]
#Импортиране с три щраквания
- Отворете Начало (първият бутон в долната лента). Под Вашите игри всяка игра, която JoyPro е намерил на компютъра ви, има карта със своята снимка. Натиснете Импортиране на играта, която играете най-много.
- JoyPro пита как:
- Добавяне към моя профил (препоръчително) запазва това, което имате, и добавя назначенията на играта.
- Започване отначало от тази игра заменя връзките ви с това, което има играта (JoyPro първо пази копие на профила ви).
- Вземи и клавишите на клавиатурата взема и командите за полет на клавиатурата. Назначенията на устройства винаги се вземат.
- За DCS: Всички мои самолети в DCS или махнете отметката и изберете самолети.
- Натиснете Импортиране сега. Миг по-късно картата казва „Готово: профилът ви вече има 214 връзки (180 назначени)“, а Виж моите връзки ги отваря. Първо поглед вместо това показва какво има играта, без да променя нищо.


Няма отворен профил? JoyPro създава един за вас и оттам нататък го запазва автоматично (няма бутон за запазване: всяка промяна се запазва и може да се отмени, и след рестартиране).
#Какво се променя в играта?
Нищо. Импортирането само чете файловете на играта. Играта запазва назначенията си точно както са, независимо дали ще експортирате по-късно или не.
#Импортиране, после JoyPro запълва празнините
На страницата Начало картата „Настройте устройствата си“ изброява игри, в които сами сте направили назначения. Импортиране, после запълване на празнините първо импортира такава игра. После Запълване на празнините сега... поставя важните функции на бутоните, които още са свободни. Вашите собствени назначения остават. За игри, които вече са в профила ви, картата предлага Запълване на празнините....
#Преди първото импортиране: списъкът с команди
JoyPro трябва да знае командите на всяка игра (техните имена и ID). Той изгражда този списък веднъж от вашата собствена инсталация. Когато списъкът липсва, страницата Начало показва Изграждане на списъка (или Изграждане на всички липсващи списъци); картата на игра предлага Актуализиране след актуализация на играта. Това отнема от няколко секунди до няколко минути (DCS чете всеки модул).
#Опции и какво правят
| Опция | По подразбиране | Ефект |
|---|---|---|
| Добавяне към моя профил / Отначало | Добави | Добавяне слива в отворения профил; Отначало заменя връзките му след потвърждение и копие на профила. |
| Вземи и клавишите на клавиатурата | последният ви избор | Влизат и полетните команди, назначени на клавиши. |
| Импортиране и на устройства, които не са свързани | включено | Импортират се и устройствата, които сега не са включени (полезно за ръчка, която свързвате по-късно). Изключено: те се пропускат и се преброяват. |
| Устройства с едно и също име да се третират като едно устройство | включено | Windows от време на време дава на устройството нов ИД; старите и новите му файлове се четат като едно устройство на свързания ИД. Две еднакви устройства, включени едновременно, остават отделни. |
| Включване на подразбиращите се (DCS, форма за експерти) | включено | Влиза всяко назначение по подразбиране, което DCS има активно за импортирано устройство, така че импортиране, последвано от експортиране със Замяна + Изчистване и на другите, оставя DCS какъвто беше. Вашите собствени назначения надделяват над стойност по подразбиране на същия вход. |
| Импортиране на обръщане / плъзгач / кривина / мъртва зона / насищане (форма за експерти) | изкл. | Взема стойностите, зададени в играта, за назначения, които JoyPro не е експортирал сам. Назначение, експортирано от JoyPro, получава обратно настройката си и без тях. |
| DCS: игнориране на самолети *_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: разпределението на клавишите и реакциите на осите.
- Star Citizen: назначенията на клавишите от клона (LIVE, PTU ...), с назначенията по подразбиране на играта за joystick на js1.
- Игри с пехота или превозни средства (War Thunder, Arma, Reforger, WARDOGS ...): само действията за полет; всичко друго се пренебрегва, не се изтрива.
- MSFS: входните профили на симулатора (версията от Steam или от Microsoft Store) и при поискване предварителните настройки по подразбиране на симулатора.
Устройства, които играта не може да различи (две устройства от един модел в някои игри), и назначения на половин ос (Elite) се пропускат и се посочват в резултата.
#Как работи отвътре
- GUI.
StartImportWizard→RunImportWizardAsync(MainWindowViewModel.GameHub.cs). ПитаAskAboutUnexportedChangesAsync(ядроsync pending), потвърждава Отначало и пази копие на профила (BackupProfileBeforeChange("before-import")), после извиква импортирането на играта:ImportDcsAsync,ImportIl2Async,ImportStarCitizenAsyncилиImportRegistryGameAsync. Първо поглед изпълнява същото съсscan(PreviewImportWizardAsync) и отваря панела Изход. - Ядро. За 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 и по името, съпоставя всеки идентификатор на команда със списъка с команди на играта (DB\<game>в%LOCALAPPDATA%\JoyPro2\GameData) и изгражда по една връзка за всяка функция и вход. Корекциите при зареждане (--load-corrections,--correction-mode) пренасочват преименувани идентификатори на команди с оценка на достоверността. - Профил. Връзките се сливат по име и по еднакъв вход; модификаторите се създават от
modifiers.lua(DCS) или от настройките за shift на играта. Профилът се записва атомарно и всеки запис е версия в<data>\ProfileHistory(отмяната работи и след рестартиране). - Наблюдател. Импортиране на игра без запис за синхронизация записва файловете на играта, така че промените, които правите в играта по-късно, се забелязват (
<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.
#Свързани
- Страницата Начало, всеки контрол на нея
- Първо стартиране: кои игри намира JoyPro
- Създаване на връзки: какво да правите след импортирането
- Следенето на игрите