Project Wingman — аркадна гра про повітряні бої на Unreal Engine 4. Вона читає кілька пристроїв DirectInput одночасно й зберігає прив'язки у простому Input.ini, кожну з назвою пристрою та його місцем у списку пристроїв гри; криві й мертві зони зберігаються в збереженні гри. JoyPro читає обидва у ваш профіль і записує їх назад. Клавіатура, миша, геймпад і хети залишаються такими, як їх налаштовано в грі.
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)
- ✓ Імпорт
- ✓ Експорт
- ✗ Прив'язки клавіатури
- ✗ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✗ Налаштування керування гри
- ✗ Налаштування Force Feedback у грі
- ✗ Force Feedback з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ◐ Майстер налаштування / Auto Assign
- ✗ Кабіни
- ✓ Шпаргалки
- ◐ Внутрішньоігровий тестProject Wingman: експорт та імпорт перевірено в грі; ще потрібен один повний прогін тесту (поки що 19/25 і 17/24).
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
Project Wingman має бути закрита
До: один раз запустіть гру, потім закрийте її. Вимкніть для гри Steam Input.
Потім: ваші прив'язки є в розділі гри Controls. Додали чи прибрали контролер? Експортуйте знову.
Ви вже прив'язували кнопки в 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.
- Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої або виберіть Оновити, зберегти прив'язки гри, якщо ви також прив'язуєте в грі. Натисніть Експортувати зараз на картці.


Відкрийте розділ гри Controls. KEY BINDINGS і AXIS BINDINGS показують ваші прив'язки в наступному вільному слоті кожного рядка, з назвою пристрою без пробілів і його номером, наприклад «VJOYDEVICE 8 BUTTON 24» або «VJOYDEVICE 8 AXIS 1», а там, де ви інвертували, позначено поле Invert. CURVES + DEADZONES показує CURVE і DEADZONE, які JoyPro записав для кожної осі.
#Що ви робите самі в Project Wingman
- Експортуйте знову після того, як додали чи прибрали контролер. Гра нумерує пристрій за його місцем у своєму списку пристроїв, і це місце змінюється, коли контролер з'являється або зникає. JoyPro обчислює його за пристроями, підключеними під час експорту.
- Хети: гра не вміє прив'язувати хет. Налаштуйте Hat Function 1 / 2 (WEAPON або VIEW) в Controls > Miscellaneous.
- Вимкніть для гри Steam Input; геймпад Steam Input з'являється як додатковий пристрій.
#Типові помилки
- Прив'язки вказують на не той пристрій: після експорту контролер додали або прибрали. Експортуйте знову з підключеними звичними пристроями. Імпорт попереджає, коли номер пристрою зсунувся.
- Прив'язку хета відхилено: так задумано, див. 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) і функції хета |
<install>\ProjectWingman\Content\Paks\pakchunk0-WindowsNoEditor.pak |
лише читання: DefaultInput.ini, стандартні прив'язки гри й список дій |
...\Input.ini.joypro-meta.json |
дані JoyPro про експортовані прив'язки (назви, групи, налаштування осей) для наступного імпорту |
Гра записує Input.ini тієї ж миті, коли в її меню змінюється прив'язка, і лише ті списки, які ви змінили; решта береться зі стандартних значень pak. Оскільки записаний список замінює стандартні значення, JoyPro спершу записує стандартні значення відсутнього списку. Steam Cloud синхронізує теку збережень.
#Режими експорту в Project Wingman
Видаляються лише призначення joystick для дій польоту з каталогу; клавіатура, геймпад, миша, рядки меню й непідключені пристрої залишаються.
| Режим | Що відбувається |
|---|---|
| Лише додати | Прив'язка на вході, який гра використовує для іншої дії польоту, не записується (позначено «Не записано в гру»); власна форма прив'язки гри (Invert) залишається. |
| Оновити, зберегти прив'язки гри | Також видаляє призначення гри на вході, який профіль віддає іншій дії; інші призначення цієї дії залишаються. |
| Оновити, мій профіль головніший | Також видаляє інші призначення joystick кожної дії, яку прив'язує профіль, тож перенесення переносить повністю. |
| Замінити на моїх пристроях | Експортовані пристрої втрачають свої інші призначення joystick (гра лише про політ). |
| + Очистити й інші мої пристрої | Те саме на інших підключених пристроях. |
#Що ніколи не змінюється
- Призначення клавіатури, миші й геймпада, рядки меню, хети.
- Пристрої, які не підключено, пристрої, ігноровані під час імпорту, і пристрій 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 припускає перемасштабовану мертву зону й криву як показник степеня (ще не підтверджено).
- Глобально: без профілів літаків. Без модифікаторів (у грі їх немає), без Force Feedback.
- Спостерігач: за
Input.iniіsavegame.savстежать після закриття гри (спостерігач). - 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.
#Відомі обмеження
- Номер пристрою змінюється разом із вашими контролерами: після зміни обладнання експортуйте знову.
- Хети й модифікатори відхиляються.
- Формула кривої — робоче припущення.
- Один повний прогін тесту в грі ще попереду; експорт та імпорт перевірено в грі.
- Тести:
engine\tests\smoke\projectwingman.ps1(тестові файли справжньої форми); у гріtools\e2e\games\ProjectWingmanSettings.ps1(випадкові осі, кнопки, інверсія, крива й мертва зона; сторінки керування читаються назад; теки конфігурації й збережень відновлюються).
Усі технічні примітки до цієї гри (створено з репозиторію): project-wingman.md.