FSX, FSX: Steam Edition oraz Prepar3D v4, v5 i v6 trzymają Twoje sterowanie w jednym pliku XML w %APPDATA%: jedna mapa na urządzenie z jego osiami, przyciskami i hatem, plus klawiatura. JoyPro wczytuje ten plik do Twojego profilu, łączy go z Twoimi innymi grami w relacjach i zapisuje z powrotem blok po bloku, zostawiając formatowanie, komentarze i inne mapy bez zmian. Każdy symulator jest w JoyPro osobną grą, bo każdy ma własny plik.
Ta integracja została napisana na podstawie publicznych źródeł i jest objęta tylko syntetycznym plikiem testowym: żaden z tych symulatorów nie był jeszcze testowany z JoyPro na prawdziwej instalacji. Po pierwszym eksporcie otwórz sterowanie symulatora, sprawdź przypisania i zgłoś, co się różni.
Microsoft Flight Simulator X natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine fsx- Plik przypisań
%APPDATA%\Microsoft\FSX\Controls\Standard.XML(XML)- Wejścia, które gra czyta
- odczytuje 32 przyciski, 8 osi na joystick (zgłoszone)
- Lista poleceń z
- własna lista zdarzeń JoyPro (publiczne identyfikatory SDK) + zdarzenia z Twoich plików sterowania i szablonu z instalacji
- ✓ Importuj
- ✓ Eksportuj
- ✓ Przypisania klawiatury
- ◐ ModyfikatoryFSX i Prepar3D: Ctrl/Shift/Alt na klawiszach; bez modyfikatora na przypisaniach joysticka.
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✓ Krzywe osi i martwe strefy
- ✗ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ◐ Kreator konfiguracji / Autoprzypisanie
- ✓ Kokpity
- ✓ Ściągi
- ✗ Test w grze
Microsoft Flight Simulator X: Steam Edition natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine fsxse- Plik przypisań
%APPDATA%\Microsoft\FSX-SE\Controls\(lub folder FSX), XML- Wejścia, które gra czyta
- odczytuje 32 przyciski, 8 osi na joystick (zgłoszone)
- Lista poleceń z
- jak FSX
- ✓ Importuj
- ✓ Eksportuj
- ✓ Przypisania klawiatury
- ◐ ModyfikatoryFSX i Prepar3D: Ctrl/Shift/Alt na klawiszach; bez modyfikatora na przypisaniach joysticka.
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✓ Krzywe osi i martwe strefy
- ✗ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ◐ Kreator konfiguracji / Autoprzypisanie
- ✗ Kokpity
- ✓ Ściągi
- ✗ Test w grze
Prepar3D v4 natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine p3d4- Plik przypisań
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml(XML)- Wejścia, które gra czyta
- odczytuje 32 przyciski, 8 osi na joystick (zgłoszone)
- Lista poleceń z
- własna lista zdarzeń JoyPro + Twoje pliki sterowania +
Standard.xmlxz instalacji
- ✓ Importuj
- ✓ Eksportuj
- ✓ Przypisania klawiatury
- ◐ ModyfikatoryFSX i Prepar3D: Ctrl/Shift/Alt na klawiszach; bez modyfikatora na przypisaniach joysticka.
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✓ Krzywe osi i martwe strefy
- ✗ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ◐ Kreator konfiguracji / Autoprzypisanie
- ✗ Kokpity
- ✓ Ściągi
- ✗ Test w grze
Prepar3D v5 natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine p3d5- Plik przypisań
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml(XML)- Wejścia, które gra czyta
- odczytuje 32 przyciski, 8 osi na joystick (zgłoszone)
- Lista poleceń z
- jak Prepar3D v4
- ✓ Importuj
- ✓ Eksportuj
- ✓ Przypisania klawiatury
- ◐ ModyfikatoryFSX i Prepar3D: Ctrl/Shift/Alt na klawiszach; bez modyfikatora na przypisaniach joysticka.
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✓ Krzywe osi i martwe strefy
- ✗ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ◐ Kreator konfiguracji / Autoprzypisanie
- ✓ Kokpity
- ✓ Ściągi
- ✗ Test w grze
Prepar3D v6 natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine p3d6- Plik przypisań
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml(XML)- Wejścia, które gra czyta
- odczytuje 32 przyciski, 8 osi na joystick (zgłoszone)
- Lista poleceń z
- jak Prepar3D v4
- ✓ Importuj
- ✓ Eksportuj
- ✓ Przypisania klawiatury
- ◐ ModyfikatoryFSX i Prepar3D: Ctrl/Shift/Alt na klawiszach; bez modyfikatora na przypisaniach joysticka.
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✓ Krzywe osi i martwe strefy
- ✗ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ◐ Kreator konfiguracji / Autoprzypisanie
- ✗ Kokpity
- ✓ Ściągi
- ✗ Test w grze
Z macierzy obsługi, wygenerowanej z kodu silnika: wszystkie gry.
#Uruchom to w 3 krokach
- Ustaw wszystko za mnie
na stronie Start - Użyj tych przycisków
najpierw obejrzyj listę - Zapisz w mojej grze
symulator musi być zamknięty
Przed: uruchom symulator raz z podłączonymi urządzeniami, potem go zamknij.
Potem: otwórz ustawienia sterowania symulatora i sprawdź przypisania. Ta integracja nie była jeszcze testowana na prawdziwej instalacji: zgłoś, co się różni.
Przypisywałeś już przyciski w symulatorze? Wtedy strona Start zaproponuje Importuj, potem wypełnij luki. Twoje przypisania zostają, a nowe zadania dostają tylko wolne przyciski. Zobacz Szybki start: niech mój drążek działa.
#Co JoyPro robi dla FSX i Prepar3D
- Importuj: osie, przyciski i haty Twoich urządzeń trafiają do Twojego profilu, razem z czułością i strefą zerową każdej osi. Klawisze klawiatury przychodzą, gdy o nie poprosisz.
- Relacje: jedna relacja to jedna funkcja we wszystkich Twoich grach („Gear” w FSX, MSFS i X-Plane na tym samym przycisku). Polecenia to publiczne nazwy zdarzeń symulatorów (
GEAR_TOGGLE,AXIS_AILERONS_SET...). - Eksportuj: JoyPro zapisuje aktywny plik sterowania symulatora, do którego eksportujesz.
#Zaimportuj swoje przypisania
- Otwórz Start. Karta Twojego symulatora pokazuje jego obraz. Jeśli prosi o listę poleceń, naciśnij Zbuduj listę: JoyPro połączy własną listę zdarzeń ze zdarzeniami, które wymieniają Twoje pliki sterowania (i własne pliki szablonów symulatora).
- Naciśnij Importuj na karcie. Wybierz Dodaj do mojego profilu i zaznacz Uwzględnij także klawisze klawiatury, jeśli chcesz mieć też swoje klawisze.
- Naciśnij Importuj teraz. Pokaż moje relacje otwiera to, co przyszło.
#Buduj i sprawdzaj relacje
Na stronie Relacje zdarzenie symulatora danej relacji stoi obok tej samej funkcji w Twoich innych grach. Połącz je za pomocą przebiegu relacji, potem naciśnij Sprawdź teraz na stronie Eksport (sprawdzanie).
#Eksportuj
- Zamknij symulator. Zapisuje on plik na nowo przy wyjściu; JoyPro odmawia, dopóki działa
fsx.exelubPrepar3D.exe. - Otwórz Eksportuj i użyj karty swojego symulatora.
- Zostaw Zastąp na moich urządzeniach razem z Wyczyść też moje inne urządzenia, jeśli to w JoyPro konfigurujesz swoje urządzenia. Naciśnij Eksportuj teraz na karcie.
Uruchom symulator i otwórz jego ustawienia sterowania: widać tam przypisania Twoich urządzeń, a czułość i strefę zerową każdej osi na jej stronie kalibracji. Dokładna ścieżka w menu i to, jak symulatory pokazują plik JoyPro, nie są jeszcze potwierdzone.
#Co robisz sam w FSX i Prepar3D
- Uruchom symulator raz z podłączonymi urządzeniami, żeby zapisał swój plik sterowania.
- Sprawdź wynik po pierwszym eksporcie (patrz wyżej). To pierwszy prawdziwy test tej integracji na Twoim PC.
- Hat jest przypisywany w całości i zwykle służy do przesuwania widoku (
PAN_VIEW). Inne zdarzenia na pojedynczych kierunkach hata nie są zapisywane; przypisz je w symulatorze.
#Częste pułapki
- „Symulator działa”: zamknij go i wyeksportuj ponownie.
- Urządzenie straciło przypisania po ponownym podłączeniu: Windows może nadać urządzeniu nowy GUID. JoyPro znajdzie wtedy jego mapę po nazwie, jeśli ma ją dokładnie jedno podłączone urządzenie (z ostrzeżeniem).
- Brakuje przypisania joysticka z modyfikatorem: format nie ma modyfikatorów na przyciskach joysticka. Klawisze mogą mieć Ctrl, Shift i Alt.
#Pliki, które JoyPro czyta i zapisuje
| Symulator | Plik sterowania |
|---|---|
| FSX (wersja pudełkowa) | %APPDATA%\Microsoft\FSX\Controls\Standard.XML (aktywny plik z fsx.cfg [CONTROLS] Controls_Current) |
| FSX: Steam Edition | %APPDATA%\Microsoft\FSX-SE\Controls\ obok pudełkowego FSX, %APPDATA%\Microsoft\FSX\Controls\ przy samodzielnej instalacji |
| Prepar3D v4 / v5 / v6 | %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (aktywny plik z Prepar3D.cfg [CONTROLS]) |
| wszystkie | <file>.joypro.json (wejścia zapisane przez JoyPro), <file>.joypro-meta.json (nazwy, grupy i strojenie dla następnego importu) |
Standard.xmlx z Prepar3D (presety urządzeń) i szablon FSX w folderze instalacji są odczytywane na potrzeby listy poleceń i nigdy nie są zapisywane.
#Tryby eksportu w FSX i Prepar3D
| Tryb | Co dzieje się w symulatorze |
|---|---|
| Tylko dodaj | Nigdy nie usuwa ani nie zastępuje bloku. Przypisanie na wejściu, które ma inne zdarzenie, nie jest zapisywane i jest wymieniane. |
| Aktualizuj, zachowaj przypisania gry | Zastępuje zdarzenie na Twoim wejściu (konflikt) i zachowuje wszystko inne. |
| Aktualizuj, wygrywa mój profil | Usuwa też inne wejścia zdarzeń, które przypisujesz (podłączone urządzenia; klawiaturę tylko przy opcji klawiatury). |
| Zastąp na moich urządzeniach | Główne mapy urządzeń, które zapisujesz, zachowują tylko Twoje przypisania. |
| + Wyczyść też moje inne urządzenia | Główne mapy innych podłączonych urządzeń są opróżniane (same mapy zostają). |
#Co nigdy nie jest ruszane
- Mapy urządzeń, które nie są podłączone, urządzenia ignorowane przy imporcie i urządzenie vJoy, do którego JoyPro przekazuje wejścia.
- Mapy slew (
... SLEW {GUID}),Mouse Yoke,Mouse Look, mapy Prepar3D dla poszczególnych SimObject oraz mapa klawiatury, chyba że eksportujesz przypisania klawiatury. - Akordy klawiszy z dwóch zwykłych klawiszy, komentarze, formatowanie i nieznane elementy.
#Krzywe i ustawienia
- Szczegółowość: globalnie, jeden plik dla wszystkich maszyn.
- Ustawienia osi (model osi
fsx): czułość (od 0 do 127) i strefa zerowa (od 0 do 127) dla każdej osi urządzenia, jak na stronie kalibracji. Krzywa domyślna jest dopasowywana (martwa strefa do strefy zerowej, nasycenie do czułości); kształt krzywej nie ma odpowiednika. W trybie Aktualizuj wartości ustawione w symulatorze zostają, gdy wartości JoyPro są zwykłymi domyślnymi. - Odwróć: ujemna czułość.
- Bez force feedback, ustawień gry i telemetrii. Obserwator zauważa zmiany po zamknięciu symulatora.
#Wnętrze integracji FSX i Prepar3D
flowchart LR
P["Twój profil<br/>(relacje + przypisania)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
E --> X["Controls / Standard.XML:<br/>mapa na każde urządzenie<br/>(nazwa urządzenia {GUID}),<br/>KEYBOARD_MAIN (tylko z<br/>opcją klawiatury)"]
X --> G["Ustawienia sterowania symulatora"]
Kod: engine\Games\FsxIntegration.cs (jedna klasa, jedna gra na symulator), engine\Games\FsxControlsFile.cs (edycja tekstu całych bloków), engine\Games\FsxEvents.cs (lista zdarzeń JoyPro).
- Format:
<SimControls.Map>z<Name>,<Axis>(<Index>od 0 do 7 = X, Y, Z, Rx, Ry, Rz, Slider, drugi suwak;<AxEvent>,<AxScale>,<AxNull>),<Entry>(<Index>przycisku liczony od 0,<Down>/<Up>,<DownRpt>1dla powtarzanych zdarzeń) i<POV>(cały hat). Nagłówekencoding="Windows-1252". - Urządzenia: jedna mapa na urządzenie DirectInput o nazwie
<instance name>{<instance GUID>}; dopasowywana po GUID, a w przeciwnym razie po nazwie, gdy ma ją dokładnie jedno podłączone urządzenie. Urządzenie, którego plik nie ma, dostaje nową mapę. Zgłaszane są 32 przyciski i 8 osi na urządzenie. - Mapowanie:
JOY_X..JOY_SLIDER2na<Index>od 0 do 7,JOY_BTN<n>na<Index>n-1, hat na jego kierunku w górę (JOY_BTN_POV1_U). - Lista poleceń:
engine fsx refresh-db(orazfsxse,p3d4,p3d5,p3d6): około 150 zdarzeń z tytułami JoyPro plus każde zdarzenie wymienione w Twoich plikach sterowania i szablonach symulatora; zdarzeniaAXIS_*to osie. - Import / eksport:
engine fsx paths(najpierw aktywny plik),engine fsx import,engine fsx scan,engine fsx exporti to samo dlaengine fsxse export,engine p3d4 export,engine p3d5 export,engine p3d6 export. Kopia zapasowa przed pierwszym zapisem.
#Znane ograniczenia
- Wszystko wymaga sprawdzenia na prawdziwej instalacji: nagłówek Prepar3D v4+ i to, czy
<Name>nadal zawiera GUID, dokładne bajty zapisywane przez symulatory, nazwa osi drugiego suwaka oraz to, czy symulator zachowa nową mapę dodaną przez JoyPro dla urządzenia, którego jeszcze nie widział. - Nazwa pliku konfiguracji FSX: Steam Edition jest wywnioskowana.
- Testy:
engine\tests\smoke\fsx.ps1z syntetycznym plikiem zbudowanym według udokumentowanego formatu.
Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): fsx-p3d.md.