# Instalar y volar con RogerATC

Todo lo que necesitás para pasar de la descarga a tu primera llamada: la cuenta gratuita de Copilot EFB, el instalador para macOS o Windows, RogerATC Setup, la tecla de transmisión en X-Plane y qué decirle al controlador y al instructor, con ejemplos en español y en inglés.

https://rogeratc.app/docs/rogeratc/

## Qué es RogerATC y qué necesitás

RogerATC reemplaza el ATC de X-Plane 12 por un controlador de tránsito aéreo con IA al que le hablás por voz. Mantenés pulsada una tecla de transmisión, hablás como lo harías en una frecuencia real, sueltas, y el controlador te contesta por COM1 o COM2, en **español o en inglés**. Una segunda voz, el **instructor virtual**, va en el intercomunicador de cabina y responde preguntas sobre tu vuelo.

La IA solo interpreta *lo que pediste*. Lo que dice el controlador lo decide un motor de reglas y se redacta con plantillas de fraseología escritas por personas, con sus fuentes. Pistas, calles de rodaje, frecuencias, fijos y procedimientos salen de **tu propia instalación de X-Plane**, incluidos los escenarios agregados: si algo no está en tus datos, el controlador nunca lo dice.

### Qué necesitás

- **X-Plane 12.4 o posterior.**
- **macOS 11 o posterior** (Apple Silicon o Intel) o **Windows 10/11 de 64 bits**. El soporte para Windows es nuevo en esta beta.
- Una **cuenta gratuita de Copilot EFB**. RogerATC la usa para verificar tu cuenta y obtener tus claves.
- Una **clave de API de OpenAI** con saldo, cargada en Copilot EFB. Le pagás directamente a OpenAI lo que uses.
- Conexión a internet y unos **auriculares con micrófono** (muy recomendables: un micrófono integrado capta el sonido del propio simulador).

> RogerATC y Copilot EFB son **gratuitos durante la beta**. Esta es la versión **1.28 beta**: es normal encontrar detalles por pulir; revisá el registro de cambios en rogeratc.app para ver qué cambió.

## Antes de instalar: tu cuenta de Copilot EFB y tus claves

RogerATC no tiene un inicio de sesión propio. Tu cuenta de Copilot EFB es tu cuenta de RogerATC, y es donde se guardan todas las claves de proveedores. Hacé estas tres cosas primero: llevan cinco minutos.

### 1. Creá tu cuenta de Copilot EFB

Abrí [copilot.rogeratc.app/sign-up](https://copilot.rogeratc.app/sign-up), ingresá tu nombre, tu correo y una contraseña, y confirmá el código de seis dígitos que llega a tu correo. La cuenta es gratuita durante la beta, y el EFB es un maletín de vuelo completo que también podés usar por sí solo.

### 2. Copiá tu clave de API de Copilot EFB

En Copilot EFB, abrí **Ajustes → Acceso a la API**. Cada cuenta tiene una clave personal que empieza con `rat_live_`. Usá el botón de copiar. Es la **única** clave que vas a pegar en RogerATC.

### 3. Cargá tu clave de OpenAI en Copilot EFB

En Copilot EFB, abrí **Ajustes → Claves que usa RogerATC** y pegá tu clave de OpenAI. RogerATC la usa para el reconocimiento de voz, la voz del controlador y el modelo de lenguaje. El plugin obtiene tus claves desde tu cuenta cada vez que arranca, así que nunca escribís una clave de proveedor en RogerATC.

Las demás claves de esa sección son opcionales. Sin ellas, la función simplemente no está:

| Clave | ¿Obligatoria? | Qué te da |
|---|---|---|
| OpenAI | Sí | Reconocimiento de voz, las voces y el modelo de lenguaje que entiende lo que dijiste. |
| openAIP | No | Espacio aéreo actualizado para el instructor, en lugar del que vino con X-Plane. |
| Windy | No | Un segundo pronóstico de viento en altura para el instructor, solo si no tiene ni el del simulador ni el del modelo GFS de NOAA, que es gratis y sin clave. |
| Flightradar24 | No | El movimiento en tu frecuencia sigue al tránsito real a tu alrededor. Solo se consulta una cantidad. Sin ella, el tránsito real gratuito hace lo mismo. |
| Tavily | No | Búsqueda web para el instructor, limitada a fuentes aeronáuticas como ANAC, FAA, OACI, EASA y SKYbrary. |
| Otros proveedores de IA | No | Solo si elegís otro proveedor y modelo como modelo de lenguaje. Son las mismas claves que usa el asistente del EFB. Sin la clave, RogerATC vuelve al proveedor predeterminado. |

> Cuando el propio Copilot EFB usa la misma clave (por ejemplo openAIP para su mapa), Ajustes la marca como **usada por Copilot EFB y RogerATC**. La cambiás en un solo lugar y las dos aplicaciones usan la nueva; RogerATC la toma la próxima vez que arranca.

## Instalar en macOS

- Descargá `RogerATC-1.28-beta-macOS.dmg` desde rogeratc.app y abrilo.
- Arrastrá **RogerATC Setup** a la carpeta **Aplicaciones** en la misma ventana.
- Abrí **RogerATC Setup** desde Aplicaciones.

### La primera vez: "Abrir igualmente"

Esta beta **no está notarizada por Apple**, así que la primera vez macOS se niega a abrirla y dice que no puede comprobar si contiene software malicioso. Para permitirla:

- Cerrá el mensaje.
- Abrí **Ajustes del Sistema → Privacidad y seguridad** y bajá hasta la sección Seguridad.
- Junto a la línea sobre RogerATC Setup, hacé clic en **Abrir igualmente** y confirmá con tu contraseña o Touch ID.

### El micrófono

La primera vez que pulses la tecla de transmisión en X-Plane, macOS pide permiso para usar el micrófono. **Permitilo.** Si elegiste No permitir, abrí **Ajustes del Sistema → Privacidad y seguridad → Micrófono**, activá X-Plane (o RogerCore, si aparece) y reiniciá X-Plane.

## Instalar en Windows

El soporte para Windows es nuevo en esta beta. El instalador trabaja solo para tu usuario y no pide permisos de administrador.

- Descargá `RogerATC-1.28-beta-Windows-Setup.exe` desde rogeratc.app y ejecutalo.
- En esta beta el instalador **no tiene firma de código**, así que Windows SmartScreen muestra *"Windows protegió tu PC"*. Hacé clic en **Más información** y después en **Ejecutar de todas formas**.
- Aceptá la licencia, dejá la carpeta sugerida y hacé clic en Instalar. Al final, dejá marcada la opción de **ejecutar RogerATC Setup**.

### El micrófono

Abrí **Configuración → Privacidad y seguridad → Micrófono** y comprobá que estén activados **Acceso al micrófono** y **Permitir que las aplicaciones de escritorio accedan al micrófono**. Si Windows pregunta la primera vez que pulsás la tecla de transmisión, permitilo.

## RogerATC Setup, paso a paso

RogerATC Setup vincula tu cuenta, instala el plugin en X-Plane y guarda todos los ajustes, en español o en inglés. Desde el simulador, lo abrís con **Plugins › Roger ATC AI › Open RogerATC Setup…**

### Vinculá tu cuenta

Pegá tu clave de Copilot EFB (`rat_live_…`) y vinculala. Setup la verifica, muestra el nombre de la cuenta y lista qué claves de proveedores tiene tu cuenta: solo los nombres, nunca los valores. Si falta OpenAI, cargala en Copilot EFB antes de volar. La clave se guarda en el llavero de macOS o en el Administrador de credenciales de Windows, nunca en un archivo de texto.

### Instalá el plugin en X-Plane

Setup encuentra tus instalaciones de X-Plane 12 y muestra si RogerATC está instalado en cada una. Elegí la tuya y hacé clic en **Instalar**; en el mismo lugar están **Actualizar**, **Reparar** y **Desinstalar**. **Cerrá X-Plane antes**: Setup no toca el plugin mientras está abierto. Después, **Iniciar X-Plane** abre el simulador.

El plugin va a su propia carpeta; no se modifica nada más de X-Plane:

```
X-Plane 12/Resources/plugins/RogerATC
```

### Ajustes

Todos los ajustes se eligen en Setup. La mayoría también se puede cambiar en pleno vuelo desde **Plugins › Roger ATC AI › Settings**, y se aplica desde la transmisión siguiente.

| Ajuste | Qué hace | Por defecto |
|---|---|---|
| Idioma | Español o inglés: la fraseología, la voz y lo que espera oír el reconocimiento. | Inglés |
| Región | La fraseología de qué país escuchás. *Automática* sigue al aeródromo, así que cruzar una frontera cambia la fraseología. También podés fijar OACI genérica o una de doce regiones. | Automática |
| Voces | Las voces sintéticas de la torre y del instructor, distintas a propósito. Rodaje, aproximación y control toman cada una otra voz propia. | marin · cedar |
| Velocidad de habla | Qué tan rápido habla el controlador, de 1,0× a 1,6×. | 1.15× |
| Efecto de radio | Ancho de banda, ruido y el clic de una radio VHF. | Activado |
| Meteorología del ATIS | La meteorología del simulador, o el METAR real si volás con meteorología real. | Simulador |
| Modelo de lenguaje | El proveedor y el modelo de IA que elijas, con tu propia clave, o un modelo local que corre en tu computadora. El reconocimiento y las voces siguen usando OpenAI. | OpenAI |
| Modelo del controlador y del instructor | El modelo que entiende la radio y el que responde como instructor, de ese mismo proveedor. Automático usa el que medimos más rápido; podés elegir otro de la lista o escribir su nombre. | Automático |
| Instructor | *Desactivado*, *Silencioso* (solo responde cuando lo llamás, nunca habla por su cuenta), *Activado* (además te avisa al instante lo importante: configuración en la carrera de despegue, límites, combustible) o *Proactivo* (además las precauciones y los avisos). | Activado |
| Tu nombre | Cómo te llama el instructor. Vacío usa el primer nombre de tu cuenta de Copilot EFB; cambiarlo aquí no cambia la cuenta. | El de tu cuenta |
| El instructor comunica por radio | Pedile al instructor por el intercomunicador que llame a la torre o a superficie por vos, y transmite; escuchás las dos partes. | Activado |
| El instructor me lee los mensajes del EFB | Cuando tenés mensajes sin leer en Copilot EFB, el instructor te avisa y te los lee de a uno por el intercomunicador — nunca encima de la radio, nunca en el despegue ni en el aterrizaje. Decí *"después"* para dejarlos para más tarde o *"siguiente"* para pasar al próximo. También en la pestaña **Instructor** de la ventana del plugin. | Activado |
| Indicativo | Cómo te llaman por radio cuando no es la matrícula de la aeronave: `ARG1234` para un vuelo de aerolínea, *Cóndor 21* para uno militar. | La matrícula |
| Tipo de vuelo | Aviación general, aerolínea o militar: cómo te trata el controlador — la denominación de la aerolínea y el pase de frecuencia tras el despegue, y, en inglés, HEAVY y la entrada militar por encima del aeródromo. *Automático* lo decide por tu indicativo y la aeronave. También en la ventana del plugin. | Automático |
| Tránsito en frecuencia | Otras aeronaves en la frecuencia: desactivado, poco, normal o mucho. | Poco |
| Tránsito real | Aviones reales a tu alrededor, desde adsb.lol (gratis, sin clave): indicativos reales en la frecuencia y el cielo real para el instructor. | Activado |
| Meteorología en red | Trae METAR y TAF reales de NOAA (sin clave) cuando el simulador no los tiene. | Activado |
| Tono de espera | Un tono corto mientras se prepara la respuesta: un pitido para el controlador, un doble tono para el instructor. | Activado |
| Fuente de datos | *Ambos* (lo predeterminado): X-Plane más tu plan de vuelo presentado, el perfil de la aeronave —el briefing de despegue necesita sus velocidades— y las frecuencias que faltan, desde Copilot EFB. *Simulador*: solo X-Plane. *EFB*: además tus fichas de aeródromo mandan en las frecuencias. | Ambos |
| Sincronización con el EFB | *Estadísticas* (siempre activado) o *Completo*, que agrega una transcripción recortada. | Estadísticas |
| Enlace en vivo con el EFB | Comparte la posición y el estado de la cabina de tu aeronave con tu propio EFB, para que vos o un instructor sigan el vuelo. | Desactivado |
| Depuración visual | Una ventana que dice qué está haciendo RogerATC en este momento. | Desactivado |

Setup también muestra un aviso cuando se publica un RogerATC más nuevo, y **Abrir la carpeta de registros** abre la carpeta con los registros y las sesiones.

## Tu primer vuelo

### Asigná las teclas

En X-Plane, abrí **Settings → Keyboard** (o **Joystick** para un botón del yugo), buscá `Roger ATC` y asigná:

| Comando | Qué hace |
|---|---|
| Roger ATC: push-to-talk on COM1 | Hablás con el controlador por COM1. La que necesitás. |
| Roger ATC: push-to-talk on COM2 | Hablás con el controlador por COM2. |
| Roger ATC: talk to the virtual instructor (intercom) | Hablás con el instructor por el intercomunicador de cabina, no por radio. |

**Mantené pulsada** la tecla mientras hablás y soltala al terminar: soltar es lo que termina la transmisión, así que una pausa en el medio nunca te corta. Un toque muy corto se ignora como pulsación accidental.

### Empezá un vuelo

- Cargá un vuelo en la plataforma de un aeródromo con frecuencia de torre o de rodaje, con motores apagados.
- Mirá **Plugins › Roger ATC AI › About** o **Diagnostics**: muestran que RogerATC está funcionando, qué aeródromo encontró y qué pista está en uso.
- Sintonizá en COM1 la frecuencia de rodaje (o la de torre, si no hay rodaje): la frecuencia decide quién contesta. Cualquier aeródromo controlado a sesenta millas (diez en tierra) contesta en su frecuencia.
- Mantené pulsada la tecla y hacé tu primera llamada: la estación y después tu indicativo. Soltá y esperá la respuesta.

> El controlador empieza a hablar en cuanto tiene lista su primera frase, cada estación con su propia voz. Mientras se prepara la respuesta escuchás el tono de espera; si no escuchás nada, mirá **Solución de problemas**.

## Hablar con el controlador

Habla como un piloto: estación, indicativo, posición y pedido en una sola llamada. La fraseología estándar es lo que mejor funciona, pero no hace falta que sea perfecta. El español es fraseología nativa, no inglés traducido.

> Los intercambios de abajo son ilustrativos. La redacción exacta depende de tu aeródromo, de tu región y de la situación: el controlador recuerda lo que ya te dijo y no lo repite.

### Contacto, puesta en marcha y rodaje

Una estación que todavía no habló con vos se presenta y saluda según la hora local del aeródromo. La ruta de rodaje se calcula sobre las calles reales del aeropuerto donde estás, según tu propio escenario.

*En inglés*

```
PILOT  Ezeiza Ground, LV-GKM, on the apron, information Delta, request start-up.
ATC    LV-GKM, Ezeiza Ground, good morning. Start-up approved, QNH 1013, squawk 4321.
PILOT  Start-up approved, QNH 1013, squawk 4321, LV-GKM.
ATC    LV-GKM, readback correct.
PILOT  LV-GKM, request taxi.
ATC    LV-GKM, taxi to holding point runway 11 via Juliett, Echo, Alfa,
       hold short of runway 17.
PILOT  Taxi to holding point runway 11 via Juliett, Echo, Alfa,
       hold short of runway 17, LV-GKM.
```

*En español*

```
PILOTO  Ezeiza Rodaje, LV-GKM, en plataforma, información Delta, solicito puesta en marcha.
ATC     LV-GKM, Ezeiza Rodaje, buen día. Puesta en marcha aprobada, QNH 1013,
        transpondedor 4321.
PILOTO  Puesta en marcha aprobada, QNH 1013, transpondedor 4321, LV-GKM.
ATC     LV-GKM, correcto.
PILOTO  LV-GKM, solicito rodaje.
ATC     LV-GKM, Ezeiza Rodaje, ruede a punto de espera de pista 11 vía calle de rodaje
        Juliett, Echo, Alfa. Mantenga antes de pista.
PILOTO  Ruedo a punto de espera de pista 11 vía Juliett, Echo, Alfa, LV-GKM.
```

### Despegue, circuito y aterrizaje

*En inglés*

```
PILOT  Ezeiza Tower, LV-GKM, holding point runway 11, ready for departure.
ATC    LV-GKM, Ezeiza Tower, runway 11, cleared for take-off, wind 270 degrees 8 knots.
PILOT  Runway 11, cleared for take-off, LV-GKM.
       ...
ATC    LV-GKM, number one, report final.
PILOT  LV-GKM, final runway 11.
ATC    LV-GKM, wind 270 degrees 8 knots, runway 11, cleared to land.
       ...
ATC    LV-GKM, vacate the runway, contact ground 121.9.
```

*En español*

```
PILOTO  Ezeiza Torre, LV-GKM, punto de espera pista 11, listo a la salida.
ATC     LV-GKM, Ezeiza Torre, pista 11, autorizado a despegar,
        viento 270 grados 8 nudos.
PILOTO  Pista 11, autorizado a despegar, LV-GKM.
        ...
ATC     LV-GKM, número uno, notifique en final.
PILOTO  LV-GKM, en final pista 11.
ATC     LV-GKM, viento 270 grados 8 nudos. Pista 11, autorizado a aterrizar.
        ...
ATC     LV-GKM, libere pista, pase con rodaje 121.9.
```

El circuito se entiende como lo dice un piloto —inicial, a favor del viento, básica, final— y se contrasta con dónde estás de verdad. Si notificás un tramo que los datos desmienten, escuchás *"negativo"* y dónde estás realmente.

### Pedidos: ATIS, QNH, frecuencias y más

*En inglés*

```
LV-GKM, request ATIS.
LV-GKM, request QNH.
LV-GKM, request the tower frequency for Rosario.
LV-GKM, request the METAR for Rosario.
LV-GKM, request the VOR frequency.
LV-GKM, request touch and go.
LV-GKM, request to cross runway 17.
```

*En español*

```
LV-GKM, solicito ATIS.
LV-GKM, solicito QNH.
LV-GKM, ¿cuál es la frecuencia de torre de Rosario?
LV-GKM, solicito el METAR de Rosario.
LV-GKM, solicito la frecuencia del VOR.
LV-GKM, ¿me autoriza un toque y motor?
LV-GKM, solicito cruzar pista 17.
```

Las respuestas salen de tus propios datos, para cualquier aeródromo; una frecuencia que tu escenario no publica sale de tu EFB o de la referencia mundial, y la pedís por nombre, código, código deletreado o código IATA — también el ILS o el VOR de un aeródromo. Si algo no está en ningún lado, el controlador lo dice en lugar de adivinar. Si no notificaste el ATIS, te dan la información vigente y el QNH al rodar o al llamar para el arribo. También se entienden el remolque, el deshielo, los tránsitos por la zona, el VFR especial, los planes de vuelo presentados o cerrados por radio y las notificaciones de posición y de nivel.

### Colaciones y "repita"

Colacioná cada autorización. Una colación correcta se confirma con *"correcto"* (*"readback correct"* en inglés); una equivocada se corrige con el valor correcto. Si no entendiste algo, pedí que lo repitan: la repetición viene marcada para que sepas que no cambió nada.

*En inglés*

```
PILOT  Taxi to holding point runway 29, LV-GKM.
ATC    LV-GKM, negative I say again, runway 11.

PILOT  Say again.
ATC    LV-GKM, I say again. Taxi to holding point runway 11 via Juliett, Echo, Alfa.
```

*En español*

```
PILOTO  Ruedo a punto de espera de pista 29, LV-GKM.
ATC     LV-GKM, negativo repito, pista 11.

PILOTO  Repita.
ATC     LV-GKM, repito. Ruede a punto de espera de pista 11 vía Juliett, Echo, Alfa.
```

### Tránsito, cruces e idas al aire

Cuando hay alguien en final, tu pedido para ingresar a la pista puede quedar en espera y liberarse cuando el tránsito se fue. La torre también puede ordenarte una ida al aire, y vos podés notificar una.

*En inglés*

```
ATC    LV-GKM, hold short runway 11, traffic on final, I will call you.
       ...
ATC    LV-GKM, cross runway 17, report runway vacated.
ATC    LV-GKM, go around, I say again, go around, runway occupied.
       Climb to 1500 feet, report downwind.
```

*En español*

```
ATC     LV-GKM, mantenga fuera de pista 11, tránsito en final, lo llamo apenas quede libre.
        ...
ATC     LV-GKM, cruce pista 17, notifique pista libre.
ATC     LV-GKM, ida al aire, ida al aire, pista ocupada.
        Ascienda a 1500 pies, notifique tramo a favor del viento.
```

### Emergencias

MAYDAY y PAN PAN siempre se reconocen y se responden, nunca con "repita". PAN PAN no se trata como un MAYDAY, y combustible mínimo recibe *"no se prevé demora"*, no prioridad, como dicen las normas.

*En inglés*

```
PILOT  MAYDAY MAYDAY MAYDAY, Ezeiza Tower, LV-GKM, engine failure,
       four miles south, 2000 feet, returning to the field.
ATC    LV-GKM, Ezeiza Tower, roger. Emergency services alerted. Runway 11 available,
       wind 270 degrees 8 knots. Report your intentions and souls on board.

PILOT  PAN PAN PAN PAN PAN PAN, Ezeiza Tower, LV-GKM, passenger unwell, request priority.
PILOT  LV-GKM, minimum fuel.
```

*En español*

```
PILOTO  MAYDAY MAYDAY MAYDAY, Ezeiza Torre, LV-GKM, falla de motor,
        cuatro millas al sur, 2000 pies, regreso al aeródromo.
ATC     LV-GKM, Ezeiza Torre, recibido. Servicios de emergencia alertados. Pista 11 a su
        disposición, viento 270 grados 8 nudos. Notifique intenciones y personas a bordo.

PILOTO  PAN PAN PAN PAN PAN PAN, Ezeiza Torre, LV-GKM, pasajero indispuesto, solicito prioridad.
PILOTO  LV-GKM, combustible mínimo.
```

### Para que te entienda

- **Usá auriculares.** Un micrófono integrado escucha el motor.
- **Decí tu indicativo** en cada transmisión; puede ir al principio o al final.
- **Decí los designadores, no los deletrees:** "vía Kilo Dos", no "vía K2". El controlador siempre contesta con el alfabeto OACI —Alfa, Juliett, Xray— y también entiende "Alpha" y "Juliet".
- **La frecuencia es símplex:** si transmitís mientras habla el controlador, lo cortas, como en una radio real.

> Por voz, las estaciones que hoy te contestan son **Torre y Rodaje**. Aproximación y centro todavía no son estaciones a las que puedas llamar; las instrucciones IFR te llegan en cambio por el enlace en vivo con el EFB (mirá **Práctica IFR** más abajo). En un aeródromo sin torre en tu escenario nadie contesta, como en un aeródromo no controlado real.

## Lo que el controlador hace por su cuenta

Una torre real no espera a que le pregunten, y esta tampoco. Calcula dónde estás según tu posición y tu rumbo respecto de la pista en uso, y habla cuando lo haría un controlador:

- Al entrar en el tramo a favor del viento: tu número en la secuencia y *"notifique en final"*; en final sin autorización, la autorización para aterrizar.
- Al entrar a una pista sin autorización de despegue: *"mantenga posición"*. Pista liberada: te pasa con Rodaje.
- Otra aeronave que se acerca, un cambio de pista en uso por el viento, un QNH nuevo: te lo avisan sin que preguntes.
- Un código de transpondedor con tu autorización, y un aviso si el código está mal, si queda en standby en la pista o si pulsás IDENT.
- A un vuelo de aerolínea se lo pasa a la dependencia siguiente después del despegue, con la frecuencia que tienen tus propios datos — o no se lo pasa si no hay ninguna.

### Otras aeronaves en la frecuencia

Con **Tránsito en frecuencia** activado, escuchás a otros pilotos pedir puesta en marcha y rodaje, notificar a favor del viento y recibir autorización para aterrizar, con sus propias voces. Nunca te pisan y nada de lo que te dicen *a vos* se refiere a ellos: tu secuencia se cuenta solo con las aeronaves que tu simulador muestra.

### Tránsito real

Con **Tránsito real** activado, que es lo predeterminado, RogerATC le pregunta a adsb.lol —una red comunitaria de receptores ADS-B, gratuita y sin clave— qué aviones vuelan de verdad cerca de vos. Los datos se publican bajo la licencia Open Database License: *adsb.lol (ODbL)*.

- **Indicativos reales en la frecuencia.** El tránsito que escuchás usa los indicativos de aviones que de verdad están en tierra o en el circuito de tu aeródromo, cuando los hay.
- **Movimiento real.** Lo cargada que suena la frecuencia sigue la cantidad real, salvo que una clave de Flightradar24 en tu Copilot EFB ya la fije.
- **El cielo real, por el instructor.** Preguntale qué vuela a tu alrededor y te lo dice, siempre como aviones del mundo real, nunca como tránsito de tu simulador.
- **Solo se nombra lo que podés ver.** El controlador dice el tipo de un avión solo cuando tu simulador también lo muestra; por ejemplo, con un inyector de tránsito real como LiveTraffic. El tránsito que tu simulador no muestra nunca se te da como tránsito.

Desactivado, o sin internet, todo funciona exactamente como antes.

## El instructor virtual

Mantené pulsada la tecla del intercomunicador y habla con normalidad. El instructor responde en tu idioma, cerca y limpio, sin efecto de radio, con su propia voz. Sabe dónde estás, la meteorología, las frecuencias, el espacio aéreo y el estado de tu aeronave.

*Cosas para preguntar, en inglés*

```
What's the crosswind on runway 11 right now?
How far am I from Ezeiza, and which runway is in use?
What is my pivotal altitude at this ground speed?
Give me the frequency of the San Fernando VOR.
How far out should I start down, and at what rate?
Let's do a steep turn to the left.
Remember that in this aeroplane we take the first stage of flap at 85 knots.
What's flying around us right now?
Tell the tower we're ready.
```

*Cosas para preguntar, en español*

```
¿Cuál es el viento cruzado en la pista 11 ahora?
¿A cuánto estoy de Ezeiza y qué pista está en uso?
¿Cuál es mi altura pivotal a esta velocidad respecto al suelo?
Dame la frecuencia del VOR de San Fernando.
¿A qué distancia empiezo el descenso y con qué régimen?
Hagamos un viraje escarpado a la izquierda.
Acuérdate de que en este avión sacamos el primer flap a 85 nudos.
¿Qué está volando cerca de nosotros ahora?
Avísale a la torre que estamos listos.
```

- **Cada número se calcula, nunca se recuerda.** Viento cruzado, distancias, altura pivotal, el radial en el que estás, dónde empezar el descenso: todo calculado a partir del simulador y de tus datos. Cuando no hay forma de calcular algo, te lo dice.
- **Viento en altura del cielo en el que volás.** El viento a tu altitud y por encima sale del propio simulador —el viento en el que de verdad vuela tu avión— antes que de cualquier pronóstico.
- **Normativa con fuente.** Con una clave de Tavily busca en una lista cerrada de fuentes aeronáuticas y te dice de dónde salió la respuesta; contrastala con la edición vigente antes de basarte en ella.
- **Ejercicios.** Virajes escarpados, un 360 nivelado, vuelo lento, vuelo recto y nivelado, virajes alrededor de un punto, un viraje de reversión y una espera. Empezá uno por voz o desde **Plugins › Roger ATC AI › Instructor**: te lo explica, te corrige mientras lo volás y al final te da un puntaje.
- **Su memoria es tuya.** Pedile que recuerde algo y lo anota, una nota por línea, en `Documents/RogerATC/instructor-memory.txt`, un archivo de texto que podés editar a mano.

### Briefing de despegue y debriefing

Pedí *"dame el briefing de despegue"* (o *"…IFR"*) y el copiloto te lo da en orden: rodaje a la pista en uso, la torre, la carrera con motor en parámetros y velocímetro vivo, la rotación y las velocidades de ascenso, flaps arriba, el viraje de salida y las emergencias — abortar en la carrera, aterrizar adelante con pista remanente, no más de 45° sin ella y el regreso a pista sólo por encima de tu altura mínima. Cada dato sale del simulador, de tu plan de vuelo y de tu aeronave en Copilot EFB; lo que no está cargado te lo dice como faltante, nunca lo inventa.

- **Decí vos el briefing** y el copiloto lo revisa punto por punto: qué está bien, qué está mal con el valor correcto y de dónde sale, y qué te faltó.
- **Debriefing.** Al rodar a plataforma después de aterrizar te lo ofrece una vez; también lo podés pedir (*"debriefing"*, *"¿cómo volé?"*). Primero lo de seguridad, después precaución, técnica y lo que salió bien, cada punto con su número. Queda guardado con la sesión en Copilot EFB. Si estudiás en la educación teórica del EFB, termina con hasta dos lecciones que explican lo que conviene trabajar, y sólo nombra lecciones que existen en tu curso.
- **Avisos a tiempo.** Freno de estacionamiento o flaps en la carrera, transponder apagado, la frecuencia equivocada, tren abajo a 1.000 ft, desvíos de nivel o de rumbo: el aviso pasa delante de lo que espera, pero nunca por encima del controlador ni de vos.
- Cargá en tu aeronave de Copilot EFB V1 (multimotores), la altura de retracción de flaps y tu altura mínima para el regreso a pista; sin esta última se usa 800 ft sobre la pista, y el briefing lo dice.

### Comunica por radio por vos

Pedile al instructor por el intercomunicador, con tus palabras, que hable con la torre o con superficie —*"avisale que estamos listos"*, *"pedí para ir a San Fernando"*, *"decile que queremos subir a tres mil"*— y entiende lo que querés y hace el llamado por radio, con su propia voz, con la fraseología correcta y los datos que el controlador necesita: el tipo de avión en el primer contacto, la letra del ATIS, tu distancia y dirección al aeródromo, tu altitud, tu destino. Después sigue en la frecuencia: colaciona, repite si se lo piden, notifica la posición, dice *"cumpliré"* y te pasa las preguntas que solo vos podés contestar —*"La torre pregunta… ¿qué le contesto?"*. Si transmitís vos por COM1, o decís *"yo sigo"*, te devuelve la radio.

*En inglés*

```
PILOT       [intercom] Tell ground we're off to San Fernando.
INSTRUCTOR  [radio] Morón Ground, Lima Victor Alfa Bravo Charlie, Cessna 172,
            on the apron, information Bravo, request taxi,
            destination San Fernando.
ATC         Lima Victor Alfa Bravo Charlie, taxi to holding point runway zero two
            via Alfa.
INSTRUCTOR  [radio] Taxi to holding point runway zero two via Alfa,
            Lima Victor Alfa Bravo Charlie.
```

*En español*

```
PILOTO      [intercomunicador] Avísale a superficie que salimos para San Fernando.
INSTRUCTOR  [radio] Morón Superficie, Lima Victor Alfa Bravo Charlie, Cessna 172,
            en plataforma, con información Bravo, solicito rodaje,
            con destino San Fernando.
ATC         Lima Victor Alfa Bravo Charlie, ruede a punto de espera de pista cero dos
            por Alfa.
INSTRUCTOR  [radio] Rodamos a punto de espera de pista cero dos vía Alfa,
            Lima Victor Alfa Bravo Charlie.
```

- **Veintiún llamados:** prueba de radio, puesta en marcha, rodaje, listo para salir, autorización a un destino, ingreso, tramo a favor del viento, final, reporte de posición, cambio de nivel, toque y motor, pista libre, cruce de pista, cruce de zona, cierre del plan de vuelo, información de tránsito, el QNH, el viento, *repita*, *cumpliré* y *recibido*.
- **Fraseología escrita, como la del controlador.** La IA solo interpreta qué le pediste; cada palabra que dice por radio sale de una plantilla, y cada lugar, pista y número sale de tus datos y del simulador. Las emergencias las declarás vos.
- **Pregunta en vez de negarse.** Si al llamado le falta algo — qué pista, qué destino —, te lo pregunta, y lo próximo que digas se toma como la respuesta.
- **Nunca toca tus radios.** Si nombrás una estación que no está sintonizada en COM1, te pide que cambies primero y después hace el llamado.
- **Activado por defecto.** Se desactiva con **El instructor comunica por radio** en RogerATC Setup.

### Te llama por tu nombre

De vez en cuando el instructor te llama por tu nombre: la primera palabra del nombre de tu cuenta de Copilot EFB. Para cambiarlo, abrí la pestaña **Instructor** en la ventana del plugin, hacé clic en el nombre, escribí y pulsá Enter, o configurá **Tu nombre** en RogerATC Setup. La ventana de X-Plane solo admite letras sin tilde, así que un nombre con tilde se escribe en RogerATC Setup. Tu cuenta no se modifica.

### Te lee los mensajes del EFB

Cuando un copiloto o el administrador te escribe en Copilot EFB, el instructor te avisa cuando la radio está tranquila y te lee los mensajes sin leer de a uno, del más antiguo al más nuevo. Cada uno queda leído en todos tus dispositivos cuando lo escuchaste entero o cuando dijiste *"siguiente"* mientras sonaba. Se revisan cada cinco minutos. Preguntá *"¿tengo mensajes?"* cuando quieras; decí *"siguiente"* o *"después"*. Se desactiva con **El instructor me lee los mensajes del EFB** en RogerATC Setup o en la pestaña **Instructor** de la ventana del plugin.

### Modo proactivo

Poné el instructor en **Proactivo** y además habla sin que le preguntes: velocidad de flaps, un régimen de descenso alto cerca del suelo, tren arriba en final, un altímetro que no coincide con el QNH, viento cruzado fuerte, poco combustible, espacio aéreo controlado por delante.

### Avisos al instante, y cómo silenciarlos

Con el instructor en **Activado** (lo predeterminado) te avisa una vez, en el momento, lo que importa: la carrera de despegue con el freno de estacionamiento puesto, con la mezcla sin estar rica a fondo por debajo de 3000 pies de altitud de densidad (empobrecer en un aeródromo alto, como dice tu POH, nunca se cuestiona) o con el compensador muy lejos de la posición de despegue; un desbalance de combustible entre los lados; la autonomía dentro de tu reserva. Usa el límite de desbalance y la reserva de tu perfil en Copilot EFB cuando los tiene; si no, un valor conservador que dice que es suyo. Si no querés que hable por su cuenta, elegí **Silencioso** en RogerATC Setup o en la pestaña **Instructor**: sigue respondiendo cuando lo llamás.

### Si te perdés

Decí *"actualmente desorientado"* o *"estoy perdido"*. El controlador te asiste: te da un código de transpondedor (7700 solo si declaraste MAYDAY y no tenías código), te pide tu última posición conocida, rumbo y altitud, y una sola vez la autonomía y las personas a bordo; si te identificó, te dice dónde estás y qué rumbo volar hacia el aeródromo apropiado más cercano o tu destino si está cerca; si no, el QDM. Te mantiene en la frecuencia hasta que digas *"reorientado"*.

## IFR por voz: Autorizaciones, Salida y Aproximación

Donde tu escenario las publica, **Autorizaciones**, **Salida** y **Aproximación** contestan en sus propias frecuencias. Autorizaciones te da la autorización IFR del plan presentado: el destino, la SID que tu propio CIFP publica para la pista en uso, el nivel, el transpondedor y la frecuencia de salida. Después del despegue la torre pasa todo vuelo IFR a Salida. Aproximación te identifica, te hace descender a la altitud que publica la aproximación y te vectorea a final: un tramo básico, una interceptación de treinta grados como máximo, la autorización de aproximación y la torre cuando estás establecido.

> Intercambio de ejemplo: el procedimiento, los niveles y las frecuencias salen de tus propios datos, así que los tuyos van a ser otros. Nunca se da un rumbo sin la variación magnética de tu avión, y nunca se autoriza una aproximación que tu CIFP no publica.

*En inglés*

```
PILOT  Aeroparque Delivery, ARG1234, information Bravo, request IFR clearance to Córdoba.
ATC    ARG1234, Aeroparque Delivery, cleared to Córdoba, Tovar One Alfa departure,
       flight planned route, climb via SID to flight level 350, squawk 4521,
       when airborne contact Aeroparque Departure 120.6.
PILOT  Cleared to Córdoba, Tovar One Alfa, flight planned route, climb via SID
       flight level 350, squawk 4521, departure 120.6, ARG1234.
ATC    ARG1234, readback correct.
       ...
PILOT  Aeroparque Departure, ARG1234, passing 2500 climbing.
ATC    ARG1234, Aeroparque Departure, radar contact, climb to flight level 350.
       ...
PILOT  Aeroparque Approach, ARG1234, 5000 descending, information Charlie.
ATC    ARG1234, Aeroparque Approach, radar contact, descend to 2500 feet, QNH 1013,
       vectoring for RNAV approach runway 31.
ATC    ARG1234, turn right heading 115.
ATC    ARG1234, 12 miles from the threshold, turn left heading 245, maintain 2500 feet
       until established, cleared RNAV approach runway 31, report established
       on the final approach course.
ATC    ARG1234, contact Aeroparque Tower 118.85.
```

*En español*

```
PILOTO  Aeroparque Autorizaciones, ARG1234, información Bravo, solicito autorización IFR a Córdoba.
ATC     ARG1234, Aeroparque Autorizaciones, autorizado a Córdoba, salida Tovar Uno Alfa,
        plan de vuelo, ascienda vía SID a nivel de vuelo 350, transpondedor 4521,
        en el aire contacte Aeroparque Salida 120.6.
PILOTO  Autorizado a Córdoba, salida Tovar Uno Alfa, plan de vuelo, vía SID a nivel 350,
        transpondedor 4521, Salida 120.6, ARG1234.
ATC     ARG1234, correcto.
        ...
PILOTO  Aeroparque Salida, ARG1234, pasando 2500 ascendiendo.
ATC     ARG1234, Aeroparque Salida, contacto radar, ascienda para nivel de vuelo 350.
        ...
PILOTO  Aeroparque Aproximación, ARG1234, 5000 descendiendo, información Charlie.
ATC     ARG1234, Aeroparque Aproximación, contacto radar, descienda para 2500 pies,
        QNH 1013, vectores para aproximación RNAV pista 31.
ATC     ARG1234, vire derecha rumbo 115.
ATC     ARG1234, posición 12 millas de la pista, vire izquierda rumbo 245, mantenga
        2500 pies hasta establecido, autorizado aproximación RNAV pista 31,
        notifique establecido en el curso de aproximación final.
ATC     ARG1234, contacte Aeroparque Torre 118.85.
```

### Tu plan desde SimBrief

En [Copilot EFB](https://copilot.rogeratc.app), **Plan de vuelo → Importar de SimBrief** trae tu último plan de SimBrief con un toque, te muestra cada casilla y lo guarda como uno de tus planes. RogerATC lo lee en menos de cinco minutos: la ruta con su SID y su STAR, el nivel y, en un vuelo de línea aérea, el indicativo — sin tipear nada en el simulador. Las personas a bordo y la casilla 19 no vienen en un plan de SimBrief: completalas en el EFB antes de presentarlo.

El ATIS ahora te dice qué aproximación prever, y su letra cambia solo cuando el tiempo cambia de verdad.

## Práctica IFR con Copilot EFB

Con el **enlace en vivo con el EFB** activado, un instructor —o un amigo que hace de ATC— sigue tu vuelo en Copilot EFB y le pide al controlador la próxima instrucción de la clase. La escuchás por COM1 del mismo controlador que todo lo demás, la colacionás y se verifica la colación.

### Cómo activarlo

- En RogerATC Setup, activá el **enlace en vivo con el EFB**. Si querés, poné la **sincronización con el EFB** en *Completo* para que la consola también muestre la transcripción de la radio.
- Iniciá X-Plane y volá. En una tableta o computadora, abrí [Copilot EFB](https://copilot.rogeratc.app) con la **misma cuenta** y andá a la pantalla **RogerATC**.
- La aeronave aparece en un mapa que la sigue y dibuja su traza, con su altitud, velocidades, rumbo, código de transpondedor, COM1 y viento, y un perfil vertical sobre el terreno; la luz indica **LIVE** mientras el plugin informa.
- Tocá una instrucción, revisá los valores (se abren completados según dónde está la aeronave) y enviala. Debajo ves si se dijo, con las palabras exactas, o si se rechazó y por qué.

### Qué se puede pedir

- Esperas con su entrada, virajes de reversión, radiales, arcos DME, rumbos, niveles, código de transpondedor y cambios de frecuencia.
- Aproximaciones por tipo —ILS, GLS, LOC, VOR, NDB, TACAN, RNAV, RNP, visual y por contacto—, además de circulación, vectores a final y aproximaciones SRA y PAR guiadas milla por milla.
- Aproximaciones frustradas, SID, STAR, directo a un fijo y desvíos, y también trabajo VFR en el circuito, aterrizaje, ida al aire y QNH.

*Una aproximación con radar de precisión, en inglés*

```
ATC  LV-GKM, this will be a precision radar approach runway 02, check your minima.
ATC  LV-GKM, six miles from touchdown, slightly left of track, slightly above glide path.
ATC  LV-GKM, four miles from touchdown, check gear down, on track, on glide path.
ATC  LV-GKM, approach completed, if runway not in sight, go around.
```

*La misma, en español*

```
ATC  LV-GKM, esta será una aproximación con radar de precisión pista 02, verifique sus mínimos.
ATC  LV-GKM, seis millas del punto de toma de contacto, ligeramente a la izquierda del rumbo,
     ligeramente por encima de la senda de planeo.
ATC  LV-GKM, cuatro millas del punto de toma de contacto, verifique tren abajo, en el rumbo,
     en la senda de planeo.
ATC  LV-GKM, aproximación completada, si no tiene la pista a la vista, ida al aire.
```

### El controlador sigue decidiendo

Cada procedimiento, fijo y frecuencia se busca en **tus propios** datos de navegación de X-Plane. Si no está, se rechaza con un motivo que ve el instructor; el controlador nunca lo reemplaza por otro. No se dice nada con el simulador en pausa ni durante una emergencia, y un pedido que no se recoge en dos minutos vence en lugar de darse tarde.

## Sesiones de tránsito instruidas

Una sesión de tránsito se arma en [Copilot EFB](https://copilot.rogeratc.app) (**RogerATC → Sesiones de tránsito**) y se vuela con RogerATC: el controlador te da una parte del plan, la volás y notificás, y te da la siguiente. Necesitás el **enlace en vivo con el EFB** activado en RogerATC Setup y la sesión marcada como **Lista** en el EFB. Si la sesión es de **principiante**, el instructor te explica por intercomunicador cómo volar cada parte que te da la torre.

### Cómo corre en la radio

- **Pedí el tránsito.** No se dice nada hasta que llamás: pedí la autorización o el tránsito, hacé el primer contacto en vuelo o, en tierra, decí que estás listo para copiar. El controlador te da el primer paso.
- **Colacioná** lo que te autorizan, como siempre; la colación se verifica.
- **Volá la parte y notificá** lo que te pidió: «establecido», «en la espera», «una vuelta completada», «nivelado», «viraje completado», el aeródromo a la vista o tu posición. Algunos pasos terminan solos por medición: en el aire a 400 ft, en la pista por debajo de 40 kt, estacionado.
- El controlador te contesta en una sola transmisión: «recibido», la parte siguiente y lo que tenés que notificar después.
- Las maniobras te las explica el **instructor** por el intercomunicador. Le podés preguntar lo que quieras en cualquier momento: sabe qué paso estás volando y cuál sigue.
- Un paso que tus datos de navegación no permiten —un procedimiento que no está en tu CIFP, por ejemplo— se rechaza con su motivo, y la sesión sigue con el siguiente.

### Emergencias y pedidos de posición

Si los elegiste para la sesión, en momentos al azar —nunca en la pista ni en los últimos dos minutos de una aproximación— el controlador te pide la posición, y RogerATC escribe en el simulador una de las emergencias elegidas: una falla real o un cambio de viento, turbulencia o visibilidad. La sesión espera a que la declares y la resuelvas; una falla de motor en un monomotor termina la sesión, en tierra. Desde el EFB también se puede inyectar una en el momento.

### Desde el EFB

En la pantalla RogerATC del EFB se ve el paso en curso y lo que se espera, y se puede **saltear el paso** o **terminar la sesión**. Si X-Plane se cierra a mitad de camino, al volver a abrirlo RogerATC retoma la sesión desde el paso en que estaba.

> Todo lo que RogerATC cambió en el simulador —fallas y meteorología— se restaura cuando la sesión termina, sea completa, terminada desde el EFB, con el plugin desactivado o al cerrar X-Plane. Es práctica en simulador: no es un dispositivo de instrucción aprobado.

## Qué envía RogerATC a Copilot EFB y qué nunca sale de tu computadora

### Cada vez que arranca

RogerATC verifica tu cuenta con Copilot EFB y envía un identificador aleatorio de esta instalación, las versiones de RogerATC, del sistema operativo y de X-Plane, y algunos ajustes (idioma, región, modelo de lenguaje, instructor, tránsito, fuente de datos, opciones del EFB). Después obtiene tus claves de proveedores por una conexión cifrada. Si no puede contactar a Copilot EFB, sigue funcionando hasta **14 días** desde la última verificación correcta, con una copia de tus claves guardada en el llavero del sistema o en el Administrador de credenciales.

### Después de cada sesión

RogerATC **siempre** envía un resumen de la sesión a tu propia cuenta de Copilot EFB, donde vos y los administradores del servicio pueden ver el uso del plugin:

| Nivel | Qué se envía |
|---|---|
| Estadísticas (siempre) | Horarios, versiones, idioma y región, matrícula y tipo de tu aeronave, los aeródromos visitados y conteos: transmisiones, pedidos de repetición, colaciones correctas e incorrectas, emergencias, tiempos de respuesta; y cuánto se le pidió a cada modelo de IA — solicitudes, tokens, segundos de audio —, para que el EFB estime lo que gastan tus claves. |
| Completo (opcional) | Todo lo anterior, más hasta doscientas líneas recortadas de lo que se escuchó y lo que se dijo. |

Si estás sin conexión, el resumen espera en el disco y se envía después. Una sesión que borrás en el EFB se borra en todos tus dispositivos.

### Solo si los activás

- **Enlace en vivo con el EFB:** cada pocos segundos, la posición y el estado actuales de tu aeronave —altitud, velocidades, rumbo, ajuste del altímetro, la altura del terreno debajo, el viento en altura, las dos radios, el código y el modo del transpondedor, combustible, flaps, tren y piloto automático—, el aeródromo, la pista en uso y el tránsito del simulador cerca de vos. Cada informe reemplaza al anterior y el servidor lo olvida diez minutos después: una posición, nunca una trayectoria. La traza del mapa del EFB la dibuja ese dispositivo con los informes que recibió, y queda allí solo durante la sesión.
- **Fuente de datos Ambos o EFB:** RogerATC *lee* de tu cuenta tu plan de vuelo presentado, el perfil de tu aeronave y las frecuencias de tus fichas de aeródromo.
- **La ruta de tu G1000:** con cualquier fuente de datos, la torre conoce la ruta cargada en el navegador del avión (G1000, GNS o FMS) y la toma como tu plan presentado. Si en tu cuenta hay un plan para ese mismo vuelo, usa ese, con todos sus detalles.

### Lo que nunca sale de tu computadora hacia nosotros

- **Tu voz.** El audio va de tu computadora directamente a OpenAI, con tu clave, para el reconocimiento. Nunca pasa por nuestros servidores y nunca se envía a Copilot EFB.
- **Los datos de navegación.** Los datos de navegación de tu X-Plane tienen licencia para tu uso y se leen donde están. Nunca se suben, y nunca se envía una lista de pistas, frecuencias o radioayudas. Las transcripciones son las palabras dichas por radio, así que pueden contener nombres que dijo el controlador —calles de rodaje, puestos, pistas—, pero ningún archivo ni extracto de datos de navegación sale de tu computadora.
- **Tus claves** se envían solo al proveedor que las emitió. Copilot EFB registra qué nombres de claves se obtuvieron y cuándo, nunca sus valores.

Otros servicios —NOAA, Windy, openAIP, Flightradar24, Tavily— se contactan solo para lo que activaste, con tus propias claves. adsb.lol, para el tránsito real, no necesita clave y solo recibe tu posición, para encontrar los aviones a su alrededor. Los registros de sesión y los logs quedan en tu computadora:

*macOS*

```
~/Library/Application Support/RogerATC
```

*Windows*

```
%APPDATA%\RogerATC
```

## Actualizar

RogerATC busca una versión nueva cada vez que arranca: en X-Plane y cuando abrís RogerATC Setup. Cuando la hay, X-Plane muestra un aviso con **Actualizar** y **Más tarde**, y RogerATC Setup muestra **Actualizar ahora**. En los dos casos, Setup descarga la versión nueva, comprueba que sea exactamente el archivo publicado en rogeratc.app, la instala y se reinicia. **Más tarde** oculta el aviso hasta mañana; **Ayuda y registros › Buscar actualizaciones** vuelve a buscar cuando quieras.

- Hacé clic en **Actualizar** en X-Plane (o en **Actualizar ahora** en RogerATC Setup).
- Si X-Plane está abierto, RogerATC Setup dice **Cierra X-Plane para terminar de actualizar RogerATC** y actualiza el plugin en cuanto X-Plane se cierra. Nunca toca el plugin mientras X-Plane está en marcha.
- Cuando diga **RogerATC <versión> está listo**, iniciá X-Plane.

Si la actualización no puede reemplazar RogerATC Setup donde está (por ejemplo, una carpeta Aplicaciones en la que no podés escribir), abrí la versión nueva en Finder: arrastrá RogerATC Setup a Aplicaciones y reemplaza la anterior. Siempre podés instalar a mano: descargá el instalador de este sitio y ejecutalo encima del anterior (macOS: arrastralo a Aplicaciones; Windows: ejecutá el .exe). Tus ajustes, tu cuenta vinculada y tus registros de sesión se conservan.

## Desinstalar

### macOS

- Cerrá X-Plane, abrí RogerATC Setup y hacé clic en **Desinstalar**. Esto quita la carpeta del plugin de X-Plane.
- Arrastrá RogerATC Setup de Aplicaciones a la Papelera.

### Windows

Abrí **Configuración → Aplicaciones → Aplicaciones instaladas**, buscá RogerATC y elegí **Desinstalar**. Te pregunta si también querés quitar el plugin de X-Plane.

### Para borrar todo

Tus ajustes, registros de sesión y claves guardadas se conservan a propósito, para que una reinstalación no los pierda. Para borrarlos también, eliminá la carpeta de soporte de RogerATC que aparece en **Qué envía RogerATC**, más arriba, y la carpeta `RogerATC` de tus Documentos (la memoria del instructor). Después quitá las claves guardadas: en macOS, abrí Acceso a Llaveros y borrá los elementos llamados `ai.rogeratc`; en Windows, abrí el Administrador de credenciales → Credenciales de Windows y quitá las entradas que empiezan con `ai.rogeratc`.

## Solución de problemas

#### "Vincula tu cuenta de Copilot EFB en RogerATC Setup"

El plugin no tiene una clave válida, o la clave se rotó en el EFB. Abrí RogerATC Setup, pegá la clave actual de **Ajustes → Acceso a la API** de Copilot EFB, vinculala y reiniciá X-Plane. Si la cuenta está pausada, el mensaje sigue hasta que se reactive.

#### "RogerATC necesita contactar a Copilot EFB una vez cada 14 días"

Conectate a internet y reiniciá X-Plane. Una verificación correcta lo habilita por otros 14 días.

#### El controlador no responde

- Comprobá que la tecla de transmisión esté asignada al comando de RogerATC y que la **mantengas pulsada** mientras hablás.
- Comprobá el permiso del micrófono (mirá las secciones de instalación) y que tus auriculares sean el dispositivo de entrada del sistema.
- Comprobá que COM1 esté en una frecuencia del aeródromo. Si estás en la equivocada, la estación te dice qué frecuencia usar.
- Abrí **Plugins › Roger ATC AI › Diagnostics**: muestra si RogerATC está funcionando y, si no, por qué.
- Si volás en VATSIM con xPilot conectado, RogerATC se hace a un lado a propósito y te lo avisa.

#### Me escucha pero nunca contesta, o falta la voz

Tu clave de OpenAI falta, es incorrecta o se quedó sin saldo. Revisala en Copilot EFB → **Ajustes → Claves que usa RogerATC** y tu saldo en la plataforma de OpenAI, y reiniciá X-Plane: las claves se obtienen cuando arranca el plugin.

#### Me dice "repita" todo el tiempo

Usá auriculares, decí tu indicativo, decí los designadores en lugar de deletrearlos y mantenete en el idioma que elegiste. Si una calle de rodaje o una pista no está en *tu* escenario, el controlador no la acepta: revisá el aeródromo en el mapa de X-Plane.

#### Setup no encuentra X-Plane o no instala

Abrí X-Plane 12 una vez para que registre dónde está instalado y volvé a abrir Setup, o indicale vos la carpeta de X-Plane. Instalar, actualizar y desinstalar solo funcionan con X-Plane cerrado.

#### Dónde están los registros

Hacé clic en **Abrir la carpeta de registros** en RogerATC Setup, o abrí la carpeta de soporte que aparece en **Qué envía RogerATC**, más arriba. La carpeta `sessions` guarda un registro por vuelo (se conservan los veinte más recientes); adjuntá el último cuando reportes un problema.

## Solo para simulación y práctica

RogerATC es para simulación de vuelo y práctica de comunicaciones. **No es un dispositivo de instrucción aprobado** y **no reemplaza la instrucción de vuelo certificada**. Su fraseología se basa en fuentes publicadas, pero los procedimientos reales cambian según el país, el aeródromo y el controlador: en una aeronave real, seguí a tu instructor, las publicaciones oficiales y las instrucciones del ATC real.

---

© RogerATC · https://rogeratc.app
