JoyPro2 Discord GitHub
Spil

Star Citizen

Vis:

Star Citizen gemmer al din betjening i én fil, actionmaps.xml, og nummererer dine sticks som joystickpladser js1 til js8. JoyPro læser skibstildelingerne fra den fil ind i din profil og skriver dem tilbage på stedet: kun skibshandlingerne og deres akseindstillinger ændres, hver anden linje forbliver, som spillet skrev den. En enhed beholder den plads, spillet allerede gav den, så dine tildelinger ikke hopper fra én stick til en anden.

Star Citizen indbygget (egne tildelingsfiler)
Understøttelse
indbygget (egne tildelingsfiler)
Motorkommando
engine starcitizen
Tildelingsfil
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml (XML)
Kommandoliste fra
Data.p4k (defaultProfile.xml) og dine profiler
Test i spillet
54/54 trin bestået (2026-10-10)
  • ✓ Import
  • ✓ Eksport
  • ✓ Tastaturtildelinger
  • ✓ Modifikatorer
  • ✓ Kommandoliste bygget på din pc
  • ✓ Spilovervågning
  • ✓ Aksekurver og dødzoner
  • ✓ Spillets kontrolindstillinger
  • ✗ Force feedback-indstillinger i spillet
  • ✗ Force feedback fra telemetri
  • ✗ Telemetrioptagelse
  • ✓ Virtuel joystick (vJoy)
  • ◐ Virtuel Xbox-pad
  • ✓ Virtuelle funktioner
  • ✓ Opsætningsguide / Auto-tildeling
  • ✓ Cockpits
  • ✓ Snydeark
  • ✓ Test i spillet

Fra understøttelsesoversigten, genereret ud fra motorens kode: alle spil.

For begyndere

#Sådan virker det på 3 trin

  1. Sæt det hele op for mig
    på siden Start
  2. Brug disse knapper
    se listen først
  3. Skriv til mit spil
    hold Star Citizen lukket

Før: tilslut alle de enheder, du bruger.

Derefter: dine tildelinger ligger i Options > Controls.

Har du tildelt knapper i Star Citizen før? Så tilbyder siden Start Importér, og udfyld så hullerne. Dine tildelinger bliver, og kun ledige knapper får nye opgaver. Se Hurtig start: få min stick til at virke.

#Hvad JoyPro gør for Star Citizen

  • Import: dine skibstildelinger på sticks, throttles og pedaler kommer ind i din profil med deres dødzoner, kurver og inverteringer. Spillets egne standard-joysticktildelinger på js1 kommer også med, så en senere eksport ikke mister dem.
  • Relationer: én relation er én funktion i alle spil. "Landing gear" kan være den samme kontakt i Star Citizen, DCS og Elite Dangerous.
  • Eksport: JoyPro redigerer actionmaps.xml på stedet. Tildelinger til fods, i køretøjer og i menuer samt mus- og gamepadtildelinger forbliver, som de er.

#Importér dine Star Citizen-tildelinger

  1. Åbn Start. Hvis Star Citizen-kortet beder om en kommandoliste, så tryk på Opbyg liste: JoyPro læser spillets handlinger fra din installation (Data.p4k, kun læsning). Efter en spilopdatering tilføjer Opdatér på kortet nye handlinger.
  2. Tryk på Import på Star Citizen-kortet. Behold Føj til min profil. Markér kun Tag også tastaturtasterne, hvis du også vil have dine skibstaster i JoyPro.
  3. Tryk på Importér nu. Se mine relationer åbner det, der kom ind.
Siden Start med dine spilSiden Start med dine spil
Siden Start med dine spil (Billederne viser appen på engelsk.)

#Opbyg og kontrollér relationer

Hver skibshandling er én post i en relation. Forbind den samme funktion i dine andre spil med relationsforløbet, og tryk så på Kontrollér på siden Eksport: den finder en knap, der gør to ting på dit skib, før spillet gør det.

#Eksportér til Star Citizen

  1. Luk Star Citizen. Spillet omskriver actionmaps.xml, når det lukker, så JoyPro nægter at skrive, mens det kører.
  2. Åbn Eksport, og markér Star Citizen-kortet.
  3. Behold Erstat på mine enheder med Ryd også mine andre enheder, hvis det er i JoyPro, du sætter dine sticks op. Tryk på Eksportér nu på kortet.
Siden EksportSiden Eksport
Siden Eksport
I spillet: Hvad du ser i Star Citizen

Start spillet, og åbn Options > Controls fra hovedmenuen. Vælg din enhed (Joystick / HOTAS 1, 2 ...): dens dødzone og mætning er dem, du har sat i JoyPro; Inversion Settings og Joystick Sensitivity Curves (Flight > Flight Movement) viser dine inverteringer, eksponenter og kurver. Dine skibstildelinger ligger på joystickpladsen for hver enhed. Spillets standarder, som JoyPro har slået fra, vises som tomme. Menuen viser mætningen 0,01 højere, end filen indeholder (0,87 vises som 0,88); spillet beholder den nøjagtige værdi.

#Hvad du selv gør i Star Citizen

  • Intet andet for tildelingerne. Tilslut alle de enheder, du bruger, før du eksporterer: en enhed, der ikke er tilsluttet, beholder sin plads og sine tildelinger, men JoyPro kan ikke give den nye.
  • Hvis spillet ligger i en anden mappe end den fundne, så angiv stien én gang på siden Eksport under Valg og stier (for eksperter), eller tilknyt mappen under Indstillinger > Spil.

#Typiske faldgruber

  • "Star Citizen kører": afslut spillet (også fra launcheren), og eksportér igen.
  • Tildelinger er havnet på den forkerte stick: hold SC: foretræk lokal rækkefølge slået til (standard). Slået fra følger pladserne den rækkefølge, Windows melder enhederne i, hvilket kan flytte alle tildelinger på en enhed til et andet js-nummer.
  • En enhed fik ingen plads: spillet har otte joystickpladser. JoyPro slår dobbelte poster for én stick (spillets navn og JoyPros navn) sammen til én plads, men mere end otte tilsluttede enheder med tildelinger kan ikke være der.
  • En standardtildeling kom tilbage på js1: den kommer tilbage, når enheden på js1 ikke er tilsluttet ved eksporten. Tilslut den, og eksportér igen med Erstat.
Avanceret

#Filer, JoyPro læser og skriver

Fil Hvad det er
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml dine omtildelinger, joystick-pladserne (<options type="joystick" instance="1..8" Product="...">), indstillingsgrupperne pr. plads (invertering, eksponent, kurve, følsomhed) og enhedsindstillingerne (dødzone, mætning pr. fysisk akse)
...\Profiles\default\attributes.xml indstillinger for hele spillet (<Attr name="..." value="..."/>), kun de værdier, der afviger fra spillets standarder
...\Profiles\default\actionmaps.jp JoyPros kopi af den skrevne fil med relationsnavne som kommentarer, læses tilbage af næste import
...\Profiles\default\actionmaps.xml.joypro.json de akseindstillinger, JoyPro skrev sidst, så "Opdatér" kan skelne en værdi, du har ændret i spillet, fra dens egen
actionmaps.xml.jpbak, attributes.xml.jpbak kopier fra før en eksports første skrivning plus JoyPros versionerede sikkerhedskopilager

Eksporten redigerer actionmaps.xml på stedet: kun skibsomtildelinger og akseindstillingerne for de akseomtildelinger, JoyPro skriver, ændres. Andre action maps, omtildelinger af mus og gamepad, aktiveringstilstande, modifikatorer, andre indstillingsgrupper og enhedsindstillinger forbliver byte for byte. En profil uden Star Citizen-tildelinger lader filen være, som den er.

#Joystick-pladserne

Star Citizen navngiver hver joysticktildeling efter dens plads: js1_button3, js2_x. Filen angiver, hvilken enhed der har hvilken plads, via enhedens DirectInput-produktnavn og produkt-GUID.

  • Foretræk lokal rækkefølge (slået til som standard): en tilsluttet enhed, som filen allerede nævner, beholder den plads. Andre enheder udfylder de ledige pladser i den rækkefølge, Windows melder dem.
  • Én enhed, én plads: den samme stick opført to gange (under spillets navn og under JoyPros instansnavn, eller en gammel ekstra post) optager én plads. Eksporten fjerner de dobbelte poster og flytter deres tildelinger til den plads, enheden beholder. Poster for enheder, der ikke er tilsluttet, bliver.
  • To tilsluttede enheder af samme model holdes adskilt.
  • En enhed, der skifter plads, tager sine indstillingsgrupper (invertering, kurver) med. En enhed, der ikke får nogen plads, mister grupperne fra sin gamle plads, med en advarsel.

#Eksporttilstandene i Star Citizen

Alle tilstande ændrer kun skibshandlinger. Maps til fods, til køretøjer og til menuer forbliver byte for byte.

Tilstand Hvad der sker i spillet
Kun tilføj Ingen spiltildeling ændres. En handling, hvis joystick-plads allerede har en omtildeling eller en aktiv standard, beholder den. En tildeling på en indgang, som en anden skibshandling bruger, skrives ikke og får mærket "Ikke skrevet til spillet".
Opdatér, behold spillets tildelinger Din indgang går ind på handlingens joystick-plads (Star Citizen har én pr. handling og inputtype). En spiltildeling på en indgang, du giver en anden skibshandling, frigives: dens omtildeling forsvinder eller bliver til en tom js1_ , når handlingen har en standard, så standarden ikke kommer tilbage.
Opdatér, min profil vinder Som ovenfor; med tastaturindstillingen mister en handling, du tildeler, også sin tastaturomtildeling.
Erstat på mine enheder De skrevne enheder beholder kun dine skibstildelinger. Med en enhed på js1 slås spillets js1-standarder, som din profil ikke har, fra.
+ Ryd også mine andre enheder Tilsluttede enheder uden tildelinger i din profil mister deres skibstildelinger; js1's standarder slås fra, når js1 ikke bruges.

Valg på siden Eksport (under Valg og stier (for eksperter)):

  • SC: behold tastaturstandarder (til): tastaturet beholder spillets standardtaster. Fra: dine tastaturtildelinger skrives, og de standardtaster, de optager, frigives.
  • SC: foretræk lokal rækkefølge (til): se joystick-pladserne ovenfor.
Indstillinger og stier (for eksperter) på siden EksportIndstillinger og stier (for eksperter) på siden Eksport
Indstillinger og stier (for eksperter) på siden Eksport

#Spillets standardtildelinger til joystick

Star Citizen har standardtildelinger til joystick, der virker på js1, indtil en handling får en omtildeling der (pitch på Y, yaw på X, roll på Z-rotation, nogle få knapper). Importen tager hver aktiv standard som en tildeling på js1-enheden, så din profil indeholder det, spillet faktisk gør. Eksporten skriver ingen omtildeling for en tildeling, der svarer til standarden (kun reelle forskelle). Erstat og Ryd også slår de standarder, din profil ikke har, fra med en tom omtildeling js1_ , ligesom spillets egen menu skriver en ryddet tildeling, og kun når enheden på js1 er tilsluttet. Så import efterfulgt af Erstat + Ryd også efterlader actionmaps.xml, som den var.

#Det, der aldrig røres

  • Tildelinger til fods, til landkøretøjer og til menuer (Star Citizens landkøretøjer tæller som deres egen køretøjsklasse).
  • Enheder, der ikke er tilsluttet: de beholder deres plads og deres omtildelinger.
  • Importens ignorerede enheder og den vJoy-enhed, JoyPro sender igennem.
  • Tildelinger til mus og gamepad; tastaturet, medmindre du eksporterer tastaturtildelinger.
  • Aktiveringstilstande, modifikatorer, andre indstillingsgrupper og enhedsindstillinger.

#Skibe, kurver, spilindstillinger

  • Granularitet: ét sæt skibstildelinger til alle skibe (spillet har ingen tildelinger pr. skib).
  • Aksekurver, to steder, sådan som spillet gemmer dem: dødzone og mætning pr. enhed og fysisk akse; invertering, eksponent (1 til 3), en kurve med 11 punkter og følsomhed pr. plads og indstillingsgruppe. Eksponent og kurve udelukker hinanden, som i spillets menu. En relation uden Star Citizen-værdier får sin JoyPro-kurve tilpasset: dødzone og mætning går til enhedsaksen, krumningen bliver til den nærmeste eksponent, eller til kurven, når ingen eksponent passer. Der er ingen ensidet akse: spillets absolutte og relative throttle er separate handlinger.
  • Opdatér beholder en akseværdi, du har ændret i spillet (med en advarsel); Erstat og min profil vinder sætter din profils værdier. En neutral relation lader spillets egen værdi være (free look beholder sin standardeksponent 2,5).
  • Indstillinger for hele spillet (attributes.xml): HOTAS-thrust-invertering, den relative throttles trap-tid og -tærskel, IFCS-følsomhedsmodifikatorerne, ESP til, styrke og dæmpning, turret-ESP, flyvestandarderne (sticky throttle, speed limiter, coupled, G-safe, auto precision, space brake), invert flight controller og Vibration. Indstil dem under Indstillinger > Spillenes force feedback-indstillinger (vælg Star Citizen) eller med engine ffb set. JoyPro ændrer kun de linjer, du indstiller, på stedet, og opretter ikke filen. ESP-styrkeskyderen slutter ved 1,00, så JoyPro tilbyder 0 til 1.
  • Force feedback: ingen. Vibration er spillets eneste indstilling af den slags.
  • Overvågning: en tildeling eller akseværdi, du ændrer i spillets menu, opdages, når spillet er lukket, og JoyPro spørger, om den skal overtages. Den sammenligner actionmaps.xml (kun skibets action maps) og de indstillinger, JoyPro har i attributes.xml.
  • HUD: HUD'en finder spillet via dets proces og viser dine Star Citizen-tildelinger.
Teknisk

#Inde i Star Citizen-integrationen

flowchart LR
  A[("actionmaps.xml")] --> S["Plads pr. enhed"]
  D["Tilsluttede enheder"] --> S
  P["Din profil"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
En kendt enhed beholder sin joystick-plads (js1 ... js8 i actionmaps.xml). En ny enhed får den første ledige plads; en forældet dublet fjernes. Skibsomtildelingerne redigeres på stedet, spillets generelle indstillinger går til attributes.xml.

Kode: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, aksemodellen engine\AxisModels\StarCitizen.cs og indstillingsmodellen engine\FfbModels\StarCitizen.cs.

  • Enhedsnavne: pladsens Product er DirectInput-produktnavnet og produkt-GUID'et med to mellemrum imellem (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). En plads eller deviceoptions-blok skrevet under et andet navn (et instans-GUID) genkendes ikke af spillet: det omskriver pladsen med sit produkt og smider pladsens indstillingsgrupper væk. JoyPro skriver derfor den tilsluttede enheds produktnavn.
  • Kommandoliste: engine db refresh-starcitizen læser Data\Libs\Config\defaultProfile.xml fra Data.p4k (eller en udpakket kopi med --source) ind i DB\StarCitizen\AllBinds.xml: hver handling med sin indstillingsgruppe, joystick-indstillingstræet (forældre og standarder, hvilke grupper der viser en kurve) og handlingens standard-joystickindgang. engine starcitizen labels henter spillets navne på styringerne fra global.ini.
  • Import: engine starcitizen import (--include-keyboard, --device, --ignore-device); hver akseomtildeling får de værdier, spillet bruger (pladsens bladgruppe, ellers den nærmeste forælder, du har sat, ellers spillets standard) og enhedsindstillingerne for sin akse, som sin game:StarCitizen-tuning. engine starcitizen scan viser det samme uden at ændre profilen; engine starcitizen list-devices viser filens joystick-pladser.
  • Eksport: 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>. En ny deviceoptions-blok placeres før den første <options>; flere relationer på én indstillingsgruppe eller én fysisk akse med forskellige værdier giver en advarsel, og den første relation efter navn vinder.
  • Spilindstillinger: engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; en eksisterende linje får værdien, en ny placeres på sin sorterede plads.
  • Sikkerhedskopier: engine backups list viser kopierne; Fortryd seneste eksport på kortet gendanner den nyeste.

#Kendte begrænsninger

  • Otte joystick-pladser; knapgrænsen pr. enhed kendes ikke (kilderne er uenige).
  • Hvor spillet vil have en ny deviceoptions-blok, kurveinterpolationen (menuen tegner en glat spline gennem punkterne), eksponentens område, og om følsomhed gælder for joysticks, er endnu ikke bekræftet. Områderne for indstillingerne for hele spillet findes ikke i spillets læsbare filer.
  • Om Vibration styrer en DirectInput-stick med force feedback, er endnu ikke bekræftet.
  • Tests: engine\tests\smoke\starcitizen.ps1 (katalogopdatering, import af indstillingsgrupper og kurver, import + eksport byte for byte, alle akseindstillinger, konflikter, pladsskift, attributes.xml på stedet); i spillet tools\e2e\games\StarCitizenSettings.ps1 (hovedmenuens Options: indstillinger, tildelinger og kurver) og tools\e2e\games\StarCitizen.ps1 (matrix over eksport- og importtilstande).

Alle tekniske noter om dette spil (genereret ud fra repositoriet): starcitizen.md.