Uma relação é uma função, por exemplo "Gear Up/Down" ou "Throttle". Contém a ação dessa função em cada jogo e aeronave que voa: DCS F-16C "Landing Gear Up/Down", IL-2 "Gear", War Thunder "Landing gear", Star Citizen "Toggle landing gear". Dá à relação um botão ou eixo na página Atribuições (ou vários, por exemplo o mesmo botão em dois manches), e esse botão faz então a mesma função em todo o lado.
Entrada 1: botão 22 do acelerador (com Shift premido)
Entrada 2: botão 5 do manche
Cada jogo recebe as mesmas entradas para a sua própria ação. A exportação escreve-as nos próprios ficheiros de controlos de cada jogo, com um backup primeiro. Um jogo que guarda menos entradas por ação (o Elite Dangerous guarda dois botões, a maioria dos jogos um eixo) recebe tantas quantas guarda, e a exportação diz-lhe qual não coube.
| Jogo | A sua ação | As suas entradas | Onde a exportação a escreve |
|---|---|---|---|
| DCS (F-16C, F/A-18C, A-10C) | Landing Gear Up/Down | Botão 22 do acelerador com Shift, botão 5 do manche | Os controlos de cada aeronave na pasta Saved Games do DCS |
| IL-2 Korea | Gear | o mesmo | O key mapping do IL-2 Korea |
| War Thunder | Landing gear | o mesmo | O ficheiro de controlos do War Thunder |
#Relações em palavras simples
Pense numa relação como uma etiqueta para uma tarefa: "baixar o trem de aterragem". Cada jogo chama a essa tarefa outra coisa e guarda-a com o seu próprio código. A relação junta-as todas, para que decida uma só vez que botão faz a tarefa.
- Página Relações: a lista das suas relações à esquerda, a relação aberta ao centro, as ferramentas à direita.
- Página Atribuições: em que botão ou eixo está cada relação. Uma relação pode estar em vários.
- Exportar: escreve-a em todos os jogos.


#Criar uma, passo a passo
- Prima Nova relação (ou Ctrl+N) e escreva um nome, por exemplo
Gear. - Em Adicionar ações, escreva o que faz:
gear. O JoyPro procura em todos os jogos e aeronaves enquanto escreve e conhece outras palavras para a mesma coisa (throttletambém encontra thrust e o coletivo do helicóptero,flareo interruptor de lançamento de contramedidas). - Os resultados aparecem agrupados por jogo. O controlo principal da função em cada jogo vem primeiro. Marque o que pertence.
- Prima Criar relação com n ações. Pronto: abra a página Atribuições e prima o botão que quer para ela.
#Deixar o JoyPro fazer
- Sugerido para esta relação lista o que mais significa o mesmo noutros jogos e aeronaves. Adicionar uma ou Adicionar todas.
- Criar relações automaticamente a partir de todas as minhas ações... cria relações para o perfil inteiro: a mesma função de todas as aeronaves e jogos junta (Por função, chamado Agrupamento automático). Primeiro vê uma pré-visualização.
- Assistente do JoyPro: escreva uma frase como "make a throttle relation for every game" e ele faz isso. Desfazer isto desfaz a resposta inteira.
Todas as alterações podem ser desfeitas com Ctrl+Z, também depois de reiniciar.
#Trabalhar com muitas relações
- Filtros por cima da lista: grupos, jogos e as suas aeronaves, dispositivos, atribuído ou não, eixo ou botão. A pesquisa pode olhar só para os nomes, para nomes e ações, ou para tudo (memorizado). Ctrl/Shift+clique marca várias relações para Alterações em massa (grupos, duplicar, apagar).
- A relação aberta: mudar o nome no próprio sítio (Enter), o seu tipo (Eixo ou Botão), a sua entrada, a etiqueta de função (o que o JoyPro acha que a relação é, a partir do seu catálogo de funções), Sugerir em falta (n), Duplicar (com ou sem a atribuição), apagar. Por baixo, As suas ações: um cartão por ação de jogo com o distintivo do jogo, a aeronave, o título. Arraste um cartão pela pega para mudar a ordem (ou Alt+Up / Alt+Down).
- Aeronaves de uma ação (DCS): um clique numa ação abre as suas aeronaves, "82 de 84 aeronaves", cada uma com uma caixa. O mesmo id de comando do DCS pode significar outra coisa noutra aeronave (
a2001cdnilé "Pitch" nos jatos e "Cyclic Pitch" nos helicópteros; um id de interruptor de cockpit são três interruptores diferentes em três warbirds): o JoyPro só acrescenta aeronaves onde o id significa o mesmo e assinala as outras. - As sugestões vêm de quatro fontes, sem qualquer IA: o catálogo de funções (verificado com os manuais), o seu próprio estilo (o que pôs nesta função noutras aeronaves), o mesmo id do DCS onde significa o mesmo, e títulos semelhantes em qualquer jogo (nunca a direção oposta). Alta a partir de 85 pontos, média a partir de 55; as fracas só a pedido. x descarta uma sugestão para sempre (fica na relação desativada, por isso nunca volta).
- Já noutra relação: uma linha diz "Já está em 'Flare'" e oferece Mover para aqui.
- Catálogo: todas as ações de um jogo ou aeronave pelas suas categorias, para navegar em vez de pesquisar.
- O Agrupamento automático funciona para DCS, Falcon BMS, IL-2 Great Battles e Korea, Star Citizen, X4, Elite Dangerous, MSFS 2020 e 2024, X-Plane 11 e 12, War Thunder, Arma 3, Arma Reforger e WARDOGS. Agrupar por descrição agrupa só o que uma frase nomeia ("all radio and comms functions of the F-16 and the A-10").
#Várias entradas para uma relação
Uma relação pode estar em mais do que uma entrada: a mesma função em dois manches, ou um segundo botão de disparo. Cada entrada tem o seu próprio dispositivo, modificadores e curva de eixo. A entrada 1 é a entrada principal.
- Acrescentar uma: página Atribuições, a relação, Mais entradas > Gravar outra entrada (ou Adicionar a entrada escolhida manualmente). Tornar principal troca-a com a entrada principal; Remover retira-a.
- Uma curva por entrada: para um eixo em dois dispositivos, a Resposta do eixo tem uma lista Entrada no topo.
- Um dispositivo inteiro: Copiar cada atribuição de um dispositivo para outro dispositivo dá a cada atribuição do primeiro dispositivo a entrada correspondente do segundo (o mesmo punho em duas bases).
- Encontrada por qualquer entrada: Seguir entrada, a página Layout, o filtro Dispositivos e a pesquisa com Tudo também encontram uma relação pela sua segunda entrada.
- Nos jogos: onde um jogo guarda várias entradas por ação, Exportar escreve-as todas, a principal primeiro. Onde guarda só uma, escreve a entrada principal e nomeia as restantes.
#Várias ações de uma vez
Na relação aberta, Ctrl+clique ou Shift+clique em cartões de ação; Ctrl+A seleciona todos. A barra "n ações selecionadas" oferece:
| Botão | O que faz |
|---|---|
| Copiar (Ctrl+C) | Depois abra outra relação do mesmo tipo e prima Colar (Ctrl+V). As ações vêm com as suas aeronaves, também as desativadas. |
| Mover para... | Nova relação (escreva um nome; mesmo tipo que a antiga) ou Relação existente, escolhida numa lista onde pode pesquisar. Só são listadas relações do mesmo tipo. |
| Remover (Del) | Retira-as depois de uma pergunta. |
O menu do botão direito de uma ação também tem Copiar e Mover para outra relação.... Na lista de relações, selecione várias relações (Ctrl/Shift+clique) e prima Mover ações para...: todas as suas ações vão para uma relação, nova ou existente, e as relações esvaziadas são apagadas. Cada uma destas operações é um passo: um Ctrl+Z desfá-la. Mais: Vários botões para uma função.
#O que a Verificação analisa
Duas relações com a mesma entrada que têm ambas uma ação da mesma aeronave ativa significam que um botão faz duas coisas aí; uma ação ativa em duas relações significa que o jogo a recebe em dois botões. A Verificação lista as duas situações com correções de um clique.
Uma relação, por si só, não muda nada num jogo. Na próxima exportação, cada ação da relação recebe as entradas da relação, em cada jogo e aeronave onde a ação está ligada:
- DCS: em cada aeronave marcada, o comando recebe o botão (com o modificador, quando a atribuição tem um). Uma aeronave desligada na ação mantém o que tinha (ou nada, com Substituir).
- IL-2, BMS, X-Plane, MSFS, War Thunder ...: uma ação por jogo; recebe o botão.
- Star Citizen e jogos com infantaria: só a ação da nave ou da aeronave recebe o botão; as atribuições a pé ficam.
- As relações de eixo levam a curva, a zona morta, a saturação, a inversão e o slider da atribuição, escritos no próprio modelo de resposta de cada jogo (curvature do DCS, response do IL-2, sensitivity do MSFS, response curve do X-Plane ...).
Assim, depois de uma exportação, "Throttle · BTN 22" baixa o trem de aterragem no F-16, no F/A-18, no A-10C, no IL-2 Korea e no War Thunder, e o jogador encontra o mesmo interruptor para a mesma tarefa em todos os cockpits.
#Como funciona por dentro
- Modelo de dados (
engine\CoreRelation.cs,CoreProfile.cs): um.pr0filecontém objetosRelation; cada um tem um nome, grupos,IsAxis, uma lista deRelationItem(jogo, id, aeronaves com estado ativo/desativo, ordem) e umBind(dispositivo, entrada, modificadores, afinação do eixo por âmbito). Os modificadores são objetos separados, referidos pelo nome. O perfil é guardado de forma atómica e com versões (ProfileHistory.cs). - Pesquisa (
engine relations search): um índice sobre a lista de comandos de todos os jogos (DB\<game>na pasta de dados dos jogos), o catálogo de funçõesDB\Functions(funções, sinónimos, termos dos jogos, verificados com os manuais) e os significados por id (EngineIdMeanings.cs: igual / próximo / diferente por aeronave do DCS). A GUI executa-a 300 ms depois da última tecla; os comandos rápidos vão para um únicoengine servede longa duração (o servidor do motor) em vez de um processo novo de cada vez. - Alterações:
relations add <name> --axis|--button --node Game:Id:Plane1|Plane2,relations suggest apply <relation> --add ... | --take | --never | --remove,relations rename,relations item move,relations aircraft set. Cada um é um comando do motor, portanto um passo de desfazer. - Sugestões:
relations suggest <relation> [--min high|medium|low](pontuações como acima);relations suggest --all --missingpara todas as relações de uma vez. - Agrupamento automático: regras determinísticas mais o estilo aprendido (pelo menos duas decisões separadas nas suas próprias relações); pré-visualizar, depois aplicar. O modelo de IA local opcional só chama as mesmas ferramentas; sem ele, respondem as regras offline.
O que acontece quando pesquisa, cria uma relação e recebe sugestões. A página Relações pergunta ao servidor do motor:
| # | Quem | O que acontece |
|---|---|---|
| 1 | Você | Escreva "gear" na pesquisa. |
| 2 | Servidor do motor | relations search "gear" --limit 200 --per-game 12 responde com linhas por jogo, o controlo principal primeiro, e porque cada uma foi encontrada. |
| 3 | Você | Marque linhas e prima Criar relação. |
| 4 | Servidor do motor | relations add "Gear" --button --node DCS:d68...:F-16C_50\|FA-18C_hornet --node WarThunder:ID_GEAR:WarThunder guarda o perfil com uma versão no histórico. |
| 5 | Servidor do motor | relations suggest "Gear" responde com sugestões, as suas pontuações e motivos. |
Comandos do motor: engine relations search, engine relations add, engine relations suggest, engine relations browse, engine relations assistant, engine relations auto-group, engine relations from-text. Documentação: Referência da página Relações, Agrupamento automático, Agrupar por descrição, Sugerir adições.
#Relacionado
- A página Relações, todos os controlos dela
- A página Atribuições: dar à relação o seu botão
- Modificadores: um botão muda o que os outros fazem