IL-2 Great Battles зберігає одну розкладку клавіш для всіх літаків у текстових файлах в інсталяції гри (data\input). JoyPro читає цю розкладку у ваш профіль, дає змогу поєднати її дії з вашими іншими іграми у зв'язках («Gear» в IL-2 і в DCS на тій самій кнопці) і записує їх назад. Гра компілює файли під час запуску, тож під час польоту нічого від JoyPro не працює.
IL-2 Sturmovik: Great Battles напряму (власні файли прив'язок)
- Підтримка
- напряму (власні файли прив'язок)
- Команда рушія
engine il2- Файл прив'язок
<install>\data\input\*.actions,current.responses,global.pitch,current.devices; супровідний файлjp.actions- Входи, які читає гра
- читає 128 кнопок, 8 осей, 4 хети на joystick (задокументовано)
- Список команд з
- файли
data\input\*.actions, які записує гра - Внутрішньоігровий тест
- 38/38 кроків пройдено (2026-10-11)
- ✓ Імпорт
- ✓ Експорт
- ✓ Прив'язки клавіатури
- ✓ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✓ Налаштування керування гри
- ✓ Налаштування Force Feedback у грі
- ✓ Force Feedback з телеметрії
- ◐ Запис телеметріїТелеметрія гри не має положення у світі: вона записується й експортується як CSV, без треку Tacview (ACMI).
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
IL-2 має бути закрита
До: дайте IL-2 один раз записати свою розкладку клавіш. Відкрийте Settings > Key mapping і натисніть ACCEPT. Закрийте IL-2.
Потім: ваші прив'язки є в Settings > Key mapping, у кожному літаку IL-2.
Ви вже прив'язували кнопки в IL-2? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.
#Огляд довкола без відстеження голови
Немає TrackIR, немає VR? Налаштування кладе швидкі види (snap views) на один хет вашої ручки: вперед, назад, ліворуч і праворуч. Осі огляду йдуть на міні-стік вашого важеля газу, якщо він є. Див. Відстеження голови й огляд довкола.
#Що JoyPro робить для IL-2 Great Battles
- Імпорт: кожна дія розкладки клавіш, що стоїть на ручці, важелі газу, педалях чи панелі, потрапляє у ваш профіль разом із модифікаторами, інверсією осі та рядками відгуку осей. Клавіші клавіатури надходять, коли ви про це просите.
- Зв'язки: один зв'язок — це одна функція в усіх ваших іграх. IL-2 має одну розкладку клавіш для кожного літака, тож дія IL-2 у зв'язку працює в кожному літаку IL-2.
- Експорт: JoyPro записує файли розкладки клавіш у теку гри
data\input. IL-2 показує ваші прив'язки в Settings > Key mapping.
#Імпорт ваших прив'язок IL-2
- Відкрийте Початок. Картка IL-2 Great Battles показує зображення гри. Якщо вона просить список команд, натисніть Створити список: JoyPro читає файли розкладки клавіш, які записала ваша IL-2.
- Натисніть Імпорт на картці. Виберіть Додати до мого профілю (або Почати знову з цієї гри) і позначте Брати також клавіші клавіатури, якщо хочете й свої льотні клавіші.
- Натисніть Імпортувати зараз. Показати мої зв'язки відкриває те, що надійшло.


#Створення й перевірка зв'язків
На сторінці Зв'язки кожна дія IL-2 у зв'язку стоїть поруч із тією самою функцією у ваших інших іграх. Об'єднайте їх за допомогою процесу зв'язків, потім натисніть Перевірити зараз на сторінці «Експорт»: перевірка знаходить кнопку, яка робить дві речі в IL-2, раніше за гру (Перевірка).
#Експорт в IL-2
- Закрийте IL-2. JoyPro відмовляється записувати, поки працює
Il-2.exe. - Відкрийте Експорт. Картка IL-2 показує, скільки її зв'язків прив'язано.
- Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої, якщо ви налаштовуєте свої ручки в JoyPro. Натисніть Експортувати зараз на картці IL-2.


Запустіть IL-2 і відкрийте Settings > Key mapping. Ваші прив'язки стоять у рядках дій кожної вкладки (наприклад, Plane controls), на ваших пристроях. Відгук осей, який записав JoyPro, гра використовує з цього запуску. Значення Force Feedback і фільтра шуму, які встановив JoyPro, видно в Settings > Input devices.
#Що ви робите самі в IL-2
- Дайте IL-2 один раз записати свою розкладку клавіш. Якщо в
data\inputще немаєglobal.actions, відкрийте Settings > Key mapping і натисніть ACCEPT. Без цього файлу імпортувати нічого, а список команд містить лише дії, які записала гра. - Для значень Force Feedback і фільтра шуму: один раз відкрийте Settings > Input devices і натисніть ACCEPT, щоб гра створила свій файл
current.devices. JoyPro змінює цей файл, але не створює його. - Для власного Force Feedback від JoyPro з телеметрії гри сторінка Force Feedback додає адресу JoyPro у
startup.cfgгри (спершу закрийте IL-2). Потім вимкніть власний Force Feedback IL-2 для цієї ручки.
#Типові помилки
- «IL-2 запущена»: повністю закрийте гру й експортуйте знову.
- Прив'язки не на тому пристрої: IL-2 розрізняє пристрої за номером у
devices.txt. Пристрій, який записує JoyPro, зберігає свій номер; новий пристрій отримує найменший вільний. Не перенумеровуйте пристрої в грі між експортом та імпортом. - Прив'язки бракує після «Лише додати»: кнопку в IL-2 використано для іншої дії. Перевірка перелічує її в розділі «Не записано в гру»; експортуйте з Оновлення або перенесіть прив'язку.
- Значення Force Feedback не змінилися: у гри ще немає
current.devices(див. вище).
#Файли, які JoyPro читає й записує
| Файл | Що це |
|---|---|
<install>\data\input\global.actions |
зіставлення клавіш: один рядок на дію, `action, input, invert |
<install>\data\input\devices.txt |
список пристроїв: номер, GUID DirectInput і назва кожного joystick |
<install>\data\input\current.responses |
рядки відгуку осей для кожної дії (центровані, односторонні), для всіх літаків |
<install>\data\input\global.pitch |
рядок тангажу зі зсувом центру (створюється, лише якщо ви його задаєте) |
<install>\data\input\jp.actions |
копія JoyPro з назвами зв'язків, групами, модифікаторами й налаштуваннями осей, яку зчитує наступний імпорт |
<install>\data\input\current.devices |
Settings > Input devices: Force Feedback і фільтр шуму joystick (змінюються на місці) |
<install>\data\startup.cfg |
значення Force Feedback і адреса телеметрії JoyPro |
current.map IL-2 компілює з цих файлів при кожному запуску; JoyPro ніколи його не записує.
#Режими експорту в IL-2
| Режим | Що відбувається в IL-2 |
|---|---|
| Лише додати | Нічого не видаляється. Прив'язка, вхід якої IL-2 уже використовує для іншої дії, не записується й отримує позначку «Не записано в гру». |
| Оновити, зберегти прив'язки гри | Ваші прив'язки додаються; інші прив'язки IL-2 залишаються, крім прив'язки іншої дії на вході, який використовуєте ви. |
| Оновити, мій профіль головніший | Як вище, і кожна дія, яку ви прив'язуєте, втрачає свої інші входи (joystick; клавіатура — лише з параметром клавіатури). |
| Замінити на моїх пристроях | Joystick, у які ви записуєте, зберігають лише ваші прив'язки. |
| + Очистити й інші мої пристрої | Підключені joystick без прив'язки у вашому профілі втрачають свої прив'язки. |
global.actions зберігає порядок гри; нові рядки йдуть у кінець.
#Що ніколи не змінюється
- Рядки joystick, який не підключено, пристрої, ігноровані під час імпорту, і пристрій vJoy, у який передає JoyPro.
- Рядки миші (також входи миші з клавішами клавіатури), TrackIR і рядки зі входом, який JoyPro не може прочитати.
- Клавіатура, якщо ви не експортуєте прив'язки клавіатури.
current.mapта інші файли гри.
#Літаки, криві, Force Feedback
- Деталізація: глобальна. Одне зіставлення клавіш і один рядок відгуку на дію охоплюють усі літаки.
- Криві осей (модель осей
il2): мертва зона в центрі, мертва зона на краю і крива («sensitivity balance») для центрованих осей; нижня й верхня мертві зони для односторонніх осей, як-от газ; зсув центру для тангажу. Типова крива підганяється під модель IL-2; можна також задати криву лише для IL-2 або для родини IL-2 (Great Battles і Korea читають значення одна одної). Інверсія записується в рядку дії. - Налаштування гри (Налаштування > Налаштування force feedback ігор): фільтр шуму joystick, увімкнення Force Feedback, сила зворотного зв'язку й тряска. Експорт без прив'язок IL-2 усе одно їх записує.
- Force Feedback з телеметрії: власні ефекти JoyPro з телеметрії гри (Force Feedback). Ті самі дані використовує запис телеметрії (CSV; телеметрія не має положення у світі, тож треку Tacview немає).
- HUD: показує прив'язки IL-2 натиснутих кнопок, поки працює IL-2 (HUD).
- Спостерігач: прив'язку, яку ви змінили в Key mapping, помічено після закриття IL-2; JoyPro питає, чи перенести її (спостерігач).
#Усередині інтеграції IL-2
flowchart LR P["Ваш профіль"] --> E["engine il2 export"] E --> A["global.actions<br/>+ jp.actions"] E --> D["devices.txt"] E --> R["current.responses<br/>global.pitch"] A --> G["current.map<br/>(під час запуску)"] D --> G R --> G G --> K["Settings ><br/>Key mapping"]
Код: engine\EngineIl2.cs (імпорт, експорт, файли), engine\EngineIl2DbRefresh.cs (список команд), engine\AxisModels (модель il2), engine\EngineFfbTelemetry.cs (налаштування телеметрії).
- Входи:
joy<N>_b<button, 0-based>,joy<N>_axis_<x|y|z|...>,joy<N>_pov<hat>_<angle>, клавіші клавіатури за назвою DirectInput, пари осей як<input>/<input>, модифікатори як<modifier>+<input>. IL-2 нумерує хети від 0, JoyPro — від 1 (JOY_BTN_POV1_*— цеpov0). - Пристрої:
devices.txtперелічує<number>,"<GUID>",<name>|; IL-2 записує останні 8 байтів GUID екземпляра DirectInput у зворотному порядку як одну групу. Кожен режим зберігає вже вказані номери. - Список команд:
engine db refresh-il2читає файли*.actions, які записує гра (неjp.actions); вкладки гри (Service, Camera controls, Plane controls, Weapons controls ...) — це категорії. Гра записує лише дії, які мають вхід, тож список нової установки містить близько 376 дій. - Імпорт / експорт:
engine il2 import,engine il2 scan,engine il2 export(--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --ignore-device <d>). Резервні копії: кожен файл у<file>.jpbakі в сховище резервних копій перед першим записом. - Налаштування й криві:
engine ffb set--device * --game IL2Game,engine binds tuning set--scope game:IL2Gameабоfamily:il2,engine binds tuning preview. - Телеметрія:
engine ffb telemetry setupil2додає один рядок адреси127.0.0.1:41994до розділуtelemetrydeviceуstartup.cfgі ніколи не змінює адреси інших програм;--removeвідновлює файл байт у байт. - Спостерігач:
engine sync status,engine sync diff(під наглядом:global.actions,devices.txt,current.responses,current.devices,startup.cfg).
#Відомі обмеження
- Дій без входу у файлах гри немає в щойно побудованому списку команд.
- Власний Force Feedback гри має бути вимкнено для ручки, яка отримує Force Feedback з телеметрії від JoyPro.
- Тести:
engine\tests\smoke\il2.ps1; у гріtools\e2e\games\IL2Game.ps1(прив'язки, 38 із 38 кроків) іIL2GameCurves.ps1(відгуки, скомпільовані грою, порівняно з попереднім переглядом JoyPro).
Усі технічні примітки до цієї гри (створено з репозиторію): README.md.