Star Citizen пази цялото ви управление в един файл, actionmaps.xml, и номерира ръчките ви като места за джойстик от js1 до js8. JoyPro чете назначенията за кораба от този файл във вашия профил и ги записва обратно на място: променят се само действията за кораба и настройките на осите им, всеки друг ред остава такъв, какъвто го е записала играта. Устройството запазва мястото, което играта вече му е дала, така че назначенията ви не прескачат от една ръчка на друга.
Star Citizen директно (собствени файлове с назначения)
- Поддръжка
- директно (собствени файлове с назначения)
- Команда на ядрото
engine starcitizen- Файл с назначения
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Списък с команди от
Data.p4k(defaultProfile.xml) и вашите профили- Тест в играта
- 54/54 успешни стъпки (2026-10-10)
- ✓ Импортиране
- ✓ Експортиране
- ✓ Назначения на клавиатурата
- ✓ Модификатори
- ✓ Списък с команди, изграден на вашия PC
- ✓ Следене на игри
- ✓ Криви на осите и мъртви зони
- ✓ Настройки за управление в играта
- ✗ Настройки за обратна сила в играта
- ✗ Обратна сила от телеметрия
- ✗ Запис на телеметрия
- ✓ Виртуален joystick (vJoy)
- ◐ Виртуален Xbox геймпад
- ✓ Виртуални функции
- ✓ Съветник за настройка / Авто назначаване
- ✓ Кабини
- ✓ Бележници
- ✓ Тест в играта
От матрицата за поддръжка, генерирана от кода на ядрото: всички игри.
#Подкарайте го в 3 стъпки
- Настрой всичко вместо мен
на страницата Начало - Използвай тези бутони
първо разгледайте списъка - Запиши в моята игра
Star Citizen трябва да е затворена
Преди: включете всяко устройство, което използвате.
После: назначенията ви са в Options > Controls.
Назначавали ли сте бутони в Star Citizen преди? Тогава страницата Начало предлага Импортиране, после запълване на празнините. Вашите назначения остават и само свободните бутони получават нови задачи. Вижте Бърз старт: да заработи ръчката ми.
#Какво прави JoyPro за Star Citizen
- Импортиране: назначенията ви за кораба на ръчки, газове и педали влизат във вашия профил заедно с мъртвите зони, кривите и обръщанията им. Собствените назначения по подразбиране за джойстик на играта на js1 също влизат, така че по-късно експортиране не ги губи.
- Връзки: една връзка е една функция във всяка игра. „Landing gear“ може да е един и същ превключвател в Star Citizen, DCS и Elite Dangerous.
- Експортиране: JoyPro редактира
actionmaps.xmlна място. Назначенията за пеша, превозни средства и менюта, както и назначенията на мишката и геймпада остават такива, каквито са.
#Импортирайте назначенията си от Star Citizen
- Отворете Начало. Ако картата на Star Citizen иска списък с команди, натиснете Изграждане на списъка: JoyPro чете действията на играта от вашата инсталация (
Data.p4k, само четене). След пач на играта Актуализиране на картата добавя новите действия. - Натиснете Импортиране на картата на Star Citizen. Оставете Добавяне към моя профил. Отметнете Вземи и клавишите на клавиатурата само ако искате клавишите ви за кораба също да са в JoyPro.
- Натиснете Импортиране сега. Виж моите връзки отваря това, което е влязло.


#Създаване и проверка на връзки
Всяко действие за кораба е един запис във връзка. Свържете същата функция от другите си игри с процеса за връзките, после натиснете Проверка на страницата Експортиране: тя открива бутон, който прави две неща на кораба ви, преди играта да го направи.
#Експортиране в Star Citizen
- Затворете Star Citizen. Играта презаписва
actionmaps.xmlпри излизане, затова JoyPro отказва да записва, докато тя работи. - Отворете Експортиране и отметнете картата на Star Citizen.
- Оставете Замяна на моите устройства с Изчистване и на другите ми устройства, ако настройвате ръчките си в JoyPro. Натиснете Експортиране сега на картата.


Стартирайте играта и отворете Options > Controls от главното меню. Изберете устройството си (Joystick / HOTAS 1, 2 ...): мъртвата му зона и насищането са тези, които сте задали в JoyPro; Inversion Settings и Joystick Sensitivity Curves (Flight > Flight Movement) показват обръщанията, експонентите и кривите ви. Назначенията ви за кораба са на мястото за джойстик на всяко устройство. Стойностите по подразбиране на играта, които JoyPro е изключил, се показват празни. Менюто показва насищането с 0.01 повече, отколкото е във файла (0.87 се показва като 0.88); играта пази точната стойност.
#Какво правите сами в Star Citizen
- За назначенията нищо друго. Включете всяко устройство, което използвате, преди да експортирате: устройство, което не е свързано, запазва мястото и назначенията си, но JoyPro не може да му даде нови.
- Ако играта е в друга папка, а не в откритата, задайте пътя веднъж на страницата Експортиране под Опции и пътища (за напреднали) или свържете папката в Настройки > Игри.
#Чести грешки
- „Star Citizen работи“: затворете играта (и от лаунчера) и експортирайте отново.
- Назначенията попаднаха на грешната ръчка: оставете SC: предпочитане на локалния ред включено (по подразбиране). Ако е изключено, слотовете следват реда, в който Windows съобщава устройствата, и това може да премести всички назначения на едно устройство към друг номер js.
- Едно устройство не получи слот: играта има осем слота за joystick. JoyPro обединява двойните записи на една ръчка (името от играта и името от JoyPro) в един слот, но повече от осем свързани устройства с назначения не се побират.
- Назначение по подразбиране се върна на js1: то се връща, когато устройството на js1 не е свързано по време на експортирането. Свържете го и експортирайте отново със Замяна.
#Файлове, които JoyPro чете и записва
| Файл | Какво е това |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
вашите пренастройки, слотовете за joystick (<options type="joystick" instance="1..8" Product="...">), групите опции за всеки слот (обръщане, степенен показател, крива, чувствителност) и опциите на устройството (мъртва зона, насищане за всяка физическа ос) |
...\Profiles\default\attributes.xml |
настройки за цялата игра (<Attr name="..." value="..."/>), само стойностите, които се различават от стойностите по подразбиране на играта |
...\Profiles\default\actionmaps.jp |
копието на JoyPro на записания файл с имената на връзките като коментари, прочитано обратно при следващото импортиране |
...\Profiles\default\actionmaps.xml.joypro.json |
настройките на осите, които JoyPro е записал последно, така че „Актуализиране“ да различи стойност, която сте променили в играта, от неговата собствена |
actionmaps.xml.jpbak, attributes.xml.jpbak |
копия от преди първия запис на експортирането, плюс хранилището на JoyPro за резервни копия с версии |
Експортирането редактира actionmaps.xml на място: променят се само пренастройките за кораба и настройките на осите от пренастройките на оси, които JoyPro записва. Другите карти на действия, пренастройките за мишка и геймпад, режимите на активиране, модификаторите, другите групи опции и опциите на устройствата остават байт по байт. Профил без назначения за Star Citizen оставя файла какъвто е.
#Слотовете за joystick
Star Citizen назовава всяко назначение за joystick по слота му: js1_button3, js2_x. Файлът изброява кое устройство заема кой слот, по името на продукта в DirectInput и GUID на продукта.
- Предпочитане на локалния ред (включено по подразбиране): свързано устройство, което файлът вече назовава, запазва този слот. Другите устройства заемат свободните слотове в реда, в който Windows ги съобщава.
- Едно устройство, един слот: една и съща ръчка, изброена два пъти (под името от играта и под името на инстанцията от JoyPro, или стар втори запис), заема един слот. Експортирането премахва дублираните записи и мести назначенията им в слота, който устройството запазва. Записите на устройства, които не са свързани, остават.
- Две свързани устройства от един и същ модел остават отделни.
- Устройство, което сменя слота си, взема групите си опции (обръщане, криви) със себе си. Устройство, което не получава слот, губи групите на стария си слот, с предупреждение.
#Режимите на експортиране в Star Citizen
Всеки режим променя само действията за кораба. Картите за пешеходно движение, превозни средства и менюта остават байт по байт.
| Режим | Какво става в играта |
|---|---|
| Само добавяне | Не се променя нито едно назначение на играта. Действие, чийто слот за joystick вече съдържа пренастройка или активна стойност по подразбиране, я запазва. Назначение на вход, който използва друго действие за кораба, не се записва и получава отметка „Не е записано в играта“. |
| Актуализиране, назначенията на играта се запазват | Вашият вход отива в слота за joystick на действието (Star Citizen има по един за всяко действие и вид вход). Назначение на играта на вход, който давате на друго действие за кораба, се освобождава: пренастройката му изчезва или става празно js1_ , когато действието има стойност по подразбиране, така че стойността по подразбиране да не се върне. |
| Актуализиране, моят профил печели | Както по-горе; с опцията за клавиатура действие, което назначите, губи и пренастройката си за клавиатура. |
| Замяна на моите устройства | Записаните устройства запазват само вашите назначения за кораба. При устройство на js1 стойностите по подразбиране на играта за js1, които профилът ви няма, се изключват. |
| + Изчистване и на другите ми устройства | Свързаните устройства без назначения в профила ви губят назначенията си за кораба; стойностите по подразбиране на js1 се изключват, когато js1 не се използва. |
Опции на страницата Експортиране (под Опции и пътища (за напреднали)):
- SC: запазване на подразбиращите се клавиши (включено): клавиатурата запазва клавишите по подразбиране на играта. Изключено: вашите назначения за клавиатура се записват, а клавишите по подразбиране, които те заемат, се освобождават.
- SC: предпочитане на локалния ред (включено): вижте слотовете за joystick по-горе.


#Назначенията за joystick по подразбиране на играта
Star Citizen има назначения за joystick по подразбиране, които действат на js1, докато действието не получи пренастройка там (pitch на Y, yaw на X, roll на въртене по Z, няколко бутона). Импортирането взема всяка активна стойност по подразбиране като назначение на устройството js1, така че профилът ви съдържа това, което играта наистина прави. Експортирането не записва пренастройка за назначение, което съвпада със стойността по подразбиране (само истинските разлики). Замяна и „Изчистване и на другите ми устройства“ изключват стойностите по подразбиране, които профилът ви няма, с празна пренастройка js1_ , както собственото меню на играта записва изчистено назначение, и само когато устройството на js1 е свързано. Така импортиране, а после Замяна + „Изчистване и на другите ми устройства“ оставя actionmaps.xml какъвто беше.
#Какво никога не се докосва
- Назначенията за пешеходно движение, наземни превозни средства и менюта (наземните превозни средства в Star Citizen се броят за отделен клас превозни средства).
- Устройства, които не са свързани: те запазват слота и пренастройките си.
- Игнорираните при импортиране устройства и устройството vJoy, към което JoyPro препраща.
- Назначенията за мишка и геймпад; клавиатурата, освен ако не експортирате назначения за клавиатура.
- Режимите на активиране, модификаторите, другите групи опции и опциите на устройствата.
#Кораби, криви, настройки на играта
- Ниво на детайл: един набор назначения за кораб за всеки кораб (играта няма назначения за отделни кораби).
- Криви на осите, на две места, както ги пази играта: мъртва зона и насищане за всяко устройство и физическа ос; обръщане, степенен показател (от 1 до 3), крива от 11 точки и чувствителност за всеки слот и група опции. Степенният показател и кривата се изключват взаимно, както в менюто на играта. Връзка без стойности за Star Citizen получава напасната крива от JoyPro: мъртвата зона и насищането отиват към оста на устройството, кривината става най-близкият степенен показател или кривата, когато не пасва никакъв показател. Няма едностранна ос: абсолютната и относителната газ в играта са отделни действия.
- Актуализиране запазва стойност на ос, която сте променили в играта (с предупреждение); Замяна и моят профил печели задават стойностите от вашия профил. Неутрална връзка оставя собствената стойност на играта (свободното оглеждане запазва степенния си показател по подразбиране 2.5).
- Настройки за цялата игра (
attributes.xml): превключвателят за обръщане на тягата за HOTAS, времето и прагът на задържане при относителната газ, модификаторите на чувствителността на IFCS, включване, сила и затихване на ESP, ESP за купола, полетните стойности по подразбиране (sticky throttle, ограничител на скоростта, coupled, G-safe, автоматична прецизност, космическа спирачка), обръщане на полетния контролер и Vibration. Задайте ги в Настройки > Настройки за обратна сила на игрите (изберете Star Citizen) или сengine ffb set. JoyPro променя само редовете, които сте задали, на място, и не създава файла. Плъзгачът за сила на ESP свършва на 1.00, затова JoyPro предлага от 0 до 1. - Обратна сила: няма. Vibration е единствената такава настройка в играта.
- Наблюдател: назначение или стойност на ос, които промените в менюто на играта, се забелязват след затварянето на играта и JoyPro пита дали да ги поеме. Сравнява
actionmaps.xml(само картите на действия за кораба) и настройките, които JoyPro пази вattributes.xml. - HUD: HUD намира играта по процеса ѝ и показва вашите назначения за Star Citizen.
#Отвътре: интеграцията със Star Citizen
flowchart LR
A[("actionmaps.xml")] --> S["Слот за всяко устройство"]
D["Свързани устройства"] --> S
P["Вашият профил"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Код: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, моделът на оста engine\AxisModels\StarCitizen.cs и моделът на настройките engine\FfbModels\StarCitizen.cs.
- Имена на устройства:
Productна слота е името на продукта в DirectInput и GUID на продукта, разделени с два интервала (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Слот или блокdeviceoptions, записан под друго име (GUID на инстанция), не се разпознава от играта: тя презаписва слота със своя продукт и изхвърля групите опции на слота. Затова JoyPro записва името на продукта на свързаното устройство. - Списък с команди:
engine db refresh-starcitizenчетеData\Libs\Config\defaultProfile.xmlотData.p4k(или от извлечено копие с--source) вDB\StarCitizen\AllBinds.xml: всяко действие с групата си опции, дървото с опции за joystick (родители и стойности по подразбиране, кои групи показват крива) и входа за joystick по подразбиране на действието.engine starcitizen labelsвзема имената на контролите от играта отglobal.ini. - Импортиране:
engine starcitizen import(--include-keyboard,--device,--ignore-device); всяка пренастройка на ос получава стойностите, които играта използва (листовата група на слота, иначе най-близкия родител, който сте задали, иначе стойността по подразбиране на играта) и опциите на устройството за оста си, като своята настройкаgame:StarCitizen.engine starcitizen scanпоказва същото, без да променя профила;engine starcitizen list-devicesизброява слотовете за joystick във файла. - Експортиране:
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>. Нов блокdeviceoptionsсе поставя преди първия<options>; няколко връзки върху една група опции или една физическа ос с различни стойности дават предупреждение и печели първата връзка по име. - Настройки на играта:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; съществуващ ред получава стойността, нов ред отива на мястото си по азбучен ред. - Резервни копия:
engine backups listизброява копията; Отмяна на последното експортиране на картата възстановява най-новото.
#Известни ограничения
- Осем слота за joystick; ограничението на бутоните за устройство не е известно (източниците си противоречат).
- Къде играта иска нов блок
deviceoptions, интерполацията на кривата (менюто чертае гладък сплайн през точките), обхватът на степенния показател и дали чувствителността важи за joystick-ите, още не е потвърдено. Обхватите на настройките за цялата игра не са в четимите файлове на играта. - Дали Vibration задвижва ръчка с обратна сила през DirectInput, още не е потвърдено.
- Тестове:
engine\tests\smoke\starcitizen.ps1(обновяване на каталога, импортиране на групи опции и криви, импортиране + експортиране байт по байт, всяка настройка на ос, конфликти, смяна на слотове,attributes.xmlна място); в игратаtools\e2e\games\StarCitizenSettings.ps1(Options в главното меню: настройки, назначения и криви) иtools\e2e\games\StarCitizen.ps1(матрица на режимите на експортиране и импортиране).
Всички технически бележки за тази игра (генерирани от хранилището): starcitizen.md.