Exportar é o passo que põe os seus manches a funcionar no jogo. O JoyPro escreve as suas relações e atribuições nos ficheiros de configuração de controlos de cada jogo, os mesmos ficheiros que o próprio menu Controls do jogo guarda. Nada corre em segundo plano enquanto voa: depois de exportado, o jogo lê os seus próprios ficheiros como sempre.
flowchart LR C["1 Verificar<br/>(opcional)"] --> M["2 Escolher como<br/>(4 opções)"] M --> G["3 Marcar jogos,<br/>Exportar jogos marcados"] G --> W["Primeiro o backup,<br/>depois os ficheiros<br/>do jogo são escritos"]
#Exportar em três passos
Abra Exportar na barra em baixo. A página tem três cartões numerados, de cima para baixo:


- Verifique o seu perfil. Prima Verificar agora. O JoyPro procura coisas que correriam mal no jogo, por exemplo um botão que faz duas coisas na mesma aeronave. Corrija o que encontrar (um clique por problema) ou deixe estar; a verificação nunca bloqueia a exportação. Veja a verificação.
- Como o JoyPro escreve nos jogos. Escolha uma de quatro opções. Se não tiver a certeza, fique com a primeira: Substituir nos meus dispositivos com Limpar também os meus outros dispositivos marcado. Os seus manches fazem então exatamente o que o seu perfil diz, e nada mais.
- Exportar para jogos. Cada jogo para o qual o seu perfil tem atribuições recebe um cartão com a sua imagem. Marque os jogos e prima Exportar jogos marcados, ou prima Exportar agora num cartão.
Feche primeiro o jogo. Os jogos escrevem os seus ficheiros de controlos ao sair, por isso o JoyPro recusa-se a exportar para um jogo que está a correr e avisa-o disso.
#Que opção é a certa para mim?
| Opção | Escolha-a quando | O que acontece às atribuições do próprio jogo |
|---|---|---|
| Substituir nos meus dispositivos | O JoyPro é o sítio onde configura os seus manches | Nos dispositivos do seu perfil, só ficam as suas atribuições (para as aeronaves que exporta). |
| Atualizar, manter atribuições do jogo | Também atribui coisas dentro do jogo e quer mantê-las | As suas atribuições entram; uma atribuição do jogo só é removida quando está num botão que usa para outra coisa. |
| Atualizar, o meu perfil ganha | Como a anterior, mas moveu ações para outros botões no JoyPro | Como acima, e cada ação que atribui perde os seus outros botões no jogo, para que mover seja mesmo mover. |
| Só adicionar | Está a experimentar o JoyPro pela primeira vez | Nada é removido. Se o jogo já usar um botão para outra coisa, a sua atribuição fica de fora e a verificação avisa-o. |
Limpar também os meus outros dispositivos (uma caixa por baixo das opções): os dispositivos ligados que não têm atribuições no seu perfil perdem as suas atribuições nas aeronaves exportadas. Deixe-a marcada se quiser começar do zero, desmarque-a se usar um segundo dispositivo só dentro do jogo.
#Seguro por conceção
- Antes de o JoyPro alterar um ficheiro do jogo, copia-o para um backup. Cada cartão tem Desfazer última exportação: repõe os ficheiros exatamente como estavam, byte a byte.
- A primeira exportação para um jogo que já tem atribuições próprias pergunta uma vez: "Importar primeiro?". Escolha Importar primeiro se quiser manter o que fez no jogo, ou Exportar mesmo assim para o substituir.
- Os dispositivos que não estão ligados mantêm as suas atribuições. As suas atribuições de rato e de comando nunca são tocadas.
#O que nota no jogo
Inicie o jogo e abra o seu menu de controlos: as suas atribuições estão lá, na coluna de cada dispositivo, com os nomes que o jogo usa. No DCS aparecem por aeronave; no Star Citizen por ação da nave; no IL-2 em Key mapping. A secção No jogo abaixo lista todos os tipos de jogo.
#Outras formas de as suas atribuições chegarem ao jogo
| Forma | O que faz |
|---|---|
| Escrever no meu jogo (a configuração rápida) | A exportação da configuração rápida. Escreve os jogos que configurou, com o mesmo backup. Veja Início rápido. |
| O comando simulado (comando Xbox virtual) | O ACE COMBAT 8 e o Hell Let Loose: Vietnam não recebem nada escrito. A exportação deles diz isso. O seu manche controla um comando simulado enquanto Iniciar está ligado. Veja Jogos só para Xbox. |
| A kneeboard do DCS | Não é uma exportação de atribuições: uma página por aeronave que lista o que os seus botões fazem, no cockpit. Veja a kneeboard. |
#Os modos em detalhe
"Mesma entrada" significa o mesmo dispositivo, o mesmo botão ou eixo e os mesmos modificadores, na mesma aeronave (ou nave, veículo) quando o jogo guarda as atribuições por aeronave. Cada modo atua só nas aeronaves da exportação.
| Só adicionar | Atualizar, manter | Atualizar, perfil ganha | Substituir | |
|---|---|---|---|---|
| As suas atribuições | escritas onde a entrada está livre | escritos | escritos | escritos |
| Uma atribuição do jogo numa entrada que usa para outra ação | mantida; a sua atribuição não é escrita e fica marcada | removida | removida | removida |
| Uma atribuição do jogo da mesma ação noutra entrada (depois de um Mover) | mantido | mantida (a ação fica nas duas entradas) | removida | removida nos dispositivos escritos |
| Outras atribuições do jogo nos seus dispositivos | mantido | mantido | mantido | removidas |
| Predefinições do jogo nos seus dispositivos | mantido | mantido | mantidas, a menos que tenham uma das suas ações | removidas |
| Dispositivos ligados sem atribuições no perfil | mantido | mantido | as suas ações são removidas deles | mantidos, a menos que Limpar também os meus outros dispositivos |
| Dispositivos que não estão ligados, rato, comando | nunca tocados | nunca tocados | nunca tocados | nunca tocados |
| Teclado | só com a opção de teclado | só com a opção de teclado | só com a opção de teclado | só com a opção de teclado |
| Aeronaves que não estão na exportação | nunca tocados | nunca tocados | nunca tocados | nunca tocadas (DCS: a menos que a opção "perder as atribuições predefinidas do DCS em todas as outras aeronaves" esteja ativa) |
Limpar também os meus outros dispositivos não é usado com Só adicionar. Com os outros modos, esvazia os dispositivos ligados que o perfil não usa, nas aeronaves exportadas (DCS: também as suas predefinições do DCS). Os dispositivos que a importação ignora e o dispositivo vJoy para onde o JoyPro encaminha nunca são limpos.
Desde a 2.5.0, a predefinição é Substituir nos meus dispositivos + Limpar também os meus outros dispositivos (como no JoyPro 1). Um modo que escolheu é memorizado.
#Em resumo: uma das suas atribuições, quatro modos
| Modo | O jogo usa o seu botão para outra coisa | A sua ação tem outros botões no jogo | Outros dispositivos ligados |
|---|---|---|---|
| Substituir nos meus dispositivos | Essa atribuição é removida; a sua é escrita | Removidos nos dispositivos escritos | Mantidos, a menos que Limpar também os meus outros dispositivos |
| Atualizar, o meu perfil ganha | Essa atribuição é removida; a sua é escrita | Removido | As suas ações são removidas deles |
| Atualizar, manter atribuições do jogo | Essa atribuição é removida; a sua é escrita | Mantidos: a ação fica em ambos | Mantido |
| Só adicionar | Mantida; a sua não é escrita e fica marcada | Mantido | Mantido |
#Opções por jogo
Em Opções e caminhos (para especialistas):
- DCS: a lista Aeronaves... no cartão do DCS (só as aeronaves marcadas são escritas); DCS: manter predefinições do teclado (ligado); os meus dispositivos perdem as atribuições predefinidas do DCS também em todas as outras aeronaves (desligado).
- Star Citizen: SC: manter predefinições do teclado, preferir a ordem local.
- Os outros jogos: uma caixa Simulação que mostra o que mudaria sem escrever.
- Caminhos: uma pasta Saved Games ou de configuração diferente por jogo; Caminhos e dispositivos ignorados próprios deste perfil dá ao perfil aberto os seus próprios em vez dos do PC.
#Marcas: "Não escrito no jogo"
Só adicionar (e qualquer modo em que um jogo não tem lugar livre para outra entrada, por exemplo o Elite Dangerous com duas entradas por ação) deixa algumas atribuições de fora. O perfil memoriza cada uma com a ação do jogo que ocupa a entrada e a data; a Verificação mostra um cartão por marca com Exportar com 'Atualizar' para o substituir, Mover para outro botão e Deixar como está. Cada exportação substitui as marcas do seu jogo e das suas aeronaves, por isso uma marca desaparece quando uma exportação posterior escreve a atribuição.
#Configurações memorizadas
O modo, a caixa Limpar também, as opções por jogo e os caminhos ficam guardados nas configurações do JoyPro; os jogos e as aeronaves do DCS que marcou ficam guardados por perfil. Substituir e Limpar também perguntam antes de cada exportação (Configurações > Confirmações pode desligar a pergunta).
#Depois da exportação
- Desfazer última exportação no cartão repõe o backup mais recente desse jogo. A lista completa está em Backups de configuração do jogo, no fundo da página Exportar.
- A exportação regista os ficheiros do jogo para o monitor de jogos: a própria exportação do JoyPro nunca pergunta mais tarde "adotar as alterações?"; uma alteração que faça no jogo depois disso pergunta (o monitor de jogos).
- O JoyPro guarda os seus próprios dados ao lado do ficheiro do jogo, para que uma importação posterior traga de volta os nomes das relações, os grupos, os modificadores e as curvas (reimportação).
#No jogo
O que o jogador vê depois de uma exportação depende do tipo de jogo. Todos os jogos abaixo seguem as mesmas regras: o JoyPro só escreve as ações da sua lista de comandos, recusa-se a escrever enquanto o jogo está a correr, faz primeiro um backup dos ficheiros e nunca adivinha um dispositivo ou uma ação que não consegue associar (ignora-o com um aviso).
O JoyPro assume o controlo dos dispositivos que escreve. Com Substituir, todas as outras atribuições desses dispositivos desaparecem nas aeronaves exportadas; com Limpar também, os outros dispositivos ligados também são esvaziados (DCS: também as suas predefinições do DCS).
- DCS World: em Options > Controls, escolha a aeronave: as suas atribuições estão na coluna do dispositivo, as predefinições removidas aparecem como células vazias, os seus modificadores estão na lista de modificadores. Só mudam as aeronaves marcadas. O JoyPro escreve só as diferenças em relação às predefinições do DCS, tal como o próprio DCS faz.
- IL-2 Great Battles: Settings > Key mapping mostra as suas atribuições e respostas dos eixos. As linhas do rato e as linhas que o JoyPro não conhece ficam.
- IL-2 Korea: o perfil de key mapping "General".
- Falcon BMS: o launcher cria o ficheiro de teclas e o mapeamento dos eixos no próximo Launch, por isso inicie o BMS através do launcher.
- MSFS 2024 / 2020: em Controls, o dispositivo mostra a predefinição do JoyPro.
- X-Plane 11 / 12: Settings > Joystick mostra as atribuições.
O JoyPro toca só nas ações de voo (aeronave, helicóptero, nave espacial). As suas atribuições a pé, de veículo e de menu ficam byte a byte. Substituir e Limpar também só libertam as ações de voo que o JoyPro conhece.
- Star Citizen: Options > Keybindings mostra as ações da nave nos seus joysticks (js1, js2, ...). Com Substituir ou Limpar também, as predefinições de joystick do próprio jogo em js1 são desligadas quando js1 é escrito ou não é usado.
- War Thunder: Controls mostra as atribuições das aeronaves; os controlos de tanques e navios ficam inalterados.
- Arma 3 / Arma 2: as configurações de teclas do perfil; só mudam as ações de aeronaves e helicópteros.
- O Elite Dangerous guarda duas entradas por ação (Primary e Secondary). Uma atribuição sem lugar livre recebe uma marca "Não escrito" com "Mover para outro botão" ou "Deixar como está". As atribuições a pé e de SRV ficam.
- X4: as configurações de entrada do jogo; só mudam as ações de nave catalogadas.
- Jogos definidos como vJoy (jogos que só leem poucos dispositivos): a exportação escreve as atribuições no dispositivo vJoy. O JoyPro copia os seus manches para ele enquanto joga, e o HidHide esconde os seus dispositivos reais só desse jogo. O jogo vê um dispositivo com tudo nele. Veja Joystick virtual.
- Jogos só para Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam): nada é escrito, e a exportação diz isso. O seu manche controla um comando simulado (comando Xbox virtual) enquanto Iniciar está ligado. Não é preciso o HidHide. Veja Jogar um jogo só para Xbox com um HOTAS.
#Como funciona por dentro
Uma exportação, desde o clique até aos ficheiros escritos:
| # | Quem | O que acontece |
|---|---|---|
| 1 | Você | Prima Exportar jogos marcados na página Exportar. |
| 2 | JoyPro | Pergunta ao motor pelo jogo (profile game-state --game <id>): importado, exportado, tem atribuições. |
| 3 | JoyPro | Pergunta-lhe quando é preciso: uma primeira exportação ("Importar primeiro?") ou um modo que remove atribuições (Configurações > Confirmações). |
| 4 | Motor | Executa <game> export --mode <m> --nuke-untouched-devices <b> ...: recusa enquanto o jogo está a correr, faz backup de cada ficheiro (GameBackups e .jpbak) e só escreve ações do catálogo. |
| 5 | Motor | Guarda o registo de sincronização (impressão digital e estado base) e as marcas de exportação, e depois responde: escrito, ignorado, SkippedTakenInputs. |
| 6 | JoyPro | O cartão do jogo mostra "Exportado 14:02", e Desfazer última exportação fica pronto. |
- GUI.
ExportSelectedGamesAsync/ExportGameNowAsync(MainWindowViewModel.ExportGames.cs) chamamAskAboutFirstExportAsync(engine profile game-state) eConfirmRiskyExportAsync, depoisExportGameAsyncescolhe o exportador do cartão:dcs,il2,starcitizenou um jogo do registo. O comando é construído a partir das configurações da página, por exemploRunDcsExportAsync: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. Cada chamada ao motor passa por um único sítio,RunEngineAsync, com--profilee--status true(o progresso e o Cancelar da área de ocupado), em série, para que dois comandos nunca escrevam ao mesmo tempo. - Motor.
engine\Program.csencaminhadcs/il2/starcitizenpara os seus exportadores e todos os outros jogos paraGames.GameRegistry(umaGameIntegrationpor jogo). DCS:EngineDcsExport.Modes.cscalcula, por ficheiro de dispositivo, as atribuições que o DCS tem ativas (perfil limpo menosremoved, maisaddedechanged), decide quais devem ficar ativas e escreve só as diferenças reais em relação às predefinições. - Segurança.
GameExportSafety.BackupBeforeOverwritecopia cada ficheiro para<file>.jpbake para o arquivo de backups com versões (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\commanifest.json; são mantidos os 30 conjuntos mais recentes por jogo). Os jogos de registo (Nuclear Option) recebem um instantâneo dos valores que podem alterar. Um ficheiro que a exportação cria é registado como "não existia", para que uma reposição o volte a remover. - Depois. O registo de sincronização (
<data>\Sync\<game>.json: tamanho, hora e SHA-256 por ficheiro e um hash de cada atribuição) faz o monitor de jogos ficar calado perante a alteração do próprio JoyPro.ExportSkippedBinds.cspreencheSkippedTakenInputs; o comando de exportação transforma-as nas marcas do perfil. O histórico do perfil guarda um ponto de controlo antes de cada exportação.
#Os ficheiros que cada jogo recebe
| Jogo | Ficheiros |
|---|---|
| DCS World | por aeronave e dispositivo Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, um .jp ao lado, o modifiers.lua da aeronave |
| IL-2 Great Battles | data\input\global.actions (linhas novas no fim, a ordem mantida), as respostas dos eixos, jp.actions |
| IL-2 Korea | data\input\general.actions |
| Falcon BMS | o User\Config\Setup.v100.* {GUID}.xml do launcher por dispositivo |
| MSFS 2024 / 2020 | perfis de entrada (2024: o pacote de predefinições joypro-input-profiles na pasta Community e os perfis Steam) |
| X-Plane 11 / 12 | as preferências de joystick em Output\preferences |
| Star Citizen | LIVE\user\client\0\Profiles\default\actionmaps.xml e actionmaps.jp |
| War Thunder | Documents\My Games\WarThunder\Saves\<id>\production\machine.blk |
| Jogos do registo | o seu ficheiro de configuração e <config>.joypro-meta.json |
Marcas de atribuições não escritas: engine export-marks list, engine export-marks dismiss. Configurações: export-settings.json (ModeChosenByUser); a predefinição do motor sem --mode é merge-overwrite.
#Todos os modos na linha de comandos
| Escolha na GUI | Opções do motor |
|---|---|
| Substituir nos meus dispositivos + Limpar também os meus outros dispositivos (predefinição) | --mode clean --nuke-untouched-devices true |
| Substituir nos meus dispositivos | --mode clean --nuke-untouched-devices false |
| Atualizar, o meu perfil ganha (+ Limpar também) | --mode merge-overwrite --nuke-untouched-devices true|false |
| Atualizar, manter atribuições do jogo (+ Limpar também) | --mode merge --nuke-untouched-devices true|false |
| Só adicionar | --mode add (nuke não é usado) |
Por jogo: engine dcs export, engine il2 export, engine starcitizen export, e engine <game> export para cada jogo do registo (por exemplo engine warthunder export, engine msfs2024 export, engine xplane12 export; cada um aceita --mode, --dry-run, --include-keyboard e --nuke-untouched-devices). Desfazer: engine backups restore. Testes: engine\tests\smoke\dcsexportmodes.ps1 (todos os modos, ciclo completo, desfazer byte a byte) e engine\tests\smoke\roundtrip.ps1 (importar, limpar + nuke, importar de novo deixa o jogo como estava).
#Relacionado
- A página Exportar, todos os controlos dela
- A verificação antes de uma exportação
- Referência da exportação e Backups de configuração do jogo
- Suporte de jogos: o que o JoyPro faz por cada jogo