JoyPro2 Discord GitHub
Hlavní postupy

Import hry

Zobrazit:

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 jen čte. Hra si ponechá svá přiřazení přesně tak, jak jsou.
Pro začátečníky

#Import na tři kliknutí

  1. 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.
  2. 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.
  3. 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.
Stránka Start s vašimi hrami a zařízenímiStránka Start s vašimi hrami a zařízeními
Stránka Start s vašimi hrami a zařízeními (Obrázky ukazují aplikaci v angličtině.)

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).

Pokročilé

#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í.
Ve hře: Co import čte, podle druhu hry

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.

Technické podrobnosti

#Jak to funguje uvnitř

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Zeptá se přes AskAboutUnexportedChangesAsync (engine sync pending), potvrdí Začít znovu a uloží kopii profilu (BackupProfileBeforeChange("before-import")), pak zavolá import hry: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync nebo ImportRegistryGameAsync. Nejprve se podívat spustí totéž se scan (PreviewImportWizardAsync) a otevře panel Výstup.
  2. 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.
  3. 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).
  4. 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.