O Nuclear Option é um jogo de combate aéreo com jatos, VTOLs e helicópteros e um conjunto de atribuições para todas as aeronaves. Não guarda os seus controlos num ficheiro, mas no registo do Windows: um mapa de joystick Rewired por dispositivo, escrito pelo Control Mapper do jogo. O JoyPro lê estes mapas para o seu perfil e escreve as suas atribuições de Flight Controls de volta neles; as atribuições de câmara, jogabilidade e chat ficam como estão.
Nuclear Option nativo (os seus próprios ficheiros de atribuições)
- Suporte
- nativo (os seus próprios ficheiros de atribuições)
- Comando do motor
engine nuclearoption- Ficheiro de atribuições
- registo
HKCU\Software\Shockfront\NuclearOption(XML Rewired em valores REG_BINARY) - Lista de comandos a partir de
resources.assetsdo jogo- Teste no jogo
- 5/5 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 mortasNuclear Option: a zona morta de calibração do jogo não é escrita.
- ✗ 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
com o Nuclear Option fechado
Antes: inicie o Nuclear Option uma vez e depois feche-o.
Depois: as suas atribuições estão em Settings > Controls > Open Control Bindings Menu, no separador do seu dispositivo.
Já atribuiu botões no Nuclear Option 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 Nuclear Option
- Importar: os mapas de joystick dos seus dispositivos ligados entram no seu perfil: eixos com a sua inversão, botões, e botões num eixo (por exemplo "Increase Throttle").
- Relações: uma relação é uma função; o Nuclear Option não tem listas de aeronaves, por isso uma relação é para todas as aeronaves.
- Exportar: o JoyPro edita o mapa de cada dispositivo no sítio, só as ações de Flight Controls que escreve. Um dispositivo para o qual o jogo não tem mapa guardado recebe um mapa novo com as suas atribuições.
#Importar as suas atribuições
- Inicie o Nuclear Option uma vez (para que a sua chave de registo exista) e feche-o.
- Abra Iniciar, prima Importar no cartão do Nuclear Option e depois Importar agora.
#Criar e verificar relações
Crie relações como em todos os jogos (fluxo das relações); o assistente de configuração e a Atribuição automática conhecem as funções do jogo. Depois execute a Verificação na página Exportar.
#Exportar para o Nuclear Option
- Feche o Nuclear Option. O JoyPro recusa escrever enquanto ele está a correr: o jogo escreve os seus mapas quando o menu de atribuições fecha e quando um dispositivo é desligado.
- Abra Exportar, mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos e prima Exportar agora no cartão do Nuclear Option.


Abra Settings > Controls > Open Control Bindings Menu. O Control Mapper tem um separador por dispositivo: clique no seu dispositivo no topo para ver lá as suas atribuições de Flight Controls (com os nomes do jogo, por exemplo Pitch, Roll, Yaw, Throttle). As atribuições de câmara, jogabilidade e chat não são alteradas.
#O que faz você mesmo no Nuclear Option
- Inicie o jogo uma vez antes da primeira importação ou exportação, para que crie a sua chave de registo.
- Use Throttle Axis Negative Region nos controlos do jogo: deixe-o ligado para um eixo de acelerador completo. O JoyPro avisa quando está desligado e o seu perfil atribui um eixo de acelerador.
- Hats: por agora, atribua as direções dos hats no jogo; o JoyPro ainda não as escreve.
#Erros comuns
- "O Nuclear Option está a correr": feche o jogo e exporte outra vez.
- Um dispositivo é ignorado: dois dispositivos ligados do mesmo modelo (ou um teclado que também aparece como controlador de jogo) não se conseguem distinguir nos mapas do jogo; o JoyPro deixa-os de fora com um aviso.
- Um dispositivo mantém as atribuições predefinidas do jogo: um dispositivo ligado para o qual o jogo não tem mapa guardado usa o mapa predefinido do jogo, que o JoyPro não consegue ler; Limpar também os meus outros dispositivos deixa-o em paz. Atribua-lhe algo no JoyPro, ou limpe o seu separador no Control Mapper uma vez.
- Acelerador preso no meio: verifique Use Throttle Axis Negative Region (veja acima).
#O que o JoyPro lê e escreve
| Onde | O que é |
|---|---|
HKCU\Software\Shockfront\NuclearOption |
As configurações Unity do jogo no registo; os valores Rewired são binários (texto UTF-8 mais um byte zero), os nomes terminam em _h<hash> |
um valor por dispositivo com dataType=ControllerMap e o hardwareIdentifier do dispositivo no nome |
o mapa de joystick de um dispositivo (XML Rewired), para o jogador Player0 |
o mesmo nome com dataType=ControllerMap_KnownActionIds |
os ids de ação que o mapa conhece; o JoyPro escreve-o com um mapa novo |
<install>\NuclearOption_Data\resources.assets |
a lista de ações Rewired do jogo: só leitura, para a lista de comandos |
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json |
os nomes, grupos e afinações do JoyPro para as atribuições exportadas, para a próxima importação |
Antes da primeira escrita, o JoyPro guarda um instantâneo dos valores de mapa de controlador do Player0 no arquivo de backups; Desfazer última exportação escreve-os de volta e remove os valores de mapa que o JoyPro acrescentou. Alguns nomes de valores têm mais de 255 caracteres, por isso o JoyPro usa a API do registo (o Regedit e o reg export não os mostram todos).
#Os modos de exportação no Nuclear Option
| Modo | O que acontece nos mapas dos seus dispositivos |
|---|---|
| Só adicionar | Nada do jogo muda; uma atribuição cujo botão ou eixo já controla outra ação (ou o outro polo de um eixo) fica de fora e é listada. |
| Atualizar, manter atribuições do jogo | Uma ação de Flight Controls numa entrada que atribui a outra ação perde-a; a ação mantém as suas outras entradas. |
| Atualizar, o meu perfil ganha | Como acima, e cada ação (ou polo) que atribui deixa as suas outras entradas, em todos os dispositivos ligados que o JoyPro consegue ler. |
| Substituir nos meus dispositivos | Todas as outras ações de Flight Controls dos dispositivos escritos são libertadas. |
| + Limpar também os meus outros dispositivos | As ações de Flight Controls dos outros mapas guardados de dispositivos ligados são libertadas. Os dispositivos sem mapa guardado mantêm o mapa predefinido do jogo. |
#O que nunca é tocado
- Todas as ações fora de Flight Controls: atribuições de câmara, jogabilidade, chat, depuração e editor de missões.
- Mapas de teclado e rato, os mapas de calibração, os comportamentos de entrada, as atribuições de controladores e todas as configurações do jogo (gráficos,
ThrottleUseNegativee as outras opções de controlo). - Dispositivos que não estão ligados, dois ou mais dispositivos do mesmo modelo, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
- Tudo num mapa editado fora dos mapas de elementos que o JoyPro altera, também atribuições de ações de mods.
#Granularidade, curvas, o resto
- Granularidade: global, um conjunto de atribuições para todas as aeronaves (a ação Throttle é também o coletivo do helicóptero).
- Curvas de eixo: não são escritas. A zona morta de calibração do jogo fica como está.
- Teclado e modificadores: não são escritos; as atribuições de joystick do jogo não têm modificadores.
- Hats: ainda não são lidos nem escritos. Os sliders são escritos com um aviso.
- Force feedback, telemetria: nenhum.
- Monitor de jogos: uma notificação de alteração do registo na chave do jogo; a impressão digital abrange só os mapas de controlador do Player0 (o monitor de jogos).
- HUD: o HUD encontra o jogo pelo seu processo (
NuclearOption).
#Por dentro da integração do Nuclear Option
flowchart LR A["resources.assets<br/>(a lista de ações do jogo,<br/>lida pelo refresh-db)"] --> E["engine nuclearoption export<br/>(antes, um instantâneo dos<br/>valores de mapa de controlador)"] P["O seu perfil"] --> E E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(um mapa de joystick por dispositivo)"] R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Código: engine\Games\NuclearOptionIntegration.cs (o arquivo no registo, as particularidades do jogo, o layout do catálogo) sobre engine\Games\RewiredMapIntegration.cs (leitura e escrita de mapas de joystick Rewired, partilhado com Tiny Combat Arena).
- Nomes de valores: o Unity acrescenta
_h<hash>a cada chave (djb2 com XOR sobre a chave UTF-8, em decimal). - Dispositivos: nenhum dos dispositivos HOTAS habituais é conhecido pelo Rewired do jogo, por isso os seus mapas têm um
hardwareGuida zero ehardwareIdentifier=WindowsRawInput+ texto de produto HID sem espaços + PID + VID (quatro dígitos hex cada, em maiúsculas).duplicateconta dispositivos do mesmo modelo; o JoyPro trata só um por modelo. - Elementos: eixos X, Y, Z, Rx, Ry, Rz = 0 a 5, sliders 6 e 7, botão n = 31 + n. Um botão numa ação de eixo é
<Action>.Positive/.Negative(axisContribution0 / 1). O mapa predefinido do jogo atribui Pitch, Roll, Yaw, Throttle e Brake aos eixos 0 a 4 e onze botões. - Escrita: só mudam os blocos
ActionElementMaptocados (botões em<buttonMaps>, eixos em<axisMaps>); um mapa novo temsourceMapId-1 e a lista de ids de ação conhecidos, para que o jogo não lhe acrescente atribuições predefinidas. - Lista de comandos:
engine nuclearoption refresh-dbencontra o InputManager Rewired emresources.assetspela sua primeira ação ("Pitch") e escreveDB\NuclearOption\actions.tsv(nome da ação, título, categoria, id Rewired; as ações de eixo têm também linhas de polo). - Comandos:
engine nuclearoption paths,engine nuclearoption catalog,engine nuclearoption scan,engine nuclearoption import,engine nuclearoption export; Desfazer comengine backups restore.
#Limites conhecidos
- Os dispositivos que o Rewired do jogo reconhece (um
hardwareGuiddiferente de zero, por exemplo um T.16000M) não são tratados. - Os ids de elemento dos hats não foram vistos num mapa guardado, por isso os hats são ignorados; os ids dos sliders seguem a definição genérica do Rewired.
- As atribuições foram verificadas no menu do jogo, ainda não em voo; o sinal de eixo que o jogo espera para Pitch ainda não está confirmado.
- Testes:
engine\tests\smoke\nuclearoption.ps1(um mapa vJoy real mais atribuições de câmara e de jogabilidade); no jogotools\e2e\games\NuclearOptionSettings.ps1(Pitch, Roll e Yaw em eixos vJoy aleatórios aparecem no separador vJoy do Control Mapper, e uma importação depois de o jogo ter gravado de novo volta a lê-los).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): nuclear-option.md.