JoyPro2 Discord GitHub
Гульні

G-Rebels

Паказаць:

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 крокі

  1. Наладзіць усё за мяне
    на старонцы «Старт»
  2. Выкарыстаць гэтыя кнопкі
    спачатку паглядзіце спіс
  3. Запісаць у маю гульню
    G-Rebels павінна быць закрыта

Да, адзін раз для кожнай прылады ў гульні: дайце ёй канал у OPTIONS > INPUT > DEVICES. Змяніце адну ролю восі на яе ўкладцы JST. Прывяжыце адну кнопку. (Падрабязнасці ніжэй.)

Потым: вашы прывязкі паказваюцца на ўкладцы JST прылады.

Вы раней ужо прывязвалі кнопкі ў G-Rebels? Тады старонка «Старт» прапануе Імпартаваць, потым запоўніць прабелы. Вашы прывязкі застаюцца, і новыя функцыі атрымліваюць толькі вольныя кнопкі. Гл. Хуткі старт: каб мая ручка запрацавала.

#Што JoyPro робіць для G-Rebels

  • Імпарт: ролі восяў кожнага канала (якая вось ручкі — тангаж, крэн, рысканне, цяга, бакавое зрушэнне, уверх / уніз) з інверсіяй, а таксама прывязкі кнопак, якія ведае JoyPro, трапляюць у ваш профіль на вашых сапраўдных прыладах.
  • Сувязі: «Pitch» у G-Rebels можа быць той жа сувяззю, што і тангаж у іншых вашых гульнях.
  • Экспарт: JoyPro задае ролі восяў і прывязкі кнопак на каналах вашых прылад. Ён ніколі не дадае канал або прыладу: гэтую частку вы робіце адзін раз у гульні.

#Імпарт вашых прывязак G-Rebels

  1. Адкрыйце Старт. Калі картка G-Rebels просіць спіс каманд, націсніце Пабудаваць спіс: JoyPro запісвае ўласную табліцу роляў восяў і кнопак гульні.
  2. Націсніце Імпарт на картцы G-Rebels, пакіньце Дадаць у мой профіль (рэкамендуецца) і націсніце Імпартаваць зараз.
  3. Паглядзець мае сувязі адкрывае тое, што было імпартавана.
Старонка «Старт» з вашымі гульняміСтаронка «Старт» з вашымі гульнямі
Старонка «Старт» з вашымі гульнямі (На малюнках праграма па-англійску.)

#Стварэнне і праверка сувязей

Прывяжыце свае сувязі да дзеянняў G-Rebels на старонцы Сувязі (гл. працэс сувязей), потым запусціце Праверыць на старонцы «Экспарт». G-Rebels дазваляе адну ролю на вось і адну кнопку на дзеянне і канал; праверка паказвае, дзе дзве сувязі хочуць адзін і той жа ўваход.

#Экспарт у G-Rebels

  1. Закрыйце G-Rebels. JoyPro адмаўляецца запісваць, пакуль гульня працуе.
  2. Адкрыйце Экспарт і пастаўце птушку на картцы G-Rebels.
  3. Пакіньце Замяніць на маіх прыладах разам з Ачысціць і іншыя мае прылады, калі вы наладжваеце свае ручкі ў JoyPro. Націсніце Экспартаваць зараз на картцы.
Старонка «Экспарт»Старонка «Экспарт»
Старонка «Экспарт»
У гульні: Што вы бачыце ў G-Rebels

Адкрыйце 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

Зрабіце гэта адзін раз для кожнай прылады перад першым экспартам:

  1. Уключыце прыладу: OPTIONS > INPUT > DEVICES пералічвае кожны joystick з DEACTIVATED. Дайце кожнай патрэбнай прыладзе канал (0 - CHANNEL ... 5 - CHANNEL). Прыладу без канала экспарт прапускае з паведамленнем «уключыце яе ў OPTIONS > INPUT > DEVICES».
  2. Змяніце адну ролю восі на ўкладцы JST прылады. Толькі тады гульня захоўвае радкі восяў гэтага канала; JoyPro змяняе іх на месцы і ніколі не дадае. Адно толькі адкрыццё ўкладкі нічога не захоўвае.
  3. Прывяжыце адну кнопку у гульні адзін раз. Файл кнопак з'яўляецца разам з першай прывязкай.

#Тыповыя памылкі

  • Роля восі не запісваецца: у канала яшчэ няма захаваных радкоў восяў. Змяніце адну ролю восі на яго ўкладцы 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
Вы адзін раз даяце кожнай прыладзе канал у гульні. JoyPro запісвае ролі восей і кнопкі гэтага канала.

Код: 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.