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 хатки на джойстик (документировано)
- Список команд из
- файлы
data\input\*.actions, которые записывает игра - Внутриигровой тест
- 38/38 шагов пройдено (2026-10-11)
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ✓ Модификаторы
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✓ Кривые осей и мёртвые зоны
- ✓ Настройки управления игры
- ✓ Настройки Force Feedback в игре
- ✓ Force Feedback из телеметрии
- ◐ Запись телеметрииВ телеметрии игры нет положения в мире: она записывается и экспортируется как CSV, без трека Tacview (ACMI).
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ✓ Мастер настройки / Автоназначение
- ✓ Кабины
- ✓ Шпаргалки
- ✓ Внутриигровой тест
Из матрицы поддержки, созданной по коду движка: все игры.
#Запуск за 3 шага
- Настроить всё за меня
на странице «Старт» - Использовать эти кнопки
сначала посмотрите список - Записать в мою игру
IL-2 должна быть закрыта
До: дайте IL-2 один раз записать свою раскладку клавиш. Откройте Settings > Key mapping и нажмите ACCEPT. Закройте IL-2.
Затем: ваши привязки находятся в Settings > Key mapping, в каждом ЛА IL-2.
Вы уже назначали кнопки в IL-2? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.
#Осмотр по сторонам без трекинга головы
Нет TrackIR и VR? Настройка помещает быстрые виды на одну хатку вашей ручки: вперёд, назад, влево и вправо. Оси обзора идут на мини-стик вашего РУД, если он есть. См. Трекинг головы и осмотр по сторонам.
#Что 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 и имя каждого джойстика |
<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 и фильтр шума джойстика (правятся на месте) |
<install>\data\startup.cfg |
значения Force Feedback и адрес телеметрии JoyPro |
current.map IL-2 собирает из этих файлов при каждом запуске; JoyPro его никогда не записывает.
#Режимы экспорта в IL-2
| Режим | Что происходит в IL-2 |
|---|---|
| Только добавить | Ничего не удаляется. Привязка, чей вход IL-2 уже использует для другого действия, не записывается и получает пометку «Не записано в игру». |
| Обновить, привязки игры сохранить | Ваши привязки добавляются; остальные привязки IL-2 остаются, кроме привязки другого действия на используемом вами входе. |
| Обновить, мой профиль важнее | Как выше, и каждое привязанное вами действие теряет свои другие входы (джойстики; клавиатуру — только с параметром клавиатуры). |
| Заменить на моих устройствах | Записываемые джойстики сохраняют только ваши привязки. |
| + Очистить и другие мои устройства | Подключённые джойстики без привязки в вашем профиле теряют свои привязки. |
global.actions сохраняет порядок игры; новые строки добавляются в конец.
#Что никогда не затрагивается
- Строки неподключённого джойстика, игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
- Строки мыши (также входы мыши с клавишами клавиатуры), TrackIR и строки со входом, который JoyPro не может прочитать.
- Клавиатура, если вы не экспортируете привязки клавиатуры.
current.mapи другие файлы игры.
#ЛА, кривые, Force Feedback
- Детализация: общая. Одно назначение клавиш и одна строка отклика на действие охватывают все ЛА.
- Кривые осей (модель осей
il2): мёртвая зона в центре, мёртвая зона на краю и кривая («sensitivity balance») для центрированных осей; нижняя и верхняя мёртвые зоны для односторонних осей, например РУД; смещение центра для тангажа. Кривая по умолчанию подгоняется под модель IL-2; можно также задать кривую только для IL-2 или для семейства IL-2 (Great Battles и Korea читают значения друг друга). Инверсия записывается в строке действия. - Настройки игры (Настройки > Настройки FFB игр): фильтр шума джойстика, включение 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.