Import čte nastavení ovládání, které hra uložila, a udělá z nich profil JoyPro: jednu relaci pro každou funkci s jejím tlačítkem nebo osou. Je to nejrychlejší start: přijde všechno, co jste už ve svých hrách nastavili, a od té chvíle to JoyPro drží na jednom místě.
flowchart LR G["Soubory ovládání<br/>vaší hry"] --> I["Importovat"] D["Vaše připojená<br/>zařízení"] --> I I --> P["Váš profil:<br/>relace, přiřazení,<br/>modifikátory, křivky"]
#Import na tři kliknutí
- Otevřete Start (první tlačítko v dolní liště). V části Vaše hry má každá hra, kterou JoyPro na vašem PC našel, kartu se svým obrázkem. Stiskněte Importovat u hry, kterou hrajete nejvíc.
- JoyPro se zeptá jak:
- Přidat do mého profilu (doporučeno) ponechá, co máte, a přidá přiřazení hry.
- Začít znovu od této hry nahradí vaše relace tím, co má hra (JoyPro si nejprve uloží kopii vašeho profilu).
- Převzít také klávesy klávesnice přinese i letové příkazy na klávesnici. Přiřazení zařízení se přebírají vždy.
- Pro DCS: Všechny moje letouny DCS, nebo zrušte zaškrtnutí a vyberte letouny.
- Stiskněte Importovat nyní. Za chvíli karta ukáže "Hotovo: váš profil má nyní 214 relací (180 přiřazených)" a Zobrazit moje relace je otevře. Nejprve se podívat místo toho ukáže, co hra má, aniž by cokoli změnil.


Nemáte otevřený profil? JoyPro vám ho vytvoří a od té chvíle ho automaticky ukládá (tlačítko Uložit není: každá změna se uloží a lze ji vrátit, i po restartu).
#Co se ve hře změní?
Nic. Import jen čte soubory hry. Hra si ponechá svá přiřazení přesně tak, jak jsou, ať později exportujete, nebo ne.
#Importovat a pak nechat JoyPro doplnit mezery
Na stránce Start uvádí karta "Nastavit zařízení" hry, ve kterých jste si přiřazení vytvořili sami. Importovat, pak doplnit mezery takovou hru nejprve importuje. Pak Nyní doplnit mezery... rozmístí důležité funkce na tlačítka, která jsou ještě volná. Vaše vlastní přiřazení zůstanou. U her, které už jsou ve vašem profilu, karta nabídne Doplnit mezery....
#Před prvním importem: seznam příkazů
JoyPro potřebuje znát příkazy každé hry (jejich názvy a id). Tento seznam sestaví jednou z vaší vlastní instalace. Když seznam chybí, stránka Start ukáže Sestavit seznam (nebo Sestavit všechny chybějící seznamy); karta hry po aktualizaci hry nabídne Aktualizace. Trvá to od několika sekund po několik minut (DCS čte každý modul).
#Možnosti a co dělají
| Možnost | Výchozí | Efekt |
|---|---|---|
| Přidat do mého profilu / Začít znovu | Přidat | Přidat sloučí do otevřeného profilu; Začít znovu po potvrzení a vytvoření kopie profilu nahradí jeho relace. |
| Převzít také klávesy klávesnice | vaše poslední volba | Přijdou i letové příkazy přiřazené klávesám. |
| Importovat i zařízení, která nejsou připojena | zapnuto | Importují se i zařízení, která teď nejsou připojená (užitečné pro ovladač, který připojíte později). Vypnuto: přeskočí se a započítají. |
| Považovat zařízení se stejným názvem za jedno zařízení | zapnuto | Windows občas dá zařízení nové ID; jeho staré a nové soubory se čtou jako jedno zařízení na připojeném ID. Dvě stejná zařízení připojená současně zůstanou oddělená. |
| Zahrnout výchozí (DCS, forma pro experty) | zapnuto | Přijde každé výchozí přiřazení, které má DCS aktivní pro importované zařízení, takže import následovaný exportem Nahradit + Vymazat i má ostatní zařízení nechá DCS tak, jak byl. Vaše vlastní přiřazení vyhrají nad výchozím na stejném vstupu. |
| Importovat invertování / posuvník / zakřivení / mrtvou zónu / saturaci (forma pro experty) | vyp. | Převezme hodnoty nastavené ve hře u přiřazení, která JoyPro sám neexportoval. Přiřazení, které JoyPro exportoval, dostane své ladění zpět i bez nich. |
| DCS: ignorovat letouny *_easy | vyp. | Kopie letounů pro snadný režim (easy mode) se vynechají. |
Import pro experty (stránka Start pod kartami a stránka Pokročilé) nabízí pro každou hru všechny možnosti enginu s Prohledat (náhled), Importovat a Export. Každá volba se zapamatuje pro příští import.
#Názvy, skupiny a modifikátory se vrátí
Soubor hry obsahuje jen zařízení, vstup a případně křivku. Export JoyPro uchová vedle něj svá vlastní data a import je načte zpět:
| Hra | Data JoyPro | Obnoví se |
|---|---|---|
| DCS | <aircraft>\joystick\<device>.jp, modifiers.lua |
název relace, skupiny (v pořadí), modifikátory s názvy, invertování, posuvník, mrtvá zóna, saturace, křivka |
| IL-2 Great Battles | data\input\jp.actions |
název, skupiny, alias, modifikátory, přesné ladění |
| Hry z registru (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) | <config>.joypro-meta.json |
název, skupiny, alias, modifikátory, ladění |
| Star Citizen | actionmaps.jp |
názvy |
Aktuální stav hry vyhrává: křivka, kterou jste po exportu změnili v DCS, se ponechá. Přiřazení, která JoyPro nikdy neexportoval, dostanou název sestavený z akce hry a skupiny DCS, IL2 nebo GENERATED + hra.
#Dvě pojistky
- Změny, které ještě nejsou exportované. Pokud jste změnili přiřazení v JoyPro a neexportovali je do této hry, import by vrátil stará přiřazení. JoyPro se nejdřív zeptá.
- Už importováno? Když profil hru obsahuje, změny, které později uděláte ve hře, přijdou přes sledování her (zeptá se po zavření hry); opětovný import zůstává na jedno kliknutí.
Import nikdy nezapisuje do složky hry. Co čte:
- DCS: přiřazení každého letounu a zařízení, vaše modifikátory a s "Zahrnout výchozí" i výchozí přiřazení, která DCS má pro každé zařízení.
- IL-2 Great Battles / Korea: key mapping a odezvy os.
- Star Citizen: keybindings větve (LIVE, PTU ...), s výchozími přiřazeními joysticku hry na js1.
- Hry s pěchotou nebo vozidly (War Thunder, Arma, Reforger, WARDOGS ...): jen letové akce; vše ostatní se ignoruje, nemaže.
- MSFS: vstupní profily simulátoru (Steam nebo verze z Microsoft Store) a na požádání i výchozí předvolby simulátoru.
Zařízení, která hra nedokáže rozlišit (v některých hrách dvě zařízení stejného modelu), a přiřazení polovin os (Elite) se přeskočí a ve výsledku se uvedou.
#Jak to funguje uvnitř
- GUI.
StartImportWizard→RunImportWizardAsync(MainWindowViewModel.GameHub.cs). Zeptá se přesAskAboutUnexportedChangesAsync(enginesync pending), potvrdí Začít znovu a uloží kopii profilu (BackupProfileBeforeChange("before-import")), pak zavolá import hry:ImportDcsAsync,ImportIl2Async,ImportStarCitizenAsyncneboImportRegistryGameAsync. Nejprve se podívat spustí totéž sescan(PreviewImportWizardAsync) a otevře panel Výstup. - Engine. Pro 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. Importér načte každý soubor zařízení, přiřadí zařízení podle jeho instančního GUID DirectInput a názvu, přiřadí každé ID příkazu k seznamu příkazů hry (DB\<game>v%LOCALAPPDATA%\JoyPro2\GameData) a sestaví jednu relaci pro každou funkci a vstup. Opravy při načítání (--load-corrections,--correction-mode) přemapují přejmenovaná ID příkazů se skóre jistoty. - Profil. Relace se slučují podle názvu a podle stejného vstupu; modifikátory se vytvoří z
modifiers.lua(DCS) nebo z nastavení shift ve hře. Profil se ukládá atomicky a každé uložení je verze v<data>\ProfileHistory(Zpět funguje i po restartu). - Sledování. Import hry bez záznamu synchronizace zaznamená soubory hry, takže se změny, které později uděláte ve hře, zaznamenají (
<data>\Sync\<game>.json).
#Soubory, které čte
| Hra | Soubory |
|---|---|
| DCS | Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua a modifiers.lua plus čisté profily, které JoyPro sestavil z vaší instalace DCS |
| IL-2 Great Battles / Korea | data\input\*.actions a odezvy os |
| Star Citizen | actionmaps.xml dané větve |
| MSFS | vzdálená složka Steam nebo uložená data z Microsoft Store |
Možnosti GUI jako možnosti enginu: Přidat --merge, klávesnice --include-keyboard true, nepřipojená zařízení --only-connected false, stejný název --merge-same-name true, letouny pro snadný režim --ignore-easy-planes true. Pojistka pro změny, které ještě nejsou exportované, je engine sync pending.
Příkazy enginu: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import a engine <game> import pro každou hru z registru (například engine warthunder import, engine msfs2024 import). Pravidla opětovného importu: opětovný import. Testy: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.
#Související
- Stránka Start, každý ovládací prvek na ní
- První spuštění: které hry JoyPro najde
- Vytvořit relace: co dělat po importu
- Sledování her