JoyPro2 Discord GitHub
Gry

Star Citizen

Pokaż:

Star Citizen trzyma całe sterowanie w jednym pliku, actionmaps.xml, i numeruje Twoje drążki jako miejsca joysticków js1 do js8. JoyPro wczytuje przypisania statku z tego pliku do Twojego profilu i zapisuje je z powrotem w miejscu: zmieniają się tylko akcje statku i ustawienia ich osi, każda inna linia zostaje taka, jak zapisała ją gra. Urządzenie zachowuje miejsce, które gra już mu dała, więc Twoje przypisania nie przeskakują z jednego drążka na drugi.

Star Citizen natywnie (własne pliki przypisań)
Obsługa
natywnie (własne pliki przypisań)
Polecenie silnika
engine starcitizen
Plik przypisań
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml (XML)
Lista poleceń z
Data.p4k (defaultProfile.xml) i Twoje profile
Test w grze
54/54 kroków zaliczonych (2026-10-10)
  • ✓ Importuj
  • ✓ Eksportuj
  • ✓ Przypisania klawiatury
  • ✓ Modyfikatory
  • ✓ Lista poleceń budowana na Twoim PC
  • ✓ Obserwator gier
  • ✓ Krzywe osi i martwe strefy
  • ✓ Ustawienia sterowania w grze
  • ✗ Ustawienia force feedback w grze
  • ✗ Force feedback z telemetrii
  • ✗ Nagrywanie telemetrii
  • ✓ Wirtualny joystick (vJoy)
  • ◐ Wirtualny pad Xbox
  • ✓ Funkcje wirtualne
  • ✓ Kreator konfiguracji / Autoprzypisanie
  • ✓ Kokpity
  • ✓ Ściągi
  • ✓ Test w grze

Z macierzy obsługi, wygenerowanej z kodu silnika: wszystkie gry.

Dla początkujących

#Uruchom to w 3 krokach

  1. Ustaw wszystko za mnie
    na stronie Start
  2. Użyj tych przycisków
    najpierw obejrzyj listę
  3. Zapisz w mojej grze
    Star Citizen musi być zamknięty

Przed: podłącz każde urządzenie, którego używasz.

Potem: Twoje przypisania są w Options > Controls.

Przypisywałeś już przyciski w Star Citizen? Wtedy strona Start proponuje Importuj, potem wypełnij luki. Twoje przypisania zostają, a nowe zadania dostają tylko wolne przyciski. Zobacz Szybki start: niech mój drążek działa.

#Co JoyPro robi dla Star Citizen

  • Importuj: Twoje przypisania statku na drążkach, przepustnicach i pedałach trafiają do Twojego profilu, z martwymi strefami, krzywymi i odwróceniami. Własne domyślne przypisania joysticka gry na js1 też trafiają, więc późniejszy eksport ich nie gubi.
  • Relacje: jedna relacja to jedna funkcja w każdej grze. "Landing gear" może być tym samym przełącznikiem w Star Citizen, DCS i Elite Dangerous.
  • Eksportuj: JoyPro edytuje actionmaps.xml w miejscu. Przypisania pieszo, w pojazdach i w menu oraz przypisania myszy i gamepada zostają bez zmian.

#Zaimportuj przypisania ze Star Citizen

  1. Otwórz Start. Jeśli karta Star Citizen prosi o listę poleceń, naciśnij Zbuduj listę: JoyPro odczyta akcje gry z Twojej instalacji (Data.p4k, tylko do odczytu). Po łatce gry Aktualizuj na karcie dodaje nowe akcje.
  2. Naciśnij Importuj na karcie Star Citizen. Zostaw Dodaj do mojego profilu. Zaznacz Uwzględnij także klawisze klawiatury tylko wtedy, gdy chcesz mieć w JoyPro również klawisze statku.
  3. Naciśnij Importuj teraz. Pokaż moje relacje otwiera to, co przyszło.
Strona Start z Twoimi gramiStrona Start z Twoimi grami
Strona Start z Twoimi grami (Obrazy pokazują aplikację po angielsku.)

#Buduj i sprawdzaj relacje

Każda akcja statku to jeden wpis w relacji. Połącz tę samą funkcję Twoich innych gier za pomocą przebiegu relacji, potem naciśnij Sprawdź na stronie Eksport: znajduje przycisk, który robi na Twoim statku dwie rzeczy, zanim zrobi to gra.

#Eksport do Star Citizen

  1. Zamknij Star Citizen. Gra przy wyjściu nadpisuje actionmaps.xml, więc JoyPro nie zapisuje, gdy gra działa.
  2. Otwórz Eksportuj i zaznacz kartę Star Citizen.
  3. Zostaw Zastąp na moich urządzeniach razem z Wyczyść też moje inne urządzenia, jeśli to w JoyPro konfigurujesz swoje drążki. Naciśnij Eksportuj teraz na karcie.
Strona EksportStrona Eksport
Strona Eksport
W grze: Co widzisz w Star Citizen

Uruchom grę i otwórz Options > Controls z menu głównego. Wybierz urządzenie (Joystick / HOTAS 1, 2 ...): jego martwa strefa i nasycenie to te, które ustawiłeś w JoyPro; Inversion Settings i Joystick Sensitivity Curves (Flight > Flight Movement) pokazują Twoje odwrócenia, wykładniki i krzywe. Twoje przypisania statku są na miejscu joysticka każdego urządzenia. Domyślne ustawienia gry, które JoyPro wyłączył, są puste. Menu pokazuje nasycenie o 0.01 wyższe, niż jest w pliku (0.87 widać jako 0.88); gra zachowuje dokładną wartość.

#Co robisz sam w Star Citizen

  • Przy przypisaniach nic więcej. Podłącz każde używane urządzenie przed eksportem: niepodłączone urządzenie zachowuje swoje miejsce i przypisania, ale JoyPro nie może dać mu nowych.
  • Jeśli gra jest w innym folderze niż wykryty, ustaw raz ścieżkę na stronie Eksport w Opcje i ścieżki (dla ekspertów) albo podłącz folder w Ustawienia > Gry.

#Częste pułapki

  • „Star Citizen działa”: zamknij grę (także z launchera) i eksportuj ponownie.
  • Przypisania trafiły na zły drążek: zostaw włączone SC: preferuj lokalną kolejność (domyślnie). Gdy jest wyłączone, miejsca idą według kolejności, w jakiej Windows zgłasza urządzenia, co może przenieść wszystkie przypisania urządzenia na inny numer js.
  • Urządzenie nie dostało miejsca: gra ma osiem miejsc na joysticki. JoyPro łączy zdublowane wpisy jednego drążka (nazwę z gry i nazwę z JoyPro) w jedno miejsce, ale więcej niż osiem podłączonych urządzeń z przypisaniami się nie zmieści.
  • Domyślne przypisanie wróciło na js1: wraca, gdy urządzenie na js1 nie jest podłączone w chwili eksportu. Podłącz je i eksportuj ponownie z Zastąp.
Zaawansowane

#Pliki, które JoyPro czyta i zapisuje

Plik Co to jest
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml Twoje zmiany przypisań, sloty joysticków (<options type="joystick" instance="1..8" Product="...">), grupy opcji dla każdego slotu (odwrócenie, wykładnik, krzywa, czułość) i opcje urządzenia (martwa strefa, nasycenie dla każdej fizycznej osi)
...\Profiles\default\attributes.xml ustawienia całej gry (<Attr name="..." value="..."/>), tylko wartości różne od domyślnych w grze
...\Profiles\default\actionmaps.jp kopia zapisanego pliku w JoyPro z nazwami relacji jako komentarzami, odczytywana przez następny import
...\Profiles\default\actionmaps.xml.joypro.json ustawienia osi zapisane ostatnio przez JoyPro, żeby "Aktualizuj" odróżniało wartość zmienioną przez Ciebie w grze od własnej
actionmaps.xml.jpbak, attributes.xml.jpbak kopie sprzed pierwszego zapisu eksportu plus wersjonowany magazyn kopii zapasowych JoyPro

Eksport edytuje actionmaps.xml na miejscu: zmieniają się tylko przypisania statków i ustawienia osi tych przypisań osi, które zapisuje JoyPro. Inne mapy akcji, przypisania myszy i gamepada, tryby aktywacji, modyfikatory, inne grupy opcji i opcje urządzeń zostają bajt w bajt. Profil bez przypisań Star Citizen zostawia plik bez zmian.

#Sloty joysticków

Star Citizen nazywa każde przypisanie joysticka według jego slotu: js1_button3, js2_x. Plik podaje, które urządzenie zajmuje który slot, według nazwy produktu DirectInput i GUID produktu.

  • Preferuj lokalną kolejność (domyślnie włączone): podłączone urządzenie, które plik już wymienia, zachowuje swój slot. Inne urządzenia zajmują wolne sloty w kolejności, w jakiej zgłasza je Windows.
  • Jedno urządzenie, jeden slot: ten sam drążek wymieniony dwa razy (pod nazwą z gry i pod nazwą instancji z JoyPro albo jako stary drugi wpis) zajmuje jeden slot. Eksport usuwa zduplikowane wpisy i przenosi ich przypisania do slotu, który urządzenie zachowuje. Wpisy niepodłączonych urządzeń zostają.
  • Dwa podłączone urządzenia tego samego modelu pozostają rozdzielone.
  • Urządzenie, które zmienia slot, zabiera ze sobą swoje grupy opcji (odwrócenie, krzywe). Urządzenie, które nie dostaje slotu, traci grupy swojego starego slotu, z ostrzeżeniem.

#Tryby eksportu w Star Citizen

Każdy tryb zmienia tylko akcje statków. Mapy pieszo, pojazdów i menu zostają bajt w bajt.

Tryb Co dzieje się w grze
Tylko dodaj Żadne przypisanie gry się nie zmienia. Akcja, której slot joysticka ma już zmienione przypisanie albo aktywne domyślne, zachowuje je. Przypisanie na wejściu, którego używa inna akcja statku, nie jest zapisywane i dostaje oznaczenie "Nie zapisano w grze".
Aktualizuj, zachowaj przypisania gry Twoje wejście trafia do slotu joysticka danej akcji (Star Citizen ma jeden na akcję i typ wejścia). Przypisanie gry na wejściu, które dajesz innej akcji statku, zostaje zwolnione: jego zmienione przypisanie znika albo staje się pustym js1_ , gdy akcja ma domyślne, żeby domyślne nie wróciło.
Aktualizuj, wygrywa mój profil Jak wyżej; z opcją klawiatury przypisana przez Ciebie akcja traci też swoje przypisanie klawiatury.
Zastąp na moich urządzeniach Zapisane urządzenia zachowują tylko Twoje przypisania statków. Gdy urządzenie jest na js1, domyślne przypisania gry na js1, których nie ma w Twoim profilu, zostają wyłączone.
+ Wyczyść też moje inne urządzenia Podłączone urządzenia bez przypisań w Twoim profilu tracą swoje przypisania statków; domyślne js1 zostają wyłączone, gdy js1 nie jest używany.

Opcje na stronie Eksport (w Opcje i ścieżki (dla ekspertów)):

  • SC: zachowaj domyślne klawiatury (włączone): klawiatura zachowuje domyślne klawisze gry. Wyłączone: Twoje przypisania klawiatury są zapisywane, a zajęte przez nie domyślne klawisze zostają zwolnione.
  • SC: preferuj lokalną kolejność (włączone): zobacz sloty joysticków powyżej.
Opcje i ścieżki (dla ekspertów) na stronie EksportOpcje i ścieżki (dla ekspertów) na stronie Eksport
Opcje i ścieżki (dla ekspertów) na stronie Eksport

#Domyślne przypisania joysticka w grze

Star Citizen ma domyślne przypisania joysticka, które działają na js1, dopóki akcja nie dostanie tam zmienionego przypisania (pitch na Y, yaw na X, roll na obrocie Z, kilka przycisków). Import bierze każde aktywne domyślne przypisanie jako przypisanie urządzenia js1, więc Twój profil zawiera to, co gra naprawdę robi. Eksport nie zapisuje zmienionego przypisania dla przypisania równego domyślnemu (tylko prawdziwe różnice). Zastąp i Wyczyść też wyłączają domyślne przypisania, których nie ma w Twoim profilu, pustym przypisaniem js1_ , tak jak własne menu gry zapisuje wyczyszczone przypisanie, i tylko wtedy, gdy urządzenie na js1 jest podłączone. Dlatego import, a potem Zastąp + Wyczyść też, zostawia actionmaps.xml takim, jaki był.

#Co nigdy nie jest ruszane

  • Przypisania pieszo, pojazdów naziemnych i menu (pojazdy naziemne Star Citizen liczą się jako osobna klasa pojazdów).
  • Urządzenia, które nie są podłączone: zachowują swój slot i swoje zmienione przypisania.
  • Urządzenia ignorowane przy imporcie i urządzenie vJoy, do którego JoyPro przekazuje wejścia.
  • Przypisania myszy i gamepada; klawiatura, chyba że eksportujesz przypisania klawiatury.
  • Tryby aktywacji, modyfikatory, inne grupy opcji i opcje urządzeń.

#Statki, krzywe, ustawienia gry

  • Szczegółowość: jeden zestaw przypisań statków dla każdego statku (gra nie ma przypisań dla poszczególnych statków).
  • Krzywe osi, w dwóch miejscach, tak jak trzyma je gra: martwa strefa i nasycenie dla każdego urządzenia i fizycznej osi; odwrócenie, wykładnik (od 1 do 3), krzywa 11-punktowa i czułość dla każdego slotu i grupy opcji. Wykładnik i krzywa wykluczają się nawzajem, tak jak w menu gry. Relacja bez wartości Star Citizen dostaje dopasowaną krzywą JoyPro: martwa strefa i nasycenie trafiają do osi urządzenia, krzywizna staje się najbliższym wykładnikiem albo krzywą, gdy żaden wykładnik nie pasuje. Nie ma osi jednostronnej: absolutna i względna przepustnica w grze to osobne akcje.
  • Aktualizuj zachowuje wartość osi zmienioną przez Ciebie w grze (z ostrzeżeniem); Zastąp i wygrywa mój profil ustawiają wartości z Twojego profilu. Neutralna relacja zostawia własną wartość gry (swobodne rozglądanie zachowuje domyślny wykładnik 2.5).
  • Ustawienia całej gry (attributes.xml): przełącznik odwrócenia ciągu HOTAS, czas i próg pułapki względnej przepustnicy, modyfikatory czułości IFCS, ESP włączone, siła i tłumienie, ESP wieżyczki, domyślne ustawienia lotu (sticky throttle, ogranicznik prędkości, coupled, G-safe, auto precision, hamulec kosmiczny), odwrócenie kontrolera lotu i Vibration. Ustaw je w Ustawienia > Ustawienia force feedback gier (wybierz Star Citizen) albo przez engine ffb set. JoyPro zmienia na miejscu tylko ustawione przez Ciebie wiersze i nie tworzy pliku. Suwak siły ESP kończy się na 1.00, więc JoyPro oferuje od 0 do 1.
  • Force feedback: brak. Vibration to jedyne takie ustawienie w grze.
  • Obserwator: przypisanie lub wartość osi zmienione przez Ciebie w menu gry zostają zauważone po zamknięciu gry, a JoyPro pyta, czy je przejąć. Porównuje actionmaps.xml (tylko mapy akcji statków) i ustawienia, które JoyPro przechowuje w attributes.xml.
  • HUD: HUD rozpoznaje grę po jej procesie i pokazuje Twoje przypisania Star Citizen.
Szczegóły techniczne

#Wewnątrz integracji Star Citizen

flowchart LR
  A[("actionmaps.xml")] --> S["Slot na urządzenie"]
  D["Podłączone urządzenia"] --> S
  P["Twój profil"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
Znane urządzenie zachowuje swój slot joysticka (js1 ... js8 w actionmaps.xml). Nowe urządzenie dostaje pierwszy wolny slot; nieaktualny duplikat jest usuwany. Przypisania statków są edytowane w miejscu, ustawienia całej gry trafiają do attributes.xml.

Kod: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, model osi engine\AxisModels\StarCitizen.cs i model ustawień engine\FfbModels\StarCitizen.cs.

  • Nazwy urządzeń: Product slotu to nazwa produktu DirectInput i GUID produktu, oddzielone dwiema spacjami (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Slotu lub bloku deviceoptions zapisanego pod inną nazwą (GUID instancji) gra nie rozpoznaje: przepisuje slot swoim produktem i porzuca grupy opcji slotu. Dlatego JoyPro zapisuje nazwę produktu podłączonego urządzenia.
  • Lista poleceń: engine db refresh-starcitizen czyta Data\Libs\Config\defaultProfile.xml z Data.p4k (albo z rozpakowanej kopii przez --source) do DB\StarCitizen\AllBinds.xml: każdą akcję z jej grupą opcji, drzewo opcji joysticka (rodzice i wartości domyślne, które grupy pokazują krzywą) i domyślne wejście joysticka akcji. engine starcitizen labels bierze nazwy elementów sterowania z gry z global.ini.
  • Importuj: engine starcitizen import (--include-keyboard, --device, --ignore-device); każde zmienione przypisanie osi dostaje wartości, których używa gra (grupa liścia slotu, a jeśli jej brak, najbliższy ustawiony przez Ciebie rodzic, a w przeciwnym razie wartość domyślna gry) oraz opcje urządzenia dla swojej osi, jako swoje strojenie game:StarCitizen. engine starcitizen scan pokazuje to samo bez zmiany profilu; engine starcitizen list-devices wymienia sloty joysticków z pliku.
  • Eksportuj: 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>. Nowy blok deviceoptions trafia przed pierwszy <options>; kilka relacji na jednej grupie opcji lub jednej fizycznej osi z różnymi wartościami daje ostrzeżenie, a wygrywa pierwsza relacja według nazwy.
  • Ustawienia gry: engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; istniejący wiersz dostaje wartość, nowy trafia na swoje miejsce w kolejności sortowania.
  • Kopie zapasowe: engine backups list wymienia kopie; Cofnij ostatni eksport na karcie przywraca najnowszą.

#Znane ograniczenia

  • Osiem slotów joysticków; limit przycisków na urządzenie nie jest znany (źródła są sprzeczne).
  • Nie jest jeszcze potwierdzone, gdzie gra chce nowy blok deviceoptions, jak interpoluje krzywą (menu rysuje gładki spline przez punkty), jaki jest zakres wykładnika i czy czułość dotyczy joysticków. Zakresów ustawień całej gry nie ma w czytelnych plikach gry.
  • Nie jest jeszcze potwierdzone, czy Vibration steruje drążkiem z force feedback DirectInput.
  • Testy: engine\tests\smoke\starcitizen.ps1 (odświeżenie katalogu, import grup opcji i krzywych, import + eksport bajt w bajt, każde ustawienie osi, konflikty, zmiany slotów, attributes.xml na miejscu); w grze tools\e2e\games\StarCitizenSettings.ps1 (Options w menu głównym: ustawienia, przypisania i krzywe) i tools\e2e\games\StarCitizen.ps1 (macierz trybów eksportu i importu).

Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): starcitizen.md.