JoyPro2 Discord GitHub
Hlavné postupy

Import hry

Zobraziť:

Import načíta nastavenia ovládania, ktoré hra uložila, a urobí z nich profil JoyPro: jeden vzťah pre každú funkciu s jej tlačidlom alebo osou. Je to najrýchlejší začiatok: všetko, čo ste už nastavili vo svojich hrách, prejde do JoyPro a odvtedy to JoyPro uchováva na jednom mieste.

flowchart LR
  G["Súbory ovládania<br/>vašej hry"] --> I["Importovať"]
  D["Vaše pripojené<br/>zariadenia"] --> I
  I --> P["Váš profil:<br/>vzťahy, väzby,<br/>modifikátory, krivky"]
Import iba číta. Hra si ponechá svoje väzby presne také, aké sú.
Pre začiatočníkov

#Import na tri kliknutia

  1. Otvorte Štart (prvé tlačidlo v dolnej lište). V časti Vaše hry má každá hra, ktorú JoyPro našiel vo vašom PC, kartu so svojím obrázkom. Stlačte Importovať pri hre, ktorú hráte najviac.
  2. JoyPro sa opýta ako:
    • Pridať do môjho profilu (odporúčané) ponechá, čo máte, a pridá väzby hry.
    • Začať odznova z tejto hry nahradí vaše vzťahy tým, čo má hra (JoyPro si najprv uloží kópiu vášho profilu).
    • Prevziať aj klávesy klávesnice prinesie aj letové príkazy na klávesnici. Väzby zariadení sa preberajú vždy.
    • Pre DCS: Všetky moje lietadlá DCS, alebo zrušte začiarknutie a vyberte lietadlá.
  3. Stlačte Importovať teraz. O chvíľu karta ukáže "Hotovo: váš profil má teraz 214 vzťahov (180 priradených)" a Zobraziť moje vzťahy ich otvorí. Najprv sa pozrieť namiesto toho ukáže, čo má hra, bez akejkoľvek zmeny.
Úvod s vašimi hrami a zariadeniamiÚvod s vašimi hrami a zariadeniami
Úvod s vašimi hrami a zariadeniami (Obrázky ukazujú aplikáciu v angličtine.)

Nemáte otvorený profil? JoyPro ho pre vás vytvorí a odvtedy ho ukladá automaticky (tlačidlo Uložiť neexistuje: každá zmena sa uloží a dá sa vrátiť, aj po reštarte).

#Čo sa zmení v hre?

Nič. Import iba číta súbory hry. Hra si ponechá svoje väzby presne také, aké sú, či už neskôr exportujete, alebo nie.

#Importovať a potom nechať JoyPro doplniť medzery

Na Úvode karta "Nastaviť zariadenia" uvádza hry, v ktorých ste si väzby vytvorili sami. Importovať, potom doplniť medzery takúto hru najprv importuje. Potom Teraz doplniť medzery... rozmiestni dôležité funkcie na tlačidlá, ktoré sú ešte voľné. Vaše vlastné väzby zostanú. Pri hrách, ktoré už sú vo vašom profile, karta ponúka Doplniť medzery....

#Pred prvým importom: zoznam príkazov

JoyPro potrebuje poznať príkazy každej hry (ich názvy a identifikátory). Tento zoznam zostaví raz z vašej vlastnej inštalácie. Keď zoznam chýba, Úvod ukáže Zostaviť zoznam (alebo Zostaviť všetky chýbajúce zoznamy); karta hry po aktualizácii hry ponúkne Aktualizovať. Trvá to od niekoľkých sekúnd po niekoľko minút (DCS číta každý modul).

Pokročilé

#Možnosti a čo robia

Možnosť Predvolené Efekt
Pridať do môjho profilu / Začať odznova Pridať Pridať zlúči do otvoreného profilu; Začať odznova nahradí jeho vzťahy po potvrdení a vytvorení kópie profilu.
Prevziať aj klávesy klávesnice vaša posledná voľba Prídu aj letové príkazy priradené klávesom.
Importovať aj zariadenia, ktoré nie sú pripojené zapnuté Importujú sa aj zariadenia, ktoré teraz nie sú pripojené (užitočné pre páku, ktorú pripojíte neskôr). Vypnuté: preskočia sa a započítajú.
Považovať zariadenia s rovnakým názvom za jedno zariadenie zapnuté Windows občas dá zariadeniu nové ID; jeho staré a nové súbory sa načítajú ako jedno zariadenie s pripojeným ID. Dve rovnaké zariadenia pripojené naraz zostanú oddelené.
Zahrnúť predvolené (DCS, expertný formulár) zapnuté Prichádza každá predvolená väzba, ktorú má DCS aktívnu pre importované zariadenie, takže import a po ňom export s Nahradiť + Vymazať aj moje ostatné zariadenia nechá DCS tak, ako bol. Vaše vlastné väzby majú prednosť pred predvolenou na rovnakom vstupe.
Importovať invertovanie / posuvník / zakrivenie / mŕtvu zónu / saturáciu (expertný formulár) vyp. Prevezme hodnoty nastavené v hre pre väzby, ktoré JoyPro sám neexportoval. Väzba, ktorú JoyPro exportoval, dostane svoje ladenie späť aj bez nich.
DCS: ignorovať lietadlá *_easy vyp. Kópie lietadiel v ľahkom režime sa vynechajú.

Expertný import (stránka Úvod, pod kartami, a stránka Pokročilé) ponúka pre každú hru všetky možnosti nástroja so Skenovať (náhľad), Importovať a Export. Každá voľba sa zapamätá pre ďalší import.

#Názvy, skupiny a modifikátory sa vrátia

Súbor hry obsahuje iba zariadenie, vstup a možno krivku. Export JoyPro uchováva vedľa neho vlastné dáta a import ich znova načíta:

Hra Dáta JoyPro Obnovené
DCS <aircraft>\joystick\<device>.jp, modifiers.lua názov vzťahu, skupiny (v poradí), modifikátory s názvami, invertovanie, posuvník, mŕtva zóna, saturácia, krivka
IL-2 Great Battles data\input\jp.actions názov, skupiny, alias, modifikátory, presné ladenie
Hry z registra (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json názov, skupiny, alias, modifikátory, ladenie
Star Citizen actionmaps.jp názvy

Aktuálny stav hry vyhráva: krivka, ktorú ste po exporte zmenili v DCS, sa ponechá. Väzby, ktoré JoyPro nikdy neexportoval, dostanú názov zložený z akcie hry a skupiny DCS, IL2 alebo GENERATED + hra.

#Dve poistky

  • Zmeny, ktoré ešte neboli exportované. Ak ste v JoyPro zmenili väzby a neexportovali ste ich do tejto hry, import by vrátil staré väzby. JoyPro sa najprv opýta.
  • Už importované? Keď profil hru obsahuje, zmeny, ktoré neskôr urobíte v hre, prídu cez sledovanie hier (opýta sa po zatvorení hry); opätovný import zostáva na jedno kliknutie.
V hre: Čo import číta, podľa druhu hry

Import nikdy nezapisuje do priečinka hry. Čo číta:

  • DCS: väzby každého lietadla a zariadenia, vaše modifikátory a so "Zahrnúť predvolené" aj predvolené väzby, ktoré má DCS pre každé zariadenie.
  • IL-2 Great Battles / Korea: Key mapping a odozvy osí.
  • Star Citizen: väzby kláves vetvy (LIVE, PTU ...) s predvolenými väzbami joysticku na js1.
  • Hry s pechotou alebo vozidlami (War Thunder, Arma, Reforger, WARDOGS ...): iba letové akcie; všetko ostatné sa ignoruje, nie maže.
  • MSFS: vstupné profily simulátora (verzia zo Steamu alebo z Microsoft Store) a na požiadanie predvolené predvoľby simulátora.

Zariadenia, ktoré hra nevie rozlíšiť (v niektorých hrách dve zariadenia jedného modelu), a väzby na polovicu osi (Elite) sa vynechajú a uvedú sa vo výsledku.

Technické podrobnosti

#Ako to funguje vnútri

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Opýta sa cez AskAboutUnexportedChangesAsync (nástroj sync pending), potvrdí Začať odznova a uchová kópiu profilu (BackupProfileBeforeChange("before-import")), potom zavolá import hry: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync alebo ImportRegistryGameAsync. Najprv sa pozrieť spustí to isté so scan (PreviewImportWizardAsync) a otvorí panel Výstup.
  2. Nástroj. Pre 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 prečíta každý súbor zariadenia, priradí zariadenie podľa GUID inštancie DirectInput a názvu, priradí každé ID príkazu k zoznamu príkazov hry (DB\<game> v %LOCALAPPDATA%\JoyPro2\GameData) a zostaví jeden vzťah pre každú funkciu a vstup. Opravy pri načítaní (--load-corrections, --correction-mode) premapujú premenované ID príkazov so skóre spoľahlivosti.
  3. Profil. Vzťahy sa zlúčia podľa názvu a podľa rovnakého vstupu; modifikátory sa vytvoria z modifiers.lua (DCS) alebo z nastavení shift v hre. Profil sa ukladá atomicky a každé uloženie je verzia v <data>\ProfileHistory (Späť funguje aj po reštarte).
  4. Sledovanie. Import hry bez záznamu synchronizácie zaznamená súbory hry, takže zmeny, ktoré neskôr urobíte v hre, sa zaznamenajú (<data>\Sync\<game>.json).

#Súbory, ktoré číta

Hra Súbory
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua a modifiers.lua, plus čisté profily, ktoré JoyPro zostavil z vašej inštalácie DCS
IL-2 Great Battles / Korea data\input\*.actions a odozvy osí
Star Citizen actionmaps.xml danej vetvy
MSFS vzdialený priečinok Steam alebo uložené dáta Microsoft Store

Možnosti GUI ako možnosti nástroja: Pridať --merge, klávesnica --include-keyboard true, nepripojené zariadenia --only-connected false, rovnaký názov --merge-same-name true, ľahké lietadlá --ignore-easy-planes true. Poistka pre zmeny, ktoré ešte neboli exportované, je engine sync pending.

Príkazy nástroja: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import a engine <game> import pre každú hru z registra (napríklad engine warthunder import, engine msfs2024 import). Pravidlá opätovného importu: opätovný import. Testy: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.