JoyPro2 Discord GitHub
Jogos

Star Citizen

Mostrar:

O Star Citizen guarda todos os seus controlos num só ficheiro, actionmaps.xml, e numera os seus manches como posições de joystick js1 a js8. O JoyPro lê as atribuições da nave desse ficheiro para o seu perfil e volta a escrevê-las no próprio ficheiro: só mudam as ações da nave e as configurações dos eixos, todas as outras linhas ficam como o jogo as escreveu. Um dispositivo mantém a posição que o jogo já lhe deu, por isso as suas atribuições não saltam de um manche para outro.

Star Citizen nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine starcitizen
Ficheiro de atribuições
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml (XML)
Lista de comandos a partir de
Data.p4k (defaultProfile.xml) e os seus perfis
Teste no jogo
54/54 passos concluídos (2026-10-10)
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ✓ Modificadores
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✓ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✗ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ✓ Assistente de configuração / Atribuição automática
  • ✓ Cockpits
  • ✓ Folhas de referência
  • ✓ Teste no jogo

Da matriz de suporte, gerada a partir do código do motor: todos os jogos.

Para iniciantes

#Pôr a funcionar em 3 passos

  1. Configurar tudo por mim
    na página Início
  2. Usar estes botões
    veja primeiro a lista
  3. Escrever no meu jogo
    mantenha o Star Citizen fechado

Antes: ligue todos os dispositivos que usa.

Depois: as suas atribuições estão em Options > Controls.

Já atribuiu botões no Star Citizen antes? Então a página Início oferece Importar e depois preencher lacunas. As suas atribuições ficam, e só os botões livres recebem novas funções. Veja Início rápido: pôr o meu manche a funcionar.

#O que o JoyPro faz pelo Star Citizen

  • Importar: as atribuições da sua nave em manches, aceleradores e pedais entram no seu perfil, com as zonas mortas, curvas e inversões. As atribuições de joystick predefinidas do próprio jogo em js1 também entram, para que uma exportação posterior não as perca.
  • Relações: uma relação é uma função em todos os jogos. "Landing gear" pode ser o mesmo interruptor no Star Citizen, no DCS e no Elite Dangerous.
  • Exportar: o JoyPro edita o actionmaps.xml no próprio ficheiro. As atribuições a pé, de veículo e de menu, de rato e de comando ficam como estão.

#Importar as suas atribuições do Star Citizen

  1. Abra Iniciar. Se o cartão do Star Citizen pedir uma lista de comandos, prima Criar lista: o JoyPro lê as ações do jogo a partir da sua instalação (Data.p4k, só leitura). Depois de um patch do jogo, Atualizar no cartão adiciona as novas ações.
  2. Prima Importar no cartão do Star Citizen. Mantenha Adicionar ao meu perfil. Marque Aceitar também as teclas do teclado só se também quiser as teclas da sua nave no JoyPro.
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.
A página Início com os seus jogosA página Início com os seus jogos
A página Início com os seus jogos (As imagens mostram a aplicação em inglês.)

#Criar e verificar relações

Cada ação da nave é uma entrada numa relação. Junte a mesma função dos seus outros jogos com o fluxo de relações e depois prima Verificar na página Exportar: encontra um botão que faz duas coisas na sua nave antes de o jogo o fazer.

#Exportar para o Star Citizen

  1. Feche o Star Citizen. O jogo reescreve o actionmaps.xml ao sair, por isso o JoyPro recusa-se a escrever enquanto ele está a correr.
  2. Abra Exportar e marque o cartão do Star Citizen.
  3. Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus manches. Prima Exportar agora no cartão.
A página ExportarA página Exportar
A página Exportar
No jogo: O que vê no Star Citizen

Inicie o jogo e abra Options > Controls no menu principal. Escolha o seu dispositivo (Joystick / HOTAS 1, 2 ...): a zona morta e a saturação são as que definiu no JoyPro; Inversion Settings e Joystick Sensitivity Curves (Flight > Flight Movement) mostram as suas inversões, expoentes e curvas. As atribuições da sua nave estão na posição de joystick de cada dispositivo. As predefinições do jogo que o JoyPro desligou aparecem vazias. O menu mostra a saturação 0,01 acima do valor no ficheiro (0.87 aparece como 0.88); o jogo mantém o valor exato.

#O que faz sozinho no Star Citizen

  • Nada mais para as atribuições. Ligue todos os dispositivos que usa antes de exportar: um dispositivo que não está ligado mantém a posição e as atribuições, mas o JoyPro não lhe consegue dar novas.
  • Se o jogo estiver numa pasta diferente da detetada, defina o caminho uma vez na página Exportar em Opções e caminhos (para especialistas), ou associe a pasta em Configurações > Jogos.

#Erros comuns

  • "Star Citizen está em execução": feche o jogo (também no launcher) e exporte outra vez.
  • As atribuições foram parar ao manche errado: mantenha SC: preferir a ordem local ligado (a predefinição). Desligado, as posições seguem a ordem em que o Windows comunica os dispositivos, o que pode mover todas as atribuições de um dispositivo para outro número js.
  • Um dispositivo ficou sem posição: o jogo tem oito posições de joystick. O JoyPro junta as entradas duplicadas de um manche (o nome do jogo e o nome do JoyPro) numa só posição, mas mais de oito dispositivos ligados com atribuições não cabem.
  • Uma atribuição predefinida voltou a aparecer em js1: volta quando o dispositivo em js1 não está ligado no momento da exportação. Ligue-o e exporte outra vez com Substituir.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml as suas reatribuições, os espaços de joystick (<options type="joystick" instance="1..8" Product="...">), os grupos de opções por espaço (inversão, expoente, curva, sensibilidade) e as opções de dispositivo (zona morta, saturação por eixo físico)
...\Profiles\default\attributes.xml configurações globais do jogo (<Attr name="..." value="..."/>), só os valores que diferem das predefinições do jogo
...\Profiles\default\actionmaps.jp a cópia do JoyPro do ficheiro escrito, com os nomes das relações como comentários, lida de volta na próxima importação
...\Profiles\default\actionmaps.xml.joypro.json as configurações de eixo que o JoyPro escreveu da última vez, para que "Atualizar" consiga distinguir um valor que alterou no jogo de um valor seu
actionmaps.xml.jpbak, attributes.xml.jpbak cópias de antes da primeira escrita de uma exportação, mais o arquivo de backups com versões do JoyPro

A exportação edita o actionmaps.xml no próprio ficheiro: só mudam as reatribuições de nave e as configurações de eixo das reatribuições de eixo que o JoyPro escreve. Os outros mapas de ações, as reatribuições de rato e de comando, os modos de ativação, os modificadores, os outros grupos de opções e as opções de dispositivo ficam byte a byte. Um perfil sem atribuições do Star Citizen deixa o ficheiro como está.

#Os espaços de joystick

O Star Citizen nomeia cada atribuição de joystick pelo seu espaço: js1_button3, js2_x. O ficheiro lista que dispositivo ocupa que espaço, pelo nome de produto DirectInput e pelo GUID de produto do dispositivo.

  • Preferir a ordem local (ligado por predefinição): um dispositivo ligado que o ficheiro já nomeia mantém esse espaço. Os outros dispositivos preenchem os espaços livres pela ordem em que o Windows os comunica.
  • Um dispositivo, um espaço: o mesmo manche listado duas vezes (com o nome do jogo e com o nome de instância do JoyPro, ou uma segunda entrada antiga) ocupa um só espaço. A exportação remove as entradas duplicadas e passa as suas atribuições para o espaço que o dispositivo mantém. As entradas de dispositivos que não estão ligados ficam.
  • Dois dispositivos ligados do mesmo modelo ficam separados.
  • Um dispositivo que muda de espaço leva consigo os seus grupos de opções (inversão, curvas). Um dispositivo que não recebe espaço perde os grupos do seu espaço antigo, com um aviso.

#Os modos de exportação no Star Citizen

Todos os modos mudam só ações de nave. Os mapas a pé, de veículo e de menu ficam byte a byte.

Modo O que acontece no jogo
Só adicionar Nenhuma atribuição do jogo muda. Uma ação cujo espaço de joystick já tem uma reatribuição ou uma predefinição ativa mantém-na. Uma atribuição numa entrada que outra ação de nave usa não é escrita e recebe a marca "Não escrito no jogo".
Atualizar, manter atribuições do jogo A sua entrada vai para o espaço de joystick da ação (o Star Citizen tem um por ação e tipo de entrada). Uma atribuição do jogo numa entrada que dá a outra ação de nave é libertada: a sua reatribuição desaparece, ou passa a um js1_ vazio quando a ação tem uma predefinição, para que a predefinição não volte.
Atualizar, o meu perfil ganha Como acima; com a opção de teclado, uma ação que atribui também perde a sua reatribuição de teclado.
Substituir nos meus dispositivos Os dispositivos escritos ficam só com as suas atribuições de nave. Com um dispositivo em js1, as predefinições js1 do jogo que o seu perfil não tem são desligadas.
+ Limpar também os meus outros dispositivos Os dispositivos ligados sem atribuições no seu perfil perdem as suas atribuições de nave; as predefinições de js1 são desligadas quando js1 não é usado.

Opções na página Exportar (em Opções e caminhos (para especialistas)):

  • SC: manter predefinições do teclado (ligado): o teclado mantém as teclas predefinidas do jogo. Desligado: as suas atribuições de teclado são escritas e as teclas predefinidas que ocupam são libertadas.
  • SC: preferir a ordem local (ligado): veja os espaços de joystick acima.
Opções e caminhos (para especialistas) na página ExportarOpções e caminhos (para especialistas) na página Exportar
Opções e caminhos (para especialistas) na página Exportar

#As atribuições de joystick predefinidas do jogo

O Star Citizen tem atribuições de joystick predefinidas que atuam em js1 até uma ação receber aí uma reatribuição (pitch em Y, yaw em X, roll na rotação Z, alguns botões). A importação toma cada predefinição ativa como uma atribuição do dispositivo js1, para que o seu perfil contenha o que o jogo faz realmente. A exportação não escreve reatribuição para uma atribuição igual à predefinição (só diferenças reais). Substituir e Limpar também desligam as predefinições que o seu perfil não tem com uma reatribuição vazia js1_ , tal como o próprio menu do jogo escreve uma atribuição apagada, e só quando o dispositivo em js1 está ligado. Assim, importar e depois Substituir + Limpar também deixa o actionmaps.xml como estava.

#O que nunca é tocado

  • Atribuições a pé, de veículos terrestres e de menu (os veículos terrestres do Star Citizen contam como a sua própria classe de veículo).
  • Dispositivos que não estão ligados: mantêm o seu espaço e as suas reatribuições.
  • Os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • Atribuições de rato e de comando; o teclado, a menos que exporte atribuições de teclado.
  • Modos de ativação, modificadores, outros grupos de opções e opções de dispositivo.

#Naves, curvas, configurações do jogo

  • Granularidade: um conjunto de atribuições de nave para todas as naves (o jogo não tem atribuições por nave).
  • Curvas de eixo, em dois sítios, tal como o jogo as guarda: zona morta e saturação por dispositivo e eixo físico; inversão, expoente (1 a 3), uma curva de 11 pontos e sensibilidade por espaço e grupo de opções. Expoente e curva excluem-se mutuamente, como no menu do jogo. Uma relação sem valores do Star Citizen recebe a sua curva do JoyPro ajustada: zona morta e saturação vão para o eixo do dispositivo, a curvatura passa ao expoente mais próximo, ou à curva quando nenhum expoente serve. Não há eixo de um só lado: o acelerador absoluto e o relativo do jogo são ações separadas.
  • Atualizar mantém um valor de eixo que alterou no jogo (com um aviso); Substituir e o meu perfil ganha definem os valores do seu perfil. Uma relação neutra deixa o valor próprio do jogo (a vista livre mantém o seu expoente predefinido 2.5).
  • Configurações globais do jogo (attributes.xml): o interruptor de inversão de thrust HOTAS, o tempo e o limiar da trap do acelerador relativo, os modificadores de sensibilidade do IFCS, ESP ligado, força e amortecimento, ESP da torre, as predefinições de voo (sticky throttle, limitador de velocidade, coupled, G-safe, auto precision, space brake), inverter o controlador de voo e Vibration. Defina-as em Configurações > Configurações de force feedback dos jogos (escolha Star Citizen) ou com engine ffb set. O JoyPro altera só as linhas que define, no próprio ficheiro, e não cria o ficheiro. O controlo deslizante da força do ESP termina em 1.00, por isso o JoyPro oferece 0 a 1.
  • Force feedback: nenhum. Vibration é a única configuração deste tipo no jogo.
  • Monitor de jogos: uma atribuição ou um valor de eixo que altera no menu do jogo é detetado depois de o jogo fechar, e o JoyPro pergunta se o deve adotar. Compara o actionmaps.xml (só os mapas de ações de nave) e as configurações que o JoyPro guarda no attributes.xml.
  • HUD: o HUD encontra o jogo pelo seu processo e mostra as suas atribuições do Star Citizen.
Detalhes técnicos internos

#Por dentro da integração do Star Citizen

flowchart LR
  A[("actionmaps.xml")] --> S["Espaço por dispositivo"]
  D["Dispositivos ligados"] --> S
  P["O seu perfil"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
Um dispositivo conhecido mantém o seu espaço de joystick (js1 ... js8 em actionmaps.xml). Um dispositivo novo recebe o primeiro espaço livre; um duplicado antigo é removido. As atribuições das naves são editadas no próprio ficheiro, as configurações de todo o jogo vão para attributes.xml.

Código: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, o modelo de eixo engine\AxisModels\StarCitizen.cs e o modelo de configurações engine\FfbModels\StarCitizen.cs.

  • Nomes dos dispositivos: o Product do espaço é o nome de produto DirectInput e o GUID de produto, separados por dois espaços (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Um espaço ou bloco deviceoptions escrito com outro nome (um GUID de instância) não é reconhecido pelo jogo: ele reescreve o espaço com o seu produto e descarta os grupos de opções do espaço. Por isso o JoyPro escreve o nome de produto do dispositivo ligado.
  • Lista de comandos: engine db refresh-starcitizen lê Data\Libs\Config\defaultProfile.xml de Data.p4k (ou de uma cópia extraída com --source) para DB\StarCitizen\AllBinds.xml: cada ação com o seu grupo de opções, a árvore de opções de joystick (pais e predefinições, que grupos mostram uma curva) e a entrada de joystick predefinida da ação. engine starcitizen labels obtém os nomes dos controlos do jogo a partir de global.ini.
  • Importar: engine starcitizen import (--include-keyboard, --device, --ignore-device); cada reatribuição de eixo recebe os valores que o jogo usa (o grupo folha do espaço, senão o pai mais próximo que definiu, senão a predefinição do jogo) e as opções de dispositivo do seu eixo, como a sua afinação game:StarCitizen. engine starcitizen scan mostra o mesmo sem alterar o perfil; engine starcitizen list-devices lista os espaços de joystick do ficheiro.
  • Exportar: engine starcitizen export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>. Um novo bloco deviceoptions fica antes do primeiro <options>; várias relações num grupo de opções ou num eixo físico com valores diferentes dão um aviso, e ganha a primeira relação por nome.
  • Configurações do jogo: engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; uma linha existente recebe o valor, uma nova vai para o seu lugar na ordem.
  • Backups: engine backups list lista as cópias; Desfazer última exportação no cartão repõe a mais recente.

#Limites conhecidos

  • Oito espaços de joystick; o limite de botões por dispositivo não é conhecido (as fontes contradizem-se).
  • Ainda não está confirmado onde o jogo quer um novo bloco deviceoptions, a interpolação da curva (o menu desenha uma spline suave pelos pontos), o intervalo do expoente e se a sensibilidade se aplica a joysticks. Os intervalos das configurações globais do jogo não estão nos ficheiros legíveis do jogo.
  • Ainda não está confirmado se Vibration controla um manche DirectInput com force feedback.
  • Testes: engine\tests\smoke\starcitizen.ps1 (atualização do catálogo, importação de grupos de opções e curvas, importação + exportação byte a byte, todas as configurações de eixo, conflitos, mudanças de espaço, attributes.xml no próprio ficheiro); no jogo tools\e2e\games\StarCitizenSettings.ps1 (Options do menu principal: configurações, atribuições e curvas) e tools\e2e\games\StarCitizen.ps1 (matriz de modos de exportação e importação).

Todas as notas técnicas sobre este jogo (geradas a partir do repositório): starcitizen.md.