Экспорт — это шаг, после которого ваши ручки работают в игре. JoyPro записывает ваши связки и привязки в файлы настроек управления каждой игры — те же файлы, которые сохраняет собственное меню управления игры. Пока вы летаете, в фоне ничего не работает: после экспорта игра, как всегда, читает свои собственные файлы.
flowchart LR C["1 Проверка<br/>(необязательно)"] --> M["2 Выбрать способ<br/>(4 варианта)"] M --> G["3 Отметить игры,<br/>«Экспорт отмеченных игр»"] G --> W["Сначала резервная копия,<br/>затем записываются<br/>файлы игры"]
#Экспорт в три шага
Откройте Экспорт в нижней панели. Страница состоит из трёх пронумерованных карточек сверху вниз:


- Проверьте свой профиль. Нажмите Проверить. JoyPro ищет то, что пошло бы не так в игре, например кнопку, которая делает две вещи в одном ЛА. Исправьте найденное (один клик на проблему) или оставьте как есть; проверка никогда не блокирует экспорт. См. Проверка.
- Как JoyPro записывает в игры. Выберите один из четырёх вариантов. Если не уверены, оставьте первый: Заменить на моих устройствах с отмеченным Очистить и другие мои устройства. Тогда ваши ручки делают ровно то, что сказано в профиле, и ничего больше.
- Экспорт в игры. Каждая игра, для которой в вашем профиле есть привязки, получает карточку со своим изображением. Отметьте игры и нажмите Экспорт отмеченных игр или нажмите Экспортировать на одной карточке.
Сначала закройте игру. Игры записывают свои файлы управления при выходе, поэтому JoyPro отказывается экспортировать в запущенную игру и сообщает вам об этом.
#Какой вариант мне подходит?
| Выбор | Выбирайте, когда | Что происходит с собственными привязками игры |
|---|---|---|
| Заменить на моих устройствах | Вы настраиваете свои ручки в JoyPro | На устройствах из вашего профиля остаются только ваши привязки (для экспортируемых ЛА). |
| Обновить, привязки игры сохранить | Вы также назначаете что-то внутри игры и хотите это сохранить | Ваши привязки добавляются; привязка игры удаляется, только если она стоит на кнопке, которую вы используете для чего-то другого. |
| Обновить, мой профиль важнее | Как вариант выше, но вы перенесли действия на другие кнопки в JoyPro | Как выше, и каждое действие, которое вы привязываете, теряет свои другие кнопки в игре, так что перенос действительно переносит. |
| Только добавить | Вы пробуете JoyPro впервые | Ничего не удаляется. Если игра уже использует кнопку для чего-то другого, ваша привязка пропускается, и проверка вам об этом сообщает. |
Очистить и другие мои устройства (флажок под вариантами): подключённые устройства, у которых нет привязок в вашем профиле, теряют свои привязки в экспортированных ЛА. Оставьте флажок, если хотите начать с чистого листа, и снимите его, если используете второе устройство только внутри игры.
#Безопасно по замыслу
- Прежде чем JoyPro изменит файл игры, он копирует его в резервную копию. На каждой карточке есть Отменить последний экспорт: это возвращает файлы точно такими, какими они были, байт в байт.
- Первый экспорт в игру, где уже есть собственные привязки, один раз спрашивает: «Сначала импортировать?». Выберите Сначала импортировать, если хотите сохранить то, что сделали в игре, или Всё равно экспортировать, чтобы это заменить.
- Устройства, которые не подключены, сохраняют свои привязки. Привязки вашей мыши и геймпада никогда не затрагиваются.
#Что вы заметите в игре
Запустите игру и откройте её меню управления: ваши привязки там, в столбце каждого устройства, под теми названиями, которые использует игра. В DCS они показаны по ЛА; в Star Citizen — по действиям корабля; в IL-2 — в Key mapping. Раздел В игре ниже перечисляет все виды игр.
#Другие способы, которыми ваши привязки попадают в игру
| Способ | Что он делает |
|---|---|
| Записать в мою игру (быстрая настройка) | Экспорт быстрой настройки. Он записывает игры, которые она настроила, с той же резервной копией. См. Быстрый старт. |
| Ненастоящий контроллер (виртуальный геймпад Xbox) | В ACE COMBAT 8 и Hell Let Loose: Vietnam ничего не записывается. Их экспорт так и сообщает. Ваша ручка управляет ненастоящим контроллером, пока включено Начать. См. Игры только для Xbox. |
| Наколенный планшет DCS | Не экспорт привязок: страница для каждого ЛА прямо в кабине, на которой перечислено, что делают ваши кнопки. См. планшет. |
#Режимы подробно
«Тот же вход» означает то же устройство, ту же кнопку или ось и те же модификаторы, в том же ЛА (или корабле, технике), если игра хранит привязки для каждого ЛА. Каждый режим работает только в ЛА, входящих в экспорт.
| Только добавить | Обновить, сохранить | Обновить, профиль важнее | Заменить | |
|---|---|---|---|---|
| Ваши привязки | записываются там, где вход свободен | описано | описано | описано |
| Привязка игры на входе, который вы используете для другого действия | сохраняется; ваша привязка не записывается и помечается | удаляется | удаляется | удаляется |
| Привязка игры для того же действия на другом входе (после переноса) | сохранено | сохраняется (действие на обоих входах) | удаляется | удаляется на записанных устройствах |
| Остальные привязки игры на ваших устройствах | сохранено | сохранено | сохранено | удаляются |
| Привязки игры по умолчанию на ваших устройствах | сохранено | сохранено | сохраняются, если не заняты одним из ваших действий | удаляются |
| Подключённые устройства без привязок в профиле | сохранено | сохранено | ваши действия с них удаляются | сохраняются, если не включено Очистить и другие мои устройства |
| Неподключённые устройства, мышь, геймпад | никогда не затрагиваются | никогда не затрагиваются | никогда не затрагиваются | никогда не затрагиваются |
| Клавиатура | только с параметром клавиатуры | только с параметром клавиатуры | только с параметром клавиатуры | только с параметром клавиатуры |
| ЛА, не входящие в экспорт | никогда не затрагиваются | никогда не затрагиваются | никогда не затрагиваются | никогда не затрагиваются (DCS: если не включён параметр «мои устройства теряют привязки DCS по умолчанию и в остальных ЛА») |
Очистить и другие мои устройства не используется с «Только добавить». В остальных режимах он очищает подключённые устройства, которые профиль не использует, в экспортируемых ЛА (в DCS — также их привязки DCS по умолчанию). Устройства, игнорируемые при импорте, и устройство vJoy, через которое JoyPro передаёт входы, никогда не очищаются.
С версии 2.5.0 по умолчанию выбрано Заменить на моих устройствах + Очистить и другие мои устройства (как в JoyPro 1). Режим, выбранный вами самостоятельно, запоминается.
#Коротко: одна ваша привязка, четыре режима
| Режим | Игра использует вашу кнопку для чего-то другого | У вашего действия в игре есть другие кнопки | Другие подключённые устройства |
|---|---|---|---|
| Заменить на моих устройствах | Та привязка удаляется; ваша записывается | Удаляются на записанных устройствах | Сохраняются, если не включено Очистить и другие мои устройства |
| Обновить, мой профиль важнее | Та привязка удаляется; ваша записывается | Удалено | Ваши действия с них удаляются |
| Обновить, привязки игры сохранить | Та привязка удаляется; ваша записывается | Сохраняются: действие на обеих | Сохранено |
| Только добавить | Сохраняется; ваша не записывается и помечается | Сохранено | Сохранено |
#Параметры для каждой игры
В разделе Параметры и пути (для экспертов):
- DCS: список ЛА... на карточке DCS (записываются только отмеченные ЛА); DCS: сохранить стандартные привязки клавиатуры (вкл.); мои устройства теряют привязки DCS по умолчанию и в остальных ЛА (выкл.).
- Star Citizen: SC: сохранить стандартные привязки клавиатуры, предпочитать локальный порядок.
- Остальные игры: флажок Пробный запуск, который показывает, что изменилось бы, ничего не записывая.
- Пути: другая папка Saved Games или папка конфигурации для каждой игры; Свои пути и игнорируемые устройства для этого профиля даёт открытому профилю собственные настройки вместо настроек ПК.
#Отметки: «Не записано в игру»
«Только добавить» (и любой режим, в котором у игры нет свободного места для ещё одного входа, например Elite Dangerous с двумя входами на действие) пропускает некоторые привязки. Профиль запоминает каждую вместе с действием игры, занимающим вход, и датой; Проверка показывает карточку на каждую отметку с кнопками Экспортировать с 'Обновить', чтобы заменить, Перенести на другую кнопку и Оставить как есть. Каждый экспорт заменяет отметки своей игры и ЛА, поэтому отметка исчезает, когда более поздний экспорт записывает привязку.
#Запоминаемые настройки
Режим, флажок Очистить и другие, параметры для каждой игры и пути хранятся в настройках JoyPro; игры и ЛА DCS, которые вы отметили сами, хранятся в каждом профиле. «Заменить» и «Очистить и другие» спрашивают подтверждение перед каждым экспортом (в «Настройки > Подтверждения» вопрос можно выключить).
#После экспорта
- Отменить последний экспорт на карточке восстанавливает самую новую резервную копию этой игры. Полный список находится в разделе Резервные копии конфигураций игр внизу страницы «Экспорт».
- Экспорт запоминает файлы игры для отслеживания игр: собственный экспорт JoyPro потом никогда не спрашивает «принять изменения?»; а изменение, которое вы потом сделаете в игре, спрашивает (отслеживание).
- JoyPro хранит свои данные рядом с файлом игры, поэтому более поздний импорт возвращает имена связок, группы, модификаторы и кривые (повторный импорт).
#В игре
Что игрок видит после экспорта, зависит от вида игры. Все игры ниже следуют одним и тем же правилам: JoyPro записывает только действия из своего списка команд, отказывается записывать, пока игра работает, сначала делает резервную копию файлов и никогда не угадывает устройство или действие, которое не может сопоставить (он пропускает его с предупреждением).
JoyPro берёт на себя устройства, в которые записывает. С Заменить все остальные привязки этих устройств исчезают в экспортированных ЛА, с Очистить и другие очищаются и другие подключённые устройства (в DCS — также их привязки DCS по умолчанию).
- DCS World: в Options > Controls выберите ЛА: ваши привязки находятся в столбце устройства, удалённые привязки по умолчанию показаны пустыми ячейками, ваши модификаторы — в списке модификаторов. Меняются только отмеченные ЛА. JoyPro записывает только отличия от привязок DCS по умолчанию, как это делает сам DCS.
- IL-2 Great Battles: Settings > Key mapping показывает ваши привязки и отклик осей. Строки мыши и строки, которых JoyPro не знает, остаются.
- IL-2 Korea: профиль раскладки клавиш «General».
- Falcon BMS: лаунчер создаёт файл клавиш и назначение осей при следующем Launch, поэтому запускайте BMS через лаунчер.
- MSFS 2024 / 2020: в Controls устройство показывает пресет JoyPro.
- X-Plane 11 / 12: Settings > Joystick показывает назначения.
JoyPro затрагивает только лётные действия (самолёт, вертолёт, космический корабль). Ваши привязки для пешего режима, техники и меню остаются байт в байт. Заменить и Очистить и другие освобождают только те лётные действия, которые знает JoyPro.
- Star Citizen: Options > Keybindings показывает действия корабля на ваших джойстиках (js1, js2, ...). С Заменить или Очистить и другие собственные привязки джойстика по умолчанию на js1 отключаются, когда js1 записывается или не используется.
- War Thunder: Controls показывает привязки самолётов; управление танками и кораблями не меняется.
- Arma 3 / Arma 2: настройки клавиш профиля; меняются только действия самолётов и вертолётов.
- Elite Dangerous хранит два входа на действие (Primary и Secondary). Привязка, для которой нет свободного места, получает отметку «Не записано» с вариантами «Перенести на другую кнопку» или «Оставить как есть». Привязки пешего режима и SRV остаются.
- X4: настройки ввода игры; меняются только действия корабля из каталога.
- Игры, настроенные на vJoy (игры, которые читают лишь несколько устройств): экспорт записывает привязки на устройство vJoy. Пока вы играете, JoyPro копирует на него ваши ручки, а HidHide скрывает ваши реальные устройства только от этой игры. Игра видит одно устройство, на котором есть всё. См. Виртуальный джойстик.
- Игры только для Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam): ничего не записывается, и экспорт так и сообщает. Ваша ручка управляет ненастоящим контроллером (виртуальным геймпадом Xbox), пока включено Начать. HidHide не нужен. См. Играть в игру только для Xbox с HOTAS.
#Как это устроено внутри
Один экспорт от щелчка до записанных файлов:
| # | Кто | Что происходит |
|---|---|---|
| 1 | Вы | Нажмите Экспорт отмеченных игр на странице «Экспорт». |
| 2 | JoyPro | Спрашивает движок об игре (profile game-state --game <id>): импортирована, экспортирована, есть привязки. |
| 3 | JoyPro | Спрашивает вас, когда нужно: первый экспорт («Сначала импорт?») или режим, который удаляет привязки (Настройки > Подтверждения). |
| 4 | Движок | Запускает <game> export --mode <m> --nuke-untouched-devices <b> ...: отказывается, пока игра запущена, делает резервную копию каждого файла (GameBackups и .jpbak) и записывает только действия из каталога. |
| 5 | Движок | Сохраняет запись синхронизации (отпечаток и базовое состояние) и пометки экспорта, затем отвечает: записано, пропущено, SkippedTakenInputs. |
| 6 | JoyPro | Карточка игры показывает «Экспортировано: 14:02», и кнопка Отменить последний экспорт готова. |
- GUI.
ExportSelectedGamesAsync/ExportGameNowAsync(MainWindowViewModel.ExportGames.cs) вызываютAskAboutFirstExportAsync(engine profile game-state) иConfirmRiskyExportAsync, затемExportGameAsyncвыбирает экспортёр карточки:dcs,il2,starcitizenили игру из реестра. Команда строится из настроек страницы, напримерRunDcsExportAsync:engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Каждый вызов движка проходит через одно место,RunEngineAsync, с--profileи--status true(прогресс и «Отмена» в области занятости), последовательно, чтобы две команды никогда не записывали одновременно. - Движок.
engine\Program.csнаправляетdcs/il2/starcitizenк их экспортёрам, а все остальные игры — кGames.GameRegistry(по однойGameIntegrationна игру). DCS:EngineDcsExport.Modes.csвычисляет для каждого файла устройства привязки, активные в DCS (чистый профиль минусremoved, плюсaddedиchanged), решает, какие должны быть активны, и записывает только реальные отличия от значений по умолчанию. - Безопасность.
GameExportSafety.BackupBeforeOverwriteкопирует каждый файл в<file>.jpbakи в хранилище версий резервных копий (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\сmanifest.json; хранятся 30 самых новых наборов на игру). Игры из реестра (Nuclear Option) получают снимок значений, которые они могут изменить. Файл, созданный экспортом, записывается как «не существовал», поэтому восстановление снова его удаляет. - Потом. Запись синхронизации (
<data>\Sync\<game>.json: размер, время и SHA-256 каждого файла и хеш каждой привязки) не даёт отслеживанию срабатывать на собственные изменения JoyPro.ExportSkippedBinds.csзаполняетSkippedTakenInputs; команда экспорта превращает их в отметки профиля. История профиля сохраняет контрольную точку перед каждым экспортом.
#Какие файлы получает каждая игра
| Игра | Файлы |
|---|---|
| DCS World | для каждого ЛА и устройства Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, рядом .jp, а также modifiers.lua ЛА |
| IL-2 Great Battles | data\input\global.actions (новые строки в конце, порядок сохраняется), отклики осей, jp.actions |
| IL-2 Korea | data\input\general.actions |
| Falcon BMS | User\Config\Setup.v100.* {GUID}.xml лаунчера для каждого устройства |
| MSFS 2024 / 2020 | профили ввода (2024: пакет пресетов joypro-input-profiles в папке Community и профили Steam) |
| X-Plane 11 / 12 | настройки джойстика в Output\preferences |
| Star Citizen | LIVE\user\client\0\Profiles\default\actionmaps.xml и actionmaps.jp |
| War Thunder | Documents\My Games\WarThunder\Saves\<id>\production\machine.blk |
| Игры из реестра | их файл конфигурации и <config>.joypro-meta.json |
Отметки незаписанных привязок: engine export-marks list, engine export-marks dismiss. Настройки: export-settings.json (ModeChosenByUser); значение движка по умолчанию без --mode — merge-overwrite.
#Каждый режим в командной строке
| Выбор в GUI | Параметры движка |
|---|---|
| Заменить на моих устройствах + Очистить и другие мои устройства (по умолчанию) | --mode clean --nuke-untouched-devices true |
| Заменить на моих устройствах | --mode clean --nuke-untouched-devices false |
| Обновить, мой профиль важнее (+ Очистить и другие) | --mode merge-overwrite --nuke-untouched-devices true|false |
| Обновить, привязки игры сохранить (+ Очистить и другие) | --mode merge --nuke-untouched-devices true|false |
| Только добавить | --mode add (nuke не используется) |
Для каждой игры: engine dcs export, engine il2 export, engine starcitizen export и engine <game> export для каждой игры из реестра (например, engine warthunder export, engine msfs2024 export, engine xplane12 export; каждая принимает --mode, --dry-run, --include-keyboard и --nuke-untouched-devices). Отмена: engine backups restore. Тесты: engine\tests\smoke\dcsexportmodes.ps1 (каждый режим, туда и обратно, отмена байт в байт) и engine\tests\smoke\roundtrip.ps1 (импорт, clean + nuke, повторный импорт оставляет игру такой, какой она была).
#См. также
- Страница «Экспорт», каждый элемент на ней
- Проверка перед экспортом
- Справочник по экспорту и Резервные копии конфигураций игр
- Поддержка игр: что JoyPro делает для каждой игры