Star Citizen tallentaa kaikki ohjauksesi yhteen tiedostoon, actionmaps.xml, ja numeroi ohjainsauvasi joystick-paikoiksi js1–js8. JoyPro lukee tiedoston alusmääritykset profiiliisi ja kirjoittaa ne takaisin paikallaan: vain alustoiminnot ja niiden akseliasetukset muuttuvat, kaikki muut rivit jäävät sellaisiksi kuin peli ne kirjoitti. Laite säilyttää paikan, jonka peli sille jo antoi, joten määrityksesi eivät hyppää ohjainsauvasta toiseen.
Star Citizen natiivi (omat näppäinmääritystiedostot)
- Tuki
- natiivi (omat näppäinmääritystiedostot)
- Moottorin komento
engine starcitizen- Näppäinmääritystiedosto
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Komentoluettelon lähde
Data.p4k(defaultProfile.xml) ja profiilisi- Pelinsisäinen testi
- 54/54 vaihetta läpäisty (2026-10-10)
- ✓ Tuo
- ✓ Vie
- ✓ Näppäimistön näppäinmääritykset
- ✓ Muuntimet
- ✓ Komentoluettelo rakennetaan PC:lläsi
- ✓ Pelien seuranta
- ✓ Akselikäyrät ja kuolleet alueet
- ✓ Pelin ohjainasetukset
- ✗ Pelin voimapalauteasetukset
- ✗ Voimapalaute telemetriasta
- ✗ Telemetrian tallennus
- ✓ Virtuaalinen joystick (vJoy)
- ◐ Virtuaalinen Xbox-ohjain
- ✓ Virtuaaliset toiminnot
- ✓ Ohjattu määritys / Automaattinen määritys
- ✓ Ohjaamot
- ✓ Pikaohjeet
- ✓ Pelinsisäinen testi
Tukimatriisista, joka on luotu moottorin koodista: kaikki pelit.
#Käyttöön 3 vaiheessa
- Tee kaikki puolestani
Alku-sivulla - Käytä näitä painikkeita
katso ensin luettelo - Kirjoita peliini
pidä Star Citizen suljettuna
Ennen: kytke kaikki käyttämäsi laitteet.
Sitten: näppäinmäärityksesi ovat kohdassa Options > Controls.
Oletko aiemmin määrittänyt painikkeita Star Citizenissä? Silloin Alku-sivu tarjoaa vaihtoehdon Tuo ja täytä sitten aukot. Määrityksesi säilyvät, ja vain vapaat painikkeet saavat uusia tehtäviä. Katso Pika-aloitus: saa ohjainsauvani toimimaan.
#Mitä JoyPro tekee Star Citizenille
- Tuo: ohjainsauvojen, kaasuvipujen ja polkimien alusmääritykset tulevat profiiliisi kuolleine alueineen, käyrineen ja kääntöineen. Myös pelin omat oletusarvoiset joystick-määritykset paikassa js1 tuodaan, jotta myöhempi vienti ei kadota niitä.
- Suhteet: yksi suhde on yksi toiminto jokaisessa pelissä. ”Landing gear” voi olla sama kytkin Star Citizenissä, DCS:ssä ja Elite Dangerousissa.
- Vie: JoyPro muokkaa tiedostoa
actionmaps.xmlpaikallaan. Jalkaisin liikkumisen, ajoneuvojen ja valikoiden määritykset sekä hiiren ja peliohjaimen määritykset pysyvät ennallaan.
#Tuo Star Citizenin määrityksesi
- Avaa Alku. Jos Star Citizen -kortti pyytää komentoluetteloa, paina Luo luettelo: JoyPro lukee pelin toiminnot asennuksestasi (
Data.p4k, vain luku). Pelipäivityksen jälkeen kortin Päivitä lisää uudet toiminnot. - Paina Star Citizen -kortin Tuo. Pidä valittuna Lisää profiiliini. Valitse Ota mukaan myös näppäimistön näppäimet vain, jos haluat aluksesi näppäimet myös JoyProhon.
- Paina Tuo nyt. Näytä suhteeni avaa sen, mitä tuli.


#Rakenna ja tarkista suhteet
Jokainen alustoiminto on yksi suhteen kohta. Yhdistä muiden peliesi sama toiminto suhteiden työnkulussa ja paina sitten Tarkista Vie-sivulla: se löytää painikkeen, joka tekee aluksessasi kaksi asiaa, ennen kuin peli huomaa sen.
#Vie Star Citizeniin
- Sulje Star Citizen. Peli kirjoittaa tiedoston
actionmaps.xmluudelleen sulkeutuessaan, joten JoyPro ei kirjoita, kun peli on käynnissä. - Avaa Vie ja valitse Star Citizen -kortti.
- Pidä Korvaa laitteillani ja Tyhjennä myös muut laitteeni valittuina, jos määrität ohjainsauvasi JoyProssa. Paina kortin Vie nyt.


Käynnistä peli ja avaa päävalikosta Options > Controls. Valitse laitteesi (Joystick / HOTAS 1, 2 ...): sen kuollut alue ja saturaatio ovat ne, jotka asetit JoyProssa; Inversion Settings ja Joystick Sensitivity Curves (Flight > Flight Movement) näyttävät kääntösi, eksponenttisi ja käyräsi. Alusmäärityksesi ovat kunkin laitteen joystick-paikassa. Pelin oletukset, jotka JoyPro kytki pois, näkyvät tyhjinä. Valikko näyttää saturaation 0,01 suurempana kuin tiedostossa on (0,87 näkyy 0,88:na); peli säilyttää tarkan arvon.
#Mitä teet itse Star Citizenissä
- Määrityksiin ei tarvita muuta. Kytke kaikki käyttämäsi laitteet ennen vientiä: laite, jota ei ole kytketty, säilyttää paikkansa ja määrityksensä, mutta JoyPro ei voi antaa sille uusia.
- Jos peli on eri kansiossa kuin havaittu, aseta polku kerran Vie-sivulla kohdassa Valinnat ja polut (asiantuntijoille) tai linkitä kansio kohdassa Asetukset > Pelit.
#Yleiset sudenkuopat
- ”Star Citizen on käynnissä”: sulje peli (myös käynnistysohjelmasta) ja vie uudelleen.
- Määritykset menivät väärälle ohjainsauvalle: pidä SC: suosi paikallista järjestystä päällä (oletus). Jos se on pois päältä, paikat noudattavat järjestystä, jossa Windows ilmoittaa laitteet, mikä voi siirtää laitteen kaikki määritykset toiseen js-numeroon.
- Laite ei saanut paikkaa: pelissä on kahdeksan joystick-paikkaa. JoyPro yhdistää saman ohjainsauvan päällekkäiset merkinnät (pelin nimi ja JoyPron nimi) yhdeksi paikaksi, mutta yli kahdeksan kytkettyä laitetta, joilla on määrityksiä, ei mahdu.
- Oletusmääritys palasi paikkaan js1: se palaa, kun js1:n laite ei ole kytkettynä viennin aikana. Kytke se ja vie uudelleen Korvaa-tilassa.
#Tiedostot, joita JoyPro lukee ja kirjoittaa
| Tiedosto | Mikä se on |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
uudelleenmäärityksesi, joystick-paikat (<options type="joystick" instance="1..8" Product="...">), asetusryhmät paikkaa kohden (käännös, eksponentti, käyrä, herkkyys) ja laiteasetukset (kuollut alue, saturaatio fyysistä akselia kohden) |
...\Profiles\default\attributes.xml |
koko pelin asetukset (<Attr name="..." value="..."/>), vain pelin oletuksista poikkeavat arvot |
...\Profiles\default\actionmaps.jp |
JoyPron kopio kirjoitetusta tiedostosta, suhteiden nimet kommentteina; seuraava tuonti lukee sen takaisin |
...\Profiles\default\actionmaps.xml.joypro.json |
akseliasetukset, jotka JoyPro kirjoitti viimeksi, jotta "Päivitä" erottaa pelissä muuttamasi arvon JoyPron omasta |
actionmaps.xml.jpbak, attributes.xml.jpbak |
kopiot ajalta ennen viennin ensimmäistä kirjoitusta sekä JoyPron versioitu varmuuskopiovarasto |
Vienti muokkaa actionmaps.xml-tiedostoa paikallaan: vain alusten uudelleenmääritykset ja JoyPron kirjoittamien akselimääritysten akseliasetukset muuttuvat. Muut toimintokartat, hiiren ja peliohjaimen uudelleenmääritykset, aktivointitilat, muuntimet, muut asetusryhmät ja laiteasetukset säilyvät tavu tavulta. Profiili, jossa ei ole Star Citizen -määrityksiä, jättää tiedoston ennalleen.
#Joystick-paikat
Star Citizen nimeää jokaisen joystick-määrityksen sen paikan mukaan: js1_button3, js2_x. Tiedosto kertoo, mikä laite on missäkin paikassa, laitteen DirectInput-tuotenimen ja tuote-GUID:n perusteella.
- Suosi paikallista järjestystä (oletuksena päällä): kytketty laite, jonka tiedosto jo nimeää, säilyttää paikkansa. Muut laitteet täyttävät vapaat paikat siinä järjestyksessä, jossa Windows ne ilmoittaa.
- Yksi laite, yksi paikka: kahdesti listattu sama ohjainsauva (pelin nimellä ja JoyPron instanssinimellä tai vanhana toisena merkintänä) vie yhden paikan. Vienti poistaa päällekkäiset merkinnät ja siirtää niiden näppäinmääritykset paikkaan, jonka laite säilyttää. Kytkemättömien laitteiden merkinnät säilyvät.
- Kaksi kytkettyä saman mallin laitetta pysyvät erillään.
- Paikkaa vaihtava laite vie asetusryhmänsä (käännös, käyrät) mukanaan. Laite, joka ei saa paikkaa, menettää vanhan paikkansa ryhmät, ja siitä annetaan varoitus.
#Vientitilat Star Citizenissä
Jokainen tila muuttaa vain alusten toimintoja. Jalkaisin liikkumisen, ajoneuvojen ja valikon kartat säilyvät tavu tavulta.
| Tila | Mitä pelissä tapahtuu |
|---|---|
| Vain lisää | Mikään pelin näppäinmääritys ei muutu. Toiminto, jonka joystick-paikassa on jo uudelleenmääritys tai aktiivinen oletus, säilyttää sen. Näppäinmääritystä tuloon, jota toinen alustoiminto käyttää, ei kirjoiteta, ja se saa merkinnän "Ei kirjoitettu peliin". |
| Päivitä, säilytä pelin määritykset | Tulosi menee toiminnon joystick-paikkaan (Star Citizenissä on yksi jokaista toimintoa ja tulotyyppiä kohden). Pelin näppäinmääritys tulossa, jonka annat toiselle alustoiminnolle, vapautetaan: sen uudelleenmääritys poistuu, tai siitä tulee tyhjä js1_ , jos toiminnolla on oletus, jottei oletus palaa. |
| Päivitä, profiilini voittaa | Kuten yllä; näppäimistövalinnan ollessa päällä määrittämäsi toiminto menettää myös näppäimistön uudelleenmäärityksensä. |
| Korvaa laitteillani | Kirjoitetuille laitteille jäävät vain alusmäärityksesi. Kun js1-paikassa on laite, pelin js1-oletukset, joita profiilissasi ei ole, kytketään pois. |
| + Tyhjennä myös muut laitteeni | Kytketyt laitteet, joilla ei ole näppäinmäärityksiä profiilissasi, menettävät alusmäärityksensä; js1:n oletukset kytketään pois, kun js1 ei ole käytössä. |
Valinnat Vie-sivulla (kohdassa Valinnat ja polut (asiantuntijoille)):
- SC: säilytä näppäimistön oletukset (päällä): näppäimistö säilyttää pelin oletusnäppäimet. Pois: näppäimistömäärityksesi kirjoitetaan ja niiden viemät oletusnäppäimet vapautetaan.
- SC: suosi paikallista järjestystä (päällä): katso joystick-paikat yllä.


#Pelin oletusarvoiset joystick-määritykset
Star Citizenissä on oletusarvoisia joystick-määrityksiä, jotka vaikuttavat js1:een, kunnes toiminto saa siellä uudelleenmäärityksen (pitch Y-akselilla, yaw X-akselilla, roll Z-kierrolla, muutama painike). Tuonti ottaa jokaisen aktiivisen oletuksen js1-laitteen näppäinmääritykseksi, joten profiilisi sisältää sen, mitä peli todella tekee. Vienti ei kirjoita uudelleenmääritystä näppäinmääritykselle, joka on sama kuin oletus (vain todelliset erot). Korvaa ja Tyhjennä myös muut laitteeni kytkevät pois oletukset, joita profiilissasi ei ole, tyhjällä uudelleenmäärityksellä js1_ samoin kuin pelin oma valikko kirjoittaa tyhjennetyn määrityksen, ja vain kun js1-paikan laite on kytketty. Tuonti ja sen jälkeen Korvaa + Tyhjennä myös muut laitteeni jättää siis actionmaps.xml-tiedoston ennalleen.
#Mihin ei koskaan kosketa
- Jalkaisin liikkumisen, maa-ajoneuvojen ja valikon näppäinmääritykset (Star Citizenin maa-ajoneuvot ovat oma ajoneuvoluokkansa).
- Laitteet, joita ei ole kytketty: ne säilyttävät paikkansa ja uudelleenmäärityksensä.
- Tuonnissa ohitetut laitteet ja vJoy-laite, johon JoyPro tunneloi.
- Hiiren ja peliohjaimen näppäinmääritykset; näppäimistö, ellet vie näppäimistömäärityksiä.
- Aktivointitilat, muuntimet, muut asetusryhmät ja laiteasetukset.
#Alukset, käyrät, peliasetukset
- Tarkkuus: yksi alusmäärityssarja kaikille aluksille (pelissä ei ole aluskohtaisia näppäinmäärityksiä).
- Akselikäyrät kahdessa paikassa, kuten peli ne säilyttää: kuollut alue ja saturaatio laitetta ja fyysistä akselia kohden; käännös, eksponentti (1–3), 11 pisteen käyrä ja herkkyys paikkaa ja asetusryhmää kohden. Eksponentti ja käyrä sulkevat toisensa pois, kuten pelin valikossa. Suhde, jolla ei ole Star Citizen -arvoja, saa JoyPro-käyränsä sovitettuna: kuollut alue ja saturaatio menevät laitteen akselille, kaarevuudesta tulee lähin eksponentti tai käyrä, jos mikään eksponentti ei sovi. Yksisuuntaista akselia ei ole: pelin absoluuttinen ja suhteellinen kaasu ovat erillisiä toimintoja.
- Päivitä säilyttää pelissä muuttamasi akseliarvon (varoituksen kera); Korvaa ja Profiilini voittaa asettavat profiilisi arvot. Neutraali suhde jättää pelin oman arvon (vapaa katselu säilyttää oletuseksponenttinsa 2.5).
- Koko pelin asetukset (
attributes.xml): HOTAS-työntövoiman käännön vaihto, suhteellisen kaasun pysäytysaika ja kynnys, IFCS-herkkyysmuuntimet, ESP päällä, voimakkuus ja vaimennus, tykkitornin ESP, lennon oletukset (sticky throttle, nopeudenrajoitin, coupled, G-safe, automaattinen tarkkuus, avaruusjarru), lennonohjaimen käännös ja Vibration. Aseta ne kohdassa Asetukset > Pelien voimapalauteasetukset (valitse Star Citizen) tai komennollaengine ffb set. JoyPro muuttaa vain asettamasi rivit, paikallaan, eikä luo tiedostoa. ESP-voimakkuuden liukusäädin päättyy arvoon 1.00, joten JoyPro tarjoaa 0–1. - Voimapalaute: ei ole. Vibration on pelin ainoa tällainen asetus.
- Seuranta: pelin valikossa muuttamasi näppäinmääritys tai akseliarvo huomataan pelin sulkemisen jälkeen, ja JoyPro kysyy, otetaanko se käyttöön. Se vertaa
actionmaps.xml-tiedostoa (vain alusten toimintokartat) ja asetuksia, joita JoyPro hallitseeattributes.xml-tiedostossa. - HUD: HUD tunnistaa pelin sen prosessista ja näyttää Star Citizen -näppäinmäärityksesi.
#Star Citizen -integraation sisältä
flowchart LR
A[("actionmaps.xml")] --> S["Paikka laitetta kohden"]
D["Yhdistetyt laitteet"] --> S
P["Profiilisi"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Koodi: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, akselimalli engine\AxisModels\StarCitizen.cs ja asetusmalli engine\FfbModels\StarCitizen.cs.
- Laitteiden nimet: paikan
Producton DirectInput-tuotenimi ja tuote-GUID kahden välilyönnin päässä toisistaan (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Peli ei tunnista paikkaa taideviceoptions-lohkoa, joka on kirjoitettu toisella nimellä (instanssi-GUID): se kirjoittaa paikan uudelleen tuotteellaan ja hylkää paikan asetusryhmät. Siksi JoyPro kirjoittaa kytketyn laitteen tuotenimen. - Komentoluettelo:
engine db refresh-starcitizenlukee tiedostonData\Libs\Config\defaultProfile.xmlarkistostaData.p4k(tai puretusta kopiosta valitsimella--source) tiedostoonDB\StarCitizen\AllBinds.xml: jokainen toiminto asetusryhmineen, joystick-asetuspuu (ylätasot ja oletukset, mitkä ryhmät näyttävät käyrän) ja toiminnon oletusarvoinen joystick-tulo.engine starcitizen labelsottaa pelin nimet ohjaimille tiedostostaglobal.ini. - Tuo:
engine starcitizen import(--include-keyboard,--device,--ignore-device); jokainen akselin uudelleenmääritys saa pelin käyttämät arvot (paikan alin ryhmä, muuten lähin asettamasi ylätaso, muuten pelin oletus) ja akselinsa laiteasetuksetgame:StarCitizen-säätönään.engine starcitizen scannäyttää saman muuttamatta profiilia;engine starcitizen list-devicesluettelee tiedoston joystick-paikat. - Vie:
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>. Uusideviceoptions-lohko menee ennen ensimmäistä<options>-lohkoa; jos useat suhteet samassa asetusryhmässä tai samalla fyysisellä akselilla antavat eri arvoja, siitä varoitetaan, ja nimen mukaan ensimmäinen suhde voittaa. - Peliasetukset:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; olemassa oleva rivi saa arvon, uusi rivi menee lajittelujärjestyksen mukaiselle paikalleen. - Varmuuskopiot:
engine backups listluettelee kopiot; kortin Kumoa viimeisin vienti palauttaa uusimman.
#Tunnetut rajoitukset
- Kahdeksan joystick-paikkaa; painikkeiden enimmäismäärää laitetta kohden ei tunneta (lähteet ovat ristiriidassa).
- Sitä, mihin peli haluaa uuden
deviceoptions-lohkon, käyrän interpolointia (valikko piirtää pehmeän splinin pisteiden kautta), eksponentin vaihteluväliä ja sitä, koskeeko herkkyys joystickeja, ei ole vielä vahvistettu. Koko pelin asetusten vaihteluvälit eivät ole pelin luettavissa tiedostoissa. - Sitä, ohjaako Vibration DirectInput-voimapalauteohjainsauvaa, ei ole vielä vahvistettu.
- Testit:
engine\tests\smoke\starcitizen.ps1(luettelon päivitys, asetusryhmien ja käyrien tuonti, tuonti + vienti tavu tavulta, jokainen akseliasetus, ristiriidat, paikanvaihdot,attributes.xmlpaikallaan); pelissätools\e2e\games\StarCitizenSettings.ps1(päävalikon Options: asetukset, näppäinmääritykset ja käyrät) jatools\e2e\games\StarCitizen.ps1(vienti- ja tuontitilojen matriisi).
Kaikki tämän pelin tekniset huomiot (luotu repositoriosta): starcitizen.md.