JoyPro2 Discord GitHub
Игры

IL-2 Sturmovik: Cliffs of Dover

Показать:

Cliffs of Dover и её издание от Team Fusion — Cliffs of Dover Blitz — хранят привязки и настройки осей в одном ini-файле в папке «Документы», confUser.ini, общем для обеих игр. Blitz называет каждое устройство по названию продукта и номеру, взятому из его USB-порта; оригинал называет их Joystick, Joystick1 ... в порядке Windows. JoyPro читает файл в ваш профиль, объединяет его с другими вашими играми в связках и записывает обратно, сохраняя каждую строку, которой он не управляет.

IL-2 Sturmovik: Cliffs of Dover напрямую (собственные файлы привязок)
Поддержка
напрямую (собственные файлы привязок)
Команда движка
engine il2cod
Файл привязок
Documents\1C SoftClub\il-2 sturmovik cliffs of dover\confUser.ini (ini; устройства Joystick, Joystick1 ...)
Входы, которые читает игра
читает 128 кнопок, 8 осей, 1 хатку на джойстик (документировано)
Список команд из
собственный список команд JoyPro + ваш confUser.ini и файл из установки
  • ✓ Импорт
  • ✓ Экспорт
  • ✓ Привязки клавиатуры
  • ✓ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✓ Кривые осей и мёртвые зоны
  • ✗ Настройки управления игры
  • ✗ Настройки Force Feedback в игре
  • ✗ Force Feedback из телеметрии
  • ✗ Запись телеметрии
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ◐ Мастер настройки / Автоназначение
  • ✗ Кабины
  • ✓ Шпаргалки
  • ✗ Внутриигровой тест
IL-2 Sturmovik: Cliffs of Dover Blitz напрямую (собственные файлы привязок)
Поддержка
напрямую (собственные файлы привязок)
Команда движка
engine il2codblitz
Файл привязок
confUser.ini как у Cliffs of Dover; устройства <product>-<hash of the HID path> (меняется вместе с USB-портом)
Входы, которые читает игра
читает 128 кнопок, 8 осей, 1 хатку на джойстик (документировано)
Список команд из
как Cliffs of Dover
  • ✓ Импорт
  • ✓ Экспорт
  • ✓ Привязки клавиатуры
  • ✓ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✓ Кривые осей и мёртвые зоны
  • ✗ Настройки управления игры
  • ✗ Настройки Force Feedback в игре
  • ✗ Force Feedback из телеметрии
  • ✗ Запись телеметрии
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ◐ Мастер настройки / Автоназначение
  • ✗ Кабины
  • ✓ Шпаргалки
  • ✗ Внутриигровой тест

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

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

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

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

До: запустите игру один раз, затем закройте её.

Затем: ваши привязки находятся на странице управления игры.

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

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

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

#Что JoyPro делает для Cliffs of Dover

  • Импорт: ваши привязки на ручках, РУД и педалях попадают в ваш профиль, сочетания (несколько входов, удерживаемых вместе) — как модификаторы, вместе с настройками осей каждой команды. Клавиши клавиатуры приходят, если вы о них просите.
  • Связки: одна связка — это одна функция во всех ваших играх («Gear» в Cliffs of Dover, IL-2 Great Battles и DCS на одной кнопке).
  • Экспорт: JoyPro записывает лётные разделы confUser.ini. Blitz и оригинал в JoyPro — две игры (две карточки на странице «Старт» и на странице «Экспорт»), потому что называют устройства по-разному; обе записывают один и тот же файл.

#Импорт ваших привязок

  1. Откройте Старт. Выберите карточку игры, в которую играете: IL-2 Sturmovik: Cliffs of Dover Blitz или IL-2 Sturmovik: Cliffs of Dover. Если она просит список команд, нажмите Создать список: JoyPro объединяет свой список команд с командами вашего файла и файла по умолчанию из установки.
  2. Нажмите Импорт на карточке. Выберите Добавить в мой профиль и отметьте Брать также клавиши клавиатуры, если вам нужны и лётные клавиши.
  3. Нажмите Импортировать. Мои связки открывает то, что пришло.

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

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

#Экспорт

  1. Закройте игру. JoyPro отказывается записывать, пока работает Blitz (Launcher64.exe) или оригинал. Игра записывает confUser.ini при закрытии.
  2. Откройте Экспорт и используйте карточку игры, в которую играете (обе карточки записывают один и тот же файл, каждая со своими именами устройств).
  3. Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.
Страница «Экспорт»Страница «Экспорт»
Страница «Экспорт» (На изображениях приложение на английском.)
В игре: Что вы видите в Cliffs of Dover

Запустите игру и откройте её страницу управления: ваши привязки стоят в строках каждой команды, на ваших устройствах. Точный путь в меню и то, как страница показывает привязки JoyPro, пока не подтверждены: живая проверка в игре ещё впереди.

#Что вы делаете сами в Cliffs of Dover

  • Запустите игру один раз. При первом запуске Blitz создаёт папку Documents\1C SoftClub\il-2 sturmovik cliffs of dover с копией стандартного confUser.ini.
  • Steam Cloud хранит копии файла, и, по сообщениям, возвращает старые привязки. Если экспорт не сохраняется, отключите Steam Cloud для игры.
  • Blitz и USB-порт: имя устройства в Blitz меняется, когда вы подключаете устройство в другой порт. JoyPro находит устройство по имени и записывает текущее имя (старая строка переименовывается, с предупреждением).

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

  • «Игра работает»: закройте её и снова выполните экспорт. Процесс оригинала называется Launcher — это имя используют и другие программы; JoyPro проверяет собственную программу игры.
  • Вернулись старые привязки: Steam Cloud восстановил более старый файл (см. выше).
  • Два одинаковых устройства в Blitz: их различает только идентификатор из USB-пути. JoyPro сопоставляет строку только по имени, лишь когда это имя есть у одного подключённого устройства, поэтому после переноса одного из них в другой порт проверьте привязки.
Расширенные

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

Файл Что это
%USERPROFILE%\Documents\1C SoftClub\il-2 sturmovik cliffs of dover\confUser.ini привязки (разделы [HotKey ...]) и настройки осей ([Config pilotMove]) обеих игр
%USERPROFILE%\Documents\1C SoftClub\il-2 sturmovik cliffs of dover - MOD\confUser.ini мод Team Fusion до Blitz (указан для оригинала)
<install>\confUser.ini значения по умолчанию, читаются только для списка команд
confUser.ini.joypro.json входы, которые записал JoyPro

conf.ini, user.ini, bldconf.ini и профили «Save As» в той же папке не затрагиваются.

#Режимы экспорта в Cliffs of Dover

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

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

  • Раздел [HotKey vehicle] (наземная техника), строки мыши и клавиатуры (клавиатура — только с параметром клавиатуры).
  • Неподключённые устройства, строки, которые импорт не может прочитать, строки без устройства (значения по умолчанию, которые игра не смогла сопоставить), игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
  • Неизвестные разделы, например раздел редактора миссий, — байт в байт.

#Кривые и настройки

  • Детализация: общая. Один файл для всех ЛА; настройки осей задаются для каждой команды, а не для каждой оси устройства.
  • Настройки осей (модель осей il2cod): у элеронов, руля высоты и руля направления есть чувствительность (от 0 — линейная до 1 — самая изогнутая), мёртвая зона в центре и мёртвая зона на краю; у остальных осей — мёртвая зона в нижнем и верхнем конце; РУД сохраняют свои пять значений в том виде, в каком они импортированы. Кривая по умолчанию подгоняется (мёртвая зона — к центру, насыщение — к краю, положительная кривизна — к чувствительности). Формула предпросмотра — это допущение.
  • Инверсия: знак перед командой (=-1throttle).
  • В режиме Update значения, заданные в игре, остаются, если у JoyPro все они равны нулю. Нет Force Feedback и настроек игры.
  • Отслеживание: изменения в confUser.ini замечаются после закрытия игры (отслеживание).
Технические подробности

#Внутри интеграции Cliffs of Dover

flowchart LR
  P["Ваш профиль<br/>(связки + привязки)"] --> B["Blitz (engine il2codblitz):<br/>устройство = имя продукта<br/>+ хеш его USB-пути"]
  P --> O["Оригинал (engine il2cod):<br/>Joystick, Joystick1 ...<br/>(порядок Windows)"]
  B --> F["Documents / 1C SoftClub /<br/>il-2 sturmovik cliffs of dover /<br/>confUser.ini"]
  O --> F
  F --> G["Страница управления игры"]
Blitz и оригинал записывают один и тот же файл. Они лишь по-разному называют ваши устройства.

Код: engine\Games\Il2CodIntegration.cs (один класс, две игры), engine\Games\Il2LegacyIntegration.cs, engine\Games\LegacyIniFile.cs.

  • Строки: <trigger> [<trigger> ...]=<command>; все триггеры удерживаются вместе, а срабатывает последний, поэтому остальные становятся модификаторами JoyPro (клавиши или кнопки джойстика). Кнопка <device>+Key<b> (с отсчётом от 0, 128 кнопок), ось <device>+AXE_<X|Y|Z|RX|RY|RZ|U|V>=<1|-1><command>, хатка Pov<angle> <device>+Pov (первая хатка).
  • Устройства, Blitz: <product name>-<id>, имя продукта DirectInput, в котором пробелы и + заменены на _; id — 31-битный хеш пути интерфейса устройства (DIPROP_GUIDANDPATH) в шестнадцатеричном виде. JoyPro вычисляет тот же id из пути (engine games devices его показывает), сопоставляет по имени и id, иначе по имени, если оно есть только у одного подключённого устройства. До 16 устройств.
  • Устройства, оригинал: Joystick, Joystick1, Joystick2 ... в порядке DirectInput, до 8 устройств.
  • Список команд: engine il2codblitz refresh-db / engine il2cod refresh-db: собственный список команд JoyPro (id вроде pilotMove.aileron, pilot.trigger0) плюс все команды вашего файла и файла по умолчанию из установки.
  • Импорт / экспорт: engine il2codblitz import, engine il2codblitz scan, engine il2codblitz export и то же для engine il2cod export. Резервная копия перед первой записью.

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

  • В игре пока не проверено: привязки, сделанные на странице управления Blitz, вторая хатка, пять значений РУД и читает ли Blitz по-прежнему старые имена Joystick<n>. Оригинальная игра проверена только по её файлу по умолчанию.
  • Тесты: engine\tests\smoke\il2cod.ps1; в игре tools\e2e\games\IL2CoDBlitz.ps1 (написан, ещё не запускался).

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