JoyPro2 Discord GitHub
Główne procesy

Import gry

Pokaż:

Import odczytuje ustawienia sterowania, które zapisała gra, i zamienia je w profil JoyPro: jedna relacja na funkcję, z jej przyciskiem lub osią. To najszybszy start: wszystko, co już ustawiłeś w swoich grach, trafia do profilu, a od tej chwili JoyPro trzyma to w jednym miejscu.

flowchart LR
  G["Pliki sterowania<br/>Twojej gry"] --> I["Importuj"]
  D["Twoje podłączone<br/>urządzenia"] --> I
  I --> P["Twój profil:<br/>relacje, przypisania,<br/>modyfikatory, krzywe"]
Import tylko odczytuje. Gra zachowuje swoje przypisania dokładnie takie, jakie są.
Dla początkujących

#Import w trzech kliknięciach

  1. Otwórz Start (pierwszy przycisk na dolnym pasku). W Twoje gry każda gra, którą JoyPro znalazł na Twoim komputerze, ma kartę ze swoim obrazem. Naciśnij Importuj przy grze, w którą grasz najczęściej.
  2. JoyPro pyta, jak:
    • Dodaj do mojego profilu (zalecane) zachowuje to, co masz, i dodaje przypisania gry.
    • Zacznij od nowa z tej gry zastępuje Twoje relacje tym, co ma gra (JoyPro najpierw robi kopię Twojego profilu).
    • Uwzględnij także klawisze klawiatury przynosi też polecenia lotu na klawiaturze. Przypisania urządzeń są zawsze uwzględniane.
    • Dla DCS: Wszystkie moje maszyny DCS albo odznacz to i wybierz maszyny.
  3. Naciśnij Importuj teraz. Chwilę później karta mówi „Gotowe: Twój profil ma teraz 214 relacji (180 przypisanych)”, a Pokaż moje relacje je otwiera. Najpierw zobacz pokazuje zamiast tego, co ma gra, niczego nie zmieniając.
Strona Start z Twoimi grami i urządzeniamiStrona Start z Twoimi grami i urządzeniami
Strona Start z Twoimi grami i urządzeniami (Obrazy pokazują aplikację po angielsku.)

Nie masz otwartego profilu? JoyPro zrobi go za Ciebie i od tej chwili będzie go zapisywał automatycznie (nie ma przycisku Zapisz: każda zmiana jest zapisywana i można ją cofnąć, także po restarcie).

#Co zmienia się w grze?

Nic. Import tylko odczytuje pliki gry. Gra zachowuje swoje przypisania dokładnie takie, jakie są, niezależnie od tego, czy później eksportujesz.

#Importuj, a potem pozwól JoyPro wypełnić luki

Na stronie Start karta „Skonfiguruj urządzenia” wymienia gry, w których sam zrobiłeś przypisania. Importuj, potem wypełnij luki najpierw importuje taką grę. Potem Wypełnij teraz luki... umieszcza ważne funkcje na przyciskach, które są jeszcze wolne. Twoje własne przypisania zostają. Dla gier, które już są w Twoim profilu, karta proponuje Wypełnij luki....

#Przed pierwszym importem: lista poleceń

JoyPro musi znać polecenia każdej gry (ich nazwy i identyfikatory). Buduje tę listę raz z Twojej własnej instalacji. Gdy listy brakuje, strona Start pokazuje Zbuduj listę (albo Zbuduj wszystkie brakujące listy); karta gry proponuje Aktualizuj po aktualizacji gry. Trwa to od kilku sekund do kilku minut (DCS odczytuje każdy moduł).

Zaawansowane

#Opcje i co robią

Opcja Domyślne Efekt
Dodaj do mojego profilu / Zacznij od nowa Dodaj Dodaj scala z otwartym profilem; Zacznij od nowa zastępuje jego relacje po potwierdzeniu i zrobieniu kopii profilu.
Uwzględnij także klawisze klawiatury Twój ostatni wybór Polecenia lotu przypisane do klawiszy też są importowane.
Importuj także urządzenia, które nie są podłączone włączone Urządzenia, które nie są teraz podłączone, też są importowane (przydatne dla drążka, który podłączysz później). Wyłączone: są pomijane i liczone.
Traktuj urządzenia o tej samej nazwie jako jedno urządzenie włączone Windows od czasu do czasu daje urządzeniu nowe ID; jego stare i nowe pliki są czytane jako jedno urządzenie pod podłączonym ID. Dwa identyczne urządzenia podłączone jednocześnie pozostają rozdzielone.
Uwzględnij domyślne (DCS, forma dla ekspertów) włączone Każde domyślne przypisanie, które DCS ma aktywne dla importowanego urządzenia, jest importowane, więc import, po którym następuje eksport Zastąp + Wyczyść też, zostawia DCS takim, jaki był. Twoje własne przypisania wygrywają z domyślnym na tym samym wejściu.
Importuj odwrócenie / suwak / krzywiznę / martwą strefę / nasycenie (forma dla ekspertów) wył. Bierze wartości ustawione w grze dla przypisań, których JoyPro sam nie wyeksportował. Przypisanie wyeksportowane przez JoyPro odzyskuje swoje strojenie bez tych opcji.
DCS: pomiń maszyny *_easy wył. Kopie maszyn w trybie łatwym są pomijane.

Import zaawansowany (strona Start, pod kartami, oraz strona Zaawansowane) oferuje każdą opcję silnika dla każdej gry ze Skanuj (podgląd), Importuj i Eksportuj. Każdy wybór zostaje zapamiętany na następny import.

#Nazwy, grupy i modyfikatory wracają

Plik gry zawiera tylko urządzenie, wejście i może krzywą. Eksport JoyPro trzyma obok własne dane, a import odczytuje je z powrotem:

Gra Dane JoyPro Przywracane
DCS <aircraft>\joystick\<device>.jp, modifiers.lua nazwa relacji, grupy (w kolejności), modyfikatory z nazwami, odwrócenie, suwak, martwa strefa, nasycenie, krzywa
IL-2 Great Battles data\input\jp.actions nazwa, grupy, alias, modyfikatory, dokładne strojenie
Gry z rejestru (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json nazwa, grupy, alias, modyfikatory, strojenie
Star Citizen actionmaps.jp nazwy

Wygrywa bieżący stan gry: krzywa zmieniona przez Ciebie w DCS po eksporcie zostaje zachowana. Przypisania, których JoyPro nigdy nie eksportował, dostają nazwę zbudowaną z akcji gry oraz grupy DCS, IL2 albo GENERATED + gra.

#Dwa zabezpieczenia

  • Zmiany jeszcze niewyeksportowane. Jeśli zmieniłeś przypisania w JoyPro i nie wyeksportowałeś ich do tej gry, import przywróciłby stare przypisania. JoyPro najpierw pyta.
  • Już zaimportowano? Gdy profil ma już tę grę, zmiany, które później zrobisz w grze, przychodzą przez obserwatora gier (pyta po zamknięciu gry); ponowny import to nadal jedno kliknięcie.
W grze: Co odczytuje import, według rodzaju gry

Import nigdy nie zapisuje w folderze gry. Co odczytuje:

  • DCS: przypisania każdej maszyny i urządzenia, Twoje modyfikatory, a z „Uwzględnij domyślne” domyślne przypisania, które DCS ma dla każdego urządzenia.
  • IL-2 Great Battles / Korea: key mapping i odpowiedzi osi.
  • Star Citizen: przypisania klawiszy gałęzi (LIVE, PTU ...), z domyślnymi ustawieniami joysticka gry na js1.
  • Gry z piechotą lub pojazdami (War Thunder, Arma, Reforger, WARDOGS ...): tylko akcje lotu; wszystko inne jest pomijane, nie usuwane.
  • MSFS: profile wejść symulatora (wersja Steam lub Microsoft Store) oraz, na życzenie, domyślne presety symulatora.

Urządzenia, których gra nie potrafi rozróżnić (w niektórych grach dwa urządzenia jednego modelu), i przypisania połówki osi (Elite) są pomijane i wymienione w wyniku.

Szczegóły techniczne

#Jak to działa w środku

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Pyta AskAboutUnexportedChangesAsync (silnik sync pending), potwierdza Zacznij od nowa i zachowuje kopię profilu (BackupProfileBeforeChange("before-import")), potem wywołuje import gry: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync albo ImportRegistryGameAsync. Najpierw zobacz uruchamia to samo ze scan (PreviewImportWizardAsync) i otwiera panel Wyjście.
  2. Silnik. Dla 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. Importer czyta każdy plik urządzenia, dopasowuje urządzenie po GUID instancji DirectInput i nazwie, dopasowuje każde ID polecenia do listy poleceń gry (DB\<game> w %LOCALAPPDATA%\JoyPro2\GameData) i buduje jedną relację na funkcję i wejście. Poprawki przy wczytywaniu (--load-corrections, --correction-mode) przemapowują ID poleceń o zmienionych nazwach z oceną pewności.
  3. Profil. Relacje są scalane po nazwie i po tym samym wejściu; modyfikatory powstają z modifiers.lua (DCS) albo z ustawień shift gry. Profil jest zapisywany atomowo, a każdy zapis to wersja w <data>\ProfileHistory (Cofnij działa także po ponownym uruchomieniu).
  4. Obserwator. Import gry bez zapisu synchronizacji zapisuje stan plików gry, więc zmiany, które później zrobisz w grze, zostaną zauważone (<data>\Sync\<game>.json).

#Pliki, które czyta

Gra Pliki
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua i modifiers.lua, plus czyste profile zbudowane przez JoyPro z Twojej instalacji DCS
IL-2 Great Battles / Korea data\input\*.actions i odpowiedzi osi
Star Citizen actionmaps.xml danej gałęzi
MSFS zdalny folder Steam albo zapis Microsoft Store

Opcje GUI jako opcje silnika: Dodaj --merge, klawiatura --include-keyboard true, niepodłączone urządzenia --only-connected false, ta sama nazwa --merge-same-name true, maszyny w trybie łatwym --ignore-easy-planes true. Zabezpieczenie przed jeszcze niewyeksportowanymi zmianami to engine sync pending.

Polecenia silnika: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import oraz engine <game> import dla każdej gry z rejestru (na przykład engine warthunder import, engine msfs2024 import). Zasady ponownego importu: ponowny import. Testy: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.