JoyPro2 Discord GitHub
Wichtigste Abläufe

In Ihre Spiele exportieren

Zeigen:

Der Export ist der Schritt, der Ihre Sticks im Spiel zum Laufen bringt. JoyPro schreibt Ihre Relationen und Belegungen in die Steuerungsdateien jedes Spiels, dieselben Dateien, die das eigene Controls-Menü des Spiels speichert. Während Sie fliegen, läuft nichts im Hintergrund: Nach dem Export liest das Spiel wie immer seine eigenen Dateien.

flowchart LR
  C["1 Prüfen<br/>(optional)"] --> M["2 Art wählen<br/>(4 Möglichkeiten)"]
  M --> G["3 Spiele anhaken,<br/>Angehakte Spiele exportieren"]
  G --> W["Zuerst Sicherung,<br/>dann werden die<br/>Spieldateien geschrieben"]
Schritt 1 schaut nur; er stoppt den Export nie. Letzten Export rückgängig machen auf der Karte eines Spiels legt seine Dateien zurück. Reine Xbox-Spiele bekommen nichts geschrieben: Sie nutzen Start auf der Seite Virtueller Joystick.
Für Einsteiger

#Export in drei Schritten

Öffnen Sie Exportieren in der Leiste unten. Die Seite besteht aus drei nummerierten Karten von oben nach unten:

Die Seite Export: Prüfung, Art, SpieleDie Seite Export: Prüfung, Art, Spiele
Die Seite Export: Prüfung, Art, Spiele (Die Bilder zeigen die App auf Englisch.)
  1. Prüfen Sie Ihr Profil. Drücken Sie Jetzt prüfen. JoyPro sucht nach Dingen, die im Spiel schiefgehen würden, zum Beispiel eine Taste, die im selben Flugzeug zwei Dinge tut. Beheben Sie, was es findet (ein Klick pro Problem), oder lassen Sie es; die Prüfung blockiert den Export nie. Siehe die Prüfung.
  2. Wie JoyPro in die Spiele schreibt. Wählen Sie eine von vier Möglichkeiten. Wenn Sie unsicher sind, behalten Sie die erste: Auf meinen Geräten ersetzen mit angehaktem Auch meine anderen Geräte leeren. Ihre Sticks tun dann genau, was Ihr Profil sagt, und sonst nichts.
  3. In Spiele exportieren. Jedes Spiel, für das Ihr Profil Belegungen hat, bekommt eine Karte mit seinem Bild. Haken Sie die Spiele an und drücken Sie Angehakte Spiele exportieren, oder drücken Sie Jetzt exportieren auf einer Karte.

Schließen Sie zuerst das Spiel. Spiele schreiben ihre Steuerungsdateien beim Beenden, darum exportiert JoyPro nicht in ein laufendes Spiel und sagt Ihnen das.

#Welche Möglichkeit ist die richtige für mich?

Auswahl Wählen Sie sie, wenn Was mit den eigenen Belegungen des Spiels passiert
Auf meinen Geräten ersetzen Sie Ihre Sticks in JoyPro einrichten Auf den Geräten in Ihrem Profil bleiben nur Ihre Belegungen (für die Flugzeuge, die Sie exportieren).
Aktualisieren, Belegungen des Spiels behalten Sie auch im Spiel Dinge belegen und sie behalten möchten Ihre Belegungen kommen hinein; eine Belegung des Spiels wird nur dort entfernt, wo sie auf einer Taste liegt, die Sie für etwas anderes nutzen.
Aktualisieren, mein Profil gewinnt Wie oben, aber Sie haben in JoyPro Aktionen auf andere Tasten verschoben Wie oben, und jede Aktion, die Sie belegen, verliert im Spiel ihre anderen Tasten, sodass ein Verschieben wirklich verschiebt.
Nur hinzufügen Sie probieren JoyPro zum ersten Mal aus Nichts wird entfernt. Wenn das Spiel eine Taste schon für etwas anderes nutzt, wird Ihre Belegung weggelassen, und die Prüfung sagt es Ihnen.

Auch meine anderen Geräte leeren (ein Haken unter den Möglichkeiten): Angeschlossene Geräte, die in Ihrem Profil keine Belegungen haben, verlieren ihre Belegungen in den exportierten Flugzeugen. Lassen Sie den Haken, wenn Sie sauber neu beginnen möchten, und nehmen Sie ihn weg, wenn Sie ein zweites Gerät nur im Spiel nutzen.

#Von Grund auf sicher

  • Bevor JoyPro eine Spieldatei ändert, kopiert es sie in eine Sicherung. Jede Karte hat Letzten Export rückgängig machen: Das legt die Dateien genau so zurück, wie sie waren, Byte für Byte.
  • Der erste Export in ein Spiel, das schon eigene Belegungen hat, fragt einmal: „Zuerst importieren?“. Wählen Sie Zuerst importieren, wenn Sie behalten möchten, was Sie im Spiel gemacht haben, oder Trotzdem exportieren, um es zu ersetzen.
  • Geräte, die nicht angeschlossen sind, behalten ihre Belegungen. Ihre Belegungen für Maus und Gamepad werden nie angefasst.

#Was Sie im Spiel bemerken

Starten Sie das Spiel und öffnen Sie sein Steuerungsmenü: Ihre Belegungen sind dort, in der Spalte jedes Geräts, unter den Namen, die das Spiel nutzt. In DCS erscheinen sie pro Flugzeug, in Star Citizen pro Schiffsaktion, in IL-2 unter Key mapping. Der Abschnitt Im Spiel unten listet jede Art von Spiel auf.

#Andere Wege, wie Ihre Belegungen ins Spiel kommen

Weg Was er tut
In mein Spiel schreiben (die Schnelleinrichtung) Der Export der Schnelleinrichtung. Er schreibt die Spiele, die sie eingerichtet hat, mit derselben Sicherung. Siehe Schnellstart.
Der Ersatz-Controller (virtuelles Xbox-Pad) ACE COMBAT 8 und Hell Let Loose: Vietnam bekommen nichts geschrieben. Ihr Export sagt das. Ihr Stick steuert einen Ersatz-Controller, solange Start an ist. Siehe Reine Xbox-Spiele.
Das DCS-Kniebrett Kein Export von Belegungen: eine Seite pro Flugzeug, die im Cockpit auflistet, was Ihre Tasten tun. Siehe das Kniebrett.
Erweitert

#Die Modi im Detail

„Dieselbe Eingabe“ heißt dasselbe Gerät, dieselbe Taste oder Achse und dieselben Modifikatoren, im selben Flugzeug (oder Schiff, Fahrzeug), wenn das Spiel Belegungen pro Flugzeug hält. Jeder Modus arbeitet nur in den Flugzeugen des Exports.

Nur hinzufügen Aktualisieren, behalten Aktualisieren, Profil gewinnt Ersetzen
Ihre Belegungen geschrieben, wo die Eingabe frei ist beschrieben beschrieben beschrieben
Eine Belegung des Spiels auf einer Eingabe, die Sie für eine andere Aktion nutzen behalten; Ihre Belegung wird nicht geschrieben und markiert entfernt entfernt entfernt
Eine Belegung des Spiels mit derselben Aktion auf einer anderen Eingabe (nach einem Verschieben) behalten behalten (die Aktion liegt auf beiden Eingaben) entfernt auf den geschriebenen Geräten entfernt
Andere Belegungen des Spiels auf Ihren Geräten behalten behalten behalten entfernt
Standards des Spiels auf Ihren Geräten behalten behalten behalten, außer sie haben eine Ihrer Aktionen entfernt
Angeschlossene Geräte ohne Belegungen im Profil behalten behalten Ihre Aktionen werden von ihnen entfernt behalten, außer bei Auch meine anderen Geräte leeren
Geräte, die nicht angeschlossen sind, Maus, Gamepad nie berührt nie berührt nie berührt nie berührt
Tastatur nur mit der Tastatur-Option nur mit der Tastatur-Option nur mit der Tastatur-Option nur mit der Tastatur-Option
Flugzeuge, die nicht im Export sind nie berührt nie berührt nie berührt nie berührt (DCS: außer mit der Option „verlieren die DCS-Standardbelegungen auch in jedem anderen Flugzeug“)

Auch meine anderen Geräte leeren wird mit Nur hinzufügen nicht genutzt. Bei den anderen Modi leert es die angeschlossenen Geräte, die das Profil nicht nutzt, in den exportierten Flugzeugen (DCS: auch ihre DCS-Standards). Die Geräte, die der Import ignoriert, und das vJoy-Gerät, in das JoyPro einspeist, werden nie geleert.

Seit 2.5.0 ist der Standard Auf meinen Geräten ersetzen + Auch meine anderen Geräte leeren (wie in JoyPro 1). Einen Modus, den Sie selbst gewählt haben, merkt sich JoyPro.

#Kurz gesagt: eine Ihrer Belegungen, vier Modi

Modus Das Spiel nutzt Ihre Taste für etwas anderes Ihre Aktion hat im Spiel andere Tasten Andere angeschlossene Geräte
Auf meinen Geräten ersetzen Diese Belegung wird entfernt; Ihre wird geschrieben Auf den geschriebenen Geräten entfernt Behalten, außer bei Auch meine anderen Geräte leeren
Aktualisieren, mein Profil gewinnt Diese Belegung wird entfernt; Ihre wird geschrieben Entfernt Ihre Aktionen werden von ihnen entfernt
Aktualisieren, Belegungen des Spiels behalten Diese Belegung wird entfernt; Ihre wird geschrieben Behalten: Die Aktion liegt auf beiden Behalten
Nur hinzufügen Behalten; Ihre wird nicht geschrieben und markiert Behalten Behalten

#Optionen pro Spiel

Unter Optionen und Pfade (für Experten):

  • DCS: die Liste Flugzeuge... auf der DCS-Karte (nur angehakte Flugzeuge werden geschrieben); DCS: Tastatur-Standards behalten (an); meine Geräte verlieren die DCS-Standardbelegungen auch in jedem anderen Flugzeug (aus).
  • Star Citizen: SC: Tastatur-Standards behalten, lokale Reihenfolge bevorzugen.
  • Die anderen Spiele: ein Feld Probelauf, das zeigt, was sich ändern würde, ohne zu schreiben.
  • Pfade: ein anderer Saved-Games- oder Konfigurationsordner pro Spiel; Eigene Pfade und ignorierte Geräte für dieses Profil gibt dem offenen Profil eigene statt der des PCs.

#Markierungen: „Nicht ins Spiel geschrieben“

Nur hinzufügen (und jeder Modus, bei dem ein Spiel keinen freien Platz für eine weitere Eingabe hat, zum Beispiel Elite Dangerous mit zwei Eingaben pro Aktion) lässt manche Belegungen aus. Das Profil merkt sich jede davon mit der Aktion des Spiels, die die Eingabe hat, und dem Datum; die Prüfung zeigt pro Markierung eine Karte mit Mit 'Aktualisieren' exportieren, um es zu ersetzen, Auf eine andere Taste verschieben und So lassen. Jeder Export ersetzt die Markierungen seines Spiels und seiner Flugzeuge, sodass eine Markierung verschwindet, wenn ein späterer Export die Belegung schreibt.

#Gemerkte Einstellungen

Der Modus, der Haken Auch leeren, die Optionen pro Spiel und die Pfade werden in den Einstellungen von JoyPro gespeichert; die Spiele und DCS-Flugzeuge, die Sie selbst angehakt haben, werden pro Profil gespeichert. Ersetzen und Auch leeren fragen vor jedem Export nach (Einstellungen > Rückfragen kann die Frage abschalten).

#Nach dem Export

  • Letzten Export rückgängig machen auf der Karte stellt die neueste Sicherung dieses Spiels wieder her. Die vollständige Liste steht unter Sicherungen der Spielkonfiguration unten auf der Seite Export.
  • Der Export merkt sich die Dateien des Spiels für die Spielüberwachung: Beim eigenen Export von JoyPro fragt sie später nie „Änderungen übernehmen?“; bei einer Änderung, die Sie danach im Spiel machen, schon (die Überwachung).
  • JoyPro legt seine eigenen Daten neben die Spieldatei, damit ein späterer Import Relationsnamen, Gruppen, Modifikatoren und Kurven zurückbringt (Re-Import).

#Im Spiel

Was der Spieler nach einem Export sieht, hängt von der Art des Spiels ab. Jedes Spiel unten folgt denselben Regeln: JoyPro schreibt nur die Aktionen seiner Befehlsliste, schreibt nicht, solange das Spiel läuft, sichert die Dateien vorher und rät nie ein Gerät oder eine Aktion, die es nicht zuordnen kann (es überspringt sie mit einer Warnung).

Im Spiel: Flugsimulatoren: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro übernimmt die Geräte, die es schreibt. Mit Ersetzen verschwindet jede andere Belegung dieser Geräte in den exportierten Flugzeugen, mit Auch meine anderen Geräte leeren werden auch die anderen angeschlossenen Geräte geleert (DCS: auch ihre DCS-Standards).

  • DCS World: Wählen Sie unter Options > Controls das Flugzeug: Ihre Belegungen stehen in der Spalte des Geräts, entfernte Standards erscheinen als leere Zellen, Ihre Modifikatoren stehen in der Modifikatorenliste. Nur die angehakten Flugzeuge ändern sich. JoyPro schreibt nur die Abweichungen von den DCS-Standards, so wie DCS es selbst tut.
  • IL-2 Great Battles: Settings > Key mapping zeigt Ihre Belegungen und Achsenkennlinien. Mauszeilen und Zeilen, die JoyPro nicht kennt, bleiben.
  • IL-2 Korea: das Key-mapping-Profil „General“.
  • Falcon BMS: Der Launcher baut die Tastendatei und die Achsenzuordnung beim nächsten Launch, darum starten Sie BMS über den Launcher.
  • MSFS 2024 / 2020: Unter Controls zeigt das Gerät JoyPros Preset.
  • X-Plane 11 / 12: Settings > Joystick zeigt die Zuweisungen.
Im Spiel: Spiele mit Infanterie, Fahrzeugen oder Menüs: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro fasst nur die Flugaktionen an (Flugzeug, Hubschrauber, Raumschiff). Ihre Belegungen zu Fuß, für Fahrzeuge und Menüs bleiben Byte für Byte erhalten. Ersetzen und Auch meine anderen Geräte leeren geben nur die Flugaktionen frei, die JoyPro kennt.

  • Star Citizen: Options > Keybindings zeigt die Schiffsaktionen auf Ihren Joysticks (js1, js2, ...). Mit Ersetzen oder Auch meine anderen Geräte leeren werden die eigenen Joystick-Standards des Spiels auf js1 ausgeschaltet, wenn js1 geschrieben wird oder ungenutzt ist.
  • War Thunder: Controls zeigt die Flugzeugbelegungen; Panzer- und Schiffssteuerung bleiben unverändert.
  • Arma 3 / Arma 2: die Tasteneinstellungen des Profils; nur Flugzeug- und Hubschrauberaktionen ändern sich.
Im Spiel: Weltraumspiele: Elite Dangerous, X4: Foundations
  • Elite Dangerous speichert zwei Eingaben pro Aktion (Primary und Secondary). Eine Belegung ohne freien Platz bekommt eine Markierung „Nicht geschrieben“ mit „Auf eine andere Taste verschieben“ oder „So lassen“. Belegungen zu Fuß und für den SRV bleiben.
  • X4: die Eingabeeinstellungen des Spiels; nur die katalogisierten Schiffsaktionen ändern sich.
Im Spiel: Spiele, die ein Gerät oder nur einen Xbox-Controller lesen
  • Auf vJoy gestellte Spiele (Spiele, die nur wenige Geräte lesen): Der Export schreibt die Belegungen auf das vJoy-Gerät. JoyPro kopiert Ihre Sticks darauf, während Sie spielen, und HidHide versteckt Ihre echten Geräte nur vor diesem Spiel. Das Spiel sieht ein Gerät, auf dem alles liegt. Siehe Virtueller Joystick.
  • Reine Xbox-Spiele (ACE COMBAT 8, Hell Let Loose: Vietnam): Nichts wird geschrieben, und der Export sagt das. Ihr Stick steuert einen Ersatz-Controller (virtuelles Xbox-Pad), solange Start an ist. HidHide ist nicht nötig. Siehe Ein reines Xbox-Spiel mit einem HOTAS spielen.
Technische Details

#Wie es im Inneren funktioniert

Ein Export vom Klick bis zu den geschriebenen Dateien:

# Wer Was passiert
1 Sie Drücken Sie Angehakte Spiele exportieren auf der Seite Exportieren.
2 JoyPro Fragt die Engine nach dem Spiel (profile game-state --game <id>): importiert, exportiert, hat Belegungen.
3 JoyPro Fragt Sie, wenn nötig: bei einem ersten Export („Zuerst importieren?“) oder bei einem Modus, der Belegungen entfernt (Einstellungen > Rückfragen).
4 Engine Führt <game> export --mode <m> --nuke-untouched-devices <b> ... aus: Es lehnt ab, solange das Spiel läuft, sichert jede Datei (GameBackups und .jpbak) und schreibt nur katalogisierte Aktionen.
5 Engine Speichert den Sync-Eintrag (Fingerabdruck und Ausgangsstand) und die Exportmarkierungen und antwortet dann: geschrieben, übersprungen, SkippedTakenInputs.
6 JoyPro Die Karte des Spiels zeigt „Exportiert 14:02“, und Letzten Export rückgängig machen ist bereit.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) fragen AskAboutFirstExportAsync (engine profile game-state) und ConfirmRiskyExportAsync, dann wählt ExportGameAsync den Exporter der Karte: dcs, il2, starcitizen oder ein Registry-Spiel. Der Befehl wird aus den Einstellungen der Seite gebaut, z. B. RunDcsExportAsync: engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Jeder Engine-Aufruf geht über eine Stelle, RunEngineAsync, mit --profile und --status true (Fortschritt und Abbrechen im Arbeitsbereich), nacheinander, damit nie zwei Befehle gleichzeitig schreiben.
  2. Engine. engine\Program.cs leitet dcs / il2 / starcitizen an ihre Exporter weiter und jedes andere Spiel an Games.GameRegistry (eine GameIntegration pro Spiel). DCS: EngineDcsExport.Modes.cs berechnet pro Gerätedatei die Belegungen, die DCS aktiv hat (sauberes Profil minus removed, plus added und changed), entscheidet, welche aktiv sein sollen, und schreibt nur echte Unterschiede zu den Standards.
  3. Sicherheit. GameExportSafety.BackupBeforeOverwrite kopiert jede Datei nach <file>.jpbak und in den versionierten Sicherungsspeicher (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ mit manifest.json; die neuesten 30 Sätze pro Spiel bleiben erhalten). Registry-Spiele (Nuclear Option) bekommen einen Schnappschuss der Werte, die sie ändern dürfen. Eine Datei, die der Export anlegt, wird als „gab es nicht“ vermerkt, damit eine Wiederherstellung sie wieder entfernt.
  4. Danach. Der Sync-Eintrag (<data>\Sync\<game>.json: Größe, Zeit und SHA-256 pro Datei und ein Hash jeder Belegung) hält die Überwachung bei der eigenen Änderung von JoyPro still. ExportSkippedBinds.cs füllt SkippedTakenInputs; der Export-Befehl macht daraus die Markierungen des Profils. Der Profilverlauf hält vor jedem Export einen Kontrollpunkt fest.

#Die Dateien, die jedes Spiel bekommt

Spiel Dateien
DCS World pro Flugzeug und Gerät Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, eine .jp daneben, die modifiers.lua des Flugzeugs
IL-2 Great Battles data\input\global.actions (neue Zeilen am Ende, die Reihenfolge bleibt), die Achsen-Antworten, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS die User\Config\Setup.v100.* {GUID}.xml des Launchers pro Gerät
MSFS 2024 / 2020 Eingabeprofile (2024: das Preset-Paket joypro-input-profiles im Community-Ordner und die Steam-Profile)
X-Plane 11 / 12 die Joystick-Einstellungen in Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml und actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Registry-Spiele ihre Konfigurationsdatei und <config>.joypro-meta.json

Markierungen nicht geschriebener Belegungen: engine export-marks list, engine export-marks dismiss. Einstellungen: export-settings.json (ModeChosenByUser); der Standard der Engine ohne --mode ist merge-overwrite.

#Jeder Modus auf der Kommandozeile

Auswahl in der GUI Engine-Optionen
Auf meinen Geräten ersetzen + Auch meine anderen Geräte leeren (Standard) --mode clean --nuke-untouched-devices true
Auf meinen Geräten ersetzen --mode clean --nuke-untouched-devices false
Aktualisieren, mein Profil gewinnt (+ Auch leeren) --mode merge-overwrite --nuke-untouched-devices true|false
Aktualisieren, Belegungen des Spiels behalten (+ Auch leeren) --mode merge --nuke-untouched-devices true|false
Nur hinzufügen --mode add (nuke wird nicht genutzt)

Pro Spiel: engine dcs export, engine il2 export, engine starcitizen export und engine <game> export für jedes Registry-Spiel (zum Beispiel engine warthunder export, engine msfs2024 export, engine xplane12 export; jeder nimmt --mode, --dry-run, --include-keyboard und --nuke-untouched-devices). Rückgängig: engine backups restore. Tests: engine\tests\smoke\dcsexportmodes.ps1 (jeder Modus, Rundlauf, Rückgängig Byte für Byte) und engine\tests\smoke\roundtrip.ps1 (Import, clean + nuke, erneuter Import lässt das Spiel, wie es war).