> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stopbars.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

## Debug Mode

The Pilot Client includes a **Debug Mode** feature that allows you to verify your light models and states are working correctly without needing to connect.

When activated, Debug Mode freezes the current state and automatically cycles through all possible light states at the nearest holding point. This helps you confirm that:

* All light models have been successfully installed
* Lights are displaying and functioning correctly in your simulator

### Activating Debug Mode

To use Debug Mode, press `Ctrl + Shift + D` while the **Pilot Client window is selected**. To disable Debug Mode, simply press the same keybind again.

<Note>
  Before using Debug Mode, ensure that:

  * You are spawned at an airport [supported](https://preview.stopbars.com/status) by BARS
  * Light models have fully loaded (wait a few seconds after spawning)

  If these conditions are not met, you won't see the closest light objects changing when Debug Mode is activated, as it freezes the current state.
</Note>

When Debug Mode is active, a **red warning** will display in the top-right corner of the Pilot Client. This warning also shows the **current light state** being displayed in the simulator as it cycles through each state.

<Frame>
  <img src="https://mintcdn.com/bars-20e5ea6e/ijXrpuvLnA2agl5B/images/v2/Pilot_Client-DebugMode.png?fit=max&auto=format&n=ijXrpuvLnA2agl5B&q=85&s=14d385830782da8631b114fb045b79e2" alt="Debug Mode active in the Pilot Client showing red warning and current light state" width="586" height="667" data-path="images/v2/Pilot_Client-DebugMode.png" />
</Frame>

The closest light model will automatically toggle through all possible lighting states in your simulator:

<Frame>
  <img src="https://mintcdn.com/bars-20e5ea6e/ijXrpuvLnA2agl5B/images/v2/Pilot_Client-DebugModeSimulator.gif?s=a4533c0ff5042b4c37828736164cb4be" alt="Debug Mode cycling through light states in the simulator" width="800" height="450" data-path="images/v2/Pilot_Client-DebugModeSimulator.gif" />
</Frame>

<Warning>
  Debug Mode will **not** activate if your simulator window is focused instead of the Pilot Client. Pressing `Ctrl + Shift + D` in the simulator will trigger any action bound to that keybind within the simulator itself, rather than activating Debug Mode inside the Pilot Client.
</Warning>

## Testing Mode

The Pilot Client includes a **Testing Mode** feature that allows you to load and preview your contribution XML directly in your simulator before submitting it. This lets you verify the positions of your lights in sim.

When Testing Mode is active, the Pilot Client disconnects from the network and loads your contribution data locally, setting all light states to true so every light in your submission is visible at once.

### Using Testing Mode

Testing Mode is initiated from the Test page of the Contribution flow, not from the Pilot Client.

<Steps>
  <Step title="Upload your XML">
    Navigate to the **Test** page of the Contribution flow, upload your XML file, and click the **Test XML** button. Once your XML has been processed, a **Test in Client** button will appear.

    <Frame>
      <img src="https://mintcdn.com/bars-20e5ea6e/fsdMAF0JyXtuexPV/images/v2/Pilot_Client-TestingMode_TestInClient.png?fit=max&auto=format&n=fsdMAF0JyXtuexPV&q=85&s=c947f3a937162196428785c4e92230ed" alt="Contribution test page showing the Test In Client button after XML has been processed" width="438" height="352" data-path="images/v2/Pilot_Client-TestingMode_TestInClient.png" />
    </Frame>
  </Step>

  <Step title="Open in the Pilot Client">
    Click the **Test in Client** button to open your contribution in the Pilot Client's Testing Mode.

    If this is your first time, your browser may prompt you to allow the website to open the BARS Client, click **Open BARS Client** to proceed. It is recommended you select the option to always allow this, so you are not prompted again in future testing sessions.

    <Frame>
      <img src="https://mintcdn.com/bars-20e5ea6e/fsdMAF0JyXtuexPV/images/v2/Pilot_Client-TestingMode_BrowserPrompt.png?fit=max&auto=format&n=fsdMAF0JyXtuexPV&q=85&s=7dad445a61fab6d0fdc4635a1d764f47" alt="Browser prompt asking whether to open the BARS Client" width="570" height="229" data-path="images/v2/Pilot_Client-TestingMode_BrowserPrompt.png" />
    </Frame>

    <Warning>
      You must have the Pilot Client installed through the **BARS Installer** for the Client to open correctly. If the Pilot Client is not installed, the browser prompt will appear but nothing will open.
    </Warning>
  </Step>

  <Step title="Verify Testing Mode is active">
    Once the Pilot Client opens, it will display a **Testing Mode** indicator in the top-right corner confirming Testing Mode is active with your contribution loaded.

    <Frame>
      <img src="https://mintcdn.com/bars-20e5ea6e/fsdMAF0JyXtuexPV/images/v2/Pilot_Client-TestingMode.png?fit=max&auto=format&n=fsdMAF0JyXtuexPV&q=85&s=67f4977df5306be1ae247ccf866231f6" alt="Pilot Client with Testing Mode indicator visible in the top-right corner" width="586" height="667" data-path="images/v2/Pilot_Client-TestingMode.png" />
    </Frame>
  </Step>

  <Step title="Check your lights in the simulator">
    With Testing Mode active, your contribution XML is loaded locally into your simulator. All light states are set to true, so every mapped light in your submission will be visible simultaneously, allowing you to verify their positions.

    <Note>
      Your aircraft must be in close proximity to the lights for them to load in your simulator. Lights only load near your aircraft to keep simulator performance smooth, this prevents your simulator from loading in airport lights across the entire airport at once.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/bars-20e5ea6e/fsdMAF0JyXtuexPV/images/v2/Pilot_Client-TestingModeSimulator.png?fit=max&auto=format&n=fsdMAF0JyXtuexPV&q=85&s=5de9a78dc729bb2e2568206355091813" alt="Simulator view showing all mapped lights active simultaneously during Testing Mode" width="1920" height="1080" data-path="images/v2/Pilot_Client-TestingModeSimulator.png" />
    </Frame>
  </Step>

  <Step title="Exit Testing Mode">
    When you are done, click the **X** icon on the **Testing Mode** button in the Pilot Client UI to exit Testing Mode. This will stop the test session and return the client to normal network operations.

    <Frame>
      <img src="https://mintcdn.com/bars-20e5ea6e/fsdMAF0JyXtuexPV/images/v2/Pilot_Client-TestingMode_Exit.png?fit=max&auto=format&n=fsdMAF0JyXtuexPV&q=85&s=bb5397bb7927fa3aaac621797f2f03cd" alt="Pilot Client Testing Mode button with the X icon to exit Testing Mode" width="281" height="165" data-path="images/v2/Pilot_Client-TestingMode_Exit.png" />
    </Frame>
  </Step>
</Steps>

<Danger>
  Testing Mode only works if your simulator is already open and you are loaded into the airport you wish to test. If you trigger Testing Mode before your simulator is open or before you have spawned at the correct airport, the lights will not load. You must **exit Testing Mode first**, then open your simulator, spawn at the correct airport, and trigger Testing Mode again from the website.
</Danger>

### What Testing Mode Does

When Testing Mode is active:

* The Pilot Client **disconnects from the network**
* Your contribution XML is loaded locally into the simulator
* **All light states are set to true**, making every mapped light visible simultaneously
* A **Testing Mode** indicator will display in the Pilot Client confirming Testing Mode is active

<Note>
  Testing Mode only affects your local simulator session. No contribution is submitted or published by activating Testing Mode, it is purely for local in simulator testing before you submit your contribution.
</Note>
