War Thunder зберігає ваше керування в machine.blk — текстовому файлі, який містить лише те, що відрізняється від пресету, з якого ви почали. JoyPro зчитує керування літаками й гелікоптерами у ваш профіль і записує його назад на місце: керування танками, кораблями й меню залишається без змін. Гра також зберігає копію файлу на сервері Gaijin; JoyPro записує так, щоб під час наступного входу переміг ваш експортований файл.
War Thunder напряму (власні файли прив'язок)
- Підтримка
- напряму (власні файли прив'язок)
- Команда рушія
engine warthunder- Файл прив'язок
Documents\My Games\WarThunder\Saves\<uid>\production\machine.blk(текст BLK, відмінності від пресета)- Список команд з
- за замовчуванням
gui.vromfs.bin/lang.vromfs.bin; власний список JoyPro з--no-game-archives(Налаштування > Ігри) - Внутрішньоігровий тест
- 29/29 кроків пройдено (2026-10-10)
- ✓ Імпорт
- ✓ Експорт
- ✓ Прив'язки клавіатури
- ✓ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✓ Налаштування керування гри
- ✓ Налаштування Force Feedback у грі
- ✓ Force Feedback з телеметрії
- ✓ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
тримайте War Thunder закритою
До: один раз увійдіть у гру. Підключіть пристрої, запустіть гру й один раз відкрийте Елементи керування. Потім вийдіть.
Потім: увійдіть у гру. Ваші прив'язки — в Елементи керування.
Ви вже прив'язували кнопки у War Thunder раніше? Тоді сторінка «Початок» пропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаються, а нові завдання отримують лише вільні кнопки. Див. Швидкий старт: як змусити мою ручку керування працювати.
#Що JoyPro робить для War Thunder
- Імпорт: клавіші швидкого доступу й осі літаків і гелікоптерів на ваших пристроях потрапляють у ваш профіль разом з усіма значеннями діалогу налаштування осей гри та загальними параметрами керування гри (чутливість, інверсія, WEP, автотрим, Force Feedback).
- Зв'язки: один зв'язок — це одна функція в усіх іграх. «Шасі» може бути тим самим перемикачем у War Thunder, DCS та IL-2.
- Експорт: JoyPro редагує
machine.blkна місці. Танки, кораблі, підводні човни, піхота й меню ніколи не зачіпаються.
#Імпорт ваших прив'язок War Thunder
- Відкрийте Початок. Якщо картка War Thunder просить список команд, натисніть Створити список: JoyPro зчитує дії літаків і гелікоптерів з архівів гри (лише читання; 290 дій). У Налаштування > Ігри це можна вимкнути; тоді JoyPro використовує свій коротший список.
- Натисніть Імпорт на картці War Thunder. Залиште Додати до мого профілю. Позначте Брати також клавіші клавіатури, якщо хочете мати в JoyPro й свої льотні клавіші.
- Натисніть Імпортувати зараз. Показати мої зв'язки відкриває те, що надійшло.


#Створення й перевірка зв'язків
Об'єднайте ту саму функцію ваших ігор за допомогою процесу роботи зі зв'язками, потім натисніть Перевірити на сторінці «Експорт». Газ літака й загальний крок гелікоптера на одній осі — у War Thunder це нормально; дві дії літака на одній кнопці — ні.
#Експорт у War Thunder
- Закрийте War Thunder. Гра час від часу зберігає файл, поки працює, і під час виходу, тому JoyPro відмовляється записувати, поки вона працює.
- Відкрийте Експорт і позначте картку War Thunder.
- Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої, якщо ви налаштовуєте свої ручки в JoyPro. Натисніть Експортувати зараз на картці.


Запустіть гру й увійдіть. В ангарі натисніть Esc і відкрийте Елементи керування. Ваші прив'язки — в розділах літаків і гелікоптерів; діалог Налаштування осі для осі показує її мертву зону, нелінійність, множник, корекцію та інверсію. Рядки чутливості, множник Force Feedback і автотрим показуються лише в реалістичному й повністю реальному режимах керування. Клацання вкладок Mouse aim / Simplified / Realistic / Full-real змінює ваш режим керування, а не фільтрує список.
#Що ви робите самі у War Thunder
- Дайте грі один раз перелічити кожен пристрій. War Thunder нумерує кнопки й осі кожного пристрою у власній таблиці. Підключіть пристрій, запустіть гру й відкрийте Елементи керування: тоді гра додасть пристрій у
machine.blk. JoyPro пропускає пристрій, якого гра ще не перелічила. - Перед першим експортом один раз увійдіть у гру, щоб файл вашого облікового запису існував.
#Типові помилки
- «War Thunder працює»: вийдіть із гри й експортуйте знову.
- Пристрій пропущено: гра його не перелічила, два підключені пристрої мають однаковий VID:PID, або кількість його кнопок чи осей відрізняється від тієї, що записала гра (усі номери були б зсунуті). Відкрийте в грі «Елементи керування», коли пристрій підключено.
- Старі прив'язки повернулися після входу: ви вручну відновили копію. Натомість використовуйте Скасувати останній експорт: тоді JoyPro підвищує версію файлу, щоб сервер його не замінив.
- Діагоналі хета, кнопки миші та модифікатори осей записати неможливо.
#Файли, які JoyPro читає й записує
| Файл | Що це |
|---|---|
%USERPROFILE%\Documents\My Games\WarThunder\Saves\<uid>\production\machine.blk |
ваше керування (hotkeys{}, axes{}, params{}, deviceMapping{}) і блоки налаштувань гри; <uid> — це ваш обліковий запис (його називає Saves\lastlogin.blk; Saves\last до входу) |
...\production\machine.blk.joypro-meta.json |
назви, групи й налаштування осей записаних прив'язок від JoyPro, які зчитує наступний імпорт |
machine.blk.jpbak |
копія, зроблена перед першим записом, а також сховище версійних резервних копій JoyPro |
експортований пресет керування (controls{} угорі) |
його теж можна імпортувати й експортувати; параметри для всієї гри записуються лише в machine.blk |
machine.blk — це різниця відносно базового пресету, названого в basePresetPaths: перший блок комбінації замінює весь список пресету для неї, порожній ID_X{} означає «не прив'язано», а відсутній атрибут осі означає «значення пресету». JoyPro записує блоки комбінацій з каталогу, axisId і значення осей з каталогу, а також окремі ключі параметрів, які ви задаєте. Усі інші рядки зберігають свій текст; deviceMapping{} лише читається.
#Режими експорту у War Thunder
Враховується лише керування літаками й гелікоптерами з каталогу. Конфлікт — це інше таке керування на тому самому вході.
| Режим | Що відбувається в machine.blk |
|---|---|
| Лише додати | Комбінація записується лише тоді, коли жодне інше керування літаком чи гелікоптером не використовує цей вхід; вона ніколи не видаляє блок і не замінює прив'язану вісь. Пропущені прив'язки отримують позначку «Не записано в гру». |
| Оновити, зберегти прив'язки гри | Ваші комбінації стають поруч з іншими комбінаціями цього керування; видаляються лише конфлікти (вісь іншого керування на вашій осі отримує axisId -1). |
| Оновити, мій профіль головніший | Як вище, і керування, яке ви прив'язуєте, втрачає свої інші комбінації на підключених пристроях, які перелічує гра (клавіатура — лише з параметром клавіатури). |
| Замінити на моїх пристроях | Як вище, і інші комбінації й осі літаків і гелікоптерів на записаних пристроях звільняються. |
| + Очистити й інші мої пристрої | Те саме для підключених пристроїв без прив'язок у вашому профілі. |
Порожній ID_X{} замінюється, коли JoyPro прив'язує керування. Керування, якого немає у файлі, отримує попередження: тоді ваша комбінація замінює для нього стандартне значення базового пресету.
#Що ніколи не змінюється
- Комбінації й осі танків, кораблів, підводних човнів, піхоти й меню.
deviceMapping{},config{}і кожен рядок налаштувань, який JoyPro не задає.- Прив'язки миші, непідключені пристрої, пристрої, ігноровані імпортом, і пристрій vJoy, у який JoyPro передає входи.
- Клавіатура, якщо ви не експортуєте прив'язки клавіатури.
- Відносне керування, утримання значення й діапазон осі залишаються такими, як у файлі, якщо ви їх не задаєте.
#Літаки, криві, параметри гри
- Деталізація: один набір керування для всіх літаків і один для всіх гелікоптерів (у грі немає прив'язок для окремих літаків).
- Модифікатори: остання кнопка комбінації — це основний вхід, інші кнопки й клавіші в блоці — її модифікатори. До трьох варіантів на комбінацію.
- Криві осей у власних одиницях гри, як їх показує діалог Axis setup: мертва зона (від 0 до 0.5), нелінійність (від 0 до 3, показується як від 1 до 4), множник, корекція, інверсія, відносне керування з його чутливістю й кроком, утримання значення для вимкненої осі. Зв'язок без значень War Thunder отримує підібрану криву JoyPro: множник = 1 / насичення X, мертва зона масштабується разом із ним, найближча нелінійність; для повзунка хід між мертвою зоною й насиченням розтягується на весь діапазон. Значення, що дорівнює значенню базового пресету, прибирає рядок, як зберігає й сама гра.
- Параметри гри: чутливість крену, тангажу й рискання для літаків і для гелікоптерів, інверсія Y (літак, гелікоптер), інверсія газу, утримання газу для WEP, автотример, увімкнення Force Feedback (гру треба перезапустити) і його множник. Задайте їх у Налаштування > Налаштування force feedback ігор (виберіть War Thunder) або через
engine ffb set. Вони записуються й експортом без прив'язок War Thunder; імпорт бере значення з файлу. - Хмарна копія: під час входу гра порівнює перший рядок файлу
version:i=Nз рядком на сервері. JoyPro зберігає версію, тож ваш новий вміст завантажується на сервер. Скасувати останній експорт дає відновленому файлу версію, вищу за ту, яку він замінює, тож копія з сервера не повертається. - Force Feedback з телеметрії: сторінка Force Feedback керує вашою ручкою з Force Feedback через локальний вебсервер гри (
127.0.0.1:8111, його надає запущена гра; нічого налаштовувати не треба). Вимкніть власний Force Feedback гри для цієї ручки. - Запис телеметрії: JoyPro може записати виліт з того самого сервера й експортувати його як CSV або для Tacview (плоска мапа навколо 0/0, бо гра не має справжнього географічного положення).
- Спостерігач: прив'язку, значення осі чи параметр, які ви змінили в грі, помічено після її закриття; змінений порядок ключів або стиль різниці гри не вважаються зміною.
- HUD: HUD знаходить гру за її процесом і показує ваші прив'язки War Thunder.
#Усередині інтеграції War Thunder
flowchart LR
P["Ваш профіль<br/>(літаки + гелікоптери)"] --> E["engine warthunder export"]
M[("deviceMapping<br/>пристрої, які перелічила гра")] --> E
E --> B["machine.blk<br/>комбінації, осі, параметри<br/>(різниця з базовим пресетом)"]
B --> L["Наступний вхід: ваш файл<br/>перемагає (той самий рядок версії);<br/>Controls у War Thunder"]
Код: engine\Games\WarThunderIntegration.cs, engine\Games\WarThunderVromfs.cs, модель осей engine\AxisModels\WarThunder.cs і модель налаштувань engine\FfbModels\WarThunder.cs.
- Пристрої:
deviceMapping{ joystick{ devId:t="0738:2215" name:t="..." buttonsOffset:i= buttonsCount:i= axesOffset:i= axesCount:i= } }.devId— це VID:PID продукту DirectInput; гра зіставляє пристрої лише заdevId, тож два однакові пристрої зливаються в один.joyButton= buttonsOffset + локальний індекс (кнопки, потім по чотири на хет: вгору, вправо, вниз, вліво);axisId= axesOffset + локальний індекс у порядку DirectInput (X, Y, Z, Rx, Ry, Rz, два повзунки), потім по дві на хет.engine games devicesпоказує, що JoyPro бачить для кожного пристрою. - Формат: текст BLK,
name:type=value, назви блоків повторюються (розбираються як упорядкований список), CRLF. Файли зcontrols.versionнижче 5 застарілі й не читаються. - Список команд:
engine warthunder refresh-dbчитаєshortcutsgroupaircraft.nutіshortcutsgrouphelicopter.nutзgui.vromfs.binі заголовки зlang.vromfs.bin(lang/controls.csv), розпаковані в тимчасову теку, яку потім видаляють; залишаються лише ідентифікатори й заголовки.--no-game-archives(Налаштування > Ігри: зніміть позначку «War Thunder: читати повний список команд з архівів гри») використовує власний список JoyPro із 116 дій; ідентифікатори безID_— це осі.--pathбере теку зі скриптами керування як звичайними файлами. - Імпорт / експорт:
engine warthunder import,engine warthunder scan;engine warthunder export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run. - Базові пресети: без таблиці значень офіційних пресетів експорт явно записує кожен налаштований атрибут осі (він ніколи не прибирає рядок як «рівний базовому»), тож файл правильний, хоч би яким був базовий пресет; імпорт використовує стандартні значення з коду для атрибутів, яких файл не задає.
- Параметри гри:
engine ffb set --device * --game WarThunder --param <key>=<value>(joyFX,forceGain0..100,aileronsMultiplier... у %,invertY,invertYHelicopter,invertT,holdThrottleForWEP,autotrim). - Телеметрія:
engine ffb telemetry setupіengine telemetry record; JoyPro опитує/state20 разів на секунду і/indicatorsна кожен другий запит, лише поки гра працює.
#Відомі обмеження
- Немає вбудованої таблиці значень базових пресетів (див. вище).
- Одного разу спостерігач пропустив зміну «утримання газу для WEP», а одна чутливість прочиталася назад зі зсувом на одиницю.
- Читається 128 кнопок і 4 хети на пристрій; діагоналі хета, кнопки миші й модифікатори осей не записуються.
- Тести: у грі
tools\e2e\games\WarThunderSettings.ps1(прив'язки на осях vJoy, діалоги Axis setup для тангажу й газу, значення сторінки Controls та імпорт файлу, який гра переписала).
Усі технічні примітки до цієї гри (створено з репозиторію): war-thunder.md.