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.
#Pôr a funcionar em 3 passos
- Configurar tudo por mim
na página Início - Usar estes botões
veja primeiro a lista - 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.xmlno 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
- 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. - 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.
- Prima Importar agora. Ver as minhas relações abre o que entrou.


#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
- Feche o Star Citizen. O jogo reescreve o
actionmaps.xmlao sair, por isso o JoyPro recusa-se a escrever enquanto ele está a correr. - Abra Exportar e marque o cartão do Star Citizen.
- 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.


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


#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 comengine 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 noattributes.xml. - HUD: o HUD encontra o jogo pelo seu processo e mostra as suas atribuições do Star Citizen.
#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"]
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
Productdo 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 blocodeviceoptionsescrito 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-starcitizenlêData\Libs\Config\defaultProfile.xmldeData.p4k(ou de uma cópia extraída com--source) paraDB\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 labelsobtém os nomes dos controlos do jogo a partir deglobal.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çãogame:StarCitizen.engine starcitizen scanmostra o mesmo sem alterar o perfil;engine starcitizen list-deviceslista 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 blocodeviceoptionsfica 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 listlista 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.xmlno próprio ficheiro); no jogotools\e2e\games\StarCitizenSettings.ps1(Options do menu principal: configurações, atribuições e curvas) etools\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.