Star Citizen tüm kontrollerinizi tek bir dosyada, actionmaps.xml içinde tutar ve kollarınızı js1 ile js8 arasındaki joystick yuvaları olarak numaralandırır. JoyPro bu dosyanın gemi atamalarını profilinize okur ve yerinde geri yazar: yalnızca gemi eylemleri ve eksen ayarları değişir, diğer her satır oyunun yazdığı gibi kalır. Bir cihaz oyunun ona daha önce verdiği yuvayı korur, böylece atamalarınız bir koldan diğerine atlamaz.
Star Citizen doğrudan (kendi atama dosyaları)
- Destek
- doğrudan (kendi atama dosyaları)
- Motor komutu
engine starcitizen- Atama dosyası
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Komut listesinin kaynağı
Data.p4k(defaultProfile.xml) ve profilleriniz- Oyun içi test
- 54/54 adım geçildi (2026-10-10)
- ✓ İçe aktar
- ✓ Dışa aktar
- ✓ Klavye atamaları
- ✓ Değiştiriciler
- ✓ Bilgisayarınızda oluşturulan komut listesi
- ✓ Oyun izleyici
- ✓ Eksen eğrileri ve ölü bölgeler
- ✓ Oyunun kontrol ayarları
- ✗ Oyun içi kuvvet geri bildirimi ayarları
- ✗ Telemetriden kuvvet geri bildirimi
- ✗ Telemetri kaydı
- ✓ Sanal joystick (vJoy)
- ◐ Sanal Xbox kolu
- ✓ Sanal işlevler
- ✓ Kurulum sihirbazı / Auto Assign
- ✓ Kokpitler
- ✓ Özet kâğıtları
- ✓ Oyun içi test
Motorun kodundan oluşturulan destek tablosundan: tüm oyunlar.
#3 adımda çalıştırın
- Hepsini benim için kur
Başlangıç sayfasında - Bu düğmeleri kullan
önce listeye bakın - Oyunuma yaz
Star Citizen'ı kapalı tutun
Önce: kullandığınız her cihazı takın.
Sonra: atamalarınız Options > Controls içindedir.
Daha önce Star Citizen'da düğme atadınız mı? O zaman Başlangıç sayfası İçe aktar, sonra boşlukları doldur seçeneğini sunar. Atamalarınız kalır, yalnızca boş düğmeler yeni görev alır. Bkz. Hızlı başlangıç: kolumu çalıştır.
#JoyPro Star Citizen için ne yapar
- İçe aktar: kollar, gaz kolları ve pedallardaki gemi atamalarınız, ölü bölgeleri, eğrileri ve ters çevirmeleriyle birlikte profilinize gelir. Oyunun js1 üzerindeki kendi varsayılan joystick atamaları da gelir, böylece sonraki bir dışa aktarma onları kaybetmez.
- İlişkiler: bir ilişki, her oyunda tek bir işlevdir. “Landing gear”, Star Citizen'da, DCS'te ve Elite Dangerous'ta aynı anahtar olabilir.
- Dışa aktar: JoyPro
actionmaps.xmldosyasını yerinde düzenler. Yaya, araç ve menü atamaları, fare ve gamepad atamaları olduğu gibi kalır.
#Star Citizen atamalarınızı içe aktarın
- Başlangıç'ı açın. Star Citizen kartı bir komut listesi isterse Liste Oluştur'a basın: JoyPro oyunun eylemlerini kurulumunuzdan okur (
Data.p4k, yalnızca okuma). Bir oyun yamasından sonra karttaki Güncelle yeni eylemleri ekler. - Star Citizen kartında İçe aktar'a basın. Profilime ekle seçili kalsın. Klavye tuşlarını da al'ı yalnızca gemi tuşlarınızın da JoyPro'da olmasını istiyorsanız işaretleyin.
- Şimdi içe aktar'a basın. İlişkilerimi gör, gelenleri açar.


#İlişkileri oluşturun ve denetleyin
Her gemi eylemi bir ilişkide bir kayıttır. Diğer oyunlarınızın aynı işlevini ilişkiler akışı ile birleştirin, sonra Dışa aktar sayfasında Denetle'ye basın: geminizde iki şey yapan bir düğmeyi oyundan önce bulur.
#Star Citizen'a dışa aktarın
- Star Citizen'ı kapatın. Oyun çıkarken
actionmaps.xmldosyasını yeniden yazar, bu yüzden JoyPro oyun çalışırken yazmayı reddeder. - Dışa aktar'ı açın ve Star Citizen kartını işaretleyin.
- Kollarınızı JoyPro'da kuruyorsanız Cihazlarımda değiştir ile Diğer cihazlarımı da temizle seçili kalsın. Karttaki Şimdi dışa aktar'a basın.


Oyunu başlatın ve ana menüden Options > Controls'u açın. Cihazınızı seçin (Joystick / HOTAS 1, 2 ...): ölü bölgesi ve doygunluğu JoyPro'da ayarladığınız değerlerdir; Inversion Settings ve Joystick Sensitivity Curves (Flight > Flight Movement) ters çevirmelerinizi, üsleri ve eğrileri gösterir. Gemi atamalarınız her cihazın joystick yuvasındadır. JoyPro'nun kapattığı oyun varsayılanları boş görünür. Menü doygunluğu dosyadakinden 0.01 yüksek gösterir (0.87, 0.88 olarak görünür); oyun tam değeri korur.
#Star Citizen'da kendiniz yapmanız gerekenler
- Atamalar için başka bir şey gerekmez. Dışa aktarmadan önce kullandığınız her cihazı takın: bağlı olmayan bir cihaz yuvasını ve atamalarını korur, ama JoyPro ona yenilerini veremez.
- Oyun algılanandan farklı bir klasördeyse yolu bir kez Dışa aktar sayfasında Seçenekler ve yollar (uzmanlar için) altında ayarlayın ya da klasörü Ayarlar > Oyunlar içinde bağlayın.
#Sık yapılan hatalar
- "Star Citizen çalışıyor": oyundan (başlatıcıdan da) çıkın ve yeniden dışa aktarın.
- Atamalar yanlış kola gitti: SC: yerel sırayı tercih et seçeneğini açık tutun (varsayılan). Kapalıyken yuvalar, Windows'un cihazları bildirdiği sırayı izler; bu da bir cihazın tüm atamalarını başka bir js numarasına kaydırabilir.
- Bir cihaz yuva alamadı: oyunda sekiz joystick yuvası vardır. JoyPro, tek bir kolun yinelenen girdilerini (oyunun verdiği ad ve JoyPro'nun verdiği ad) tek bir yuvada birleştirir, ancak atama içeren sekizden fazla bağlı cihaz sığmaz.
- Varsayılan bir atama js1'de geri geldi: dışa aktarma sırasında js1'deki cihaz bağlı değilse geri gelir. Cihazı bağlayın ve Değiştir ile yeniden dışa aktarın.
#JoyPro'nun okuduğu ve yazdığı dosyalar
| Dosya | Nedir |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
yeniden atamalarınız, joystick yuvaları (<options type="joystick" instance="1..8" Product="...">), yuva başına seçenek grupları (ters çevirme, üs, eğri, hassasiyet) ve cihaz seçenekleri (fiziksel eksen başına ölü bölge, doygunluk) |
...\Profiles\default\attributes.xml |
oyun genelindeki ayarlar (<Attr name="..." value="..."/>), yalnızca oyunun varsayılanlarından farklı olan değerler |
...\Profiles\default\actionmaps.jp |
JoyPro'nun yazılan dosyanın kopyası, ilişki adları yorum olarak; bir sonraki içe aktarma tarafından geri okunur |
...\Profiles\default\actionmaps.xml.joypro.json |
JoyPro'nun en son yazdığı eksen ayarları; böylece "Güncelle" oyunda değiştirdiğiniz bir değeri kendi değerinden ayırt edebilir |
actionmaps.xml.jpbak, attributes.xml.jpbak |
bir dışa aktarmanın ilk yazmasından önceki kopyalar, artı JoyPro'nun sürümlü yedek deposu |
Dışa aktarma actionmaps.xml dosyasını yerinde düzenler: yalnızca gemi yeniden atamaları ve JoyPro'nun yazdığı eksen yeniden atamalarının eksen ayarları değişir. Diğer eylem haritaları, fare ve gamepad yeniden atamaları, etkinleştirme modları, değiştiriciler, diğer seçenek grupları ve cihaz seçenekleri bayt bayt aynı kalır. Star Citizen ataması olmayan bir profil dosyayı olduğu gibi bırakır.
#Joystick yuvaları
Star Citizen her joystick atamasını yuvasına göre adlandırır: js1_button3, js2_x. Dosya, hangi cihazın hangi yuvayı tuttuğunu cihazın DirectInput ürün adı ve ürün GUID'iyle listeler.
- Yerel sırayı tercih et (varsayılan olarak açık): dosyanın zaten adlandırdığı bağlı bir cihaz o yuvayı korur. Diğer cihazlar boş yuvaları Windows'un bildirdiği sırayla doldurur.
- Bir cihaz, bir yuva: iki kez listelenen aynı kol (oyunun verdiği ad ve JoyPro'nun örnek adı altında ya da eski bir ikinci girdi) tek bir yuva alır. Dışa aktarma yinelenen girdileri kaldırır ve atamalarını cihazın koruduğu yuvaya taşır. Bağlı olmayan cihazların girdileri kalır.
- Aynı modelden iki bağlı cihaz ayrı kalır.
- Yuva değiştiren bir cihaz seçenek gruplarını (ters çevirme, eğriler) yanında götürür. Yuva alamayan bir cihaz, eski yuvasının gruplarını bir uyarıyla kaybeder.
#Star Citizen'da dışa aktarma modları
Her mod yalnızca gemi eylemlerini değiştirir. Yaya, araç ve menü haritaları bayt bayt aynı kalır.
| Mod | Oyunda ne olur |
|---|---|
| Yalnızca ekle | Hiçbir oyun ataması değişmez. Joystick yuvasında zaten bir yeniden atama veya etkin bir varsayılan bulunan bir eylem onu korur. Başka bir gemi eyleminin kullandığı bir girişteki atama yazılmaz ve "Oyuna yazılmadı" işareti alır. |
| Güncelle, oyunun atamalarını koru | Girişiniz eylemin joystick yuvasına gider (Star Citizen'da eylem ve giriş türü başına bir yuva vardır). Başka bir gemi eylemine verdiğiniz bir girişteki oyun ataması serbest bırakılır: yeniden ataması silinir veya eylemin bir varsayılanı varsa boş bir js1_ olur, böylece varsayılan geri gelmez. |
| Güncelle, profilim kazanır | Yukarıdaki gibi; klavye seçeneğiyle, atadığınız bir eylem klavye yeniden atamasını da kaybeder. |
| Cihazlarımda değiştir | Yazılan cihazlar yalnızca gemi atamalarınızı korur. js1'de bir cihaz varsa, oyunun profilinizde olmayan js1 varsayılanları kapatılır. |
| + Diğer cihazlarımı da temizle | Profilinizde ataması olmayan bağlı cihazlar gemi atamalarını kaybeder; js1 kullanılmadığında js1'in varsayılanları kapatılır. |
Dışa aktar sayfasındaki seçenekler (Seçenekler ve yollar (uzmanlar için) altında):
- SC: klavye varsayılanlarını koru (açık): klavye oyunun varsayılan tuşlarını korur. Kapalı: klavye atamalarınız yazılır ve aldıkları varsayılan tuşlar serbest bırakılır.
- SC: yerel sırayı tercih et (açık): yukarıdaki joystick yuvalarına bakın.


#Oyunun varsayılan joystick atamaları
Star Citizen'ın, bir eylem orada yeniden atama alana kadar js1 üzerinde çalışan varsayılan joystick atamaları vardır (Y'de pitch, X'te yaw, Z dönüşünde roll, birkaç düğme). İçe aktarma her etkin varsayılanı js1 cihazının bir ataması olarak alır, böylece profiliniz oyunun gerçekte yaptığını tutar. Dışa aktarma, varsayılana eşit bir atama için yeniden atama yazmaz (yalnızca gerçek farklar). Değiştir ve Diğer cihazlarımı da temizle, profilinizde olmayan varsayılanları, oyunun kendi menüsünün temizlenmiş bir atamayı yazdığı gibi boş bir js1_ yeniden atamasıyla kapatır; bunu da yalnızca js1'deki cihaz bağlıyken yapar. Böylece içe aktarma, ardından Değiştir + Diğer cihazlarımı da temizle, actionmaps.xml dosyasını olduğu gibi bırakır.
#Asla dokunulmayanlar
- Yaya, kara aracı ve menü atamaları (Star Citizen'ın kara araçları kendi araç sınıfı sayılır).
- Bağlı olmayan cihazlar: yuvalarını ve yeniden atamalarını korurlar.
- İçe aktarmanın yok sayılan cihazları ve JoyPro'nun tünel açtığı vJoy cihazı.
- Fare ve gamepad atamaları; klavye atamalarını dışa aktarmadığınız sürece klavye.
- Etkinleştirme modları, değiştiriciler, diğer seçenek grupları ve cihaz seçenekleri.
#Gemiler, eğriler, oyun ayarları
- Ayrıntı düzeyi: her gemi için tek bir gemi atama takımı (oyunda gemi başına atama yoktur).
- Eksen eğrileri, oyunun tuttuğu gibi iki yerde: cihaz ve fiziksel eksen başına ölü bölge ve doygunluk; yuva ve seçenek grubu başına ters çevirme, üs (1 ile 3 arası), 11 noktalı bir eğri ve hassasiyet. Oyunun menüsünde olduğu gibi üs ve eğri birbirini dışlar. Star Citizen değerleri olmayan bir ilişkiye JoyPro eğrisi uyarlanır: ölü bölge ve doygunluk cihaz eksenine gider, eğrilik en yakın üs olur ya da hiçbir üs uymuyorsa eğri olur. Tek yönlü eksen yoktur: oyunun mutlak ve göreli gaz kolu ayrı eylemlerdir.
- Güncelle, oyunda değiştirdiğiniz bir eksen değerini korur (bir uyarıyla); Değiştir ve profilim kazanır profilinizin değerlerini ayarlar. Nötr bir ilişki oyunun kendi değerini bırakır (serbest bakış varsayılan üssü 2.5'i korur).
- Oyun genelindeki ayarlar (
attributes.xml): HOTAS itki ters çevirme anahtarı, göreli gaz kolu tuzak süresi ve eşiği, IFCS hassasiyet değiştiricileri, ESP açık, gücü ve sönümlemesi, taret ESP'si, uçuş varsayılanları (sticky throttle, speed limiter, coupled, G-safe, auto precision, space brake), uçuş denetleyicisini ters çevirme ve Vibration. Bunları Ayarlar > Oyunların kuvvet geri bildirimi ayarları içinde (Star Citizen'ı seçin) veyaengine ffb setile ayarlayın. JoyPro yalnızca ayarladığınız satırları yerinde değiştirir ve dosyayı oluşturmaz. ESP gücü kaydırıcısı 1.00'da biter, bu yüzden JoyPro 0 ile 1 arasını sunar. - Force feedback: yok. Vibration oyunun bu türdeki tek ayarıdır.
- İzleyici: oyunun menüsünde değiştirdiğiniz bir atama veya eksen değeri oyun kapandıktan sonra fark edilir ve JoyPro onu devralıp almayacağını sorar.
actionmaps.xmldosyasını (yalnızca gemi eylem haritaları) ve JoyPro'nunattributes.xmliçinde tuttuğu ayarları karşılaştırır. - HUD: HUD oyunu işleminden bulur ve Star Citizen atamalarınızı gösterir.
#Star Citizen entegrasyonunun içi
flowchart LR
A[("actionmaps.xml")] --> S["Cihaz başına yuva"]
D["Bağlı cihazlar"] --> S
P["Profiliniz"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Kod: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, eksen modeli engine\AxisModels\StarCitizen.cs ve ayar modeli engine\FfbModels\StarCitizen.cs.
- Cihaz adları: yuvanın
Productdeğeri, aralarında iki boşluk bulunan DirectInput ürün adı ve ürün GUID'idir (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Başka bir ad (bir örnek GUID'i) altında yazılmış bir yuva veyadeviceoptionsbloğu oyun tarafından tanınmaz: oyun yuvayı kendi ürün adıyla yeniden yazar ve yuvanın seçenek gruplarını atar. Bu yüzden JoyPro bağlı cihazın ürün adını yazar. - Komut listesi:
engine db refresh-starcitizen,Data\Libs\Config\defaultProfile.xmldosyasınıData.p4kiçinden (veya--sourceile çıkarılmış bir kopyadan) okuyupDB\StarCitizen\AllBinds.xmldosyasına yazar: seçenek grubuyla birlikte her eylem, joystick seçenek ağacı (üst öğeler ve varsayılanlar, hangi grupların eğri gösterdiği) ve eylemin varsayılan joystick girişi.engine starcitizen labels, kontrollerin oyundaki adlarınıglobal.inidosyasından alır. - İçe aktar:
engine starcitizen import(--include-keyboard,--device,--ignore-device); her eksen yeniden ataması, oyunun kullandığı değerleri (yuvanın yaprak grubu, yoksa ayarladığınız en yakın üst öğe, yoksa oyunun varsayılanı) ve ekseninin cihaz seçeneklerinigame:StarCitizenayarı olarak alır.engine starcitizen scanprofili değiştirmeden aynısını gösterir;engine starcitizen list-devicesdosyanın joystick yuvalarını listeler. - Dışa aktar:
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>. Yeni birdeviceoptionsbloğu ilk<options>öğesinden önce gelir; aynı seçenek grubunda veya aynı fiziksel eksende farklı değerlere sahip birkaç ilişki bir uyarı verir ve ada göre ilk ilişki kazanır. - Oyun ayarları:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; mevcut bir satır değeri alır, yeni bir satır sıralı yerine gider. - Yedekler:
engine backups listkopyaları listeler; karttaki Son dışa aktarmayı geri al en yenisini geri yükler.
#Bilinen sınırlar
- Sekiz joystick yuvası; cihaz başına düğme sınırı bilinmiyor (kaynaklar çelişiyor).
- Oyunun yeni bir
deviceoptionsbloğunu nerede istediği, eğri ara değerlemesi (menü noktalardan geçen yumuşak bir spline çizer), üs aralığı ve hassasiyetin joystick'lere uygulanıp uygulanmadığı henüz doğrulanmadı. Oyun genelindeki ayarların aralıkları oyunun okunabilir dosyalarında yer almıyor. - Vibration'ın DirectInput kuvvet geri bildirimli bir kolu sürüp sürmediği henüz doğrulanmadı.
- Testler:
engine\tests\smoke\starcitizen.ps1(katalog yenileme, seçenek grupları ve eğrilerin içe aktarılması, bayt bayt içe aktarma + dışa aktarma, her eksen ayarı, çakışmalar, yuva değişiklikleri, yerindeattributes.xml); oyundatools\e2e\games\StarCitizenSettings.ps1(ana menü Options: ayarlar, atamalar ve eğriler) vetools\e2e\games\StarCitizen.ps1(dışa ve içe aktarma modu matrisi).
Bu oyunla ilgili tüm teknik notlar (depodan oluşturuldu): starcitizen.md.