# Instalación y uso / Installation and use Candidato de publicación **1.1.0.0**. Windows 11, War Thunder PC y Stream Deck 7.1+. Stream Deck incluye Node 24; no necesitas npm, compilador, administrador ni un companion separado. Las comprobaciones y sus límites se adjuntan a la documentación de entrega del candidato. ## Funciones agrupadas / Grouped functions La lista contiene nueve acciones: Tierra, Aviación, Helicóptero, Naval, Radar/IRST, Motor/MEC, Comunes, Dial de eje relativo y Datos de vuelo. Añade la familia, busca una función y selecciónala en el inspector. El botón cambia de imagen; los 19 ejes se eligen dentro del dial. Cada opción conserva su atajo y ajustes propios, y los cambios se guardan automáticamente con lectura de confirmación. Si falla el guardado, recarga antes de continuar. Los UUID anteriores se mantienen para los perfiles existentes. Las 32 plantillas se importan voluntariamente; actualizar el plugin no las instala ni activa automáticamente. The action list offers seven keypad families, one relative-axis dial and the flight display. Choose a function in the inspector; the key image changes accordingly. Settings save automatically with confirmation and remain separate for each option. All 280 previous UUIDs remain registered for existing profiles. Virtual templates are optional imports and never install or switch automatically. ## Idioma / Language El idioma del inspector se detecta automáticamente desde Stream Deck. Puedes elegir English, Español, Deutsch, Français, 日本語, 한국어, 简体中文 o 繁體中文 y guardar esa preferencia por acción. Los perfiles virtuales se identifican por EN/ES/DE/FR/JA/KO/ZH_CN/ZH_TW; las carpetas y el retorno también están traducidos. La documentación de instalación y privacidad se incluye en español e inglés. The inspector automatically follows Stream Deck’s language. You can override and save a language for each action. Choose the four vehicle profiles with your language code. Interface language does not remap physical keys. AZERTY/QWERTZ labels are preserved separately from key positions. IME composition and unsupported JIS/Hangul-specific keys require a supported keyboard alternative; the plugin does not type text. ## Empezar en español 1. Abre el `.streamDeckPlugin` en Windows y pulsa **Instalar**. Añade una familia de controles a tu propio perfil y elige la función en el inspector. Si prefieres una plantilla, importa manualmente uno de los 32 perfiles incluidos para **Virtual Stream Deck 6×3**, por vehículo e idioma. No se instalan ni cambian tu perfil activo automáticamente. 2. Elige una acción. Las asignaciones comienzan vacías; las imágenes no contienen texto. El inspector muestra el control del juego y su referencia; el equipamiento del vehículo determina si existe. 3. Elige **General** o el perfil de asignaciones del vehículo. La asignación específica sustituye a General para ese control completo. Si la compartes, se aplica a todas sus copias con ese perfil. Desmarca compartir para una excepción de esta tecla; el perfil nativo de Stream Deck y el perfil de asignaciones son opciones distintas. 4. Pulsa **Grabar**, mantén juntas entre una y cuatro teclas de tu atajo actual y suéltalas todas para terminar. Admite `1+X`, Ctrl/Alt/Shift izquierdo o derecho, modificadores solos y Bloq Mayús. Conserva la posición física, sin convertirla según el idioma. Windows/Command, AltGr, ratón y HOTAS requieren otra asignación de teclado; no se emulan silenciosamente. 5. Pulsa **Guardar** y espera confirmación. Si otro editor cambió los ajustes, recarga y revisa el conflicto. Los borradores se conservan. El diagnóstico local muestra versiones, estado del motor nativo y recuentos sin incluir credenciales ni rutas del usuario. 6. Pon el juego en primer plano y comprueba primero el efecto en conducción/vuelo de prueba. El proceso inicial es `aces`; `.exe` se normaliza. La confirmación nativa de Stream Deck indica que la entrada fue aceptada; no demuestra posición de tren, bloqueo radar, disparo ni resultado de la acción. ### Uso del dispositivo virtual Abre la ventana flotante del Virtual Stream Deck desde su icono de ojo. Una pulsación con ratón puede quitar foco al juego. **Opciones de entrada → Restaurar foco desde la ventana virtual** permite volver al mismo juego que estuvo en primer plano recientemente, exclusivamente desde esa ventana flotante identificada. Está desactivado inicialmente y requiere guardar. La ventana principal/editor de Stream Deck y cualquier otro programa siguen rechazándose. Si cambia la implementación de la ventana en otra versión de Stream Deck, el plugin puede rechazar el control; comprueba diagnóstico y versión. Las carpetas nativas organizan Armamento, Radar, Motor/MEC, Vehículo, Comunes y, para aeronaves, Datos de vuelo. Los grupos extensos tienen subcarpetas numeradas y una tecla **Volver**. Los perfiles solo contienen ajustes del plugin sin atajos del juego. No sustituyen perfiles del usuario ni obligan a usar un dispositivo físico. War Thunder puede capturar el cursor durante el combate. La ventana flotante necesita recibir realmente el clic: una pulsación que se queda en el juego no activa el plugin. Para liberar el cursor en vuelo, asigna Mostrar el cursor del ratón a una tecla libre sin modificadores, por ejemplo F8. Mantener Alt/Ctrl/Mayús bloquea otros atajos por la protección de teclas ocupadas. La restauración opcional del foco sigue necesitando comprobarse cuando el host cambia realmente de ventana. ### Importar controles sin cambiarlos en el juego Pulsa **Importar tus controles** en el acceso directo superior del inspector. Elige el vehículo y pulsa **Buscar perfiles guardados del juego**. Se buscan los `machine.blk` conocidos en Documentos/OneDrive. `last/production` es la copia guardada más reciente: comprueba que corresponde a tus ajustes actuales. También puedes exportar los controles desde War Thunder y seleccionar el `.blk` de hasta 2 MiB. Revisa la vista previa y marca las filas que quieras importar. Si hay varias combinaciones, selecciona una. Por defecto solo se seleccionan huecos sin binding y se conserva lo guardado; **Sobrescribir asignaciones seleccionadas** debe marcarse expresamente para reemplazar. Los ejes guardan disminuir/aumentar/reiniciar en su control compartido, de modo que sirven al dial y a sus tres botones. El indicador de relativo solo se importa cuando el archivo declara ese ajuste. Un export puede contener solo cambios sobre un preset. **Incluir referencias del preset base detectado** permite resolver tres presets de teclado conocidos (`keyboard_ver1`, `keyboard_ver2` y `keyboard_shooter_ver2`) mediante un snapshot identificado para 2.59.0.44. Los cambios y controles borrados del archivo prevalecen. Las referencias empiezan desmarcadas: compruébalas en el juego o usa **Seleccionar filas compatibles sin asignar** después de revisarlas. No sustituyen lo guardado sin marcar reemplazo. Los presets desconocidos siguen sin resolver; graba sus atajos manualmente. No se extraen paquetes del juego. Las combinaciones con ratón/HOTAS se identifican como externas; el fragmento de teclado de una combinación mixta no se importa como si fuese un atajo completo. Nunca se escribe sobre `.blk`. **Copia portable y diagnóstico → Exportar asignaciones JSON** guarda una copia nueva en Descargas de Windows y confirma el nombre después de leerla de vuelta. No sobrescribe copias anteriores. El JSON contiene las asignaciones compartidas General y por vehículo. En otro equipo puedes previsualizarlo e importar el perfil seleccionado con el mismo control de conflictos. Las excepciones por instancia viajan mediante la exportación nativa del perfil/acción de Stream Deck; no están en el JSON compartido. La importación de bindings no modifica preferencias del proceso o de foco virtual. ### Pulsaciones mantenidas Solo las acciones compatibles muestran **Mantener mientras pulsas**. La combinación se pulsa una vez y se libera al soltar. No se repite periódicamente. El límite admite 500–30.000 ms y empieza en 10.000 ms. También se libera al desaparecer la acción, cambiar ajustes/foco, desconectar el dispositivo/transporte, perder la concesión del worker o cerrarse el padre. Si se mata el worker, el plugin intenta reiniciarlo automáticamente con hasta tres intentos. El siguiente worker recupera solo key-up pendientes; nunca repite key-down. En la prueba histórica de 0.2.1 en ORDENATA se midieron 703 ms desde la terminación del worker hasta la liberación observada de F5. No es una garantía absoluta frente a fallos del sistema. En la prueba histórica de 0.2.1 con Stream Deck 7.6 se observaron mouse-down/mouse-up sobre el panel virtual real: F5 permaneció pulsada unos ocho segundos y se liberó al soltar. Las versiones y hosts distintos requieren su propia comprobación. No uses una secuencia automática para sustituir un control incompatible. La radio ofrece menú, ocho opciones manuales y los dos favoritos reales del juego: cada opción sigue siendo una pulsación manual. ### Ejes: botones y diales Los 19 ejes tienen disminuir/aumentar/reinicio por botón además del dial. Para cambios relativos activa **Control relativo** en el eje del juego, asigna disminuir y aumentar, y confirma la casilla del inspector. Reiniciar usa la asignación del eje si existe. No se infieren los metros, porcentaje o grados: cada incremento depende del juego. Los botones y diales compartidos usan el mismo control; una excepción local del botón tiene su propio atajo. Los diales admiten hasta tres detents en un evento, sin aceleración. Una entrada concurrente, caducada o demasiado rápida se rechaza; un evento parcialmente ejecutado no se completa después. Los botones equivalentes permiten usar los ejes en Virtual Stream Deck. Este encargo no verifica diales físicos. MEC se configura desde Control total → Controles manuales del motor. Radiadores, paso, mezcla, turbo y selección de motores dependen del avión; vuelve después a tu esquema habitual. Los controles de pistón no se aplican automáticamente a reactores. El radar requiere un sensor y ajustes de eje apropiados para su tipo de vehículo; las etiquetas no establecen su estado real. ### Datos de vuelo opcionales Activa el visor y elige IAS, TAS, altitud, G, Mach, ascenso, AoA, combustible, RPM, temperatura de aceite/motor, acelerador, tren, flaps o aerofreno. Para los campos de motor, elige 1–8; si ese motor/campo no se informa se muestra **Sin datos**, nunca otro motor como sustituto. Tren, flaps y aerofreno pueden mostrar sus porcentajes recibidos en acciones compatibles si activas **Mostrar estado recibido** y su lectura local. Solo se consultan `/state` y `/indicators` en `127.0.0.1:8111`. Fallo, identidad incompatible, datos inválidos o recepción antigua retiran los valores. La edad mostrada es desde la recepción HTTP; no prueba que una muestra idéntica haya cambiado en origen ni que exista batalla activa. No se leen objetivos, enemigos, mapa o munición. La disponibilidad por vehículo y modo requiere evidencia específica. ### Diagnóstico Un triángulo significa rechazo; con el inspector abierto aparece el motivo. Comprueba binding, perfil, proceso/foco, teclas ya mantenidas y requisitos del eje. **ENVIADO** no confirma el efecto. El diagnóstico copia versiones, tipo de dispositivo, estado/PID/recuperaciones del worker, revisión, recuentos, estado de datos y hasta 32 eventos de entrada de los últimos 120 segundos. Los eventos omiten atajos, títulos de ventanas y rutas del usuario. Adjunta el contexto de vehículo/modo y resultado observado, sin archivos de controles completos o credenciales. **Vuelo estacionario** cambia el modo del helicóptero; **Altura de hover** ajusta su eje. En naval, **Seleccionar armamento principal/secundario/antiaéreo** selecciona un grupo y no admite mantener; **Disparar armamento naval seleccionado** usa el control de disparo y sí admite mantener. ## English quick start Install the local package on Windows. Add a control family to your own profile and choose its function in the inspector. Optionally import a Ground/Aircraft/Helicopters/Naval **Virtual 6×3** template manually in your language; templates never install or switch automatically. Record your existing physical keyboard chord, select the shared role or a local instance override, save and test with the game in the foreground. Read-only `.blk`/JSON import previews selected bindings and fills unassigned slots by default; replacement is explicit. Unresolved inherited presets and Mouse/HOTAS combinations require a keyboard alternative. Supported holds press once and release on keyUp, focus/page/device/transport changes or the bounded deadline. Relative-axis buttons/dials require in-game Relative control and confirmation. Optional virtual focus restoration is restricted to the identified floating virtual window; other applications remain guarded. Flight data starts disabled and displays only reported fields for the selected engine. Shared JSON backup and native per-instance profile export serve different scopes. Keypad and Encoder actions are implemented; included profiles target Virtual Stream Deck only. Mini/MK.2/XL/Neo/Mobile/+ and other SDK devices are possible layouts, not physical QA results. No combat sequences, automatic targeting or telemetry-driven input. No physical HID presses or dials were observed in this revision. Version 1.1 was installed and checked in the native Stream Deck 7.6 editor on Windows 11; a camera effect was observed in a real test flight using an SDK test host. These observations do not validate every game function. The 1.0.0 ORDENATA exclusion is historical and was superseded by the owner’s authorization for this revision.