G-Rebels — киберпанковая игра о воздушных боях на Unreal Engine 5: вы летаете на VTOL над мегаполисами. Игра помещает каждый включённый вами джойстик на канал (от 0 до 5) и хранит роль каждой оси (тангаж, крен, рыскание, тяга, боковое смещение, вверх / вниз) и привязки кнопок для каждого канала в двух файлах сохранения. JoyPro читает эти роли и привязки в ваш профиль и записывает их обратно; клавиатура, геймпад и мышь остаются такими, как в игре.
G-Rebels напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine grebels- Файл привязок
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav(GVAS, роли осей меняются на месте) +EnhancedInputUserSettings.sav(кнопки)- Входы, которые читает игра
- читает 96 кнопок, 24 оси, без хаток на джойстик (документировано)
- Список команд из
- собственная таблица JoyPro (роли осей, кнопки)
- Внутриигровой тест
- 18/18 шагов пройдено (2026-10-11)
- ✓ Импорт
- ✓ Экспорт
- ✗ Привязки клавиатуры
- ✗ Модификаторы
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✗ Кривые осей и мёртвые зоныG-Rebels: только инверсия.
- ✗ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ◐ Мастер настройки / Автоназначение
- ✗ Кабины
- ✓ Шпаргалки
- ✓ Внутриигровой тест
Из матрицы поддержки, созданной по коду движка: все игры.
#Запуск за 3 шага
- Настроить всё за меня
на странице «Старт» - Использовать эти кнопки
сначала посмотрите список - Записать в мою игру
G-Rebels должна быть закрыта
До, один раз для каждого устройства в игре: назначьте ему канал в OPTIONS > INPUT > DEVICES. Измените одну роль оси на его вкладке JST. Привяжите одну кнопку. (Подробности ниже.)
Затем: ваши привязки видны на вкладке JST устройства.
Вы уже назначали кнопки в G-Rebels? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.
#Что JoyPro делает для G-Rebels
- Импорт: роли осей каждого канала (какая ось ручки — тангаж, крен, рыскание, тяга, боковое смещение, вверх / вниз) с инверсией и известные JoyPro привязки кнопок попадают в ваш профиль на ваших настоящих устройствах.
- Связки: «Pitch» в G-Rebels может быть той же связкой, что и тангаж в ваших других играх.
- Экспорт: JoyPro задаёт роли осей и привязки кнопок на каналах ваших устройств. Он никогда не добавляет канал или устройство: это вы один раз делаете в игре.
#Импорт привязок G-Rebels
- Откройте Старт. Если карточка G-Rebels просит список команд, нажмите Создать список: JoyPro записывает свою таблицу ролей осей и кнопок игры.
- Нажмите Импорт на карточке G-Rebels, оставьте Добавить в мой профиль (рекомендуется) и нажмите Импортировать.
- Мои связки открывает то, что пришло.


#Создание и проверка связок
Привяжите свои связки к действиям G-Rebels на странице Связки (см. работу со связками), затем запустите Проверить на странице «Экспорт». G-Rebels допускает одну роль на ось и одну кнопку на действие и канал; проверка показывает, где две связки хотят один и тот же вход.
#Экспорт в G-Rebels
- Закройте G-Rebels. JoyPro отказывается записывать, пока игра работает.
- Откройте Экспорт и отметьте карточку G-Rebels.
- Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.


Откройте OPTIONS > INPUT > CONTROLS и вкладку JST<канал> вашего устройства (JST0 для канала 0). В разделе AXIS каждая ось джойстика (X, Y, Z, RX, RY, RZ, Slider, Dial) показывает роль, заданную JoyPro (YAW, THRUST, ROLL, PITCH, SIDE STRAFE, UP / DOWN или NONE). В разделе BUTTONS привязанное действие показывает вашу кнопку, например «Enhanced Raw Input Controller 0 Button 5».
#Что вы делаете сами в G-Rebels
Сделайте это один раз для каждого устройства перед первым экспортом:
- Включите устройство: OPTIONS > INPUT > DEVICES показывает каждый джойстик как DEACTIVATED. Назначьте каждому нужному устройству канал (0 - CHANNEL ... 5 - CHANNEL). Устройство без канала экспорт пропускает с сообщением «включите его в OPTIONS > INPUT > DEVICES».
- Измените одну роль оси на вкладке JST устройства. Только тогда игра сохраняет строки осей этого канала; JoyPro меняет их на месте и никогда не добавляет. Одно лишь открытие вкладки ничего не сохраняет.
- Привяжите одну кнопку в игре один раз. Файл кнопок появляется с первой привязкой.
#Частые ошибки
- Роль оси не записывается: у канала ещё нет сохранённых строк осей. Измените одну роль оси на его вкладке JST в игре, закройте игру и снова выполните экспорт.
- Не хватает привязки кнопки: из кнопок игры пока подтверждена только Primary Fire; другие действия появятся, когда станут известны их названия.
- Несколько raw-input-устройств делят клавиши: перенесите весь HOTAS на одно устройство с помощью Виртуальный джойстик; тогда ему нужен только один канал.
#Файлы, которые JoyPro читает и записывает
| Файл | Что это |
|---|---|
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav |
устройства с их каналами (по HID-пути) и по одной строке оси на каждую ось каждого канала: роль, инверсия, мёртвая зона, множитель |
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\EnhancedInputUserSettings.sav |
привязки кнопок, по одному сопоставлению на действие и канал |
...\SaveOptions.sav.joypro-meta.json |
Данные JoyPro об экспортированных привязках (имена, группы), которые считывает следующий импорт |
Перед первой записью делается резервная копия обоих файлов сохранения (.jpbak рядом с ними и хранилище резервных копий JoyPro).
#Режимы экспорта в G-Rebels
Одна роль на ось и одна клавиша на действие и канал. Для ролей осей и для кнопок действуют одни правила.
| Режим | Что происходит |
|---|---|
| Только добавить | Роль ставится только на ось без роли; ось с другой ролью пропускается и помечается «Не записано в игру». |
| Обновить, привязки игры сохранить | Роль из профиля ставится на свою ось (прежняя роль там убирается); на других её осях роль остаётся. Кнопка: сопоставление другого действия на этой клавише убирается. |
| Обновить, мой профиль важнее | Как выше, и другие оси этой роли на подключённых каналах получают NONE. |
| Заменить на моих устройствах | Каждая другая роль записываемого канала становится NONE. |
| + Очистить и другие мои устройства | То же на включённых подключённых каналах, которые JoyPro не записывает. |
#Что никогда не затрагивается
- Клавиатура, геймпад, мышь и другие параметры игры.
- Канал, устройство которого не подключено, сохраняет свои роли.
- Игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
- Список устройств игры: JoyPro никогда не включает и не выключает устройство и никогда не добавляет канал.
#Оси и другие настройки
- Общие: один набор привязок на канал, без профилей ЛА.
- Инверсия записывается вместе с ролью. Хатки (строки POV), мёртвая зона и чувствительность пока не записываются.
- Нет общеигровых настроек, нет Force Feedback.
- Отслеживание: роль или привязка, которые вы меняете в игре, замечаются после её закрытия (отслеживание).
- HUD: пока работает G-Rebels, HUD называет действие каждой нажатой кнопки.
- Игра читает до 96 кнопок и 24 осей на устройство, без хаток.
#Внутри интеграции G-Rebels
flowchart LR D["G-Rebels: DEVICES<br/>устройство на канале 0-5"] --> S P["Ваш профиль<br/>(связки + привязки)"] --> E["engine grebels export"] E --> S["SaveOptions.sav<br/>роли осей + инверсия<br/>для каждого канала"] E --> B["EnhancedInputUserSettings.sav<br/>привязки кнопок для каждого канала"] S --> G["G-Rebels: CONTROLS ><br/>вкладка JST канала"] B --> G
Код: engine\Games\GRebelsIntegration.cs, engine\Games\GRebelsSaveOptions.cs, engine\Games\GvasKeyMappings.cs.
- SaveOptions.sav: Unreal GVAS (UE 5.8, теги свойств с деревьями типов).
JoysticksхранитS_Controller_Save { DeviceID (HID path), Enabled, MultiID (channel) };AxisOptionsхранитS_Input_Axis_Save { Key, Offset, Multiplier, Role, Inverted, DeadZone }с ключами вродеRawInput_Controller0_AxisYи ролью в виде enum (0 Yaw, 1 Thrust, 2 Roll, 3 Pitch, 4 Side strafe, 5 Up/down, 6 None). Контрольной суммы нет: JoyPro правит значения фиксированного размера на месте. - EnhancedInputUserSettings.sav: назначенные игроком клавиши Unreal Enhanced Input. Имена сопоставлений —
<ACTION>JST<channel>(PRIMARYFIREJST0), клавиши —RawInput_Controller<channel>_Button<n>, где n — номер кнопки DirectInput. Список сопоставлений переписывается; все остальные байты остаются. - Устройства: сопоставляются по HID-пути с каналом, который им дала игра.
- Список команд: собственная таблица JoyPro (
DB\GRebels\actions.tsv, роли осей и кнопки; файлы игры не читаются).engine grebels refresh-dbзаписывает её в папку данных игры; уже имеющиеся строки сохраняют свою запись. - Команды:
engine grebels paths,engine grebels catalog,engine grebels scan,engine grebels import,engine grebels export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --dry-run.
#Известные ограничения
- Хатки, мёртвая зона и чувствительность не записываются.
- Из кнопок в игре подтверждена только Primary Fire.
- Записи никогда не добавляются: каналы, строки осей и файл кнопок должны уже существовать от игры.
- Тесты:
engine\tests\smoke\grebels.ps1; в игреtools\e2e\games\GRebelsSettings.ps1(два запуска: первый даёт vJoy канал и сохраняет строки осей, второй проверяет случайные роли и Primary Fire на JST0; папка сохранений потом восстанавливается).
Все технические заметки по этой игре (созданы из репозитория): g-rebels.md.