JoyPro2 Discord GitHub
Fluxos principais

Importar um jogo

Mostrar:

A importação lê as configurações de controlo que um jogo guardou e transforma-as num perfil do JoyPro: uma relação por função, com o seu botão ou eixo. É o começo mais rápido: tudo o que já configurou nos seus jogos entra, e a partir daí o JoyPro mantém tudo num só sítio.

flowchart LR
  G["Os ficheiros de<br/>controlos do seu jogo"] --> I["Importar"]
  D["Os seus dispositivos<br/>ligados"] --> I
  I --> P["O seu perfil:<br/>relações, atribuições,<br/>modificadores, curvas"]
A importação só lê. O jogo mantém as suas atribuições exatamente como estão.
Para iniciantes

#Importar em três cliques

  1. Abra Iniciar (o primeiro botão na barra em baixo). Em Os seus jogos, cada jogo que o JoyPro encontrou no seu PC tem um cartão com a sua imagem. Prima Importar no jogo que mais joga.
  2. O JoyPro pergunta como:
    • Adicionar ao meu perfil (recomendado) mantém o que tem e adiciona as atribuições do jogo.
    • Recomeçar a partir deste jogo substitui as suas relações pelo que o jogo tem (o JoyPro guarda primeiro uma cópia do seu perfil).
    • Aceitar também as teclas do teclado traz também os comandos de voo no teclado. As atribuições de dispositivos são sempre aceites.
    • Para o DCS: Todas as minhas aeronaves DCS, ou desmarque e escolha aeronaves.
  3. Prima Importar agora. Um momento depois o cartão diz "Concluído: o seu perfil tem agora 214 relações (180 atribuídas)" e Ver as minhas relações abre-as. Ver primeiro, em vez disso, mostra o que o jogo tem, sem alterar nada.
A página Início com os seus jogos e dispositivosA página Início com os seus jogos e dispositivos
A página Início com os seus jogos e dispositivos (As imagens mostram a aplicação em inglês.)

Nenhum perfil aberto? O JoyPro cria um para si e passa a guardá-lo automaticamente (não há botão Guardar: cada alteração é guardada e pode ser desfeita, também depois de reiniciar).

#O que muda no jogo?

Nada. A importação só lê os ficheiros do jogo. O jogo mantém as suas atribuições exatamente como estão, quer exporte mais tarde quer não.

#Importar e depois deixar o JoyPro preencher as lacunas

Na página Início, o cartão "Configurar os seus dispositivos" lista os jogos onde fez atribuições por si. Importar e depois preencher lacunas importa primeiro esse jogo. Depois Preencher lacunas agora... põe as funções importantes nos botões que ainda estão livres. As suas próprias atribuições ficam. Para os jogos que já estão no seu perfil, o cartão oferece Preencher lacunas....

#Antes da primeira importação: a lista de comandos

O JoyPro precisa de conhecer os comandos de cada jogo (os nomes e as ids). Cria esta lista uma vez a partir da sua própria instalação. Quando falta uma lista, a página Início mostra Criar lista (ou Criar todas as listas em falta); um cartão de jogo oferece Atualizar depois de uma atualização do jogo. Isto demora de alguns segundos a alguns minutos (o DCS lê todos os módulos).

Avançado

#Opções e o que fazem

Opção Predefinição Efeito
Adicionar ao meu perfil / Recomeçar Adicionar Adicionar une ao perfil aberto; Recomeçar substitui as suas relações depois de uma confirmação e de uma cópia do perfil.
Aceitar também as teclas do teclado a sua última escolha Os comandos de voo atribuídos a teclas também entram.
Importar também dispositivos que não estão ligados ligado Os dispositivos que agora não estão ligados também são importados (útil para um manche que liga mais tarde). Desligado: são ignorados e contados.
Tratar dispositivos com o mesmo nome como um só dispositivo ligado O Windows dá de vez em quando um novo ID a um dispositivo; os seus ficheiros antigos e novos são lidos como um só dispositivo com o ID ligado. Dois dispositivos idênticos ligados ao mesmo tempo ficam separados.
Incluir predefinições (DCS, formulário para especialistas) ligado Todas as atribuições predefinidas que o DCS tem ativas para um dispositivo importado entram, para que uma importação seguida de uma exportação Substituir + Limpar também deixe o DCS como estava. As suas próprias atribuições ganham sobre uma predefinição na mesma entrada.
Importar inversão / slider / curvatura / zona morta / saturação (formulário para especialistas) desligado Toma os valores definidos no jogo para atribuições que o JoyPro não exportou ele próprio. Uma atribuição que o JoyPro exportou recebe a sua afinação de volta sem estas opções.
DCS: ignorar aeronaves *_easy desligado As cópias das aeronaves em modo fácil ficam de fora.

A importação avançada (página Início, por baixo dos cartões, e a página Avançado) oferece todas as opções do motor por jogo com Analisar (pré-visualização), Importar e Exportar. Cada escolha é memorizada para a próxima importação.

#Nomes, grupos e modificadores voltam

Um ficheiro de jogo só contém o dispositivo, a entrada e talvez uma curva. A exportação do JoyPro guarda os seus próprios dados ao lado, e uma importação volta a lê-los:

Jogo Dados do JoyPro Reposto
DCS <aircraft>\joystick\<device>.jp, modifiers.lua nome da relação, grupos (por ordem), modificadores com nomes, inversão, slider, zona morta, saturação, curva
IL-2 Great Battles data\input\jp.actions nome, grupos, alias, modificadores, a afinação exata
Jogos do registo (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json nome, grupos, alias, modificadores, afinação
Star Citizen actionmaps.jp nomes

O estado atual do jogo ganha: uma curva que alterou no DCS depois da exportação é mantida. As atribuições que o JoyPro nunca exportou recebem um nome formado a partir da ação do jogo e os grupos DCS, IL2 ou GENERATED + jogo.

#Duas proteções

  • Alterações ainda não exportadas. Se alterou atribuições no JoyPro e ainda não as exportou para este jogo, uma importação traria de volta as atribuições antigas. O JoyPro pergunta primeiro.
  • Já importado? Quando o perfil já tem o jogo, as alterações que fizer mais tarde no jogo entram através do monitor de jogos (ele pergunta depois de o jogo fechar); importar de novo continua a ser um clique.
No jogo: O que a importação lê, por tipo de jogo

A importação nunca escreve numa pasta de jogo. O que lê:

  • DCS: as atribuições de cada aeronave e dispositivo, os seus modificadores e, com "Incluir predefinições", as atribuições predefinidas que o DCS tem para cada dispositivo.
  • IL-2 Great Battles / Korea: o key mapping e as respostas dos eixos.
  • Star Citizen: as keybindings do ramo (LIVE, PTU ...), com as predefinições de joystick do jogo em js1.
  • Jogos com infantaria ou veículos (War Thunder, Arma, Reforger, WARDOGS ...): só as ações de voo; tudo o resto é ignorado, não apagado.
  • MSFS: os perfis de entrada do simulador (Steam ou a versão da Microsoft Store) e, a pedido, as predefinições de origem do simulador.

Os dispositivos que o jogo não consegue distinguir (dois dispositivos do mesmo modelo em alguns jogos) e as atribuições de meio eixo (Elite) são ignorados e indicados no resultado.

Detalhes técnicos internos

#Como funciona por dentro

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Chama AskAboutUnexportedChangesAsync (motor sync pending), confirma Recomeçar e guarda uma cópia do perfil (BackupProfileBeforeChange("before-import")), depois chama a importação do jogo: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync ou ImportRegistryGameAsync. Ver primeiro executa o mesmo com scan (PreviewImportWizardAsync) e abre o painel Saída.
  2. Motor. Para o DCS: engine dcs import [--path <Saved Games\DCS>] --merge --include-defaults [--plane <a> --plane <b>] --include-keyboard true|false --ignore-easy-planes false --only-connected false --merge-same-name true. O importador lê cada ficheiro de dispositivo, identifica o dispositivo pelo seu GUID de instância DirectInput e pelo nome, associa cada id de comando à lista de comandos do jogo (DB\<game> em %LOCALAPPDATA%\JoyPro2\GameData) e cria uma relação por função e entrada. As correções ao carregar (--load-corrections, --correction-mode) remapeiam ids de comando com nome alterado, com uma pontuação de certeza.
  3. Perfil. As relações são unidas pelo nome e pela mesma entrada; os modificadores são criados a partir de modifiers.lua (DCS) ou das configurações de shift do jogo. O perfil é guardado de forma atómica e cada gravação é uma versão em <data>\ProfileHistory (Desfazer funciona entre reinícios).
  4. Monitor de jogos. Uma importação de um jogo sem registo de sincronização regista os ficheiros do jogo, para que as alterações que fizer mais tarde no jogo sejam detetadas (<data>\Sync\<game>.json).

#Os ficheiros que lê

Jogo Ficheiros
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua e modifiers.lua, mais os perfis limpos que o JoyPro criou a partir da sua instalação do DCS
IL-2 Great Battles / Korea data\input\*.actions e as respostas dos eixos
Star Citizen actionmaps.xml do ramo
MSFS a pasta remota do Steam ou a gravação da Microsoft Store

As opções da GUI como opções do motor: Adicionar --merge, teclado --include-keyboard true, dispositivos não ligados --only-connected false, mesmo nome --merge-same-name true, aeronaves fáceis --ignore-easy-planes true. A proteção para alterações ainda não exportadas é engine sync pending.

Comandos do motor: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import e engine <game> import para cada jogo do registo (por exemplo engine warthunder import, engine msfs2024 import). Regras de reimportação: reimportação. Testes: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.