JoyPro2 Discord GitHub
Hry

Star Citizen

Zobrazit:

Star Citizen drží celé vaše ovládání v jednom souboru, actionmaps.xml, a čísluje vaše ovladače jako sloty joysticků js1 až js8. JoyPro načte přiřazení lodi z tohoto souboru do vašeho profilu a zapíše je zpět přímo na místo: mění se jen akce lodi a nastavení jejich os, každý další řádek zůstane, jak ho hra zapsala. Zařízení si ponechá slot, který mu hra už dala, takže vaše přiřazení nepřeskočí z jednoho ovladače na druhý.

Star Citizen nativně (vlastní soubory přiřazení)
Podpora
nativně (vlastní soubory přiřazení)
Příkaz enginu
engine starcitizen
Soubor přiřazení
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml (XML)
Seznam příkazů z
Data.p4k (defaultProfile.xml) a vaše profily
Herní test
54/54 kroků splněno (2026-10-10)
  • ✓ Importovat
  • ✓ Export
  • ✓ Přiřazení klávesnice
  • ✓ Modifikátory
  • ✓ Seznam příkazů sestavený na vašem PC
  • ✓ Sledování her
  • ✓ Křivky os a mrtvé zóny
  • ✓ Nastavení ovládání hry
  • ✗ Herní nastavení zpětné vazby síly
  • ✗ Zpětná vazba síly z telemetrie
  • ✗ Záznam telemetrie
  • ✓ Virtuální joystick (vJoy)
  • ◐ Virtuální gamepad Xbox
  • ✓ Virtuální funkce
  • ✓ Průvodce nastavením / Automatické přiřazení
  • ✓ Kokpity
  • ✓ Taháky
  • ✓ Herní test

Z matice podpory, vygenerované z kódu enginu: všechny hry.

Pro začátečníky

#Zprovozněte to ve 3 krocích

  1. Nastavit vše za mě
    na stránce Start
  2. Použít tato tlačítka
    nejdřív se podívejte na seznam
  3. Zapsat do mé hry
    mějte Star Citizen zavřený

Před: připojte každé zařízení, které používáte.

Pak: vaše přiřazení jsou v Options > Controls.

Přiřazovali jste tlačítka ve Star Citizen už dříve? Pak stránka Start nabídne Importovat, pak doplnit mezery. Vaše přiřazení zůstanou a nové úkoly dostanou jen volná tlačítka. Viz Rychlý start: zprovoznit můj ovladač.

#Co JoyPro dělá pro Star Citizen

  • Importovat: vaše přiřazení lodi na ovladačích, plynových pákách a pedálech přijdou do vašeho profilu, s mrtvými zónami, křivkami a inverzemi. Přijdou i vlastní výchozí přiřazení joysticku hry na js1, takže je pozdější export neztratí.
  • Relace: jedna relace je jedna funkce v každé hře. "Landing gear" může být stejný přepínač ve Star Citizen, DCS a Elite Dangerous.
  • Export: JoyPro upraví actionmaps.xml přímo na místě. Přiřazení pro pohyb pěšky, vozidla a menu, přiřazení myši a gamepadu zůstanou, jak jsou.

#Import přiřazení ze Star Citizen

  1. Otevřete Start. Pokud karta Star Citizen žádá seznam příkazů, stiskněte Sestavit seznam: JoyPro načte akce hry z vaší instalace (Data.p4k, jen čtení). Po patchi hry přidá nové akce Aktualizace na kartě.
  2. Stiskněte Importovat na kartě Star Citizen. Ponechte Přidat do mého profilu. Zaškrtněte Převzít také klávesy klávesnice jen tehdy, když chcete mít v JoyPro i klávesy lodi.
  3. Stiskněte Importovat nyní. Zobrazit moje relace otevře, co přišlo.
Stránka Start s vašimi hramiStránka Start s vašimi hrami
Stránka Start s vašimi hrami (Obrázky ukazují aplikaci v angličtině.)

#Vytvořte a zkontrolujte relace

Každá akce lodi je jedna položka v relaci. Spojte stejnou funkci vašich dalších her pomocí postupu relací, pak stiskněte Zkontrolovat na stránce Export: najde tlačítko, které na vaší lodi dělá dvě věci, dřív než na to přijde hra.

#Export do Star Citizen

  1. Zavřete Star Citizen. Hra při ukončení přepíše actionmaps.xml, takže JoyPro odmítne zapisovat, dokud běží.
  2. Otevřete Export a zaškrtněte kartu Star Citizen.
  3. Ponechte Nahradit na mých zařízeních s Vymazat i má ostatní zařízení, pokud své ovladače nastavujete v JoyPro. Stiskněte Exportovat nyní na kartě.
Stránka ExportStránka Export
Stránka Export
Ve hře: Co uvidíte ve Star Citizen

Spusťte hru a v hlavním menu otevřete Options > Controls. Vyberte své zařízení (Joystick / HOTAS 1, 2 ...): jeho mrtvá zóna a saturace jsou ty, které jste nastavili v JoyPro; Inversion Settings a Joystick Sensitivity Curves (Flight > Flight Movement) ukazují vaše inverze, exponenty a křivky. Vaše přiřazení lodi jsou na slotu joysticku každého zařízení. Výchozí hodnoty hry, které JoyPro vypnul, se ukážou jako prázdné. Menu ukazuje saturaci o 0.01 vyšší, než je v souboru (0.87 se ukáže jako 0.88); hra drží přesnou hodnotu.

#Co ve Star Citizen uděláte sami

  • U přiřazení nic dalšího. Před exportem připojte každé zařízení, které používáte: zařízení, které není připojené, si ponechá svůj slot a svá přiřazení, ale JoyPro mu nemůže dát nová.
  • Pokud je hra v jiné složce, než je ta zjištěná, nastavte cestu jednou na stránce Export v části Možnosti a cesty (pro experty), nebo složku propojte v Nastavení > Hry.

#Časté chyby

  • "Star Citizen běží": ukončete hru (i z launcheru) a exportujte znovu.
  • Přiřazení skončila na špatném ovladači: nechte zapnuté SC: preferovat místní pořadí (výchozí). Když je vypnuté, sloty následují pořadí, v jakém Windows hlásí zařízení, a to může přesunout všechna přiřazení zařízení na jiné číslo js.
  • Zařízení nedostalo slot: hra má osm slotů pro joysticky. JoyPro sloučí duplicitní položky jednoho ovladače (název ze hry a název z JoyPro) do jednoho slotu, ale více než osm připojených zařízení s přiřazeními se nevejde.
  • Na js1 se vrátilo výchozí přiřazení: vrátí se, když zařízení na js1 není při exportu připojené. Připojte ho a exportujte znovu s možností Nahradit.
Pokročilé

#Soubory, které JoyPro čte a zapisuje

Soubor Co to je
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml vaše přepsaná přiřazení, sloty joysticků (<options type="joystick" instance="1..8" Product="...">), skupiny možností pro každý slot (invertování, exponent, křivka, citlivost) a možnosti zařízení (mrtvá zóna, saturace pro každou fyzickou osu)
...\Profiles\default\attributes.xml nastavení pro celou hru (<Attr name="..." value="..."/>), jen hodnoty, které se liší od výchozích hodnot hry
...\Profiles\default\actionmaps.jp kopie zapsaného souboru od JoyPro s názvy relací jako komentáři, kterou načte příští import
...\Profiles\default\actionmaps.xml.joypro.json nastavení os, která JoyPro zapsal naposledy, aby "Aktualizace" poznala hodnotu, kterou jste změnili ve hře, od své vlastní
actionmaps.xml.jpbak, attributes.xml.jpbak kopie z doby před prvním zápisem exportu plus úložiště záloh JoyPro s verzemi

Export upraví actionmaps.xml přímo na místě: změní se jen přepsaná přiřazení lodí a nastavení os u osových přiřazení, která JoyPro zapisuje. Ostatní mapy akcí, přepsaná přiřazení myši a gamepadu, režimy aktivace, modifikátory, ostatní skupiny možností a možnosti zařízení zůstanou bajt po bajtu stejné. Profil bez přiřazení pro Star Citizen nechá soubor, jak je.

#Sloty joysticků

Star Citizen pojmenovává každé přiřazení joysticku podle jeho slotu: js1_button3, js2_x. Soubor uvádí, které zařízení má který slot, podle názvu produktu DirectInput a GUID produktu.

  • Preferovat místní pořadí (ve výchozím stavu zapnuto): připojené zařízení, které soubor už uvádí, si ponechá svůj slot. Ostatní zařízení zaplní volné sloty v pořadí, v jakém je hlásí Windows.
  • Jedno zařízení, jeden slot: stejný ovladač uvedený dvakrát (pod názvem ze hry a pod instančním názvem z JoyPro, nebo starý druhý záznam) zabere jeden slot. Export odstraní duplicitní záznamy a přesune jejich přiřazení do slotu, který si zařízení ponechá. Záznamy zařízení, která nejsou připojená, zůstanou.
  • Dvě připojená zařízení stejného modelu zůstanou oddělená.
  • Zařízení, které změní slot, si vezme své skupiny možností (invertování, křivky) s sebou. Zařízení, které nedostane žádný slot, přijde o skupiny svého starého slotu, s varováním.

#Režimy exportu ve Star Citizen

Každý režim mění jen akce lodí. Mapy pro chůzi, vozidla a menu zůstanou bajt po bajtu stejné.

Režim Co se stane ve hře
Pouze přidat Žádné přiřazení hry se nezmění. Akce, jejíž slot joysticku už obsahuje přepsané přiřazení nebo aktivní výchozí přiřazení, si ho ponechá. Přiřazení na vstupu, který používá jiná akce lodi, se nezapíše a dostane označení "Nezapsáno do hry".
Aktualizovat, ponechat přiřazení hry Váš vstup jde do slotu joysticku dané akce (Star Citizen má jeden na akci a typ vstupu). Přiřazení hry na vstupu, který dáte jiné akci lodi, se uvolní: jeho přepsané přiřazení zmizí, nebo se z něj stane prázdné js1_ , když má akce výchozí přiřazení, aby se výchozí přiřazení nevrátilo.
Aktualizovat, vyhraje můj profil Jako výše; s možností klávesnice přijde akce, kterou přiřadíte, také o své přepsané přiřazení klávesnice.
Nahradit na mých zařízeních Zapsaná zařízení si ponechají jen vaše přiřazení lodí. Se zařízením na js1 se vypnou výchozí přiřazení hry na js1, která váš profil nemá.
+ Vymazat i má ostatní zařízení Připojená zařízení bez přiřazení ve vašem profilu přijdou o svá přiřazení lodí; výchozí přiřazení na js1 se vypnou, když se js1 nepoužívá.

Volby na stránce Export (pod Možnosti a cesty (pro experty)):

  • SC: ponechat výchozí nastavení klávesnice (zapnuto): klávesnice si ponechá výchozí klávesy hry. Vypnuto: vaše přiřazení klávesnice se zapíšou a výchozí klávesy, které zaberou, se uvolní.
  • SC: preferovat místní pořadí (zapnuto): viz sloty joysticků výše.
Možnosti a cesty (pro experty) na stránce ExportMožnosti a cesty (pro experty) na stránce Export
Možnosti a cesty (pro experty) na stránce Export

#Výchozí přiřazení joysticku ve hře

Star Citizen má výchozí přiřazení joysticku, která působí na js1, dokud tam akce nedostane přepsané přiřazení (pitch na Y, yaw na X, roll na rotaci Z, pár tlačítek). Import vezme každé aktivní výchozí přiřazení jako přiřazení zařízení js1, takže váš profil obsahuje to, co hra skutečně dělá. Export nezapíše žádné přepsané přiřazení pro přiřazení, které se rovná výchozímu (jen skutečné rozdíly). Nahradit a Vymazat i má ostatní zařízení vypnou výchozí přiřazení, která váš profil nemá, prázdným přepsaným přiřazením js1_ , stejně jako vymazané přiřazení zapisuje menu samotné hry, a jen když je zařízení na js1 připojené. Import a pak Nahradit + Vymazat i má ostatní zařízení tedy nechá actionmaps.xml tak, jak byl.

#Čeho se nikdy nedotkne

  • Přiřazení pro chůzi, pozemní vozidla a menu (pozemní vozidla Star Citizenu se počítají jako vlastní třída vozidel).
  • Zařízení, která nejsou připojená: ponechají si svůj slot a svá přepsaná přiřazení.
  • Zařízení ignorovaná při importu a zařízení vJoy, do kterého JoyPro posílá.
  • Přiřazení myši a gamepadu; klávesnice, pokud neexportujete přiřazení klávesnice.
  • Režimy aktivace, modifikátory, ostatní skupiny možností a možnosti zařízení.

#Lodě, křivky, nastavení hry

  • Granularita: jedna sada přiřazení lodí pro všechny lodě (hra nemá přiřazení pro jednotlivé lodě).
  • Křivky os, na dvou místech, jak je uchovává hra: mrtvá zóna a saturace pro každé zařízení a fyzickou osu; invertování, exponent (1 až 3), křivka o 11 bodech a citlivost pro každý slot a skupinu možností. Exponent a křivka se navzájem vylučují, jako v menu hry. Relace bez hodnot pro Star Citizen dostane přizpůsobenou křivku z JoyPro: mrtvá zóna a saturace jdou na osu zařízení, zakřivení se stane nejbližším exponentem, nebo křivkou, když žádný exponent nesedí. Jednostranná osa neexistuje: absolutní a relativní plyn hry jsou samostatné akce.
  • Aktualizace ponechá hodnotu osy, kterou jste změnili ve hře (s varováním); Nahradit a vyhraje můj profil nastaví hodnoty vašeho profilu. Neutrální relace ponechá vlastní hodnotu hry (volné rozhlížení si ponechá svůj výchozí exponent 2.5).
  • Nastavení pro celou hru (attributes.xml): přepínač invertování tahu HOTAS, čas a práh pasti relativního plynu, modifikátory citlivosti IFCS, zapnutí ESP, síla a tlumení, ESP věží, výchozí letová nastavení (sticky throttle, omezovač rychlosti, coupled, G-safe, auto precision, vesmírná brzda), invertování letového ovladače a vibrace. Nastavte je v Nastavení > Nastavení zpětné vazby síly her (vyberte Star Citizen) nebo pomocí engine ffb set. JoyPro mění jen řádky, které nastavíte, přímo na místě, a soubor nevytváří. Posuvník síly ESP končí na 1.00, proto JoyPro nabízí 0 až 1.
  • Force feedback: žádný. Vibrace jsou jediným takovým nastavením hry.
  • Sledování: přiřazení nebo hodnota osy, kterou změníte v menu hry, se zaznamená po zavření hry a JoyPro se zeptá, zda ji převzít. Porovnává actionmaps.xml (jen mapy akcí lodí) a nastavení, která JoyPro drží v attributes.xml.
  • HUD: HUD najde hru podle jejího procesu a ukazuje vaše přiřazení pro Star Citizen.
Technické podrobnosti

#Uvnitř integrace Star Citizen

flowchart LR
  A[("actionmaps.xml")] --> S["Slot pro každé zařízení"]
  D["Připojená zařízení"] --> S
  P["Váš profil"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
Známé zařízení si ponechá svůj slot joysticku (js1 ... js8 v actionmaps.xml). Nové zařízení dostane první volný slot; zastaralý duplikát se odstraní. Přepsaná přiřazení lodí se upravují na místě, nastavení pro celou hru jdou do attributes.xml.

Kód: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, model os engine\AxisModels\StarCitizen.cs a model nastavení engine\FfbModels\StarCitizen.cs.

  • Názvy zařízení: Product slotu je název produktu DirectInput a GUID produktu, oddělené dvěma mezerami (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Slot nebo blok deviceoptions zapsaný pod jiným názvem (instanční GUID) hra nerozpozná: přepíše slot svým produktem a zahodí skupiny možností slotu. JoyPro proto zapisuje název produktu připojeného zařízení.
  • Seznam příkazů: engine db refresh-starcitizen načte Data\Libs\Config\defaultProfile.xml z Data.p4k (nebo z rozbalené kopie pomocí --source) do DB\StarCitizen\AllBinds.xml: každou akci s její skupinou možností, strom možností joysticku (rodiče a výchozí hodnoty, které skupiny ukazují křivku) a výchozí vstup joysticku dané akce. engine starcitizen labels převezme názvy ovládacích prvků ze hry z global.ini.
  • Importovat: engine starcitizen import (--include-keyboard, --device, --ignore-device); každé přepsané osové přiřazení dostane hodnoty, které hra používá (koncová skupina slotu, jinak nejbližší nadřazená, kterou jste nastavili, jinak výchozí hodnota hry), a možnosti zařízení své osy jako své ladění game:StarCitizen. engine starcitizen scan ukáže totéž bez změny profilu; engine starcitizen list-devices vypíše sloty joysticků v souboru.
  • 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ý blok deviceoptions jde před první <options>; několik relací na jedné skupině možností nebo jedné fyzické ose s různými hodnotami vyvolá varování a vyhraje první relace podle názvu.
  • Nastavení hry: engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; existující řádek dostane hodnotu, nový jde na své seřazené místo.
  • Zálohy: engine backups list vypíše kopie; Vrátit poslední export na kartě obnoví tu nejnovější.

#Známá omezení

  • Osm slotů joysticků; limit tlačítek na zařízení není známý (zdroje si odporují).
  • Kam hra chce nový blok deviceoptions, interpolace křivky (menu kreslí body hladkou spline), rozsah exponentu a zda se citlivost týká joysticků, zatím není potvrzeno. Rozsahy nastavení pro celou hru nejsou v čitelných souborech hry.
  • Zda vibrace ovládají ovladač se zpětnou vazbou síly přes DirectInput, zatím není potvrzeno.
  • Testy: engine\tests\smoke\starcitizen.ps1 (obnovení katalogu, import skupin možností a křivek, import + export bajt po bajtu, každé nastavení os, konflikty, změny slotů, attributes.xml na místě); ve hře tools\e2e\games\StarCitizenSettings.ps1 (Options v hlavním menu: nastavení, přiřazení a křivky) a tools\e2e\games\StarCitizen.ps1 (matice režimů exportu a importu).

Všechny technické poznámky k této hře (vygenerované z repozitáře): starcitizen.md.