Star Citizen uchováva celé vaše ovládanie v jednom súbore, actionmaps.xml, a vaše páky čísluje ako sloty joystickov js1 až js8. JoyPro načíta väzby lode z tohto súboru do vášho profilu a zapíše ich späť priamo na mieste: menia sa iba akcie lode a nastavenia ich osí, každý iný riadok zostane tak, ako ho hra zapísala. Zariadenie si ponechá slot, ktorý mu hra už dala, takže vaše väzby nepreskakujú z jednej páky na druhú.
Star Citizen natívne (vlastné súbory väzieb)
- Podpora
- natívne (vlastné súbory väzieb)
- Príkaz nástroja
engine starcitizen- Súbor väzieb
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Zoznam príkazov z
Data.p4k(defaultProfile.xml) a vaše profily- Test v hre
- 54/54 krokov splnených (2026-10-10)
- ✓ Importovať
- ✓ Export
- ✓ Väzby klávesnice
- ✓ Modifikátory
- ✓ Zoznam príkazov zostavený vo vašom PC
- ✓ Sledovanie hier
- ✓ Krivky osí a mŕtve zóny
- ✓ Nastavenia ovládania v hre
- ✗ Nastavenia Force Feedback v hre
- ✗ Force Feedback z telemetrie
- ✗ Záznam telemetrie
- ✓ Virtuálny joystick (vJoy)
- ◐ Virtuálny gamepad Xbox
- ✓ Virtuálne funkcie
- ✓ Sprievodca nastavením / Automatické priradenie
- ✓ Kokpity
- ✓ Ťaháky
- ✓ Test v hre
Z matice podpory, vygenerovanej z kódu nástroja: všetky hry.
#Spustite to v 3 krokoch
- Nastaviť všetko za mňa
na stránke Úvod - Použiť tieto tlačidlá
najprv si pozrite zoznam - Zapísať do mojej hry
Star Citizen nechajte zatvorený
Pred: pripojte každé zariadenie, ktoré používate.
Potom: vaše väzby sú v Options > Controls.
Priraďovali ste už tlačidlá v Star Citizen? Potom vám Úvod ponúkne Importovať, potom doplniť medzery. Vaše väzby zostanú a nové úlohy dostanú iba voľné tlačidlá. Pozri Rýchly štart: rozbehať moju páku.
#Čo JoyPro robí pre Star Citizen
- Importovať: vaše väzby lode na pákach, plynoch a pedáloch prejdú do vášho profilu s mŕtvymi zónami, krivkami a invertovaním. Prejdú aj vlastné predvolené väzby joysticku na js1, aby ich neskorší export nestratil.
- Vzťahy: jeden vzťah je jedna funkcia vo všetkých hrách. "Landing gear" môže byť ten istý prepínač v Star Citizen, DCS aj Elite Dangerous.
- Export: JoyPro upravuje
actionmaps.xmlpriamo na mieste. Väzby pre pohyb pešo, vozidlá a ponuky, ako aj väzby myši a gamepadu zostanú tak, ako sú.
#Importujte svoje väzby zo Star Citizen
- Otvorte Štart. Ak karta Star Citizen žiada zoznam príkazov, stlačte Zostaviť zoznam: JoyPro načíta akcie hry z vašej inštalácie (
Data.p4k, iba na čítanie). Po patchi hry pridá Aktualizovať na karte nové akcie. - Na karte Star Citizen stlačte Importovať. Ponechajte Pridať do môjho profilu. Prevziať aj klávesy klávesnice začiarknite iba vtedy, ak chcete mať v JoyPro aj klávesy lode.
- Stlačte Importovať teraz. Zobraziť moje vzťahy otvorí, čo prišlo.


#Vytvorte a skontrolujte vzťahy
Každá akcia lode je jedna položka vo vzťahu. Spojte tú istú funkciu vašich ostatných hier pomocou postupu vzťahov a potom na stránke Export stlačte Skontrolovať: nájde tlačidlo, ktoré na vašej lodi robí dve veci, skôr než na to príde hra.
#Export do Star Citizen
- Zatvorte Star Citizen. Hra pri ukončení prepíše
actionmaps.xml, preto JoyPro odmietne zapisovať, kým beží. - Otvorte Export a začiarknite kartu Star Citizen.
- Ponechajte Nahradiť na mojich zariadeniach s Vymazať aj moje ostatné zariadenia, ak svoje páky nastavujete v JoyPro. Na karte stlačte Exportovať teraz.


Spustite hru a v hlavnej ponuke otvorte Options > Controls. Vyberte svoje zariadenie (Joystick / HOTAS 1, 2 ...): jeho mŕtva zóna a saturácia sú tie, ktoré ste nastavili v JoyPro; Inversion Settings a Joystick Sensitivity Curves (Flight > Flight Movement) ukazujú vaše invertovania, exponenty a krivky. Vaše väzby lode sú na slote joysticku každého zariadenia. Predvolené väzby hry, ktoré JoyPro vypol, sa zobrazia ako prázdne. Ponuka ukazuje saturáciu o 0.01 vyššiu, než je v súbore (0.87 sa zobrazí ako 0.88); hra si ponechá presnú hodnotu.
#Čo urobíte sami v Star Citizen
- Pre väzby nič ďalšie. Pred exportom pripojte každé zariadenie, ktoré používate: zariadenie, ktoré nie je pripojené, si ponechá svoj slot a svoje väzby, ale JoyPro mu nemôže dať nové.
- Ak je hra v inom priečinku, než bol zistený, nastavte cestu raz na stránke Export v časti Možnosti a cesty (pre expertov) alebo prepojte priečinok v Nastavenia > Hry.
#Časté problémy
- "Star Citizen beží": ukončite hru (aj zo spúšťača) a exportujte znova.
- Väzby skončili na nesprávnej páke: nechajte zapnuté SC: uprednostniť lokálne poradie (predvolené). Keď je vypnuté, sloty sa riadia poradím, v akom Windows hlási zariadenia, a to môže presunúť všetky väzby zariadenia na iné číslo js.
- Zariadenie nedostalo slot: hra má osem slotov pre joysticky. JoyPro zlúči duplicitné položky jednej páky (názov v hre a názov v JoyPro) do jedného slotu, ale viac ako osem pripojených zariadení s väzbami sa nezmestí.
- Predvolená väzba sa vrátila na js1: vráti sa, keď zariadenie na js1 nie je v čase exportu pripojené. Pripojte ho a exportujte znova s Nahradiť.
#Súbory, ktoré JoyPro číta a zapisuje
| Súbor | Čo to je |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
vaše zmenené väzby, sloty joystickov (<options type="joystick" instance="1..8" Product="...">), skupiny možností pre každý slot (invertovanie, exponent, krivka, citlivosť) a možnosti zariadenia (mŕtva zóna, saturácia pre každú fyzickú os) |
...\Profiles\default\attributes.xml |
nastavenia pre celú hru (<Attr name="..." value="..."/>), iba hodnoty, ktoré sa líšia od predvolených hodnôt hry |
...\Profiles\default\actionmaps.jp |
kópia zapísaného súboru od JoyPro s názvami vzťahov ako komentármi, ktorú znova načíta ďalší import |
...\Profiles\default\actionmaps.xml.joypro.json |
nastavenia osí, ktoré JoyPro zapísal naposledy, aby „Aktualizovať“ rozlíšilo hodnotu, ktorú ste zmenili v hre, od vlastnej |
actionmaps.xml.jpbak, attributes.xml.jpbak |
kópie spred prvého zápisu exportu plus úložisko verzovaných záloh JoyPro |
Export upravuje actionmaps.xml na mieste: menia sa iba zmenené väzby lode a nastavenia osí tých väzieb osí, ktoré JoyPro zapisuje. Ostatné mapy akcií, zmenené väzby myši a gamepadu, režimy aktivácie, modifikátory, ostatné skupiny možností a možnosti zariadení zostanú bajt po bajte. Profil bez väzieb pre Star Citizen nechá súbor tak, ako je.
#Sloty joystickov
Star Citizen pomenúva každú väzbu joysticku podľa jej slotu: js1_button3, js2_x. Súbor uvádza, ktoré zariadenie má ktorý slot, podľa názvu produktu a GUID produktu v DirectInput.
- Uprednostniť lokálne poradie (predvolene zapnuté): pripojené zariadenie, ktoré súbor už pomenúva, si ponechá svoj slot. Ostatné zariadenia vyplnia voľné sloty v poradí, v akom ich hlási Windows.
- Jedno zariadenie, jeden slot: rovnaká páka uvedená dvakrát (pod názvom z hry a pod názvom inštancie od JoyPro, alebo stará druhá položka) zaberie jeden slot. Export odstráni duplicitné položky a presunie ich väzby do slotu, ktorý si zariadenie ponechá. Položky zariadení, ktoré nie sú pripojené, zostanú.
- Dve pripojené zariadenia rovnakého modelu zostanú oddelené.
- Zariadenie, ktoré zmení slot, si zoberie so sebou svoje skupiny možností (invertovanie, krivky). Zariadenie, ktoré nedostane žiadny slot, stratí skupiny svojho starého slotu, s upozornením.
#Režimy exportu v Star Citizen
Každý režim mení iba akcie lode. Mapy pre pohyb pešo, vozidlá a menu zostanú bajt po bajte.
| Režim | Čo sa deje v hre |
|---|---|
| Iba pridať | Žiadna väzba hry sa nezmení. Akcia, ktorej slot joysticku už má zmenenú väzbu alebo aktívnu predvolenú väzbu, si ju ponechá. Väzba na vstupe, ktorý používa iná akcia lode, sa nezapíše a dostane označenie „Nezapísané do hry“. |
| Aktualizovať, ponechať väzby hry | Váš vstup ide do slotu joysticku danej akcie (Star Citizen má jeden na akciu a typ vstupu). Väzba hry na vstupe, ktorý dáte inej akcii lode, sa uvoľní: jej zmenená väzba zmizne alebo sa z nej stane prázdne js1_ , keď má akcia predvolenú väzbu, aby sa predvolená väzba nevrátila. |
| Aktualizovať, môj profil vyhráva | Ako vyššie; s možnosťou klávesnice stratí akcia, ktorú priradíte, aj svoju zmenenú väzbu klávesnice. |
| Nahradiť na mojich zariadeniach | Zapísané zariadenia si ponechajú iba vaše väzby lode. So zariadením na js1 sa vypnú predvolené väzby hry na js1, ktoré váš profil nemá. |
| + Vymazať aj moje ostatné zariadenia | Pripojené zariadenia bez väzieb vo vašom profile stratia svoje väzby lode; predvolené väzby js1 sa vypnú, keď sa js1 nepoužíva. |
Možnosti na stránke Export (v časti Možnosti a cesty (pre expertov)):
- SC: ponechať predvolené nastavenia klávesnice (zapnuté): klávesnica si ponechá predvolené klávesy hry. Vypnuté: vaše väzby klávesnice sa zapíšu a predvolené klávesy, ktoré zaberú, sa uvoľnia.
- SC: uprednostniť lokálne poradie (zapnuté): pozrite sloty joystickov vyššie.


#Predvolené väzby joysticku v hre
Star Citizen má predvolené väzby joysticku, ktoré pôsobia na js1, kým akcia nedostane na tomto slote zmenenú väzbu (pitch na Y, yaw na X, roll na rotácii Z, niekoľko tlačidiel). Import berie každú aktívnu predvolenú väzbu ako väzbu zariadenia js1, takže váš profil obsahuje to, čo hra naozaj robí. Export nezapíše zmenenú väzbu pre väzbu, ktorá sa rovná predvolenej (iba skutočné rozdiely). Nahradiť a Vymazať aj moje ostatné zariadenia vypnú predvolené väzby, ktoré váš profil nemá, prázdnou zmenenou väzbou js1_ , presne ako vymazanú väzbu zapisuje vlastné menu hry, a iba keď je zariadenie na js1 pripojené. Takže import a potom Nahradiť + Vymazať aj moje ostatné zariadenia nechá actionmaps.xml tak, ako bol.
#Čoho sa JoyPro nikdy nedotkne
- Väzby pre pohyb pešo, pozemné vozidlá a menu (pozemné vozidlá v Star Citizen sa počítajú ako samostatná trieda vozidiel).
- Zariadenia, ktoré nie sú pripojené: ponechajú si svoj slot a svoje zmenené väzby.
- Zariadenia ignorované pri importe a zariadenie vJoy, do ktorého JoyPro presmerúva.
- Väzby myši a gamepadu; klávesnica, pokiaľ neexportujete väzby klávesnice.
- Režimy aktivácie, modifikátory, ostatné skupiny možností a možnosti zariadení.
#Lode, krivky, nastavenia hry
- Granularita: jedna sada väzieb lode pre všetky lode (hra nemá väzby pre jednotlivé lode).
- Krivky osí, na dvoch miestach, ako ich uchováva hra: mŕtva zóna a saturácia pre každé zariadenie a fyzickú os; invertovanie, exponent (1 až 3), krivka s 11 bodmi a citlivosť pre každý slot a skupinu možností. Exponent a krivka sa navzájom vylučujú, ako v menu hry. Vzťah bez hodnôt pre Star Citizen dostane prispôsobenú krivku z JoyPro: mŕtva zóna a saturácia idú na os zariadenia, zakrivenie sa stane najbližším exponentom, alebo krivkou, keď žiadny exponent nesedí. Jednostranná os neexistuje: absolútny a relatívny plyn hry sú samostatné akcie.
- Aktualizovať ponechá hodnotu osi, ktorú ste zmenili v hre (s upozornením); Nahradiť a môj profil vyhráva nastavia hodnoty z vášho profilu. Neutrálny vzťah ponechá vlastnú hodnotu hry (voľný pohľad si ponechá svoj predvolený exponent 2.5).
- Nastavenia pre celú hru (
attributes.xml): prepínač invertovania ťahu HOTAS, čas a prah zarážky relatívneho plynu, modifikátory citlivosti IFCS, ESP zapnuté, sila a tlmenie, ESP veže, letové predvoľby (sticky throttle, speed limiter, coupled, G-safe, auto precision, space brake), invertovanie letového ovládača a Vibration. Nastavte ich v Nastavenia > Nastavenia Force Feedback hier (vyberte Star Citizen) alebo cezengine ffb set. JoyPro mení iba riadky, ktoré nastavíte, na mieste, a súbor nevytvára. Posuvník sily ESP končí na 1.00, preto JoyPro ponúka 0 až 1. - Force feedback: žiadny. Vibration je jediné také nastavenie hry.
- Sledovanie: väzbu alebo hodnotu osi, ktorú zmeníte v menu hry, JoyPro zaznamená po zatvorení hry a opýta sa, či ju má prevziať. Porovnáva
actionmaps.xml(iba mapy akcií lode) a nastavenia, ktoré JoyPro uchováva vattributes.xml. - HUD: HUD nájde hru podľa jej procesu a zobrazí vaše väzby pre Star Citizen.
#Ako funguje integrácia Star Citizen
flowchart LR
A[("actionmaps.xml")] --> S["Slot na zariadenie"]
D["Pripojené zariadenia"] --> S
P["Váš profil"] --> 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, model osi engine\AxisModels\StarCitizen.cs a model nastavení engine\FfbModels\StarCitizen.cs.
- Názvy zariadení:
Productslotu je názov produktu v DirectInput a GUID produktu, oddelené dvoma medzerami (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Slot alebo blokdeviceoptionszapísaný pod iným názvom (GUID inštancie) hra nerozpozná: prepíše slot svojím produktom a zahodí skupiny možností slotu. JoyPro preto zapisuje názov produktu pripojeného zariadenia. - Zoznam príkazov:
engine db refresh-starcitizenčítaData\Libs\Config\defaultProfile.xmlzData.p4k(alebo z rozbalenej kópie cez--source) doDB\StarCitizen\AllBinds.xml: každú akciu s jej skupinou možností, strom možností joysticku (rodičia a predvolené hodnoty, ktoré skupiny zobrazujú krivku) a predvolený vstup joysticku pre akciu.engine starcitizen labelsberie názvy ovládacích prvkov z hry zo súboruglobal.ini. - Importovať:
engine starcitizen import(--include-keyboard,--device,--ignore-device); každá zmenená väzba osi dostane hodnoty, ktoré hra používa (listovú skupinu slotu, inak najbližšieho rodiča, ktorého ste nastavili, inak predvolenú hodnotu hry) a možnosti zariadenia pre svoju os, ako svoje ladeniegame:StarCitizen.engine starcitizen scanukáže to isté bez zmeny profilu;engine starcitizen list-devicesvypíše sloty joystickov zo súboru. - Export:
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>. Nový blokdeviceoptionside pred prvý<options>; viac vzťahov na jednej skupine možností alebo jednej fyzickej osi s rôznymi hodnotami vyvolá upozornenie a vyhrá prvý vzťah podľa názvu. - Nastavenia hry:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; existujúci riadok dostane hodnotu, nový ide na svoje miesto v zoradení. - Zálohy:
engine backups listvypíše kópie; Vrátiť posledný export na karte obnoví najnovšiu.
#Známe obmedzenia
- Osem slotov joystickov; limit tlačidiel na zariadenie nie je známy (zdroje si odporujú).
- Kde hra chce nový blok
deviceoptions, interpolácia krivky (menu kreslí cez body hladký spline), rozsah exponentu a či sa citlivosť uplatňuje na joysticky, zatiaľ nie je potvrdené. Rozsahy nastavení pre celú hru nie sú v čitateľných súboroch hry. - Či Vibration ovláda páku s Force Feedback cez DirectInput, zatiaľ nie je potvrdené.
- Testy:
engine\tests\smoke\starcitizen.ps1(obnovenie katalógu, import skupín možností a kriviek, import + export bajt po bajte, každé nastavenie osi, konflikty, zmeny slotov,attributes.xmlna mieste); v hretools\e2e\games\StarCitizenSettings.ps1(Options v hlavnom menu: nastavenia, väzby a krivky) atools\e2e\games\StarCitizen.ps1(matica režimov exportu a importu).
Všetky technické poznámky k tejto hre (vygenerované z repozitára): starcitizen.md.