JoyPro2 Discord GitHub
Ігри

Project Wingman

Показати:

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

  1. Налаштувати все за мене
    на сторінці «Початок»
  2. Використати ці кнопки
    спершу перегляньте список
  3. Записати в мою гру
    Project Wingman має бути закрита

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

Потім: ваші прив'язки є в розділі гри Controls. Додали чи прибрали контролер? Експортуйте знову.

Ви вже прив'язували кнопки в 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

Відкрийте розділ гри 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.