JoyPro2 Discord GitHub
Jogos

VTOL VR

Mostrar:

O VTOL VR é um jogo de voo de combate só para VR: voa com os comandos de VR no manche e acelerador virtuais. O próprio jogo só atribui três eixos de um dispositivo físico, o leme e os dois travões de pé, e guarda-os num único ficheiro para todas as aeronaves. O suporte completo de HOTAS (manche, acelerador, todos os interruptores, por aeronave e lugar) vem do mod gratuito BYOJoystick. O JoyPro trata ambos como dois jogos: VTOL VR (BYOJoystick mod) escreve os ficheiros de atribuições do mod, VTOL VR (native rudder and brakes) escreve o próprio ficheiro do jogo e as suas configurações de controlo.

VTOL VR (mod BYOJoystick) nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine vtolvr
Ficheiro de atribuições
<install>\SaveData\BYOJ_<seat>.xml (XmlSerializer)
Entradas que o jogo lê
lê 128 botões, 8 eixos, 4 hats (4 direções) por joystick (verificado)
Lista de comandos a partir de
o BYOJoystick.dll do mod instalado (Steam Workshop; no programa: "Instalar BYOJoystick" no cartão do VTOL VR), senão os seus próprios BYOJ_*.xml
  • ✓ Importar
  • ✓ Exportar
  • ✓ Atribuições de teclado
  • ◐ ModificadoresBYOJoystick: um modificador por atribuição (um botão de joystick para atribuições de joystick, uma tecla para atribuições de teclado).
  • ◐ Lista de comandos criada no seu PCVTOL VR (BYOJoystick): a lista só é criada quando o mod BYOJoystick está instalado.
  • ✓ Monitor de jogos
  • ◐ Curvas de eixo e zonas mortasBYOJoystick: um valor de zona morta por atribuição (limiar de tomada de controlo, ou um corte para slew e inclinação); sem curvas.
  • ✓ 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
VTOL VR (nativo: leme e travões) nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine vtolvr-native
Ficheiro de atribuições
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg (ConfigNode + XML Rewired) + gameSettings.cfg
Lista de comandos a partir de
level0 do jogo
  • ✓ Importar
  • ✓ Exportar
  • ✗ Atribuições de teclado
  • ✗ Modificadores
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ◐ Curvas de eixo e zonas mortasVTOL VR nativo: só inversão e intervalo do eixo, sem curva nem zona morta.
  • ✓ 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 VTOL VR fechado

Antes: prima Instalar BYOJoystick no cartão do VTOL VR (uma vez, ver abaixo). Inicie o VTOL VR uma vez com os pedais ligados e saia de Settings com OK.

Depois: ligue Hardware Control Rudder nas configurações do jogo, senão o jogo ignora o seu leme.

Já atribuiu botões no VTOL VR 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 VTOL VR

  • Com o BYOJoystick: todos os alvos que o mod oferece (eixos do manche e do acelerador, trem de aterragem, flaps, armas, contramedidas, radar, luzes, botões dos MFD e mais) para cada veículo e lugar, a partir dos seus manches, aceleradores e do teclado.
  • Sem o mod: o próprio Rudder, Wheel Brake L e Wheel Brake R do jogo, mais as configurações do seu menu Controls (Hardware Control Rudder, zonas mortas de VR, háptica).
  • Relações: uma relação é uma função; a exportação do BYOJoystick escreve-a em todos os ficheiros de lugar cujo veículo tenha esse alvo.

#Instalar o BYOJoystick (uma vez)

  1. Abra Iniciar e prima Instalar BYOJoystick no cartão do VTOL VR. Um painel mostra o que é o mod, a sua fonte oficial (o Steam Workshop, o código-fonte no GitHub), o seu tamanho e se o VTOL VR Mod Loader e o mod estão neste PC.
  2. Marque a caixa a confirmar que leu o que é o BYOJoystick e que o quer instalar a partir do Steam Workshop, e depois prima Instalar BYOJoystick. O JoyPro faz uma cópia de segurança dos seus ficheiros BYOJ e abre o Steam: instale o Mod Loader se o Steam pedir e depois prima Subscribe na página do BYO Joystick. O Steam descarrega o mod; o JoyPro não copia nada dele.
  3. Prima Verificar de novo: o JoyPro encontra o mod e cria a partir dele a sua lista de comandos do VTOL VR.

#Importar as suas atribuições

Prima Importar no cartão do VTOL VR (BYOJoystick) ou no cartão da parte nativa e depois Importar agora. Para o BYOJoystick, Aceitar também as teclas do teclado traz também as suas atribuições de teclado.

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

Crie relações como para qualquer jogo (fluxo de relações); o assistente de configuração e a Atribuição automática conhecem os alvos do BYOJoystick. Depois execute a Verificação na página Exportar.

#Exportar para o VTOL VR

  1. Feche o VTOL VR. O JoyPro recusa-se a escrever enquanto o jogo está a correr (processo VTOLVR).
  2. Abra Exportar e mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus dispositivos.
  3. Prima Exportar agora no cartão do VTOL VR (BYOJoystick) e, para os pedais, no cartão nativo.
No jogo: O que vê no VTOL VR

No jogo, Settings mostra Hardware Control Rudder ligado quando o seu perfil o define, e Bindings lista Rudder, Wheel Brake L e Wheel Brake R com o seu dispositivo e o respetivo eixo. As atribuições do BYOJoystick estão na própria janela do mod, por lugar do veículo; o seu Load volta a ler os ficheiros.

#O que faz sozinho no VTOL VR

  • Inicie o VTOL VR uma vez com os pedais ligados e saia de Settings com OK. O jogo lista então os seus dispositivos e cria o gameSettings.cfg; a exportação nativa só escreve dispositivos que o jogo listou e nunca cria o ficheiro de configurações.
  • Hardware Control Rudder tem de estar ligado, senão o jogo ignora os eixos do leme e dos travões. Ligue-o no jogo, ou guarde-o no JoyPro (Avançado) para que a exportação nativa o escreva.
  • O BYOJoystick precisa do VTOL VR Mod Loader do Steam; o JoyPro só abre as páginas do Steam.

#Erros comuns

  • O leme não faz nada: o Hardware Control Rudder está desligado. O jogo lê-o quando um veículo aparece.
  • Só funciona um travão de pé, ou ambos seguem o gatilho do acelerador: o jogo só usa os travões dos seus pedais quando Wheel Brake L está atribuído. Atribua ambos.
  • Um travão de pé só trava na segunda metade do curso: o jogo lê um travão de 0 a 1. Defina o intervalo do eixo dessa relação como Positivo (Avançado); o JoyPro avisa sobre este caso.
  • Dois pedais idênticos: o jogo guarda um mapa por modelo de dispositivo, por isso ambos controlam a mesma ação.
  • Uma atribuição do BYOJoystick desapareceu: o mod descarta os alvos que um veículo não tem quando carrega um ficheiro.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
<install>\SaveData\BYOJ_<seat>.xml Atribuições BYOJoystick de um lugar de veículo: AV42C, FA26B, F45A, AH94Front, AH94Rear, T55Front, T55Rear, EF24GFront, EF24GRear
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg as atribuições próprias do jogo: mapas de joystick Rewired num ficheiro de texto; o Steam Cloud sincroniza-o
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\gameSettings.cfg os valores de Settings > Controls (HARDWARE_RUDDER, ...); o Steam Cloud sincroniza-o
<library>\steamapps\workshop\content\3018410\3276352374\BYOJoystick.dll o mod instalado: só leitura, para a sua lista de alvos
<install>\VTOLVR_Data\level0 a lista de ações Rewired do jogo: só leitura, para a lista de comandos nativa

O ficheiro antigo <install>\SaveData\inputbindings.cfg nunca é escrito. Cada escrita tem primeiro um backup e é feita de forma atómica (ficheiro temporário, depois substituição): o jogo substitui um inputbindings.cfg danificado por um vazio.

#Os modos de exportação no VTOL VR

Modo BYOJoystick (ficheiro por lugar) Nativo (inputbindings.cfg)
Só adicionar Nada por cima das atribuições do lugar: uma atribuição numa entrada que outro alvo usa (com o mesmo estado de modificador) é listada como não escrita. Só eixos livres; um eixo ocupado é listado como não escrito.
Atualizar, manter atribuições do jogo O outro alvo na sua entrada perde-a; tudo o resto fica, também a entrada antiga de um alvo movido. A ação no seu eixo é substituída; tudo o resto fica.
Atualizar, o meu perfil ganha Como acima, e os seus alvos deixam as suas outras entradas nos dispositivos ligados (teclas só com a opção de teclado). Como acima, e as suas ações deixam os seus outros eixos nos dispositivos ligados.
Substituir nos meus dispositivos Os dispositivos que o JoyPro escreve ficam só com as suas atribuições. As outras ações dos dispositivos escritos são apagadas.
+ Limpar também os meus outros dispositivos Os dispositivos ligados sem atribuições são apagados. Os dispositivos ligados sem atribuições são apagados.

#O que nunca é tocado

  • Os dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • BYOJoystick: entradas que o JoyPro não consegue ler, e o botão modificador do lugar, a menos que o seu perfil traga o seu próprio.
  • Nativo: mapas de botões, mapas de teclado e rato, comportamentos de entrada, os mapas de calibração, as atribuições de controladores e o jogador System. A exportação BYOJoystick não escreve gameSettings.cfg.
  • O teclado, a menos que exporte atribuições de teclado (só BYOJoystick).

#Lugares, eixos, configurações

  • Granularidade: BYOJoystick por lugar de veículo (um alvo vai para cada lugar que o tenha); a parte nativa é global.
  • Eixos BYOJoystick: inversão e o número único de Zona morta do mod por atribuição. Em Joystick Pitch, Roll, Yaw e em Throttle, Power, Collective não é uma zona morta, mas o desvio de que o HOTAS precisa para tirar o controlo ao outro tripulante em multijogador; em SOI Slew X/Y e Articulate Tilt corta os valores pequenos sem reescalar; noutros sítios o mod não o usa. Sem curvas. Veja axis-curves.
  • Eixos nativos: inversão e, para os travões de pé, o intervalo do eixo (Full ou Positive). Zonas mortas e curvas não podem ser escritas.
  • Modificadores: o BYOJoystick conhece um botão modificador por ficheiro de lugar (as atribuições que precisam dele só atuam enquanto está premido); uma atribuição de teclado pode ter uma tecla modificadora. A parte nativa não tem nenhum.
  • Configurações de controlo: Configurações > Configurações de force feedback dos jogos, jogo VTOL VR (control settings, VR haptics): Hardware Control Rudder, Thumb Control Rudder, Twist Rudder Deadzone, Thumbstick Deadzone, Thumbstick Mode, Toggle Grip, Flight Control Haptics, Overall Haptics. A exportação nativa escreve-as em gameSettings.cfg, também quando o perfil não tem atribuições nativas.
  • Force feedback: o VTOL VR não tem force feedback de joystick; a resposta háptica é a dos controladores VR.
  • Monitor de jogos: os ficheiros BYOJ e, com a parte nativa, o gameSettings.cfg (o monitor de jogos).
Detalhes técnicos internos

#Por dentro da integração do VTOL VR

flowchart LR
  P["O seu perfil"] --> B["engine vtolvr export"]
  P --> N["engine vtolvr-native<br/>export"]
  B --> X["BYOJ_seat.xml"]
  N --> I["inputbindings.cfg"]
  N --> S["gameSettings.cfg"]
  X --> M["Mod BYOJoystick"]
  I --> G["VTOL VR:<br/>Bindings"]
Dois jogos no JoyPro: os ficheiros do mod BYOJoystick (um BYOJ_seat.xml por lugar na SaveData do jogo) e o leme e os travões de pé próprios do jogo (inputbindings.cfg, e Hardware Control Rudder em gameSettings.cfg).

Código: engine\Games\VtolVrIntegration.cs (BYOJoystick), VtolVrMod.cs (estado da instalação, lista de alvos), ClrMetadata.cs, VtolVrNativeIntegration.cs, engine\AxisModels\VtolVr.cs (byoj, vtolnative), engine\FfbModels\VtolVr.cs (as configurações de controlo).

  • Formato BYOJoystick: serialização XML do .NET, raiz <Bindings> com <KeyboardBindings> (Target, Key, ModifierKey como nomes KeyCode do Unity) e <JoystickBindings> (Target, JoystickId, Input, RequiresModifier, Invert, Deadzone, POVDirection). Input: X Y Z RX RY RZ, S1 S2, PoV1..PoV4, B1..B128. Dispositivos pelo GUID de instância DirectInput (JoystickId).
  • Formato nativo: um ficheiro de texto com a raiz RewiredSaveData e linhas {key} = {value}; o mapa de joystick é XML Rewired (declarado UTF-16 dentro de um ficheiro UTF-8). Ações: 0 Rudder, 5 Wheel Brake L, 6 Wheel Brake R. Um mapa é identificado pelo modelo do dispositivo: hardwareIdentifier = WindowsRawInput + texto de produto HID sem espaços + PID decimal + GUID de produto, hardwareGuid a zero para dispositivos que o Rewired não conhece. O elemento é o n-ésimo eixo do dispositivo.
  • Listas de comandos: engine vtolvr refresh-db lê os alvos do BYOJoystick.dll instalado sem o carregar nem executar (os seus metadados e literais de texto), depois os seus próprios BYOJ_*.xml; sem o mod não há lista. engine vtolvr-native refresh-db lê a lista de ações Rewired de level0.
  • Comandos: engine vtolvr mod (status, prepare --accept-license), engine vtolvr scan, engine vtolvr import, engine vtolvr export, engine vtolvr-native scan, engine vtolvr-native import, engine vtolvr-native export, as configurações com engine ffb set --device * --game VTOLVR.

#Limites conhecidos

  • Ainda sem execução no jogo; o BYOJoystick é testado com uma DLL substituta. Ainda não está confirmado se o mod carrega na versão atual do jogo.
  • Nativo: a ordem dos eixos dos dispositivos que o Rewired não conhece e o identificador exato do dispositivo vêm do código do jogo, ainda não de um ficheiro escrito pelo jogo.
  • BYOJoystick: diagonais do hat, um botão num alvo de eixo e um eixo num alvo de botão são ignorados com um aviso.
  • O JoyPro não distribui nenhuma parte do BYOJoystick; a sua lista de comandos só existe com o mod instalado.
  • Testes: engine\tests\smoke\vtolvr.ps1 (ciclos de importação e exportação, valores próprios, configurações globais do jogo, exportação só de configurações).

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