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.dlldo mod instalado (Steam Workshop; no programa: "Instalar BYOJoystick" no cartão do VTOL VR), senão os seus própriosBYOJ_*.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
level0do 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.
#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 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)
- 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.
- 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.
- 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.


#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
- Feche o VTOL VR. O JoyPro recusa-se a escrever enquanto o jogo está a correr (processo
VTOLVR). - Abra Exportar e mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus dispositivos.
- Prima Exportar agora no cartão do VTOL VR (BYOJoystick) e, para os pedais, no cartão nativo.
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.
#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).
#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"]
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,ModifierKeycomo 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
RewiredSaveDatae 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,hardwareGuida zero para dispositivos que o Rewired não conhece. O elemento é o n-ésimo eixo do dispositivo. - Listas de comandos:
engine vtolvr refresh-dblê os alvos doBYOJoystick.dllinstalado sem o carregar nem executar (os seus metadados e literais de texto), depois os seus própriosBYOJ_*.xml; sem o mod não há lista.engine vtolvr-native refresh-dblê a lista de ações Rewired delevel0. - 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 comengine 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.