Star Citizen speichert Ihre ganze Steuerung in einer Datei, actionmaps.xml, und nummeriert Ihre Sticks als Joystick-Plätze js1 bis js8. JoyPro liest die Schiffsbelegungen dieser Datei in Ihr Profil und schreibt sie direkt dort zurück: Nur die Schiffsaktionen und ihre Achseneinstellungen ändern sich, jede andere Zeile bleibt, wie das Spiel sie geschrieben hat. Ein Gerät behält den Platz, den das Spiel ihm schon gegeben hat, sodass Ihre Belegungen nicht von einem Stick zum anderen springen.
Star Citizen direkt (eigene Belegungsdateien)
- Unterstützung
- direkt (eigene Belegungsdateien)
- Engine-Befehl
engine starcitizen- Belegungsdatei
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Befehlsliste aus
Data.p4k(defaultProfile.xml) und Ihre Profile- Test im Spiel
- 54/54 Schritte bestanden (2026-10-10)
- ✓ Importieren
- ✓ Exportieren
- ✓ Tastaturbelegungen
- ✓ Modifikatoren
- ✓ Befehlsliste auf Ihrem PC erstellt
- ✓ Spielüberwachung
- ✓ Achsenkurven und Totzonen
- ✓ Steuerungseinstellungen des Spiels
- ✗ Force-Feedback-Einstellungen im Spiel
- ✗ Force Feedback aus Telemetrie
- ✗ Telemetrie-Aufzeichnung
- ✓ Virtueller Joystick (vJoy)
- ◐ Virtuelles Xbox-Pad
- ✓ Virtuelle Funktionen
- ✓ Einrichtungsassistent / Auto Assign
- ✓ Cockpits
- ✓ Spickzettel
- ✓ Test im Spiel
Aus der Unterstützungsmatrix, erzeugt aus dem Code der Engine: alle Spiele.
#In 3 Schritten zum Laufen bringen
- Alles für mich einrichten
auf der Seite Start - Diese Tasten verwenden
zuerst die Liste ansehen - In mein Spiel schreiben
Star Citizen geschlossen lassen
Vorher: Schließen Sie jedes Gerät an, das Sie nutzen.
Dann: Ihre Belegungen stehen unter Options > Controls.
Haben Sie in Star Citizen schon Tasten belegt? Dann bietet die Startseite Importieren, dann Lücken füllen an. Ihre Belegungen bleiben, und nur freie Tasten bekommen neue Aufgaben. Siehe Schnellstart: Meinen Stick zum Laufen bringen.
#Was JoyPro für Star Citizen tut
- Importieren: Ihre Schiffsbelegungen auf Sticks, Schubhebeln und Pedalen kommen in Ihr Profil, mit ihren Totzonen, Kurven und Invertierungen. Auch die eigenen Standard-Joystick-Belegungen des Spiels auf js1 kommen mit, damit ein späterer Export sie nicht verliert.
- Relationen: Eine Relation ist eine Funktion in jedem Spiel. „Fahrwerk“ kann derselbe Schalter in Star Citizen, DCS und Elite Dangerous sein.
- Exportieren: JoyPro bearbeitet
actionmaps.xmldirekt. Belegungen zu Fuß, für Fahrzeuge und Menüs sowie Maus- und Gamepad-Belegungen bleiben, wie sie sind.
#Ihre Star-Citizen-Belegungen importieren
- Öffnen Sie Start. Wenn die Star-Citizen-Karte nach einer Befehlsliste fragt, drücken Sie Liste erstellen: JoyPro liest die Aktionen des Spiels aus Ihrer Installation (
Data.p4k, nur lesend). Nach einem Spiel-Patch fügt Aktualisieren auf der Karte neue Aktionen hinzu. - Drücken Sie Importieren auf der Star-Citizen-Karte. Lassen Sie Zu meinem Profil hinzufügen gewählt. Haken Sie Auch die Tastaturbelegungen übernehmen nur an, wenn Sie Ihre Schiffstasten auch in JoyPro haben möchten.
- Drücken Sie Jetzt importieren. Meine Relationen ansehen öffnet, was hereingekommen ist.


#Relationen bauen und prüfen
Jede Schiffsaktion ist ein Eintrag in einer Relation. Verbinden Sie dieselbe Funktion Ihrer anderen Spiele mit dem Ablauf Relationen und drücken Sie dann Prüfen auf der Seite Export: Es findet eine Taste, die auf Ihrem Schiff zwei Dinge tut, bevor das Spiel es tut.
#Nach Star Citizen exportieren
- Schließen Sie Star Citizen. Das Spiel schreibt
actionmaps.xmlbeim Beenden neu, darum schreibt JoyPro nicht, solange es läuft. - Öffnen Sie Exportieren und haken Sie die Star-Citizen-Karte an.
- Lassen Sie Auf meinen Geräten ersetzen mit Auch meine anderen Geräte leeren gewählt, wenn Sie Ihre Sticks in JoyPro einrichten. Drücken Sie Jetzt exportieren auf der Karte.


Starten Sie das Spiel und öffnen Sie im Hauptmenü Options > Controls. Wählen Sie Ihr Gerät (Joystick / HOTAS 1, 2 ...): Seine Totzone und Sättigung sind die, die Sie in JoyPro eingestellt haben; Inversion Settings und Joystick Sensitivity Curves (Flight > Flight Movement) zeigen Ihre Invertierungen, Exponenten und Kurven. Ihre Schiffsbelegungen liegen auf dem Joystick-Platz jedes Geräts. Standardbelegungen des Spiels, die JoyPro ausgeschaltet hat, erscheinen leer. Das Menü zeigt die Sättigung 0,01 höher, als die Datei enthält (0.87 erscheint als 0.88); das Spiel behält den genauen Wert.
#Was Sie in Star Citizen selbst tun
- Für die Belegungen nichts weiter. Schließen Sie vor dem Export jedes Gerät an, das Sie nutzen: Ein nicht angeschlossenes Gerät behält seinen Platz und seine Belegungen, aber JoyPro kann ihm keine neuen geben.
- Liegt das Spiel in einem anderen Ordner als dem erkannten, setzen Sie den Pfad einmal auf der Seite Export unter Optionen und Pfade (für Experten) oder verknüpfen Sie den Ordner unter Einstellungen > Spiele.
#Häufige Stolperfallen
- „Star Citizen läuft“: Beenden Sie das Spiel (auch im Launcher) und exportieren Sie erneut.
- Belegungen sind auf dem falschen Stick gelandet: Lassen Sie SC: lokale Reihenfolge bevorzugen eingeschaltet (die Voreinstellung). Ist es aus, folgen die Plätze der Reihenfolge, in der Windows die Geräte meldet, und das kann jede Belegung eines Geräts auf eine andere js-Nummer schieben.
- Ein Gerät hat keinen Platz bekommen: Das Spiel hat acht Joystick-Plätze. JoyPro legt doppelte Einträge eines Sticks (den Namen des Spiels und den Namen von JoyPro) auf einen Platz zusammen, aber mehr als acht angeschlossene Geräte mit Belegungen passen nicht hinein.
- Eine Standardbelegung ist auf js1 zurückgekommen: Sie kommt zurück, wenn das Gerät auf js1 beim Export nicht angeschlossen ist. Schließen Sie es an und exportieren Sie erneut mit Ersetzen.
#Dateien, die JoyPro liest und schreibt
| Datei | Was es ist |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
Ihre Neubelegungen, die Joystick-Plätze (<options type="joystick" instance="1..8" Product="...">), die Optionsgruppen pro Platz (Invertierung, Exponent, Kurve, Empfindlichkeit) und die Geräteoptionen (Totzone, Sättigung pro physischer Achse) |
...\Profiles\default\attributes.xml |
spielweite Einstellungen (<Attr name="..." value="..."/>), nur die Werte, die von den Standardwerten des Spiels abweichen |
...\Profiles\default\actionmaps.jp |
die Kopie der geschriebenen Datei von JoyPro mit Relationsnamen als Kommentare, vom nächsten Import zurückgelesen |
...\Profiles\default\actionmaps.xml.joypro.json |
die Achseneinstellungen, die JoyPro zuletzt geschrieben hat, damit „Aktualisieren“ einen Wert, den Sie im Spiel geändert haben, von seinem eigenen unterscheiden kann |
actionmaps.xml.jpbak, attributes.xml.jpbak |
Kopien von vor dem ersten Schreiben eines Exports, dazu der versionierte Sicherungsspeicher von JoyPro |
Der Export bearbeitet actionmaps.xml an Ort und Stelle: Nur Schiffs-Neubelegungen und die Achseneinstellungen der Achsen-Neubelegungen, die JoyPro schreibt, ändern sich. Andere Action Maps, Maus- und Gamepad-Neubelegungen, Aktivierungsmodi, Modifikatoren, andere Optionsgruppen und Geräteoptionen bleiben Byte für Byte gleich. Ein Profil ohne Star-Citizen-Belegungen lässt die Datei, wie sie ist.
#Die Joystick-Plätze
Star Citizen benennt jede Joystick-Belegung nach ihrem Platz: js1_button3, js2_x. Die Datei listet, welches Gerät welchen Platz hat, nach dem DirectInput-Produktnamen und der Produkt-GUID des Geräts.
- Lokale Reihenfolge bevorzugen (standardmäßig an): Ein angeschlossenes Gerät, das die Datei schon nennt, behält diesen Platz. Andere Geräte füllen die freien Plätze in der Reihenfolge, in der Windows sie meldet.
- Ein Gerät, ein Platz: Derselbe Stick, der zweimal aufgeführt ist (unter dem Namen des Spiels und unter dem Instanznamen von JoyPro, oder ein alter zweiter Eintrag), bekommt einen Platz. Der Export entfernt die doppelten Einträge und verschiebt ihre Belegungen auf den Platz, den das Gerät behält. Einträge nicht angeschlossener Geräte bleiben.
- Zwei angeschlossene Geräte desselben Modells bleiben getrennt.
- Ein Gerät, das den Platz wechselt, nimmt seine Optionsgruppen (Invertierung, Kurven) mit. Ein Gerät, das keinen Platz bekommt, verliert die Gruppen seines alten Platzes, mit einer Warnung.
#Die Exportmodi in Star Citizen
Jeder Modus ändert nur Schiffsaktionen. Die Maps für zu Fuß, Fahrzeuge und Menüs bleiben Byte für Byte gleich.
| Modus | Was im Spiel passiert |
|---|---|
| Nur hinzufügen | Keine Belegung des Spiels ändert sich. Eine Aktion, deren Joystick-Platz schon eine Neubelegung oder einen aktiven Standard hat, behält sie. Eine Belegung auf einer Eingabe, die eine andere Schiffsaktion nutzt, wird nicht geschrieben und bekommt die Markierung „Nicht ins Spiel geschrieben“. |
| Aktualisieren, Belegungen des Spiels behalten | Ihre Eingabe kommt in den Joystick-Platz der Aktion (Star Citizen hat einen pro Aktion und Eingabeart). Eine Belegung des Spiels auf einer Eingabe, die Sie einer anderen Schiffsaktion geben, wird freigegeben: Ihre Neubelegung fällt weg oder wird zu einem leeren js1_ , wenn die Aktion einen Standard hat, damit der Standard nicht zurückkommt. |
| Aktualisieren, mein Profil gewinnt | Wie oben; mit der Tastatur-Option verliert eine Aktion, die Sie belegen, auch ihre Tastatur-Neubelegung. |
| Auf meinen Geräten ersetzen | Die geschriebenen Geräte behalten nur Ihre Schiffsbelegungen. Bei einem Gerät auf js1 werden die js1-Standards des Spiels, die Ihr Profil nicht hat, abgeschaltet. |
| + Auch meine anderen Geräte leeren | Angeschlossene Geräte ohne Belegungen in Ihrem Profil verlieren ihre Schiffsbelegungen; die Standards von js1 werden abgeschaltet, wenn js1 nicht genutzt wird. |
Optionen auf der Seite Export (unter Optionen und Pfade (für Experten)):
- SC: Tastatur-Standards behalten (an): Die Tastatur behält die Standardtasten des Spiels. Aus: Ihre Tastaturbelegungen werden geschrieben, und die Standardtasten, die sie belegen, werden freigegeben.
- SC: lokale Reihenfolge bevorzugen (an): siehe die Joystick-Plätze oben.


#Die Standard-Joystick-Belegungen des Spiels
Star Citizen hat Standard-Joystick-Belegungen, die auf js1 wirken, bis eine Aktion dort eine Neubelegung bekommt (Pitch auf Y, Yaw auf X, Roll auf Z-Rotation, ein paar Tasten). Der Import übernimmt jeden aktiven Standard als Belegung des js1-Geräts, damit Ihr Profil enthält, was das Spiel wirklich tut. Der Export schreibt keine Neubelegung für eine Belegung, die dem Standard entspricht (nur echte Unterschiede). Ersetzen und Auch leeren schalten die Standards, die Ihr Profil nicht hat, mit einer leeren Neubelegung js1_ ab, so wie das eigene Menü des Spiels eine gelöschte Belegung schreibt, und nur, wenn das Gerät auf js1 angeschlossen ist. Import und dann Ersetzen + Auch leeren lässt actionmaps.xml also so, wie es war.
#Was nie angefasst wird
- Belegungen für zu Fuß, Bodenfahrzeuge und Menüs (die Bodenfahrzeuge von Star Citizen zählen als eigene Fahrzeugklasse).
- Geräte, die nicht angeschlossen sind: Sie behalten ihren Platz und ihre Neubelegungen.
- Die beim Import ignorierten Geräte und das vJoy-Gerät, in das JoyPro weiterleitet.
- Maus- und Gamepad-Belegungen; die Tastatur, außer Sie exportieren Tastaturbelegungen.
- Aktivierungsmodi, Modifikatoren, andere Optionsgruppen und Geräteoptionen.
#Schiffe, Kurven, Spieleinstellungen
- Granularität: ein Satz Schiffsbelegungen für jedes Schiff (das Spiel hat keine Belegungen pro Schiff).
- Achsenkurven, an zwei Stellen, so wie das Spiel sie hält: Totzone und Sättigung pro Gerät und physischer Achse; Invertierung, Exponent (1 bis 3), eine 11-Punkte-Kurve und Empfindlichkeit pro Platz und Optionsgruppe. Exponent und Kurve schließen sich gegenseitig aus, wie im Menü des Spiels. Eine Relation ohne Star-Citizen-Werte bekommt ihre JoyPro-Kurve angenähert: Totzone und Sättigung gehen an die Geräteachse, die Krümmung wird zum nächstliegenden Exponenten oder zur Kurve, wenn kein Exponent passt. Es gibt keine einseitige Achse: Der absolute und der relative Schub des Spiels sind getrennte Aktionen.
- Aktualisieren behält einen Achsenwert, den Sie im Spiel geändert haben (mit einer Warnung); Ersetzen und mein Profil gewinnt setzen die Werte Ihres Profils. Eine neutrale Relation lässt den eigenen Wert des Spiels (der freie Blick behält seinen Standard-Exponenten 2.5).
- Spielweite Einstellungen (
attributes.xml): HOTAS-Schubumkehr-Schalter, die Fangzeit und Schwelle des relativen Schubs, die IFCS-Empfindlichkeitsfaktoren, ESP an, Stärke und Dämpfung, Turret-ESP, die Flug-Standards (Sticky Throttle, Geschwindigkeitsbegrenzer, Coupled, G-Safe, Auto Precision, Space Brake), Flugsteuerung invertieren und Vibration. Stellen Sie sie unter Einstellungen > Force-Feedback-Einstellungen der Spiele ein (Star Citizen wählen) oder mitengine ffb set. JoyPro ändert nur die Zeilen, die Sie setzen, an Ort und Stelle, und legt die Datei nicht an. Der Regler für die ESP-Stärke endet bei 1.00, darum bietet JoyPro 0 bis 1 an. - Force Feedback: keins. Vibration ist die einzige Einstellung dieser Art im Spiel.
- Überwachung: Eine Belegung oder einen Achsenwert, den Sie im Menü des Spiels ändern, bemerkt JoyPro nach dem Schließen des Spiels und fragt, ob es ihn übernehmen soll. Es vergleicht
actionmaps.xml(nur Schiffs-Action-Maps) und die Einstellungen, die JoyPro inattributes.xmlverwaltet. - HUD: Das HUD erkennt das Spiel an seinem Prozess und zeigt Ihre Star-Citizen-Belegungen.
#Im Inneren der Star-Citizen-Anbindung
flowchart LR
A[("actionmaps.xml")] --> S["Platz pro Gerät"]
D["Verbundene Geräte"] --> S
P["Das Profil"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Code: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, das Achsenmodell engine\AxisModels\StarCitizen.cs und das Einstellungsmodell engine\FfbModels\StarCitizen.cs.
- Gerätenamen: Das
Productdes Platzes ist der DirectInput-Produktname und die Produkt-GUID, mit zwei Leerzeichen getrennt (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Einen Platz oderdeviceoptions-Block, der unter einem anderen Namen (einer Instanz-GUID) geschrieben ist, erkennt das Spiel nicht: Es schreibt den Platz mit seinem Produkt neu und verwirft die Optionsgruppen des Platzes. JoyPro schreibt darum den Produktnamen des angeschlossenen Geräts. - Befehlsliste:
engine db refresh-starcitizenliestData\Libs\Config\defaultProfile.xmlausData.p4k(oder einer entpackten Kopie mit--source) inDB\StarCitizen\AllBinds.xml: jede Aktion mit ihrer Optionsgruppe, den Joystick-Optionsbaum (Eltern und Standards, welche Gruppen eine Kurve zeigen) und die Standard-Joystick-Eingabe der Aktion.engine starcitizen labelsholt die Namen der Steuerelemente des Spiels ausglobal.ini. - Importieren:
engine starcitizen import(--include-keyboard,--device,--ignore-device); jede Achsen-Neubelegung bekommt die Werte, die das Spiel nutzt (die unterste Gruppe des Platzes, sonst die nächste Elterngruppe, die Sie gesetzt haben, sonst den Standard des Spiels) und die Geräteoptionen ihrer Achse, als ihregame:StarCitizen-Abstimmung.engine starcitizen scanzeigt dasselbe, ohne das Profil zu ändern;engine starcitizen list-deviceslistet die Joystick-Plätze der Datei. - Exportieren:
engine starcitizen export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>. Ein neuerdeviceoptions-Block kommt vor das erste<options>; mehrere Relationen auf einer Optionsgruppe oder einer physischen Achse mit verschiedenen Werten ergeben eine Warnung, und die erste Relation nach Name gewinnt. - Spieleinstellungen:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; eine vorhandene Zeile bekommt den Wert, eine neue kommt an ihre sortierte Stelle. - Sicherungen:
engine backups listlistet die Kopien; Letzten Export rückgängig machen auf der Karte stellt die neueste wieder her.
#Bekannte Grenzen
- Acht Joystick-Plätze; die Tastengrenze pro Gerät ist nicht bekannt (die Quellen widersprechen sich).
- Wo das Spiel einen neuen
deviceoptions-Block haben will, die Kurveninterpolation (das Menü zeichnet einen glatten Spline durch die Punkte), der Exponentenbereich und ob die Empfindlichkeit für Joysticks gilt, ist noch nicht bestätigt. Die Wertebereiche der spielweiten Einstellungen stehen nicht in den lesbaren Dateien des Spiels. - Ob Vibration einen DirectInput-Force-Feedback-Stick ansteuert, ist noch nicht bestätigt.
- Tests:
engine\tests\smoke\starcitizen.ps1(Katalog-Aktualisierung, Import von Optionsgruppen und Kurven, Import + Export Byte für Byte, jede Achseneinstellung, Konflikte, Platzwechsel,attributes.xmlan Ort und Stelle); im Spieltools\e2e\games\StarCitizenSettings.ps1(Hauptmenü Options: Einstellungen, Belegungen und Kurven) undtools\e2e\games\StarCitizen.ps1(Matrix der Export- und Importmodi).
Alle technischen Hinweise zu diesem Spiel (erzeugt aus dem Repository): starcitizen.md.