JoyPro2 Discord GitHub
Игры

IL-2 Series: Korea

Показать:

IL-2 Series: Korea из того же семейства, что и IL-2 Great Battles, но хранит раскладку клавиш в новом формате JSON: один профиль («General») для всех ЛА внутри установки игры. JoyPro читает его в ваш профиль, объединяет его действия с другими вашими играми в связках и записывает обратно, включая кривые отклика из редактора кривых игры и её настройки Force Feedback.

IL-2 Series: Korea напрямую (собственные файлы привязок)
Поддержка
напрямую (собственные файлы привязок)
Команда движка
engine il2korea
Файл привязок
<install>\data\input\general.actions (JSON) + known.devices.json; кривые в general.pitch / shared.responses; настройки в data\NSData\UserData\UserSettings.json
Список команд из
general.actions; названия из списка IL-2 Great Battles или в формулировке JoyPro
Внутриигровой тест
49/49 шагов пройдено (2026-10-11)
  • ✓ Импорт
  • ✓ Экспорт
  • ✓ Привязки клавиатуры
  • ✓ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✓ Кривые осей и мёртвые зоны
  • ✓ Настройки управления игры
  • ✓ Настройки Force Feedback в игре
  • ✓ Force Feedback из телеметрии
  • ◐ Запись телеметрииВ телеметрии игры нет положения в мире: она записывается и экспортируется как CSV, без трека Tacview (ACMI).
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ✓ Мастер настройки / Автоназначение
  • ✓ Кабины
  • ✓ Шпаргалки
  • ✓ Внутриигровой тест

Из матрицы поддержки, созданной по коду движка: все игры.

Для начинающих

#Запуск за 3 шага

  1. Настроить всё за меня
    на странице «Старт»
  2. Использовать эти кнопки
    сначала посмотрите список
  3. Записать в мою игру
    игра должна быть закрыта

До: один раз сохраните раскладку клавиш. Откройте Settings > Key mapping и нажмите ACCEPT. Закройте игру.

Затем: ваши привязки находятся в Settings > Key mapping, в каждом ЛА.

Вы уже назначали кнопки в IL-2 Korea? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.

#Осмотр по сторонам без трекинга головы

Нет TrackIR и VR? Настройка помещает быстрые виды на одну хатку вашей ручки: вперёд, назад, влево и вправо. Оси обзора идут на мини-стик вашего РУД, если он есть. См. Трекинг головы и осмотр по сторонам.

#Что JoyPro делает для IL-2 Korea

  • Импорт: каждое действие раскладки клавиш, которое стоит на ручке, РУД, педалях или панели, попадает в ваш профиль вместе с модификаторами, инверсией каждой оси и значениями редактора кривых. Клавиши клавиатуры приходят, если вы о них просите.
  • Связки: одна связка — это одна функция во всех ваших играх, например «Gear» в Korea, IL-2 Great Battles и DCS на одной кнопке. В Korea одна раскладка клавиш для всех ЛА.
  • Экспорт: JoyPro записывает раскладку клавиш и даёт каждому вашему устройству номер устройства, как это делает собственный диалог игры «assign device number».

#Импорт привязок Korea

  1. Откройте Старт. Карточка IL-2 Series: Korea показывает картинку игры. Если она просит список команд, нажмите Создать список: JoyPro читает general.actions игры (каждое действие получает собственное название и пояснение от JoyPro).
  2. Нажмите Импорт на карточке. Выберите Добавить в мой профиль и отметьте Брать также клавиши клавиатуры, если вам нужны и лётные клавиши.
  3. Нажмите Импортировать. Мои связки открывает то, что пришло.

#Создание и проверка связок

На странице Связки действие Korea в связке стоит рядом с той же функцией ваших других игр. Объедините их с помощью работы со связками, затем нажмите Проверить на странице «Экспорт»: проверка находит кнопку, которая делает в Korea две вещи (Проверка).

#Экспорт в IL-2 Korea

  1. Закройте игру. JoyPro отказывается записывать, пока работает IL2Series.exe.
  2. Откройте Экспорт. Карточка IL-2 Series: Korea показывает, сколько её связок привязано.
  3. Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.
Страница «Экспорт»Страница «Экспорт»
Страница «Экспорт» (На изображениях приложение на английском.)
В игре: Что вы видите в IL-2 Korea

Запустите игру и откройте Settings > Key mapping. Ваши привязки стоят в строках действий (например, на вкладке Basic), с вашим устройством по имени и его номером («joy 2»); игра не спрашивает номер устройства. Значок кривой в строке оси открывает редактор отклика со значениями, записанными JoyPro. Force Feedback и фильтр шума осей видны в Settings > Input devices.

#Что вы делаете сами в IL-2 Korea

  • Один раз сохраните раскладку клавиш. Игра записывает general.actions, когда вы нажимаете ACCEPT в Key mapping. Первый запуск также показывает пользовательское соглашение игры. Без general.actions экспортировать некуда.
  • Отдельная версия по умолчанию устанавливается в Program Files, и Windows может защищать эту папку. Тогда экспорт сообщает об этом, а не записывает половину файлов.
  • Для собственного Force Feedback JoyPro из телеметрии игры страница Force Feedback добавляет адрес JoyPro в startup.cfg игры (сначала закройте игру). Отключите собственный Force Feedback игры для этой ручки.

#Частые ошибки

  • «IL-2 Korea работает»: закройте игру и снова выполните экспорт.
  • Устройство пропущено: устройство без номера, которое не подключено, не может его получить. Подключите его и снова выполните экспорт.
  • После «Только добавить» не хватает привязки: вход в игре использовался для другого действия. Проверка показывает его в разделе «Не записано в игру».
Расширенные

#Файлы, которые JoyPro читает и записывает

Файл Что это
<install>\data\input\general.actions профиль назначения клавиш «General» (JSON): используемые устройства, модификаторы, каждое действие с его входами, значения Relative Control
<install>\data\input\known.devices.json каждое устройство, которое видела игра, с его номером устройства
<install>\data\input\general.pitch кривая тангажа («General (Common pitch curve)»)
<install>\data\input\shared.responses кривые остальных осей
<install>\data\NSData\UserData\UserSettings.json Settings > Input devices: Force Feedback и фильтр шума осей (раздел input)
<install>\data\startup.cfg адрес телеметрии JoyPro (только когда вы настраиваете Force Feedback по телеметрии)
general.actions.joypro-meta.json имена, группы, модификаторы и настройка осей от JoyPro рядом с файлом, которые считывает следующий импорт

<install> для Steam — это steamapps\common\IL2Series, или папка game под автономным лаунчером. current.map собирает игра; JoyPro его никогда не записывает.

#Режимы экспорта в IL-2 Korea

Режим Что происходит в игре
Только добавить Ничего не удаляется. Привязка, чей вход игра использует для другого действия, не записывается и попадает в список.
Обновить, привязки игры сохранить Ваши привязки добавляются; другие входы игры остаются, кроме привязки игры на входе, который вы отдаёте другому действию.
Обновить, мой профиль важнее Как выше, и каждое привязанное вами действие теряет свои другие входы (джойстики; клавиатуру — только с параметром клавиатуры).
Заменить на моих устройствах Все входы джойстика записываемых устройств освобождаются; затем добавляются ваши привязки.
+ Очистить и другие мои устройства Подключённые устройства без привязки в вашем профиле теряют свои входы джойстика.

#Что никогда не затрагивается

  • Клавиши клавиатуры, входы мыши и пары клавиш на осях при «Заменить» (клавиатура меняется только с параметром клавиатуры).
  • Неподключённые устройства, строки, которые импорт не может прочитать, игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
  • current.map, файлы Force Feedback для каждого устройства и другие настройки игры.

#Кривые, Relative Control, Force Feedback

  • Детализация: общая. Одно назначение клавиш для всех ЛА; профиль кривой тангажа по умолчанию назначен каждому ЛА.
  • Кривые осей (модель осей il2korea): экспонента (от -100 до 100), мёртвые зоны в центре и на краю, смещение центра для тангажа; для тангажа, крена и рыскания также встроенная кривая отклика и нагрузка на рули. Односторонние оси (РУД, тормоза) получают экспоненту и нижнюю/верхнюю мёртвые зоны на всём ходе. У осей камеры нет редактора, и они не получают кривой. Значения указаны в единицах файла; игра показывает мёртвые зоны в четыре раза большими.
  • Relative Control (кнопка ◆ у входа оси): вкл./выкл., мёртвая зона (от 0 до 80 %) и чувствительность (от 1 до 20), как их показывает диалог.
  • Настройки игры (Настройки > Настройки FFB игр): включение Force Feedback, сила тряски, сила обратной связи, усилие на ручке на малой и большой скорости, перебалансировка нейтрали усилия, контакт с землёй и фильтр шума осей, в %, как их показывает игра.
  • Force Feedback по телеметрии и запись: по телеметрии игры, как в Great Battles (только CSV, без трека Tacview).
  • Отслеживание: изменения в general.actions замечаются после закрытия игры (отслеживание).
Технические подробности

#Внутри интеграции Korea

flowchart LR
  P["Ваш профиль"] --> E["engine il2korea export"]
  E --> A["general.actions<br/>known.devices.json"]
  E --> R["general.pitch<br/>shared.responses"]
  E --> S["UserSettings.json"]
  A --> G["Settings ><br/>Key mapping"]
  R --> G
Korea собирает эти файлы (data/input: привязки и номера устройств, кривые; Force Feedback и фильтр в UserSettings.json) в своё назначение клавиш (current.map) при следующем запуске.

Код: engine\Games\Il2KoreaIntegration.cs, модель осей il2korea в engine\AxisModels.

  • Входы: dev<N>_b<button, 0-based>, dev<N>_axis_<x|y|z|w|s|t|p|q> (X, Y, Z, RX, RY, RZ, ползунок 1, ползунок 2), - перед токеном = инвертировано, * = Relative Control, хатки dev<N>_pov<hat>_<angle>, клавиши key_<name>, комбинации через +.
  • Устройства: known.devices.json хранит каждое устройство под ключом его GUID экземпляра DirectInput (в порядке байтов IL-2) и содержит его deviceId (номер, -1 = нет) и ident (vid_pid). Устройство, которое записывает JoyPro, сохраняет свой номер; подключённое устройство без номера получает наименьший свободный номер, начиная с 1.
  • Список команд: engine il2korea refresh-db добавляет действия из файла назначения клавиш. Действий без входа нет в general.actions, поэтому свежий список содержит около 318 действий. JoyPro не читает упакованные архивы игры.
  • Импорт / экспорт: engine il2korea import, engine il2korea scan, engine il2korea export (--mode, --nuke-untouched-devices, --include-keyboard, --dry-run); engine il2korea paths показывает файлы.
  • Настройки и кривые: engine ffb set --device * --game IL2Korea --param ffForce=80, engine binds tuning set --scope game:IL2Korea (или family:il2), engine binds tuning preview (совпадает с собранной игрой таблицей с точностью до 1e-6, кроме плоской стороны смещения центра).
  • Телеметрия: engine ffb telemetry setup il2korea.

#Известные ограничения

  • Собственные тексты действий игры находятся в её упакованных архивах, которые JoyPro не читает; JoyPro использует свои названия.
  • Около 60 действий страницы Key mapping не имеют входа в свежем general.actions и отсутствуют в свежесозданном списке.
  • Тесты: engine\tests\smoke\il2korea.ps1, il2koreainstall.ps1; в игре tools\e2e\games\IL2Korea.ps1 (49 из 49 шагов), IL2KoreaCurves.ps1, IL2KoreaSettings.ps1.

Все технические заметки по этой игре (созданы из репозитория): il2-korea.md.