G-Rebels — кіберпанкавая гульня пра паветраныя баі на Unreal Engine 5: вы лётаеце на VTOL над мегаполісамі. Гульня змяшчае кожны joystick, які вы ўключаеце, на канал (ад 0 да 5) і захоўвае ролю кожнай восі (тангаж, крэн, рысканне, цяга, бакавое зрушэнне, уверх / уніз) і прывязкі кнопак для кожнага канала ў двух файлах захавання. JoyPro чытае гэтыя ролі і прывязкі ў ваш профіль і запісвае іх назад; клавіятура, геймпад і мыш застаюцца такімі, як іх мае гульня.
G-Rebels напрамую (уласныя файлы прывязак)
- Падтрымка
- напрамую (уласныя файлы прывязак)
- Каманда рухавіка
engine grebels- Файл прывязак
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav(GVAS, ролі восяў змяняюцца на месцы) +EnhancedInputUserSettings.sav(кнопкі)- Уваходы, якія чытае гульня
- чытае 96 кнопак, 24 восі, без Hat на joystick (задакументавана)
- Спіс каманд з
- уласная табліца JoyPro (ролі восяў, кнопкі)
- Праверка ў гульні
- 18/18 крокаў пройдзена (2026-10-11)
- ✓ Імпарт
- ✓ Экспарт
- ✗ Прывязкі клавіятуры
- ✗ Мадыфікатары
- ✓ Спіс каманд, пабудаваны на вашым ПК
- ✓ Назіральнік за гульнямі
- ✗ Крывыя восяў і мёртвыя зоныG-Rebels: толькі інверсія.
- ✗ Налады кіравання ў гульні
- ✗ Налады зваротнай сувязі па сіле ў гульні
- ✗ Зваротная сувязь па сіле з тэлеметрыі
- ✗ Запіс тэлеметрыі
- ✓ Віртуальны joystick (vJoy)
- ◐ Віртуальны пульт Xbox
- ✓ Віртуальныя функцыі
- ◐ Майстар налады / Auto Assign
- ✗ Кабіны
- ✓ Шпаргалкі
- ✓ Праверка ў гульні
З матрыцы падтрымкі, створанай з кода рухавіка: усе гульні.
#Запуск за 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<channel> вашай прылады (JST0 для канала 0). У AXIS кожная вось joystick (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 пералічвае кожны joystick з DEACTIVATED. Дайце кожнай патрэбнай прыладзе канал (0 - CHANNEL ... 5 - CHANNEL). Прыладу без канала экспарт прапускае з паведамленнем «уключыце яе ў OPTIONS > INPUT > DEVICES».
- Змяніце адну ролю восі на ўкладцы JST прылады. Толькі тады гульня захоўвае радкі восяў гэтага канала; JoyPro змяняе іх на месцы і ніколі не дадае. Адно толькі адкрыццё ўкладкі нічога не захоўвае.
- Прывяжыце адну кнопку у гульні адзін раз. Файл кнопак з'яўляецца разам з першай прывязкай.
#Тыповыя памылкі
- Роля восі не запісваецца: у канала яшчэ няма захаваных радкоў восяў. Змяніце адну ролю восі на яго ўкладцы JST у гульні, закрыйце гульню, экспартуйце зноў.
- Прывязкі кнопкі няма: з кнопак гульні пакуль пацверджана толькі Primary Fire; іншыя дзеянні з'явяцца, калі стануць вядомыя іх назвы.
- Некалькі прылад raw input падзяляюць ключы: перанясіце ўвесь HOTAS на адну прыладу з дапамогай Віртуальны joystick; тады ёй патрэбны толькі адзін канал.
#Файлы, якія 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 ніколі не ўключае і не выключае прыладу і ніколі не дадае канал.
#Восі і іншыя налады
- Агульна: адзін набор прывязак на канал, без профіляў лятальных апаратаў.
- Інвертаваць запісваецца разам з роляй. Hat (радкі POV), мёртвая зона і адчувальнасць пакуль не запісваюцца.
- Без агульных налад гульні, без зваротнай сувязі па сіле.
- Назіральнік: роля або прывязка, якую вы змянілі ў гульні, заўважаецца пасля яе закрыцця (назіральнік).
- HUD: пакуль працуе G-Rebels, HUD называе дзеянне кожнай націснутай кнопкі.
- Гульня чытае да 96 кнопак і 24 восей на прыладу, без Hat.
#Унутры інтэграцыі 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, і роляй як пералічэннем (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.
#Вядомыя абмежаванні
- Hat, мёртвая зона і адчувальнасць не запісваюцца.
- З кнопак у гульні пацверджана толькі Primary Fire.
- Запісы ніколі не дадаюцца: каналы, радкі восей і файл кнопак павінны ўжо існаваць з гульні.
- Тэсты:
engine\tests\smoke\grebels.ps1; у гульніtools\e2e\games\GRebelsSettings.ps1(два запускі: першы дае vJoy канал і захоўвае радкі восей, другі правярае выпадковыя ролі і Primary Fire на JST0; пасля гэтага папка захаванняў аднаўляецца).
Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): g-rebels.md.