JoyPro2 Discord GitHub
Oyunlar

X4: Foundations

Göster:

X4: Foundations atamalarınızı inputmap.xml dosyasında tutar ve bir joystick'i adıyla değil, yuvasıyla (1 ile 8 arası) adlandırır. Hangi cihazın hangi yuvada olduğu config.xml dosyasındadır. JoyPro uzay uçuşu atamalarını profilinize okur ve X4'ün cihazlarınıza sabitlediği yuvalara, yerinde geri yazar. X4'te ters çevirmeler ve ölü bölge oyun genelidir, bu yüzden JoyPro bunları ilişkilerinize göre tüm oyun için ayarlar.

X4: Foundations doğrudan (kendi atama dosyaları)
Destek
doğrudan (kendi atama dosyaları)
Motor komutu
engine x4
Atama dosyası
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + config.xml içindeki yuvalar
Oyunun okuduğu girişler
joystick başına 64 düğme, 8 eksen, 1 Hat okur (doğrulanmış)
Komut listesinin kaynağı
X4.exe ad tabloları ve .cat/.dat arşivleri
Oyun içi test
36/36 adım geçildi (2026-10-11)
  • ✓ İçe aktar
  • ✓ Dışa aktar
  • ✓ Klavye atamaları
  • ◐ DeğiştiricilerX4: klavye atamalarında Shift/Ctrl; joystick atamaları değiştirici almaz.
  • ✓ Bilgisayarınızda oluşturulan komut listesi
  • ✓ Oyun izleyici
  • ✗ Eksen eğrileri ve ölü bölgelerX4: yalnızca oyun geneli ölü bölge ve ters çevirmeler (Game settings), atama başına hiçbir şey.
  • ✓ 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
X Rebirth yalnızca belgelenmiş
Destek
yalnızca belgelenmiş
Motor komutu
yok
  • — İç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
X3 (Reunion, Terran Conflict, Albion Prelude) yalnızca belgelenmiş
Destek
yalnızca belgelenmiş
Motor komutu
yok
  • — İç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.

Yeni başlayanlar için

#3 adımda çalıştırın

  1. Hepsini benim için kur
    Başlangıç sayfasında
  2. Bu düğmeleri kullan
    önce listeye bakın
  3. Oyunuma yaz
    X4 kapalı kalsın

Önce: her cihaza bir kez yuva verin. X4'ün kontrol ayarlarında Manage Controllers/Joysticks'i açın. Her cihazı bir yuvaya atayın, ardından oyundan normal şekilde çıkın.

Sonra: atamalarınız Settings > Controls altındadır.

Daha önce X4'te 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üğmelere yeni görevler verilir. Bkz. Hızlı başlangıç: kolumu çalıştır.

#JoyPro'nun X4 için yaptıkları

  • İçe aktar: kollarınızın, gaz kollarınızın ve pedallarınızın uzay uçuşu atamaları, oyunun ters çevirmeleri ve gaz moduyla birlikte profilinize gelir.
  • İlişkiler: bir ilişki, her oyunda tek bir işlevdir. "Boost", X4, Elite Dangerous ve Star Citizen'da aynı düğme olabilir.
  • Dışa aktar: JoyPro inputmap.xml dosyasını cihazlarınızın yuvalarında, yerinde düzenler. Menü, birinci şahıs, klavye ve fare atamaları kalır.

#X4 atamalarınızı içe aktarın

  1. Başlangıç sayfasını açın. X4 kartı bir komut listesi isterse Liste Oluştur'a basın: JoyPro oyunun kontrollerini kurulumunuzdan okur (salt okunur).
  2. X4 kartında İçe aktar'a basın. Profilime ekle seçeneğini koruyun. Uçuş tuşlarınızın da JoyPro'da olmasını istiyorsanız Klavye tuşlarını da al kutusunu işaretleyin.
  3. Şimdi içe aktar'a basın. İlişkilerimi gör, gelenleri açar.

#İlişkileri oluşturun ve denetleyin

Oyunlarınızın aynı işlevini ilişki akışı ile birleştirin, ardından Dışa aktar sayfasında Denetle'ye basın. Joystick atamalarınızı değiştiricisiz tutun: X4, bir joystick atamasında değiştirici kabul etmez.

#X4'e dışa aktarma

  1. X4'ü kapatın. Oyun bir oturum bittiğinde inputmap.xml ve config.xml dosyalarını yazar, bu yüzden JoyPro oyun çalışırken yazmayı reddeder.
  2. Dışa aktar sayfasını açın ve X4 kartını işaretleyin.
  3. 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.
Oyunda: X4'te gördükleriniz

Oyunu başlatın ve Settings > Controls sayfasını açın. Atamalarınız, her uzay uçuşu kontrolünün kumanda / joystick sütununda, cihazınızın yuvasındadır. Invert Controller / Joystick Axes, JoyPro'nun ayarladığı ters çevirmeleri gösterir; çift yönlü gaz, joystick ölü bölgesi ve uyarlanabilir yönlendirme satırları da değerlerinizi gösterir. Otomatik yuvarlanma ve titreşim oyun ayarlarındadır.

#X4'te kendiniz yapmanız gerekenler

  • Her cihaza bir kez yuva verin. X4'ün kontrol ayarlarında Manage Controllers/Joysticks'i açın ve her kolu, gaz kolunu ve pedal setini bir yuvaya atayın, ardından oyundan normal şekilde çıkın. X4 böylece cihazı config.xml dosyasında hatırlar. Böyle bir kaydı olmayan bir cihaz bir oturumdan diğerine yuvalar arasında yer değiştirir, bu yüzden JoyPro onu atlar ("assign the device to a slot in X4 once"). Orada "none" olarak ayarlanmış bir cihaz da atlanır.
  • Dışa aktarmadan önce cihazlarınızı takın.

#Sık yapılan hatalar

  • "X4 çalışıyor": oyundan çıkın ve yeniden dışa aktarın.
  • Bir cihaz atlandı: X4'te bir yuvaya sabitlenmemiştir. Onu Manage Controllers/Joysticks altında atayın.
  • 1. yuvadaki bir kol gamepad işleri yapıyor: 1. yuva, X4'ün varsayılan haritasında gamepad yuvasıdır, bu yüzden oradaki bir kol hazır gamepad atamalarını devralır. Cihazlarımda değiştir bunları kaldırır.
  • 64'ün üstündeki düğmeler veya ikinci bir hat hiçbir şey yapmıyor: X4 cihaz başına 64 düğme, 8 eksen ve bir hat okur. JoyPro bunun ötesindeki atamaları bir uyarıyla atlar.
  • Bir ters çevirmeye dokunulmadı: bir ters çevirme, o kontroldeki tüm cihazlar için geçerlidir. İlişkileriniz çeliştiğinde veya aynı kontrole bir gamepad atandığında JoyPro oyunun değerini bırakır ve uyarır.
Gelişmiş

#JoyPro'nun okuduğu ve yazdığı dosyalar

Dosya Nedir
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml etkin atamalar (kontrol ve giriş başına <action>, <state>, <range>) ve <config> parametreleri (ters çevirmeler, ölü bölge, çift yönlü gaz kolu, uyarlanır yönlendirme). <id>, Steam hesabının klasörüdür.
...\X4\<id>\config.xml cihaz yuvaları (<joysticks>) ve titreşim, otomatik yatış ve gamepad modu gibi oyun ayarları; yuvalar için okunur, ayarlar için yerinde düzenlenir
...\X4\<id>\inputmap.xml.joypro-meta.json JoyPro'nun yazılan atamalara ait adları, grupları ve ayarları; bir sonraki içe aktarma bunları geri okur
inputmap.xml.jpbak, config.xml.jpbak ilk yazmadan önceki kopyalar ve JoyPro'nun sürümlü yedek deposu

Dosya metin olarak yazılır: bildirim, satır sonları, girinti, bölüm yorumları, <config>, kök öznitelikleri ve dokunulmayan her satır bayt bayt aynı kalır. Yeni bir satır, bölümünde aynı türden ve daha düşük kontrol numaralı son girdinin arkasına gider. JoyPro kayıtlı profiller inputmap_1.xml ile inputmap_5.xml arasındakilere veya oyun kayıtlarınıza asla dokunmaz. Steam Cloud klasörü eşitler; hangi dosyaları eşitlediği henüz doğrulanmadı.

#X4'te dışa aktarma modları

Çakışma, aynı yuva ve girişte başka bir uçuş kontrolünün olmasıdır. Bir kontrolün harita ve ayrıntı monitörü ikizleri aynı kontrol sayılır.

Mod inputmap.xml içinde ne olur
Yalnızca ekle Hiçbir şey kaldırılmaz. Girişi başka bir uçuş kontrolünde olan bir atama yazılmaz ve "Oyuna yazılmadı" işareti alır.
Güncelle, oyunun atamalarını koru Satırlarınız kontrolün diğer girişlerinin yanına eklenir; yalnızca çakışmalar kaldırılır.
Güncelle, profilim kazanır Yukarıdaki gibi; ayrıca atadığınız bir kontrol, bağlı cihazların sabitlenmiş yuvalarındaki diğer satırlarını kaybeder (klavye seçeneğiyle klavye satırlarını da).
Cihazlarımda değiştir Yazılan yuvaların profilinizde olmayan uçuş atamaları kaldırılır, 1. yuvadaki hazır gamepad uçuş atamaları da.
+ Diğer cihazlarımı da temizle config.xml dosyasının, dışa aktarmanın kullanmadığı bağlı cihazlara sabitlediği yuvalar için de aynısı. Sabitlenmiş cihazı olmayan bir yuvaya dokunulmaz: cihazı bilinmemektedir.

X4'ün menüsü bazı kontrolleri birlikte atar: "Toggle Travel Mode" aynı girişi haritanın içinde de ayarlar, "Dock" ayrıca kenetlenmeyi de çözer. JoyPro bu tür grupları menünün yaptığı gibi yazar ve kaldırır ve birinci şahıs "Interact" ikizini asla kaldırmaz.

#Asla dokunulmayanlar

  • Menü, harita, birinci şahıs, seçenekler ve erişilebilirlik kontrolleri; dairesel menü girdileri.
  • Klavye ve fare satırları; klavye yalnızca klavye seçeneğiyle, yalnızca uçuş kontrolleri için yazılır, X4'ün menüsünün reddettiği tuşlarla (Escape, Delete, Ctrl+X/C/V ...) asla yazılmaz.
  • Bağlı olmayan veya sabitlenmemiş cihazların yuvaları, gamepad'ler, içe aktarmanın yok sayılan cihazları ve JoyPro'nun aktardığı vJoy cihazı.
  • JoyPro'nun ayarlamadığı her <config> satırı.

#Eğriler ve oyun ayarları

  • Ayrıntı düzeyi: her gemi için tek bir atama takımı (uzay uçuşu kontrolleri).
  • Ters çevirmeler, her cihaz için kontrol başına tek bir değerdir (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). İlişkiniz DCS'nin yönünü korur; X4'ün kendi HOTAS haritaları pitch, roll ve gaz kolunu ters çevrilmiş sayar, bu yüzden JoyPro bunlar için parametreyi ters çevirmenizin tersine ayarlar. Bir parametreyi yalnızca o kontroldeki tüm JoyPro eksenleri hemfikirse ayarlar.
  • Çift yönlü gaz kolu, gaz kolu ilişkisinin Kaydırıcı ayarını izler: Kaydırıcı = yalnızca ileri, Kaydırıcı yok = orta nokta sıfır itkidir.
  • Ölü bölge: X4'ün her joystick'in her ekseni için tek bir ölü bölgesi vardır. İlişkilerin ölü bölgeleri yazılmaz (dışa aktarma bunu belirtir); oyunun ölü bölgesini Ayarlar > Oyunların kuvvet geri bildirimi ayarları içinde (X4'ü seçin) veya engine ffb set ile ayarlayın. Aynı yerde uyarlanır yönlendirme, titreşim, otomatik yatış ve gamepad modu da bulunur. Orada kaydettiğiniz bir ayar ilişkilere baskın gelir; onları tersine çevirdiğinde bir uyarı verilir.
  • X4'te eksen başına eğri veya doygunluk yok; kuvvet geri bildirimi yok; telemetri yok.
  • İzleyici: oyunda değiştirdiğiniz bir atama veya seçenek oyun kapandıktan sonra fark edilir (inputmap.xml ve config.xml) ve JoyPro onu devralıp almayacağını sorar.
  • HUD: HUD oyunu işleminden bulur ve X4 atamalarınızı gösterir.

#X Rebirth ve X3

X Rebirth, X4 ile aynı inputmap.xml sözcüklerini kullanır, ancak komut listesi bir kurulumdan kendi çıkarımını gerektirir. X3 (Reunion, Terran Conflict, Albion Prelude) başka bir motora ve bilinmeyen bir dosya biçimine sahiptir. İkisi de yalnızca belgelenmiştir: JoyPro bunları içe veya dışa aktarmaz.

Teknik ayrıntılar

#X4 entegrasyonunun içi

flowchart LR
  D["Cihazınız<br/>(örnek GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Bir yuvaya sabitlenmiş:<br/>yuva 1 ... 8"]
  C --> K["Sabitlenmemiş veya devre dışı:<br/>atlanır; X4'te bir kez<br/>atayın"]
  P["Profiliniz"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>yuva başına atamalar"]
  E --> O["oyun geneli seçenekler:<br/>ters çevirmeler, gaz kolu modu"]
X4 bir joystick'i yuvasına göre adlandırır. Sabit yuvası olmayan bir cihaz atlanır.

Kod: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs ve ayar modeli engine\FfbModels\X4.cs.

  • Yuvalar: bir atama bir kaynağı adlandırır: INPUT_SOURCE_JOYBUTTONS (düğmeler ve Hat) veya INPUT_SOURCE_JOYAXES; 1. yuva için sonek yok, diğerleri için _2 ile _8 arası. config.xml, cihazları DirectInput örnek GUID'i ile yuvalara eşler; bu GUID X4'ün kendi biçiminde yazılır ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); 0 ile 7 arasındaki num yuvadır, disabled="1" yok demektir. JoyPro yalnızca geçerli, etkin girdisi bağlı bir cihazla eşleşen yuvalara yazar.
  • Kodlar: 1 ile 11 arasındaki düğmeler X4'ün gamepad adlarını kullanır (INPUT_XBUTTON_A ... BIGBUTTON), 12 ile 64 arası INPUT_XBUTTON_12 ...; Hat INPUT_XBUTTON_DPAD_* (sekiz yön); eksenler INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Aralıklar sgn almaz. Klavye: _SHIFT / _CONTROL ile INPUT_KEYCODE_<DIK>.
  • Komut listesi: engine x4 refresh-db, gameoptions.lua dosyasını ve İngilizce metin sayfasını .cat/.dat arşivlerinden, ad tablolarını da X4.exe dosyasından yalnızca okuyarak alır; 128 uzay uçuşu kontrolü (6 eksen, 122 düğme). Satırlar "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)" şeklinde görünür. engine x4 catalog onu listeler, engine x4 paths bulunan dosyaları gösterir.
  • İçe / dışa aktarma: engine x4 import, engine x4 scan; engine x4 export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run.
  • Oyun ayarları: engine ffb set --device * --game X4 --param <key>=<value>; parametreler yerinde düzenlenir, eksik olan <config> bölümünün son satırı olarak eklenir. X4 ataması olmayan bir dışa aktarma da kaydedilen ayarları yazar.

#Bilinen sınırlar

  • Sabitlenmiş yuvası olmayan cihazlar atlanır; JoyPro bunları henüz kendisi sabitlemiyor.
  • Joystick değiştiricileri yazılmaz: dosyadaki işaretlemeleri henüz doğrulanmadı.
  • Cihaz başına 64 düğme, 8 eksen ve bir Hat; gamepad'lerle paylaşılan sekiz yuva.
  • Titreşim: oyunun kaydırıcısı değerin 100 katını kırparak gösterir (%21, 20 olarak görünür); dosya tam değeri tutar.
  • Testler: engine\tests\smoke\x4.ps1 (katalog yenileme dahil); oyunda tools\e2e\games\X4.ps1 (atamalar ve mod matrisi, kendi profil klasöründe) ve tools\e2e\games\X4Settings.ps1 (ters çevirmeler, gaz kolu modu, oyun ayarları).

Bu oyunla ilgili tüm teknik notlar (depodan oluşturuldu): x4.md.