JoyPro2 Discord GitHub
Fluxos principais

Exportar para os seus jogos

Mostrar:

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"]
O passo 1 só olha; nunca para a exportação. Desfazer última exportação no cartão de um jogo repõe os ficheiros dele. Os jogos só para Xbox não recebem nada escrito: usam Iniciar na página Joystick virtual.
Para iniciantes

#Exportar em três passos

Abra Exportar na barra em baixo. A página tem três cartões numerados, de cima para baixo:

A página Exportar: verificação, como, jogosA página Exportar: verificação, como, jogos
A página Exportar: verificação, como, jogos (As imagens mostram a aplicação em inglês.)
  1. 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.
  2. 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.
  3. 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.
Avançado

#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).

No jogo: Simuladores de voo: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

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.
No jogo: Jogos com infantaria, veículos ou menus: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

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.
No jogo: Jogos espaciais: Elite Dangerous, X4: Foundations
  • 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.
No jogo: Jogos que leem um só dispositivo ou só um comando Xbox
  • 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.
Detalhes técnicos internos

#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.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) chamam AskAboutFirstExportAsync (engine profile game-state) e ConfirmRiskyExportAsync, depois ExportGameAsync escolhe o exportador do cartão: dcs, il2, starcitizen ou um jogo do registo. O comando é construído a partir das configurações da página, por exemplo 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. Cada chamada ao motor passa por um único sítio, RunEngineAsync, com --profile e --status true (o progresso e o Cancelar da área de ocupado), em série, para que dois comandos nunca escrevam ao mesmo tempo.
  2. Motor. engine\Program.cs encaminha dcs / il2 / starcitizen para os seus exportadores e todos os outros jogos para Games.GameRegistry (uma GameIntegration por jogo). DCS: EngineDcsExport.Modes.cs calcula, por ficheiro de dispositivo, as atribuições que o DCS tem ativas (perfil limpo menos removed, mais added e changed), decide quais devem ficar ativas e escreve só as diferenças reais em relação às predefinições.
  3. Segurança. GameExportSafety.BackupBeforeOverwrite copia cada ficheiro para <file>.jpbak e para o arquivo de backups com versões (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ com manifest.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.
  4. 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.cs preenche SkippedTakenInputs; 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).