A Star Citizen az összes vezérlését egyetlen fájlban, az actionmaps.xml fájlban tárolja, és a botkormányait js1–js8 joystickhelyként számozza. A JoyPro e fájl hajókiosztásait beolvassa a profiljába, és helyben visszaírja őket: csak a hajóműveletek és tengelybeállításaik változnak, minden más sor úgy marad, ahogy a játék megírta. Egy eszköz megtartja azt a helyet, amelyet a játék már adott neki, így a kiosztásai nem ugrálnak egyik botkormányról a másikra.
Star Citizen natív (saját kiosztásfájlok)
- Támogatás
- natív (saját kiosztásfájlok)
- Motorparancs
engine starcitizen- Kiosztásfájl
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Parancslista forrása
Data.p4k(defaultProfile.xml) és az Ön profiljai- Játékon belüli teszt
- 54/54 lépés sikeres (2026-10-10)
- ✓ Importálás
- ✓ Exportálás
- ✓ Billentyűzet-kiosztások
- ✓ Módosítók
- ✓ A számítógépén létrehozott parancslista
- ✓ Játékfigyelő
- ✓ Tengelygörbék és holtzónák
- ✓ A játék vezérlési beállításai
- ✗ A játékon belüli erővisszacsatolás-beállítások
- ✗ Erővisszacsatolás telemetriából
- ✗ Telemetria-rögzítés
- ✓ Virtuális joystick (vJoy)
- ◐ Virtuális Xbox-kontroller
- ✓ Virtuális funkciók
- ✓ Beállítóvarázsló / Automatikus kiosztás
- ✓ Pilótafülkék
- ✓ Puskák
- ✓ Játékon belüli teszt
A támogatási mátrixból, amely a motor kódjából készül: minden játék.
#Működésre bírás 3 lépésben
- Minden beállítása helyettem
a Kezdőlapon - Ezen gombok használata
előbb nézze át a listát - Írás a játékomba
a Star Citizen maradjon zárva
Előtte: csatlakoztasson minden eszközt, amelyet használ.
Aztán: a kiosztásai az Options > Controls menüben vannak.
Osztott már ki gombokat korábban a Star Citizenben? Akkor a Kezdőlap felkínálja az Importálás, majd a hézagok kitöltése lehetőséget. A kiosztásai megmaradnak, és csak a szabad gombok kapnak új feladatot. Lásd: Gyors kezdés: működjön a botkormányom.
#Mit tesz a JoyPro a Star Citizenért
- Importálás: a botkormányain, gázkarjain és pedáljain lévő hajókiosztásai bekerülnek a profiljába, a holtzónáikkal, görbéikkel és invertálásaikkal együtt. A játék saját alapértelmezett joystick-kiosztásai a js1-en szintén bekerülnek, így egy későbbi exportálás nem veszíti el őket.
- Relációk: egy reláció egy funkció minden játékban. A „Landing gear” lehet ugyanaz a kapcsoló a Star Citizenben, a DCS-ben és az Elite Dangerousban.
- Exportálás: a JoyPro helyben szerkeszti az
actionmaps.xmlfájlt. A gyalogos, jármű- és menükiosztások, az egér- és gamepad-kiosztások úgy maradnak, ahogy vannak.
#A Star Citizen-kiosztásai importálása
- Nyissa meg a Kezdőlapot. Ha a Star Citizen kártyája parancslistát kér, nyomja meg a Lista létrehozása gombot: a JoyPro a játék műveleteit a telepítéséből olvassa ki (
Data.p4k, csak olvasás). Egy játékjavítás után a kártyán a Frissítés hozzáadja az új műveleteket. - Nyomja meg az Importálás gombot a Star Citizen kártyáján. Hagyja bejelölve a Hozzáadás a profilomhoz lehetőséget. Az A billentyűzet billentyűit is átveszi lehetőséget csak akkor jelölje be, ha a hajóbillentyűit is szeretné a JoyPróban látni.
- Nyomja meg az Importálás most gombot. A Relációim megtekintése megnyitja, ami bekerült.


#Relációk létrehozása és ellenőrzése
Minden hajóművelet egy bejegyzés egy relációban. Kapcsolja össze a többi játéka ugyanazon funkcióját a relációk folyamatával, aztán nyomja meg az Exportálás oldalon az Ellenőrzés gombot: még a játék előtt megtalálja azt a gombot, amely két dolgot csinál a hajóján.
#Exportálás a Star Citizenbe
- Zárja be a Star Citizent. A játék kilépéskor újraírja az
actionmaps.xmlfájlt, ezért a JoyPro nem hajlandó írni, amíg fut. - Nyissa meg az Exportálás oldalt, és jelölje be a Star Citizen kártyáját.
- Hagyja bejelölve a Csere az eszközeimen és az A többi eszközöm törlése is lehetőséget, ha a botkormányait a JoyPróban állítja be. Nyomja meg a kártyán az Exportálás most gombot.


Indítsa el a játékot, és a főmenüből nyissa meg az Options > Controls menüt. Válassza ki az eszközét (Joystick / HOTAS 1, 2 ...): a holtzónája és telítettsége az, amelyet a JoyPróban beállított; az Inversion Settings és a Joystick Sensitivity Curves (Flight > Flight Movement) mutatja az invertálásait, exponenseit és görbéit. A hajókiosztásai az egyes eszközök joystickhelyén vannak. A JoyPro által kikapcsolt játék-alapértékek üresként látszanak. A menü a telítettséget 0.01-dal magasabbnak mutatja, mint ami a fájlban van (a 0.87 0.88-ként látszik); a játék a pontos értéket tárolja.
#Amit saját maga tesz meg a Star Citizenben
- A kiosztásokhoz semmi mást. Exportálás előtt csatlakoztasson minden eszközt, amelyet használ: egy nem csatlakoztatott eszköz megtartja a helyét és a kiosztásait, de a JoyPro nem tud neki újakat adni.
- Ha a játék nem a felismert mappában van, állítsa be egyszer az útvonalat az Exportálás oldalon a Beállítások és útvonalak (szakértőknek) alatt, vagy kapcsolja hozzá a mappát a Beállítások > Játékok oldalon.
#Gyakori buktatók
- „A Star Citizen fut”: lépjen ki a játékból (az indítóból is), és exportáljon újra.
- A kiosztások rossz botkormányra kerültek: hagyja bekapcsolva az SC: a helyi sorrend előnyben részesítése beállítást (ez az alapértelmezés). Kikapcsolva a helyek abban a sorrendben követik egymást, ahogy a Windows az eszközöket jelenti, és ez egy eszköz összes kiosztását másik js-számra tolhatja át.
- Egy eszköz nem kapott helyet: a játékban nyolc joystickhely van. A JoyPro egy botkormány ismétlődő bejegyzéseit (a játék nevét és a JoyPro nevét) egy helyre vonja össze, de nyolcnál több csatlakoztatott, kiosztással rendelkező eszköz nem fér el.
- Egy alapértelmezett kiosztás visszajött a js1-en: akkor jön vissza, ha a js1-en lévő eszköz az exportáláskor nincs csatlakoztatva. Csatlakoztassa, és exportáljon újra Cserével.
#A JoyPro által olvasott és írt fájlok
| Fájl | Mi ez |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
az Ön átkiosztásai, a joystick-helyek (<options type="joystick" instance="1..8" Product="...">), a helyenkénti beállításcsoportok (megfordítás, kitevő, görbe, érzékenység) és az eszközbeállítások (holtzóna, telítés fizikai tengelyenként) |
...\Profiles\default\attributes.xml |
játékszintű beállítások (<Attr name="..." value="..."/>), csak azok az értékek, amelyek eltérnek a játék alapértékeitől |
...\Profiles\default\actionmaps.jp |
A JoyPro másolata a megírt fájlról, a relációnevekkel megjegyzésként; a következő importálás visszaolvassa |
...\Profiles\default\actionmaps.xml.joypro.json |
a JoyPro által legutóbb írt tengelybeállítások, hogy a „Frissítés” meg tudja különböztetni a játékban Ön által módosított értéket a sajátjától |
actionmaps.xml.jpbak, attributes.xml.jpbak |
másolatok egy exportálás első írása előttről, valamint a JoyPro verziózott biztonsági mentéseinek tárolója |
Az exportálás helyben szerkeszti az actionmaps.xml fájlt: csak a hajós átkiosztások és a JoyPro által írt tengelyes átkiosztások tengelybeállításai változnak. A többi akciótérkép, az egér- és gamepad-átkiosztások, az aktiválási módok, a módosítók, a többi beállításcsoport és az eszközbeállítások bájtról bájtra megmaradnak. Egy Star Citizen-kiosztások nélküli profil a fájlt változatlanul hagyja.
#A joystick-helyek
A Star Citizen minden joystick-kiosztást a helye alapján nevez meg: js1_button3, js2_x. A fájl felsorolja, melyik eszköz melyik helyet foglalja el, az eszköz DirectInput-terméknevével és termék-GUID-jával.
- A helyi sorrend előnyben részesítése (alapból bekapcsolva): egy csatlakoztatott eszköz, amelyet a fájl már megnevez, megtartja a helyét. A többi eszköz abban a sorrendben tölti fel a szabad helyeket, ahogy a Windows jelenti őket.
- Egy eszköz, egy hely: ugyanaz a botkormány kétszer felsorolva (a játék által adott név és a JoyPro példánynév alatt, vagy egy régi második bejegyzésként) egy helyet foglal el. Az exportálás eltávolítja a duplikált bejegyzéseket, és a kiosztásaikat arra a helyre helyezi át, amelyet az eszköz megtart. A nem csatlakoztatott eszközök bejegyzései maradnak.
- Ugyanazon modell két csatlakoztatott eszköze külön marad.
- Egy helyet váltó eszköz magával viszi a beállításcsoportjait (megfordítás, görbék). Egy eszköz, amely nem kap helyet, figyelmeztetés mellett elveszíti a régi helye csoportjait.
#Az exportálási módok a Star Citizenben
Minden mód csak a hajós műveleteket változtatja meg. A gyalogos, a jármű- és a menütérképek bájtról bájtra megmaradnak.
| Mód | Mi történik a játékban |
|---|---|
| Csak hozzáadás | Egyetlen játékbeli kiosztás sem változik. Az a művelet, amelynek joystick-helyén már van átkiosztás vagy aktív alapkiosztás, megtartja azt. Az a kiosztás, amely olyan bemeneten van, amelyet egy másik hajós művelet használ, nem íródik be, és „Nincs beírva a játékba” jelölést kap. |
| Frissítés, a játék kiosztásai megmaradnak | A bemenete a művelet joystick-helyére kerül (a Star Citizenben műveletenként és bemenettípusonként egy van). Egy játékbeli kiosztás egy olyan bemeneten, amelyet Ön egy másik hajós műveletnek ad, felszabadul: az átkiosztása törlődik, vagy üres js1_ lesz belőle, ha a műveletnek van alapkiosztása, így az alapkiosztás nem tér vissza. |
| Frissítés, az én profilom nyer | Mint fent; a billentyűzet-beállítással egy kiosztott művelet a billentyűzetes átkiosztását is elveszíti. |
| Csere az eszközeimen | Az írt eszközök csak az Ön hajós kiosztásait tartják meg. Ha egy eszköz a js1 helyen van, a játék azon js1-alapkiosztásai, amelyek nincsenek meg a profiljában, kikapcsolnak. |
| + A többi eszközöm törlése is | Azok a csatlakoztatott eszközök, amelyeknek nincs kiosztásuk a profiljában, elveszítik a hajós kiosztásaikat; a js1 alapkiosztásai kikapcsolnak, ha a js1 nincs használatban. |
Beállítások az Exportálás oldalon (a Beállítások és útvonalak (szakértőknek) alatt):
- SC: billentyűzet-alapértékek megtartása (be): a billentyűzet megtartja a játék alapértelmezett billentyűit. Ki: a billentyűzetes kiosztásai beíródnak, és az általuk elfoglalt alapértelmezett billentyűk felszabadulnak.
- SC: a helyi sorrend előnyben részesítése (be): lásd fent a joystick-helyeket.


#A játék alapértelmezett joystick-kiosztásai
A Star Citizennek vannak alapértelmezett joystick-kiosztásai, amelyek a js1 helyen működnek, amíg egy művelet ott átkiosztást nem kap (pitch az Y, yaw az X, roll a Z-forgatás tengelyen, néhány gomb). Az importálás minden aktív alapkiosztást a js1 eszköz kiosztásaként vesz át, így a profilja azt tartalmazza, amit a játék valóban csinál. Az exportálás nem ír átkiosztást olyan kiosztáshoz, amely megegyezik az alapértékkel (csak a valódi eltéréseket írja). A Csere és az „A többi eszközöm törlése is” üres js1_ átkiosztással kapcsolja ki azokat az alapkiosztásokat, amelyek nincsenek meg a profiljában, ahogy a játék saját menüje is egy törölt kiosztást ír, és csak akkor, ha a js1 helyen lévő eszköz csatlakoztatva van. Így az importálás, majd a Csere + „A többi eszközöm törlése is” az actionmaps.xml fájlt úgy hagyja, ahogy volt.
#Amihez soha nem nyúl
- A gyalogos, a földi jármű- és a menükiosztások (a Star Citizen földi járművei saját járműosztálynak számítanak).
- A nem csatlakoztatott eszközök: megtartják a helyüket és az átkiosztásaikat.
- Az importálás figyelmen kívül hagyott eszközei és az a vJoy-eszköz, amelybe a JoyPro továbbít.
- Az egér- és gamepad-kiosztások; a billentyűzet, hacsak nem exportál billentyűzetes kiosztásokat.
- Az aktiválási módok, a módosítók, a többi beállításcsoport és az eszközbeállítások.
#Hajók, görbék, játékbeállítások
- Részletesség: egyetlen hajós kiosztáskészlet minden hajóhoz (a játékban nincsenek hajónkénti kiosztások).
- Tengelygörbék, két helyen, ahogy a játék tárolja őket: holtzóna és telítés eszközönként és fizikai tengelyenként; megfordítás, kitevő (1–3), 11 pontos görbe és érzékenység helyenként és beállításcsoportonként. A kitevő és a görbe kizárja egymást, ahogy a játék menüjében is. Egy Star Citizen-értékek nélküli reláció a JoyPro-görbéjének illesztését kapja: a holtzóna és a telítés az eszköz tengelyére kerül, a görbület a legközelebbi kitevő lesz, vagy a görbe, ha egyik kitevő sem illik. Nincs egyoldalú tengely: a játék abszolút és relatív gázkarja külön művelet.
- A Frissítés megtartja a játékban Ön által módosított tengelyértéket (figyelmeztetéssel); a Csere és a profilom az erősebb a profilja értékeit állítja be. Egy semleges reláció a játék saját értékét hagyja (a szabad nézelődés megtartja a 2.5-ös alapértelmezett kitevőjét).
- Játékszintű beállítások (
attributes.xml): HOTAS thrust invert toggle, a relatív gázkar csapdaideje és küszöbértéke, az IFCS érzékenységmódosítói, ESP be, erősség és csillapítás, lövegtorony-ESP, a repülési alapértékek (sticky throttle, speed limiter, coupled, G-safe, auto precision, space brake), invert flight controller és Vibration. Állítsa be őket a Beállítások > A játékok erővisszacsatolás-beállításai helyen (válassza a Star Citizent) vagy aengine ffb setsegítségével. A JoyPro csak az Ön által beállított sorokat módosítja, helyben, és nem hozza létre a fájlt. Az ESP erősség csúszkája 1.00-nál véget ér, ezért a JoyPro 0 és 1 közötti értéket kínál. - Force feedback: nincs. A Vibration az egyetlen ilyen beállítás a játékban.
- Figyelő: a játék menüjében módosított kiosztást vagy tengelyértéket a JoyPro a játék bezárása után észreveszi, és megkérdezi, átvegye-e. Összehasonlítja az
actionmaps.xmlfájlt (csak a hajós akciótérképeket) és a JoyPro által azattributes.xmlfájlban kezelt beállításokat. - HUD: a HUD a folyamata alapján találja meg a játékot, és megmutatja az Ön Star Citizen-kiosztásait.
#A Star Citizen integráció belülről
flowchart LR
A[("actionmaps.xml")] --> S["Hely eszközönként"]
D["Csatlakoztatott eszközök"] --> S
P["Az Ön profilja"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Kód: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, az engine\AxisModels\StarCitizen.cs tengelymodell és az engine\FfbModels\StarCitizen.cs beállításmodell.
- Eszköznevek: a hely
Productértéke a DirectInput-terméknév és a termék-GUID, két szóközzel elválasztva (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Egy más néven (példány-GUID-dal) írt helyet vagydeviceoptionsblokkot a játék nem ismer fel: a helyet a saját termékével írja újra, és elveti a hely beállításcsoportjait. Ezért a JoyPro a csatlakoztatott eszköz terméknevét írja. - Parancslista: a
engine db refresh-starcitizenaData.p4kfájlból (vagy--sourcemegadásával egy kibontott másolatból) beolvassa aData\Libs\Config\defaultProfile.xmlfájlt aDB\StarCitizen\AllBinds.xmlfájlba: minden műveletet a beállításcsoportjával, a joystick-beállítások fáját (szülők és alapértékek, mely csoportok mutatnak görbét) és a művelet alapértelmezett joystick-bemenetét. Aengine starcitizen labelsa vezérlők játékbeli neveit aglobal.inifájlból veszi. - Importálás:
engine starcitizen import(--include-keyboard,--device,--ignore-device); minden tengelyes átkiosztás megkapja a játék által használt értékeket (a hely levélcsoportjáét, egyébként a legközelebbi, Ön által beállított szülőét, egyébként a játék alapértékét) és a tengelye eszközbeállításait,game:StarCitizenhangolásként. Aengine starcitizen scanugyanezt mutatja a profil módosítása nélkül; aengine starcitizen list-devicesfelsorolja a fájl joystick-helyeit. - Exportálás:
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>. Egy újdeviceoptionsblokk az első<options>elé kerül; ha több reláció egy beállításcsoporton vagy egy fizikai tengelyen eltérő értékeket ad, figyelmeztetés jelenik meg, és a név szerint első reláció nyer. - Játékbeállítások:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; egy meglévő sor megkapja az értéket, egy új sor a rendezett helyére kerül. - Biztonsági mentések: a
engine backups listfelsorolja a másolatokat; a kártyán az Utolsó exportálás visszavonása a legújabbat állítja vissza.
#Ismert korlátok
- Nyolc joystick-hely; az eszközönkénti gombkorlát nem ismert (a források ellentmondanak egymásnak).
- Még nincs megerősítve, hová kéri a játék az új
deviceoptionsblokkot, milyen a görbe interpolációja (a menü sima splinet rajzol a pontokon át), mekkora a kitevő tartománya, és hogy az érzékenység vonatkozik-e a joystickokra. A játékszintű beállítások tartományai nem szerepelnek a játék olvasható fájljaiban. - Még nincs megerősítve, hogy a Vibration működtet-e egy DirectInput-erővisszacsatolásos botkormányt.
- Tesztek:
engine\tests\smoke\starcitizen.ps1(katalógusfrissítés, beállításcsoportok és görbék importálása, importálás + exportálás bájtról bájtra, minden tengelybeállítás, ütközések, helyváltások,attributes.xmlhelyben); a játékbantools\e2e\games\StarCitizenSettings.ps1(főmenü, Options: beállítások, kiosztások és görbék) éstools\e2e\games\StarCitizen.ps1(exportálási és importálási módok mátrixa).
Minden technikai megjegyzés ehhez a játékhoz (a tárolóból generálva): starcitizen.md.