JoyPro2 Discord GitHub
Гульні

Project Wingman

Паказаць:

Project Wingman — аркадная гульня пра паветраныя баі на Unreal Engine 4. Яна чытае адначасова некалькі прылад DirectInput і захоўвае прывязкі ў простым Input.ini, кожную з назвай прылады і яе месцам у спісе прылад гульні; крывыя і мёртвыя зоны захоўваюцца ў захаванні гульні. JoyPro чытае абодва ў ваш профіль і запісвае іх назад. Клавіятура, мыш, геймпад і Hat застаюцца такімі, як іх мае гульня.

Project Wingman напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine pw
Файл прывязак
%LOCALAPPDATA%\ProjectWingman\Saved\Config\WindowsNoEditor\Input.ini (Unreal ini, па назве і месцы прылады) + крывыя і мёртвыя зоны ў savegame.sav
Спіс каманд з
DefaultInput.ini з pak-файла гульні + ваш Input.ini
Праверка ў гульні
19/25 крокаў пройдзена (2026-10-12)
  • ✓ Імпарт
  • ✓ Экспарт
  • ✗ Прывязкі клавіятуры
  • ✗ Мадыфікатары
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ◐ Майстар налады / Auto Assign
  • ✗ Кабіны
  • ✓ Шпаргалкі
  • ◐ Праверка ў гульніProject Wingman: экспарт і імпарт правераны ў гульні; яшчэ патрэбны адзін поўны прагон тэсту (пакуль 19/25 і 17/24).

З матрыцы падтрымкі, створанай з кода рухавіка: усе гульні.

Для пачаткоўцаў

#Запуск за 3 крокі

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

Да: запусціце гульню адзін раз, потым закрыйце яе. Выключыце для гульні Steam Input.

Потым: вашы прывязкі знаходзяцца ў Элементы кіравання гульні. Дадалі або прыбралі кантролер? Экспартуйце зноў.

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

#Што JoyPro робіць для Project Wingman

  • Імпарт: кожная прывязка joystick для лётных дзеянняў (тангаж, крэн, рысканне, цяга, дзве восі агляду і кнопкі) трапляе ў ваш профіль на вашых сапраўдных прыладах разам з інверсіяй, крывой і мёртвай зонай.
  • Сувязі: «Fire missile» у Project Wingman можа быць той жа сувяззю, што і скід зброі ў іншых вашых гульнях.
  • Экспарт: JoyPro запісвае вашы прывязкі ў Input.ini, а крывыя і мёртвыя зоны — у захаванне гульні.

#Імпарт вашых прывязак Project Wingman

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

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

Аб'яднайце дзеянні Project Wingman з іншымі вашымі гульнямі на старонцы Сувязі (працэс сувязей), потым запусціце Праверыць на старонцы «Экспарт»: праверка знаходзіць кнопку, якая робіць у гульні дзве рэчы.

#Экспарт у Project Wingman

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

Адкрыйце Элементы кіравання гульні. KEY BINDINGS і AXIS BINDINGS паказваюць вашы прывязкі ў наступным вольным слоце кожнага радка з назвай прылады без прабелаў і яе нумарам, напрыклад «VJOYDEVICE 8 BUTTON 24» або «VJOYDEVICE 8 AXIS 1», з птушкай у полі Інвертаваць там, дзе вы інвертавалі. CURVES + DEADZONES паказвае CURVE і DEADZONE, якія JoyPro запісаў для кожнай восі.

#Што вы робіце самі ў Project Wingman

  • Экспартуйце зноў пасля таго, як дадалі або прыбралі кантролер. Гульня нумаруе прыладу па яе месцы ў сваім спісе прылад, і гэтае месца змяняецца, калі кантролер з'яўляецца або знікае. JoyPro вылічвае яго па прыладах, падключаных падчас экспарту.
  • Hat: гульня не можа прывязаць Hat. Задайце Hat Function 1 / 2 (WEAPON або VIEW) у Controls > Miscellaneous.
  • Выключыце для гульні Steam Input; пульт Steam Input паказваецца як дадатковая прылада.

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

  • Прывязкі паказваюць на не тую прыладу: пасля экспарту быў дададзены або прыбраны кантролер. Экспартуйце зноў з вашымі звычайнымі падключанымі прыладамі. Імпарт папярэджвае, калі нумар прылады змяніўся.
  • Прывязка Hat адхілена: так задумана, гл. Hat Function вышэй.
  • РУД тармозіць у ніжняй палове: «Thrust Axis» у Project Wingman — цэнтраваная вось: вышэй за цэнтр яна паскарае, ніжэй — тармозіць.
Дадаткова

#Файлы, якія JoyPro чытае і запісвае

Файл Што гэта
%LOCALAPPDATA%\ProjectWingman\Saved\Config\WindowsNoEditor\Input.ini прывязкі, раздзел [/Script/Engine.InputSettings]: радкі ActionMappings=(...) і AxisMappings=(...)
%LOCALAPPDATA%\ProjectWingman\Saved\SaveGames\savegame.sav крывыя і мёртвыя зоны для кожнага дзеяння восі (<Axis>Curve, <Axis>Deadzone) і функцыі Hat
<install>\ProjectWingman\Content\Paks\pakchunk0-WindowsNoEditor.pak толькі для чытання: DefaultInput.ini, прывязкі гульні па змаўчанні і спіс дзеянняў
...\Input.ini.joypro-meta.json даныя JoyPro пра экспартаваныя прывязкі (назвы, групы, налада) для наступнага імпарту

Гульня запісвае Input.ini у той момант, калі прывязка змяняецца ў яе меню, і толькі тыя спісы, якія вы змянілі; астатнія бяруцца са значэнняў па змаўчанні ў pak. Паколькі запісаны спіс замяняе значэнні па змаўчанні, JoyPro спачатку запісвае значэнні па змаўчанні для адсутнага спіса. Steam Cloud сінхранізуе папку захаванняў.

#Рэжымы экспарту ў Project Wingman

Выдаляюцца толькі прызначэнні джойсціка для дзеянняў палёту з каталога; клавіятура, пульт, мыш, радкі меню і прылады, якія не падключаны, застаюцца.

Рэжым Што адбываецца
Толькі дадаць Прывязка на ўваходзе, які гульня выкарыстоўвае для іншага дзеяння палёту, не запісваецца (пазначаецца «Не запісана ў гульню»); уласная форма прывязкі ў гульні (Invert) застаецца.
Абнавіць, пакінуць прывязкі гульні Таксама выдаляе прызначэнне гульні на ўваходзе, які профіль аддае іншаму дзеянню; іншыя прызначэнні дзеяння застаюцца.
Абнавіць, мой профіль мацнейшы Таксама выдаляе іншыя прызначэнні джойсціка ў кожнага дзеяння, якое прывязвае профіль, каб перанос быў поўным.
Замяніць на маіх прыладах Экспартаваныя прылады губляюць свае іншыя прызначэнні джойсціка (гульня толькі пра палёт).
+ Ачысціць і іншыя мае прылады Тое ж самае на іншых падключаных прыладах.

#Што ніколі не змяняецца

  • Прызначэнні клавіятуры, мышы і пульта, радкі меню, Hat.
  • Прылады, якія не падключаны, прылады, што імпарт ігнаруе, і прылада vJoy, у якую JoyPro перадае сігналы.
  • Кожны іншы радок Input.ini (парадак і канцы радкоў захоўваюцца) і кожны іншы байт savegame.sav.

#Крывыя, мёртвыя зоны, іншыя налады

  • Для кожнага дзеяння восі, для ўсіх прылад разам: CURVE (у меню ад 0.00 да 2.00, 1.00 = прамая) і DEADZONE (ад 0 да 100 %) для pitch, roll, thrust, yaw і дзвюх восей агляду. Значэнні гульні па змаўчанні: pitch і roll 25 %, агляд 10 %, thrust і yaw 0 %.
  • Інвертаваць для кожнай прывязкі (поле Invert у слоце).
  • Формула гульні невядомая. Папярэдні прагляд JoyPro мяркуе перамаштабаваную мёртвую зону і крывую як паказчык ступені (яшчэ не пацверджана).
  • Глабальна: профіляў лятальных апаратаў няма. Няма мадыфікатараў (у гульні іх няма), няма зваротнай сувязі па сіле.
  • Назіральнік: за Input.ini і savegame.sav JoyPro сочыць пасля закрыцця гульні (назіральнік).
  • HUD: пакуль гульня працуе, HUD называе дзеянне кожнай націснутай кнопкі.
Тэхнічныя падрабязнасці

#Унутры інтэграцыі Project Wingman

flowchart LR
  P["Ваш профіль<br/>(сувязі + прывязкі)"] --> E["engine pw export"]
  D["Падключаныя прылады<br/>(іх месца ў спісе)"] --> E
  E --> I["Input.ini<br/>ActionMappings /<br/>AxisMappings"]
  E --> S["savegame.sav<br/>крывая + мёртвая зона<br/>для кожнай восі"]
  I --> G["Project Wingman: Controls<br/>KEY / AXIS BINDINGS"]
  S --> C["CURVES + DEADZONES"]
Гульня нумаруе прыладу па яе месцы ў сваім спісе. Пасля таго як вы дадалі або адключылі кантролер, экспартуйце зноў.

Код: engine\Games\ProjectWingmanIntegration.cs, engine\Games\ProjectWingmanSaveGame.cs, engine\AxisModels\ProjectWingman.cs (мадэль восі projectwingman).

  • Ключы: Joystick_<name>_<place>_Axis<n>, ..._Button<n>. <name> — назва прадукту DirectInput без прабелаў (VPforce Rhino FFB Joystick становіцца VPforceRhinoFFBJoystick), а не радок HID. <place> — месца прылады ў спісе гульні (Controls > Miscellaneous), гэта парадак DirectInput наадварот; пультаў XInput у гэтым спісе няма. Axis<n> лічыць наяўныя восі прылады ад 0 у парадку X Y Z Rx Ry Rz Slider Slider; Button<n> лічыць ад 0. Ключ з коскай у назве бярэцца ў двукоссе.
  • Інвертаваць = Scale=-1.000000.
  • Значэнні па змаўчанні: ключы Android_* са значэнняў па змаўчанні ў pak захоўваюцца, бо меню паказвае адзін слот на прызначэнне, а гэтыя ключы — пустыя слоты.
  • savegame.sav: Unreal GVAS; FloatProperty <Axis>Curve (палова значэння ў меню) і <Axis>Deadzone (0..1) рэдагуюцца на месцы або дадаюцца перад завяршальным None. Кантрольнай сумы няма.
  • Спіс каманд: engine pw refresh-db чытае DefaultInput.ini з pak і ваш Input.ini: 6 восей і 14 кнопак.
  • Каманды: engine pw paths, engine pw catalog, engine pw scan, engine pw import, engine pw export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --dry-run.

#Вядомыя абмежаванні

  • Нумар прылады змяняецца разам з вашымі кантролерамі: пасля змены абсталявання экспартуйце зноў.
  • Hat і мадыфікатары адхіляюцца.
  • Формула крывой — рабочае дапушчэнне.
  • Адзін поўны прагон тэсту ў гульні яшчэ наперадзе; экспарт і імпарт ужо праверылі ў гульні.
  • Тэсты: engine\tests\smoke\projectwingman.ps1 (фікстуры сапраўднай формы); у гульні tools\e2e\games\ProjectWingmanSettings.ps1 (выпадковыя восі, кнопкі, інверсія, крывая і мёртвая зона; старонкі кіравання счытваюцца назад; папкі канфігурацыі і захаванняў аднаўляюцца).

Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): project-wingman.md.