Star Citizen зберігає все ваше керування в одному файлі, actionmaps.xml, і нумерує ваші ручки як слоти joystick від 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)
- ✓ Імпорт
- ✓ Експорт
- ✓ Прив'язки клавіатури
- ✓ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✓ Налаштування керування гри
- ✗ Налаштування Force Feedback у грі
- ✗ Force Feedback з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
Star Citizen має бути закрита
До: підключіть усі пристрої, якими користуєтеся.
Потім: ваші прив'язки є в Options > Controls.
Ви вже прив'язували кнопки в Star Citizen? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.
#Що JoyPro робить для Star Citizen
- Імпорт: ваші прив'язки корабля на ручках, важелях газу й педалях потрапляють у ваш профіль разом із мертвими зонами, кривими та інверсіями. Власні стандартні прив'язки joystick гри на 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) показують ваші інверсії, експоненти й криві. Ваші прив'язки корабля стоять на слоті joystick кожного пристрою. Стандартні прив'язки гри, які JoyPro вимкнув, показуються порожніми. Меню показує насичення на 0.01 більше, ніж у файлі (0.87 показується як 0.88); гра зберігає точне значення.
#Що ви робите самі в Star Citizen
- Для прив'язок більше нічого не потрібно. Перед експортом підключіть усі пристрої, якими користуєтеся: непідключений пристрій зберігає свій слот і прив'язки, але JoyPro не може дати йому нових.
- Якщо гра лежить в іншій теці, ніж виявлена, один раз укажіть шлях на сторінці «Експорт» у розділі Параметри та шляхи (для досвідчених) або вкажіть теку в Налаштування > Ігри.
#Типові помилки
- «Star Citizen працює»: закрийте гру (також у лаунчері) й експортуйте знову.
- Прив'язки потрапили не на ту ручку керування: залиште SC: віддавати перевагу локальному порядку увімкненим (за замовчуванням). Якщо вимкнути, слоти йдуть у тому порядку, у якому Windows повідомляє про пристрої, і це може перенести всі прив'язки пристрою на інший номер js.
- Пристрій не отримав слота: у грі вісім слотів для джойстиків. 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, auto precision, space brake), інверсія контролера польоту й Vibration. Задайте їх у Налаштування > Налаштування force feedback ігор (виберіть Star Citizen) або черезengine ffb set. JoyPro змінює лише задані вами рядки, на місці, і не створює файл. Повзунок сили ESP закінчується на 1.00, тож JoyPro пропонує від 0 до 1. - Force Feedback: немає. 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 ручкою з Force Feedback DirectInput, ще не підтверджено.
- Тести:
engine\tests\smoke\starcitizen.ps1(оновлення каталогу, імпорт груп параметрів і кривих, імпорт + експорт байт у байт, кожне налаштування осі, конфлікти, зміни слотів,attributes.xmlна місці); у гріtools\e2e\games\StarCitizenSettings.ps1(Options головного меню: налаштування, прив'язки й криві) іtools\e2e\games\StarCitizen.ps1(матриця режимів експорту й імпорту).
Усі технічні примітки до цієї гри (створено з репозиторію): starcitizen.md.