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 крокі
- Наладзіць усё за мяне
на старонцы «Старт» - Выкарыстаць гэтыя кнопкі
спачатку паглядзіце спіс - Запісаць у маю гульню
Project Wingman павінна быць закрыта
Да: запусціце гульню адзін раз, потым закрыйце яе. Выключыце для гульні Steam Input.
Потым: вашы прывязкі знаходзяцца ў Элементы кіравання гульні. Дадалі або прыбралі кантролер? Экспартуйце зноў.
Вы раней ужо прывязвалі кнопкі ў Project Wingman? Тады старонка «Старт» прапануе Імпартаваць, потым запоўніць прабелы. Вашы прывязкі застаюцца, і новыя функцыі атрымліваюць толькі вольныя кнопкі. Гл. Хуткі старт: каб мая ручка запрацавала.
#Што JoyPro робіць для Project Wingman
- Імпарт: кожная прывязка joystick для лётных дзеянняў (тангаж, крэн, рысканне, цяга, дзве восі агляду і кнопкі) трапляе ў ваш профіль на вашых сапраўдных прыладах разам з інверсіяй, крывой і мёртвай зонай.
- Сувязі: «Fire missile» у Project Wingman можа быць той жа сувяззю, што і скід зброі ў іншых вашых гульнях.
- Экспарт: JoyPro запісвае вашы прывязкі ў
Input.ini, а крывыя і мёртвыя зоны — у захаванне гульні.
#Імпарт вашых прывязак Project Wingman
- Калі вы ніколі не запускалі гульню, запусціце яе адзін раз, каб з'явілася яе папка.
- Адкрыйце Старт. Калі картка Project Wingman просіць спіс каманд, націсніце Пабудаваць спіс: JoyPro чытае лётныя дзеянні з уласных файлаў гульні.
- Націсніце Імпарт на картцы, пакіньце Дадаць у мой профіль (рэкамендуецца), націсніце Імпартаваць зараз.


#Стварэнне і праверка сувязей
Аб'яднайце дзеянні Project Wingman з іншымі вашымі гульнямі на старонцы Сувязі (працэс сувязей), потым запусціце Праверыць на старонцы «Экспарт»: праверка знаходзіць кнопку, якая робіць у гульні дзве рэчы.
#Экспарт у Project Wingman
- Закрыйце Project Wingman. JoyPro адмаўляецца запісваць, пакуль яна працуе.
- Адкрыйце Экспарт і пастаўце птушку на картцы 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.savJoyPro сочыць пасля закрыцця гульні (назіральнік). - 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.