JoyPro2 Discord GitHub
Игры

Star Citizen

Показать:

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)
  • ✓ Импорт
  • ✓ Экспорт
  • ✓ Привязки клавиатуры
  • ✓ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✓ Кривые осей и мёртвые зоны
  • ✓ Настройки управления игры
  • ✗ Настройки Force Feedback в игре
  • ✗ Force Feedback из телеметрии
  • ✗ Запись телеметрии
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ✓ Мастер настройки / Автоназначение
  • ✓ Кабины
  • ✓ Шпаргалки
  • ✓ Внутриигровой тест

Из матрицы поддержки, созданной по коду движка: все игры.

Для начинающих

#Запуск за 3 шага

  1. Настроить всё за меня
    на странице «Старт»
  2. Использовать эти кнопки
    сначала посмотрите список
  3. Записать в мою игру
    Star Citizen должна быть закрыта

До: подключите все устройства, которыми пользуетесь.

Затем: ваши привязки находятся в Options > Controls.

Вы уже назначали кнопки в Star Citizen? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.

#Что JoyPro делает для Star Citizen

  • Импорт: ваши привязки корабля на ручках, РУД и педалях попадают в ваш профиль вместе с мёртвыми зонами, кривыми и инверсиями. Собственные стандартные привязки джойстика игры на js1 тоже приходят, чтобы последующий экспорт их не потерял.
  • Связки: одна связка — это одна функция во всех играх. «Landing gear» может быть одним и тем же переключателем в Star Citizen, DCS и Elite Dangerous.
  • Экспорт: JoyPro редактирует actionmaps.xml на месте. Привязки пешего режима, техники и меню, привязки мыши и геймпада остаются как есть.

#Импорт привязок Star Citizen

  1. Откройте Старт. Если карточка Star Citizen просит список команд, нажмите Создать список: JoyPro читает действия игры из вашей установки (Data.p4k, только чтение). После патча игры Обновление на карточке добавляет новые действия.
  2. Нажмите Импорт на карточке Star Citizen. Оставьте Добавить в мой профиль. Отмечайте Брать также клавиши клавиатуры, только если хотите, чтобы клавиши корабля тоже были в JoyPro.
  3. Нажмите Импортировать. Мои связки открывает то, что пришло.
Страница «Старт» с вашими играмиСтраница «Старт» с вашими играми
Страница «Старт» с вашими играми (На изображениях приложение на английском.)

#Создание и проверка связок

Каждое действие корабля — одна запись в связке. Объедините одинаковую функцию ваших других игр с помощью работы со связками, затем нажмите Проверить на странице «Экспорт»: проверка раньше игры находит кнопку, которая делает на вашем корабле две вещи.

#Экспорт в Star Citizen

  1. Закройте Star Citizen. Игра перезаписывает actionmaps.xml при выходе, поэтому JoyPro отказывается записывать, пока она работает.
  2. Откройте Экспорт и отметьте карточку Star Citizen.
  3. Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.
Страница «Экспорт»Страница «Экспорт»
Страница «Экспорт»
В игре: Что вы видите в Star Citizen

Запустите игру и откройте 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 не может дать ему новые.
  • Если игра находится не в той папке, которую нашёл JoyPro, один раз укажите путь на странице «Экспорт» в разделе Параметры и пути (для экспертов) или укажите папку в Настройки > Игры.

#Частые ошибки

  • «Star Citizen работает»: закройте игру (и лаунчер тоже) и выполните экспорт снова.
  • Привязки попали не на ту ручку: оставьте SC: предпочитать локальный порядок включённым (по умолчанию). Если выключить, слоты следуют порядку, в котором Windows сообщает об устройствах, и тогда все привязки устройства могут переехать на другой номер js.
  • Устройству не досталось слота: в игре восемь слотов для джойстиков. JoyPro объединяет повторяющиеся записи одной ручки (имя из игры и имя из JoyPro) в один слот, но больше восьми подключённых устройств с привязками не поместятся.
  • На js1 вернулась привязка по умолчанию: она возвращается, если устройство на js1 не подключено во время экспорта. Подключите его и снова выполните экспорт с заменой.
Расширенные

#Файлы, которые JoyPro читает и записывает

Файл Что это
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml ваши переназначения, слоты джойстиков (<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 оставляет файл как есть.

#Слоты джойстиков

Star Citizen называет каждую привязку джойстика по её слоту: js1_button3, js2_x. В файле указано, какое устройство занимает какой слот, по имени продукта DirectInput и GUID продукта устройства.

  • Предпочитать локальный порядок (включено по умолчанию): подключённое устройство, уже названное в файле, сохраняет этот слот. Остальные устройства занимают свободные слоты в том порядке, в котором их сообщает Windows.
  • Одно устройство — один слот: одна и та же ручка, указанная дважды (под именем игры и под именем экземпляра JoyPro, или старая вторая запись), занимает один слот. Экспорт удаляет дублирующиеся записи и переносит их привязки в слот, который сохраняет устройство. Записи неподключённых устройств остаются.
  • Два подключённых устройства одной модели остаются раздельными.
  • Устройство, сменившее слот, забирает с собой свои группы параметров (инверсия, кривые). Устройство, не получившее слота, теряет группы своего старого слота, с предупреждением.

#Режимы экспорта в Star Citizen

Каждый режим меняет только действия корабля. Карты для передвижения пешком, транспорта и меню остаются байт в байт.

Режим Что происходит в игре
Только добавить Ни одна привязка игры не меняется. Действие, в слоте джойстика которого уже есть переназначение или активная привязка по умолчанию, сохраняет её. Привязка на входе, который использует другое действие корабля, не записывается и получает отметку «Не записано в игру».
Обновить, привязки игры сохранить Ваш вход попадает в слот джойстика действия (в Star Citizen по одному на действие и тип входа). Привязка игры на входе, который вы отдаёте другому действию корабля, освобождается: её переназначение удаляется или становится пустым js1_ , если у действия есть привязка по умолчанию, чтобы она не вернулась.
Обновить, мой профиль важнее Как выше; с параметром клавиатуры привязываемое вами действие также теряет своё переназначение клавиатуры.
Заменить на моих устройствах У записанных устройств остаются только ваши привязки корабля. Если устройство на js1, привязки игры по умолчанию для js1, которых нет в вашем профиле, отключаются.
+ Очистить и другие мои устройства Подключённые устройства без привязок в вашем профиле теряют свои привязки корабля; привязки по умолчанию для js1 отключаются, если js1 не используется.

Параметры на странице «Экспорт» (в Параметры и пути (для экспертов)):

  • SC: сохранить стандартные привязки клавиатуры (вкл.): клавиатура сохраняет клавиши игры по умолчанию. Выкл.: ваши привязки клавиатуры записываются, а занятые ими клавиши по умолчанию освобождаются.
  • SC: предпочитать локальный порядок (вкл.): см. слоты джойстиков выше.
Параметры и пути (для экспертов) на странице «Экспорт»Параметры и пути (для экспертов) на странице «Экспорт»
Параметры и пути (для экспертов) на странице «Экспорт»

#Привязки джойстика игры по умолчанию

У Star Citizen есть привязки джойстика по умолчанию, которые действуют на js1, пока действие не получит там переназначение (тангаж на Y, рыскание на X, крен на вращении 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. Задайте их в Настройки > Настройки FFB игр (выберите 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"]
Известное устройство сохраняет свой слот джойстика (js1 ... js8 в actionmaps.xml). Новое устройство получает первый свободный слот; устаревший дубликат удаляется. Привязки кораблей правятся на месте, настройки для всей игры записываются в attributes.xml.

Код: 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: каждое действие с его группой параметров, дерево параметров джойстика (родители и значения по умолчанию, какие группы показывают кривую) и вход джойстика по умолчанию для действия. engine starcitizen labels берёт названия элементов управления игры из global.ini.
  • Импорт: engine starcitizen import (--include-keyboard, --device, --ignore-device); каждое переназначение оси получает значения, которые использует игра (конечная группа слота, иначе ближайший заданный вами родитель, иначе значение игры по умолчанию), и параметры устройства для своей оси — как свою настройку game:StarCitizen. engine starcitizen scan показывает то же самое, не меняя профиль; engine starcitizen list-devices перечисляет слоты джойстиков в файле.
  • Экспорт: 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 перечисляет копии; Отменить последний экспорт на карточке восстанавливает самую новую.

#Известные ограничения

  • Восемь слотов джойстиков; ограничение кнопок на устройство неизвестно (источники расходятся).
  • Где игра хочет видеть новый блок deviceoptions, интерполяция кривой (меню рисует гладкий сплайн через точки), диапазон показателя степени и применяется ли чувствительность к джойстикам — пока не подтверждено. Диапазонов общих настроек игры нет в читаемых файлах игры.
  • Управляет ли Vibration ручкой с Force Feedback через DirectInput, пока не подтверждено.
  • Тесты: engine\tests\smoke\starcitizen.ps1 (обновление каталога, импорт групп параметров и кривых, импорт + экспорт байт в байт, каждая настройка оси, конфликты, смена слотов, attributes.xml на месте); в игре tools\e2e\games\StarCitizenSettings.ps1 (Options в главном меню: настройки, привязки и кривые) и tools\e2e\games\StarCitizen.ps1 (матрица режимов экспорта и импорта).

Все технические заметки по этой игре (созданы из репозитория): starcitizen.md.