JoyPro2 Discord GitHub
Igre

X4: Foundations

Prikaži:

X4: Foundations hrani vaše vezave v inputmap.xml in joystick poimenuje po njegovem mestu (1 do 8), ne po imenu. Katera naprava je na katerem mestu, je v config.xml. JoyPro prebere vezave vesoljskega letenja v vaš profil in jih zapiše nazaj na mestu, na mesta, ki jih je X4 pripel vašim napravam. Obrati in mrtva cona v X4 veljajo za celo igro, zato jih JoyPro iz vaših relacij nastavi za celo igro.

X4: Foundations neposredno (lastne datoteke vezav)
Podpora
neposredno (lastne datoteke vezav)
Ukaz pogona
engine x4
Datoteka vezav
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + mesta v config.xml
Vhodi, ki jih igra bere
bere 64 gumbov, 8 osi, 1 Hat na joystick (preverjeno)
Seznam ukazov iz
tabele imen v X4.exe in arhivi .cat/.dat
Preizkus v igri
36/36 korakov opravljenih (2026-10-11)
  • ✓ Uvozi
  • ✓ Izvozi
  • ✓ Vezave tipkovnice
  • ◐ ModifikatorjiX4: Shift/Ctrl na vezavah tipkovnice; vezave joysticka ne sprejmejo modifikatorja.
  • ✓ Seznam ukazov, zgrajen na vašem PC-ju
  • ✓ Spremljevalec iger
  • ✗ Krivulje osi in mrtve coneX4: samo skupna mrtva cona igre in obračanja (Game settings), nič na vezavo.
  • ✓ Nastavitve kontrol igre
  • ✗ Nastavitve povratne sile v igri
  • ✗ Povratna sila iz telemetrije
  • ✗ Snemanje telemetrije
  • ✓ Virtualni joystick (vJoy)
  • ◐ Virtualni Xbox pad
  • ✓ Virtualne funkcije
  • ✓ Čarovnik za nastavitev / Samodejna dodelitev
  • ✓ Kokpiti
  • ✓ Pregledni listi
  • ✓ Preizkus v igri
X Rebirth samo dokumentirano
Podpora
samo dokumentirano
Ukaz pogona
brez
  • — Uvozi
  • — Izvozi
  • — Vezave tipkovnice
  • — Modifikatorji
  • — Seznam ukazov, zgrajen na vašem PC-ju
  • — Spremljevalec iger
  • — Krivulje osi in mrtve cone
  • — Nastavitve kontrol igre
  • — Nastavitve povratne sile v igri
  • — Povratna sila iz telemetrije
  • — Snemanje telemetrije
  • — Virtualni joystick (vJoy)
  • — Virtualni Xbox pad
  • — Virtualne funkcije
  • — Čarovnik za nastavitev / Samodejna dodelitev
  • — Kokpiti
  • — Pregledni listi
  • — Preizkus v igri
X3 (Reunion, Terran Conflict, Albion Prelude) samo dokumentirano
Podpora
samo dokumentirano
Ukaz pogona
brez
  • — Uvozi
  • — Izvozi
  • — Vezave tipkovnice
  • — Modifikatorji
  • — Seznam ukazov, zgrajen na vašem PC-ju
  • — Spremljevalec iger
  • — Krivulje osi in mrtve cone
  • — Nastavitve kontrol igre
  • — Nastavitve povratne sile v igri
  • — Povratna sila iz telemetrije
  • — Snemanje telemetrije
  • — Virtualni joystick (vJoy)
  • — Virtualni Xbox pad
  • — Virtualne funkcije
  • — Čarovnik za nastavitev / Samodejna dodelitev
  • — Kokpiti
  • — Pregledni listi
  • — Preizkus v igri

Iz matrike podpore, ustvarjene iz kode pogona: vse igre.

Za začetnike

#Do delovanja v 3 korakih

  1. Nastavi vse namesto mene
    na strani Začetek
  2. Uporabi te gumbe
    najprej poglejte seznam
  3. Zapiši v mojo igro
    X4 naj bo zaprt

Prej: vsaki napravi enkrat dodelite mesto. V nastavitvah kontrol X4 odprite Manage Controllers/Joysticks. Vsako napravo dodelite mestu, nato igro normalno zapustite.

Potem: vaše vezave so v Settings > Controls.

Ste že prej vezali gumbe v X4? Potem vam Začetek ponudi Uvozi, nato zapolni vrzeli. Vaše vezave ostanejo, nove naloge dobijo samo prosti gumbi. Glejte Hitri začetek: naj moja palica deluje.

#Kaj JoyPro naredi za X4

  • Uvozi: vezave vesoljskega letenja vaših palic, plinskih ročic in pedal pridejo v vaš profil, z igrinimi obrati in načinom plina.
  • Relacije: ena relacija je ena funkcija v vsaki igri. „Boost“ je lahko isti gumb v X4, Elite Dangerous in Star Citizen.
  • Izvozi: JoyPro ureja inputmap.xml na mestu, na mestih vaših naprav. Vezave za menije, prvoosebni pogled, tipkovnico in miško ostanejo.

#Uvozite svoje vezave iz X4

  1. Odprite Začni. Če kartica X4 zahteva seznam ukazov, pritisnite Zgradi seznam: JoyPro prebere kontrole igre iz vaše namestitve (samo branje).
  2. Na kartici X4 pritisnite Uvozi. Pustite Dodaj mojemu profilu. Označite Prevzemi tudi tipke tipkovnice, če želite tudi letalske tipke v JoyPro.
  3. Pritisnite Uvozi zdaj. Poglej moje relacije odpre, kar je prišlo noter.

#Zgradite in preverite relacije

Isto funkcijo vaših iger združite s potekom relacij, nato na strani Izvoz pritisnite Preveri. Vezave joysticka imejte brez modifikatorjev: X4 na vezavi joysticka ne sprejme modifikatorja.

#Izvoz v X4

  1. Zaprite X4. Igra ob koncu seje zapiše inputmap.xml in config.xml, zato JoyPro noče pisati, dokler teče.
  2. Odprite Izvozi in označite kartico X4.
  3. Pustite Zamenjaj na mojih napravah z Počisti tudi moje druge naprave, če palice nastavljate v JoyPro. Na kartici pritisnite Izvozi zdaj.
V igri: Kaj vidite v X4

Zaženite igro in odprite Settings > Controls. Vaše vezave so v stolpcu controller / joystick vsake kontrole vesoljskega letenja, na mestu vaše naprave. Invert Controller / Joystick Axes pokaže obrate, ki jih je nastavil JoyPro, vrstice za dvosmerni plin, mrtvo cono joysticka in prilagodljivo krmiljenje pa pokažejo vaše vrednosti. Samodejno valjanje in vibriranje sta v nastavitvah igre.

#Kaj v X4 naredite sami

  • Vsaki napravi enkrat dodelite mesto. V nastavitvah kontrol X4 odprite Manage Controllers/Joysticks in vsako palico, plinsko ročico in komplet pedal dodelite mestu, nato igro normalno zapustite. X4 si nato napravo zapomni v config.xml. Naprava brez takega vnosa se od ene seje do druge seli med mesti, zato jo JoyPro preskoči („assign the device to a slot in X4 once“). Preskočena je tudi naprava, ki je tam nastavljena na „none“.
  • Pred izvozom priključite svoje naprave.

#Pogoste pasti

  • „X4 teče“: zaprite igro in znova izvozite.
  • Naprava je bila preskočena: v X4 ni pripeta na mesto. Dodelite jo pod Manage Controllers/Joysticks.
  • Palica na mestu 1 počne stvari igralnega pada: mesto 1 je mesto igralnega pada v privzetem zemljevidu X4, zato palica tam podeduje privzete vezave pada. Zamenjaj na mojih napravah jih odstrani.
  • Gumbi nad 64 ali drugi hat ne naredijo ničesar: X4 bere 64 gumbov, 8 osi in en hat na napravo. JoyPro vezave čez to mejo z opozorilom preskoči.
  • Obrat je ostal nespremenjen: en obrat velja za vse naprave na tej kontroli. Ko se vaše relacije ne ujemajo ali je na isto kontrolo vezan igralni pad, JoyPro pusti vrednost igre in opozori.
Napredno

#Datoteke, ki jih JoyPro bere in piše

Datoteka Kaj je to
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml dejavne vezave (<action>, <state>, <range> za vsako kontrolo in vhod) in parametri <config> (obrati, mrtva cona, dvosmerni plin, prilagodljivo krmiljenje). <id> je mapa računa Steam.
...\X4\<id>\config.xml mesta naprav (<joysticks>) in nastavitve igre, kot so vibriranje, samodejno valjanje in način igralnega ploščka; bere se zaradi mest, za nastavitve pa se ureja na mestu
...\X4\<id>\inputmap.xml.joypro-meta.json imena, skupine in nastavitve osi zapisanih vezav iz JoyPro, ki jih naslednji uvoz prebere nazaj
inputmap.xml.jpbak, config.xml.jpbak kopije izpred prvega zapisa in JoyPro-jeva shramba varnostnih kopij z različicami

Datoteka se zapiše kot besedilo: deklaracija, konci vrstic, zamiki, komentarji razdelkov, <config>, atributi korena in vsaka nedotaknjena vrstica ostanejo bajt za bajtom. Nova vrstica gre v svoj razdelek za zadnji vnos iste vrste z nižjo številko kontrole. JoyPro se nikoli ne dotakne shranjenih profilov inputmap_1.xml do inputmap_5.xml ali vaših shranjenih iger. Steam Cloud sinhronizira mapo; katere datoteke sinhronizira, še ni potrjeno.

#Načini izvoza v X4

Konflikt je druga letalska kontrola na istem mestu in vhodu. Dvojčka kontrole za karto in podrobni monitor štejeta kot ista kontrola.

Način Kaj se zgodi v inputmap.xml
Samo dodaj Nič se ne odstrani. Vezava, katere vhod ima druga letalska kontrola, se ne zapiše in dobi oznako "Ni zapisano v igro".
Posodobi, ohrani vezave igre Vaše vrstice gredo poleg drugih vhodov kontrole; odstranijo se samo konflikti.
Posodobi, moj profil prevlada Kot zgoraj, poleg tega pa kontrola, ki jo vežete, izgubi svoje druge vrstice na pripetih mestih priključenih naprav (z možnostjo za tipkovnico tudi svoje vrstice tipkovnice).
Zamenjaj na mojih napravah Letalske vezave zapisanih mest, ki niso v vašem profilu, se odstranijo, tudi tovarniške letalske vezave igralnega ploščka na mestu 1.
+ Počisti tudi moje druge naprave Enako za mesta, ki jih config.xml pripne na priključene naprave, ki jih izvoz ne uporablja. Mesto brez pripete naprave ostane nedotaknjeno: njegova naprava ni znana.

Meni X4 nekatere kontrole veže skupaj: "Toggle Travel Mode" isti vhod nastavi tudi znotraj karte, "Dock" tudi odklopi. JoyPro takšne skupine zapisuje in odstranjuje tako kot meni in nikoli ne odstrani dvojčka "Interact" za prvoosebni pogled.

#Česa se nikoli ne dotakne

  • Kontrole za meni, karto, prvoosebni pogled, možnosti in dostopnost; vnosi krožnega menija.
  • Vrstice tipkovnice in miške; tipkovnica se zapiše samo z možnostjo za tipkovnico, samo za letalske kontrole, nikoli s tipkami, ki jih meni X4 zavrne (Escape, Delete, Ctrl+X/C/V ...).
  • Mesta naprav, ki niso priključene ali niso pripete, igralni ploščki, naprave, ki jih uvoz prezre, in naprava vJoy, v katero pošilja JoyPro.
  • Vsaka vrstica <config>, ki je JoyPro ne nastavi.

#Krivulje in nastavitve igre

  • Razdrobljenost: en nabor vezav za vse ladje (kontrole vesoljskega letenja).
  • Obrati so ena vrednost na kontrolo za vse naprave (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Vaša relacija ohrani smer iz DCS; lastne preslikave HOTAS v X4 nagib, valjanje in plin štejejo kot obrnjene, zato JoyPro za te parameter nastavi na vaš obrat, obrnjen. Parameter nastavi samo, ko se strinjajo vse osi JoyPro na tej kontroli.
  • Dvosmerni plin sledi Drsnik relacije plina: Drsnik = samo naprej, brez Drsnik = sredina je ničelni potisk.
  • Mrtva cona: X4 ima eno mrtvo cono za vse osi vseh joystickov. Mrtve cone relacij se ne zapišejo (izvoz to pove); mrtvo cono igre nastavite v Nastavitve > Nastavitve povratne sile iger (izberite X4) ali z engine ffb set. Na istem mestu so prilagodljivo krmiljenje, vibriranje, samodejno valjanje in način igralnega ploščka. Nastavitev, ki jo tam shranite, prevlada nad relacijami, z opozorilom, ko jih obrne.
  • V X4 ni krivulj ali nasičenosti za posamezno os; ni povratne sile; ni telemetrije.
  • Spremljevalec: vezava ali možnost, ki jo spremenite v igri, se opazi, ko se igra zapre (inputmap.xml in config.xml), in JoyPro vpraša, ali naj jo prevzame.
  • HUD: HUD najde igro po njenem procesu in prikaže vaše vezave za X4.

#X Rebirth in X3

X Rebirth uporablja iste besede v inputmap.xml kot X4, vendar bi njegov seznam ukazov potreboval lastno izvlečenje iz namestitve. X3 (Reunion, Terran Conflict, Albion Prelude) ima drug pogon in neznano obliko datoteke. Oba sta samo opisana: JoyPro ju ne uvaža in ne izvaža.

Tehnične podrobnosti

#Znotraj povezave z X4

flowchart LR
  D["Vaša naprava<br/>(instance GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Pripeto na mesto:<br/>mesto 1 ... 8"]
  C --> K["Ni pripeto ali onemogočeno:<br/>preskočeno, enkrat ga<br/>dodelite v X4"]
  P["Vaš profil"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>vezave za vsako mesto"]
  E --> O["možnosti za celotno igro:<br/>obrati, način plina"]
X4 joystick poimenuje po njegovem mestu. Naprava brez fiksnega mesta se preskoči.

Koda: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs in model nastavitev engine\FfbModels\X4.cs.

  • Mesta: vezava imenuje vir: INPUT_SOURCE_JOYBUTTONS (gumbi in hat) ali INPUT_SOURCE_JOYAXES, brez pripone za mesto 1 in z _2 do _8 za druga. config.xml naprave preslika na mesta po GUID-u primerka DirectInput, zapisanem v lastni obliki X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0 do 7 je mesto, disabled="1" pomeni nobeno. JoyPro piše samo na mesta, katerih trenutni, omogočeni vnos ustreza priključeni napravi.
  • Kode: gumbi 1 do 11 uporabljajo imena igralnega ploščka X4 (INPUT_XBUTTON_A ... BIGBUTTON), 12 do 64 INPUT_XBUTTON_12 ...; hat INPUT_XBUTTON_DPAD_* (osem smeri); osi INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Razponi ne dobijo sgn. Tipkovnica: INPUT_KEYCODE_<DIK> z _SHIFT / _CONTROL.
  • Seznam ukazov: engine x4 refresh-db prebere gameoptions.lua in angleško stran besedil iz arhivov .cat/.dat ter tabele imen iz X4.exe, samo za branje; 128 kontrol vesoljskega letenja (6 osi, 122 gumbov). Vrstice se glasijo "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)". engine x4 catalog ga navede, engine x4 paths pokaže najdene datoteke.
  • Uvoz / izvoz: 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.
  • Nastavitve igre: engine ffb set --device * --game X4 --param <key>=<value>; parametri se urejajo na mestu, manjkajoči se doda kot zadnja vrstica <config>. Izvoz brez vezav za X4 vseeno zapiše shranjene nastavitve.

#Znane omejitve

  • Naprave brez pripetega mesta se preskočijo; JoyPro jih sam še ne pripne.
  • Modifikatorji joysticka se ne zapišejo: njihov zapis v datoteki še ni potrjen.
  • 64 gumbov, 8 osi in en hat na napravo; osem mest, skupnih z igralnimi ploščki.
  • Vibriranje: drsnik v igri prikaže vrednost, pomnoženo s 100 in odrezano (21 % se prikaže kot 20); datoteka hrani natančno vrednost.
  • Testi: engine\tests\smoke\x4.ps1 (tudi osvežitev kataloga); v igri tools\e2e\games\X4.ps1 (vezave in matrika načinov, v lastni mapi profila) in tools\e2e\games\X4Settings.ps1 (obrati, način plina, nastavitve igre).

Vse tehnične opombe o tej igri (ustvarjene iz repozitorija): x4.md.