# Connecting your simulator

Click the **gear icon** at the right of the status bar to open the flight simulator link settings.

### Supported simulators

<table class="code-line" data-line="64" dir="auto" id="bkmrk-simulator-connection" style="border-collapse: collapse; margin-bottom: 0.7em; color: rgb(225, 228, 232); font-family: -apple-system, BlinkMacSystemFont, 'Segoe WPC', 'Segoe UI', system-ui, Ubuntu, 'Droid Sans', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><thead class="code-line" data-line="64" dir="auto"><tr class="code-line" data-line="64" dir="auto"><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Simulator</th><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Connection</th><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Default port</th><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Setup needed</th></tr></thead><tbody class="code-line" data-line="66" dir="auto"><tr class="code-line" data-line="66" dir="auto"><td style="padding: 5px 10px; border-color: rgba(255, 255, 255, 0.18);">Microsoft Flight Simulator (2020 or 2024)</td><td style="padding: 5px 10px; border-color: rgba(255, 255, 255, 0.18);">SimConnect over TCP</td><td style="padding: 5px 10px; border-color: rgba(255, 255, 255, 0.18);">500</td><td style="padding: 5px 10px; border-color: rgba(255, 255, 255, 0.18);">None — MSFS opens this automatically</td></tr><tr class="code-line" data-line="67" dir="auto"><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">FSX / Prepar3D</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">SimConnect over TCP</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">500</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Manual (see below)</td></tr><tr class="code-line" data-line="68" dir="auto"><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">X-Plane 11 / 12</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">X-Plane's built-in networking (UDP)</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">49000</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">One setting (see below)</td></tr></tbody></table>

**MSFS** needs nothing extra — its default configuration already listens on port 500 for exactly this kind of connection.

**FSX / Prepar3D** don't open a network listener by default the way MSFS does. You need to hand-create a `SimConnect.cfg` file on the **simulator's** PC (not the CAVAcars PC) containing:

```
```ini
[SimConnect]
Protocol=IPv4
Address=0.0.0.0
Port=500
MaxClients=64
Disabled=0

```<button aria-label="Copy code block" class="code-block-copy-button" style="position: absolute; top: 8px; right: 8px; display: flex; align-items: center; justify-content: center; width: 28px; height: 28px; padding: 0px; border-image: none 100% / 1 / 0 stretch; border-radius: 4px; background-color: rgb(47, 54, 61); color: rgb(225, 228, 232); cursor: pointer; opacity: 0; transition: opacity 0.15s; border: 0.912871px solid rgba(127, 127, 127, 0.35);"><svg aria-hidden="true" fill="none" focusable="false" height="16" viewbox="0 0 16 16" width="16"><path d="M4 4H2V14H11V12H4V4Z" fill="currentColor"></path><path clip-rule="evenodd" d="M5 2H14V11H5V2ZM6 3H13V10H6V3Z" fill="currentColor" fill-rule="evenodd"></path></svg></button>
```

The exact folder this file goes in varies by sim version — search "SimConnect.cfg location" for your specific FSX/Prepar3D version if you're not sure. The port must match whatever you set in CAVAcars (500 by default).

**X-Plane** needs one setting enabled: in X-Plane, go to **Settings → Network** and turn on **"Accept incoming connections."** No plugin is required — CAVAcars talks to X-Plane's own built-in networking directly.

### Setting the connection up

1. Choose your **Simulator** from the dropdown.
2. Enter the **Simulator PC address**: 
    - If the simulator runs on the **same PC** as CAVAcars, enter `127.0.0.1` or `localhost`.
    - If it runs on a **different PC** on your home network, enter that PC's IP address (e.g. `192.168.1.50`) — or use the scan button below instead of typing it in.
3. Confirm the **Port** — it's pre-filled with the right default for whichever simulator you picked, but change it if you've configured a non-default port (as you might with FSX/Prepar3D above).
4. Leave **"Connect automatically on launch"** checked so CAVAcars reconnects on its own every time you open the app.
5. Click **Save &amp; connect**.

### Scanning for your simulator

If you don't know your simulator PC's address, click **Scan network for the sim**. CAVAcars sweeps your local network for a machine answering on the configured port and lists every address that responds — click one to connect to it. If nothing responds:

- Confirm the simulator is actually running.
- Confirm the setup step above for your simulator (MSFS needs nothing, but FSX/Prepar3D and X-Plane do).
- Check that both PCs are on the same network, and that Windows Firewall (or any other firewall) isn't blocking the port on the simulator's PC.

If CAVAcars finds exactly one simulator on first launch (with no address saved yet), it connects automatically — you'll only need to use the scan button yourself if there's more than one candidate, or none.

### Reading the status bar

<table class="code-line" data-line="130" dir="auto" id="bkmrk-indicator-meaning-do" style="border-collapse: collapse; margin-bottom: 0.7em; color: rgb(225, 228, 232); font-family: -apple-system, BlinkMacSystemFont, 'Segoe WPC', 'Segoe UI', system-ui, Ubuntu, 'Droid Sans', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><thead class="code-line" data-line="130" dir="auto"><tr class="code-line" data-line="130" dir="auto"><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Indicator</th><th style="text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.69); padding: 5px 10px; border-top-color: rgba(255, 255, 255, 0.69); border-right-color: rgba(255, 255, 255, 0.69); border-left-color: rgba(255, 255, 255, 0.69);">Meaning</th></tr></thead><tbody class="code-line" data-line="132" dir="auto"><tr class="code-line" data-line="132" dir="auto"><td style="padding: 5px 10px; border-color: rgba(255, 255, 255, 0.18);">Dot + "Connected" / "Connecting" / "Disconnected"</td><td style="padding: 5px 10px; border-color: rgba(255, 255, 255, 0.18);">Current link status</td></tr><tr class="code-line" data-line="133" dir="auto"><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Simulator name &amp; version (e.g. "MSFS 2020")</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Confirms which sim you're talking to</td></tr><tr class="code-line" data-line="134" dir="auto"><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Aircraft name / tail number</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">The aircraft currently loaded in the sim</td></tr><tr class="code-line" data-line="135" dir="auto"><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">ALT / IAS / GS / HDG / V/S</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Live telemetry once you're in the world</td></tr><tr class="code-line" data-line="136" dir="auto"><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">RATE</td><td style="padding: 5px 10px; border-top: 1px solid rgba(255, 255, 255, 0.18); border-right-color: rgba(255, 255, 255, 0.18); border-bottom-color: rgba(255, 255, 255, 0.18); border-left-color: rgba(255, 255, 255, 0.18);">Shown only when simulator time is sped up</td></tr></tbody></table>

---