# Settings

{% embed url="<https://youtu.be/0CP1NtX9aHE?feature=shared>" %}

## Overview

The Settings window contains advanced graphics, media, camera, and UI options that you can use to customize your personal Breakroom experience. Any changes you make through the Settings window will apply only to your personal [desktop viewer](https://docs.breakroom.tech/opening-the-doors/desktop-viewers) or [World Stream](https://docs.breakroom.tech/opening-the-doors/world-stream) session.

## Opening the Settings window

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FwkQ5ROzkmQ7rikvuSnPx%2FBreakroom_GETTING_STARTED_SETTINGS_001_2026.jpg?alt=media&#x26;token=7a1cf4fe-ff1d-46c9-9c7a-a50986abe1ad" alt="The bottom right corner toolbar, which contains five buttons. The Settings button is highlighted on the far left." width="281"><figcaption><p>Highlighted: The location of the Settings button.</p></figcaption></figure></div>

You can open the Settings window by clicking the **Menu > Settings button** in the [top toolbar](https://docs.breakroom.tech/ui-tour#the-top-toolbar), or by pressing **Ctrl + /** on your keyboard.

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FHy38jO8FNj1TsCV10g9T%2FBreakroom_GETTING_STARTED_SETTINGS_002_2026.jpg?alt=media&#x26;token=ec3790d4-551b-42de-87f0-0431996f8db3" alt="A closeup of the Settings button in the upper right corner of the Breakroom login screen."><figcaption><p>Pictured: The Settings button on the login screen.</p></figcaption></figure></div>

You can also access the Settings window prior to logging in by clicking the **Settings button** in the top right corner of the Breakroom login screen.

The Settings window contains several tabs. Below, you'll find a brief overview of the options available under each tab.

## Graphics settings

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FtkVdp1Re8YbdVSf3z7q7%2FBreakroom_GETTING_STARTED_SETTINGS_003_2026.jpg?alt=media&#x26;token=f8f9b285-75a8-4852-a7a9-eb8d6b6c8681" alt="The Settings window Graphics tab, which contains various options to improve graphics performance. The UI for this tab is described below."><figcaption></figcaption></figure></div>

The Graphics tab allows you to customize your visual experience in Breakroom. You can maximize your graphics settings in order to fully enjoy Breakroom's virtual Regions, or reduce your graphics requirements to accommodate lower-end hardware.&#x20;

Key settings include:

<table data-header-hidden><thead><tr><th width="253">Setting</th><th>Function</th></tr></thead><tbody><tr><td>Setting</td><td>Function</td></tr><tr><td>Quick-adjust buttons</td><td>These buttons let you switch between a light graphics load (Low/Medium) and a heavier graphics load (High/Ultra) with a single click.</td></tr><tr><td>Advanced Options</td><td>The sliders and check boxes located under Advanced Options allow you to make specific, granular changes to your graphics configuration.</td></tr><tr><td>Framerate</td><td>This drop-down menu lets you set a target framerate. If set to a chosen value, Breakroom will attempt to meet this framerate, but will not exceed it.</td></tr><tr><td>vSync</td><td>This drop-down menu can be used to enable or disable vSync. vSync helps your computer synchronize framerate with your monitor's refresh rate, so disabling this option may result in graphical "tearing." Generally, we do not recommend turning this off.</td></tr><tr><td>Max Loaded Avatars</td><td>This drop-down menu lets you specify the maximum number of avatars that will be rendered in-world. Setting this to a lower value can help if you are dealing with a slow connection or using a computer with lower-end graphics capability.</td></tr><tr><td>Display Mode</td><td>On the desktop application, these buttons allow you to toggle Breakroom between full-screen and windowed mode.</td></tr></tbody></table>

## UI settings

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2F6DXw6aPo5ujOutSfou1I%2FBreakroom_GETTING_STARTED_SETTINGS_004_2026.jpg?alt=media&#x26;token=a38a4ba4-4a31-4802-be37-0bee46043af4" alt="The Settings window UI tab, which contains various options to change the UI display. Five large pink buttons along the top control the scale of the UI, with 80% at the far left and 190% at the far right. The UI for this tab is described below."><figcaption></figcaption></figure></div>

The UI tab allows you to customize certain aspects of [Breakroom's UI](https://docs.breakroom.tech/getting-started/ui-tour).

<table data-header-hidden><thead><tr><th width="306">Setting</th><th>Function</th></tr></thead><tbody><tr><td>Setting</td><td>Function</td></tr><tr><td>Interface size buttons</td><td>These buttons let you reduce or increase the size of the <a href="ui-tour">Breakroom UI</a> elements that frame your screen.</td></tr><tr><td>Chat Text Size</td><td>This slider allows you to adjust the <a href="../communicating-with-other-users#text-chat">chat window</a> text size independently of other UI elements.</td></tr><tr><td>"Enable Login to Preview" option</td><td>This option makes it possible to log in to the preview server. </td></tr><tr><td>"Enable Highlight Effect" option</td><td>This option toggles the highlight "aura" that surrounds clickable objects and avatars when your mouse passes over them.</td></tr><tr><td>"Prompt on Mouselook" option</td><td>This option enables or disables the prompt that appears when you use your mouse scroll wheel to transition into <a href="../controlling-your-camera#mouselook">mouselook</a>.</td></tr><tr><td>"Enable Camera Tooltips" option</td><td>This option enables or disables the camera tips that appear on screen.</td></tr><tr><td>"Show name tag of yourself" option</td><td>This option toggles the visibility of your own overhead name tag. (Please note that others will always be able to see your name tag.)</td></tr></tbody></table>

{% hint style="info" %}
World Owners can make global changes to the default UI scale by visiting the World Customization tab on the [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
{% endhint %}

## Controls settings

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2Fh27MFTigEhm18BHuuxe2%2FBreakroom_GETTING_STARTED_SETTINGS_005_2026.jpg?alt=media&#x26;token=0ce6ca54-8697-4fbc-95ad-14cd2ee1cf46" alt="The Settings window Controls tab, which contains various options to change input devices and device sensitivity. The UI for this tab is described below."><figcaption></figcaption></figure></div>

The Controls tab allows you to toggle various input options. You can also adjust your mouse and input sensitivity and customize the way your avatar responds to certain movement commands.

<table data-header-hidden><thead><tr><th width="325">Setting</th><th>Function</th></tr></thead><tbody><tr><td>Setting</td><td>Function</td></tr><tr><td>"Click to move" option</td><td>This option toggles the <a href="../controlling-your-avatar#click-to-walk">click to move</a> feature.</td></tr><tr><td>"Can click on self" option</td><td>This option controls whether you can click on your own avatar.</td></tr><tr><td>"Use Gamepad" option</td><td>This option enables or disables the use of a connected gamepad.</td></tr><tr><td>"Inverse Y Axis in Mouselook" option</td><td>This option allows you to inverses the Y axis while in <a href="../controlling-your-camera#mouselook">mouselook</a>.</td></tr><tr><td>"Walk/Run State" option<br>(Previously "Always Run mode")</td><td>This option toggles your movement style between "walk <em>or</em> run" and "always run" mode. This option will persist between login sessions and across Region teleports until you disable it. It can also be enabled by pressing <strong>Ctrl + R</strong> on your keyboard.</td></tr><tr><td>"Running: Switch" option<br>(Previously "Make Run Toggleable")</td><td>This option allows you to toggle between normal movement and "always run" mode using your keyboard. "Always run" can be toggled by pressing the <strong>Shift key</strong> once.</td></tr><tr><td>"Crouch: Switch" option<br>(Previously "Make Crouch Toggleable")</td><td>This option allows you to toggle between normal locomotion and persistent crouching by pressing the <strong>C key</strong> once. Your avatar will then crouch until you press the C key again.</td></tr><tr><td>Mouse Sensitivity</td><td>This slider adjusts the sensitivity (speed) of your mouse within the Breakroom viewer or screen.</td></tr><tr><td>Input Sensitivity</td><td>This slider adjusts the sensitivity (speed) of other input devices, such as gamepads or joysticks.</td></tr><tr><td>Movement Speed</td><td>This slider adjusts your avatar's default walk speed, so you can walk (and consequently run) slower or faster.</td></tr><tr><td>Turning Speed</td><td>This slider adjusts your avatar's default turning speed.</td></tr></tbody></table>

## Audio settings

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FJjKhSJMGB4Hr77DGMuaM%2FBreakroom_GETTING_STARTED_SETTINGS_006_2026.jpg?alt=media&#x26;token=a473ec09-e403-4daa-84a0-d822aecceb98" alt="The Settings window Audio tab, which contains options to independently control the volume of different audio types and change input and output devices. The UI for this tab is described below."><figcaption></figcaption></figure></div>

The Audio tab allows you to independently control the volume of the different types of media that might play in-world. You can also use the **Audio Test** and **Video Test buttons** to conduct [real-time tests](https://docs.breakroom.tech/getting-started/using-the-conference-system/troubleshooting-audio-and-video-issues) on your audio/visual equipment, and use the **drop-down device selection menus** to [switch between active devices](https://docs.breakroom.tech/using-the-conference-system/troubleshooting-audio-and-video-issues#the-change-devices-button).

<table data-header-hidden><thead><tr><th width="257"></th><th></th></tr></thead><tbody><tr><td>UI component</td><td>Function</td></tr><tr><td>Reset to Default button</td><td>Resets all volume and device settings to the default configuration.</td></tr><tr><td>Audio Test button</td><td>Launches the <a href="../using-the-conference-system/troubleshooting-audio-and-video-issues#the-mic-and-cam-test-button">Audio Test panel</a>.</td></tr><tr><td>Video Test button</td><td>Launches the <a href="../using-the-conference-system/troubleshooting-audio-and-video-issues#the-mic-and-cam-test-button">Video Test panel</a>.</td></tr><tr><td>Master Volume slider</td><td>Adjusts the overall volume of the Breakroom application.</td></tr><tr><td>Music Volume slider</td><td>Adjusts the volume of any music streamed on the Breakroom platform.</td></tr><tr><td>UI Volume slider</td><td>Adjusts the volume of the UI interactivity sounds.</td></tr><tr><td>SFX Volume slider</td><td>Adjusts the volume of any special effects sounds.</td></tr><tr><td>Voice Volume slider</td><td>Adjusts the voice streaming volume.</td></tr><tr><td>Mic Sensitivity slider</td><td>Adjusts your own microphone's sensitivity, impacting your voice volume.</td></tr><tr><td>Microphone Device menu</td><td>Allows you to select which microphone you want to use on Breakroom.</td></tr><tr><td>Playback Device menu</td><td>Allows you to select which speakers you want to use.</td></tr><tr><td>Webcam Device menu</td><td>Allows you to select which camera you want to use.</td></tr></tbody></table>

## Miscellaneous settings

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2F13DO1JLupoDBGlelzfMW%2FBreakroom_GETTING_STARTED_SETTINGS_007_2026.jpg?alt=media&#x26;token=c859adbf-e79b-43a7-9b10-34a07fea622a" alt="The Settings window Miscellaneous tab, which contains various options related to graphics caching and viewer display. The UI for this tab is described below."><figcaption></figcaption></figure></div>

The Misc tab allows you to enable or disable additional functions within Breakroom.

<table data-header-hidden><thead><tr><th width="317">Setting</th><th>Function</th></tr></thead><tbody><tr><td>Setting</td><td>Function</td></tr><tr><td>Caching options</td><td>These controls can be used to clear your graphics cache and change the cache storage location on your device.</td></tr><tr><td>"Media Screens" option</td><td>This option lets you enable or disable all in-world web browsers and video players. This includes the <a href="../creating-custom-experiences/exploring-the-breakroom-toolkit/breakroom-web-browser">Breakroom web browser</a> and <a href="../running-your-event/moderator-tools/participation">Slido integration</a>. Generally, we do not recommend turning this off.</td></tr><tr><td>"Enable Debug Mode" option</td><td>This option enables or disables Lua logging on <a href="../advanced-tutorials/uploading-your-own-region/testing-items-on-the-preview-server">Live servers</a>. Useful for Lua programmers debugging their code. On Windows machines, the log is available at C:\Users&#x3C;your windows username>\AppData\LocalLow\Sine Wave Entertainment Ltd\sinespace\Player.log.</td></tr></tbody></table>

## VR settings

{% hint style="danger" %}
The settings available under this tab pertain to VR experiences in Breakroom. VR is only available on the Breakroom [desktop application](https://docs.breakroom.tech/opening-the-doors/desktop-viewers), and requires access to [advanced computer equipment](https://docs.breakroom.tech/help/system-requirements).&#x20;

**In general, we do not recommend the use of VR equipment with Breakroom at this time.**
{% endhint %}

## **Camera Controls settings**

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FKx8aS8oeVOzjqnNwFesh%2FBreakroom_GETTING_STARTED_SETTINGS_008_2026.jpg?alt=media&#x26;token=3d760a0a-500d-41eb-84ca-5fc467783fd0" alt="The Settings window Camera Controls tab, which contains camera behavior options that can be customized."><figcaption></figcaption></figure></div>

The Camera Controls tab allows you to customize the way your in-world camera behaves. You can also save your custom settings for future use and to share with others.

### Profile settings vs. global settings

Under the Camera Controls tab, you will see two groups of camera settings—**Profile Settings** and **Global Settings**.

It is important to note that the camera settings listed under **Profile Settings** (from here referred to collectively as a *camera profile*) can be [reset](#resetting-the-camera-profile-to-default) with a single click. Camera profiles can also be [saved](#saving-camera-profiles), exchanged with other users, and [loaded](#loading-camera-profiles) on demand.

On the other hand, the camera settings listed under **Global Settings** *will persist no matter what changes are made to your camera profile*. Global settings *cannot* be saved or exchanged, and will be applied in addition to any camera profile that you create or load. *They also cannot be reset to their default configuration with a single click*.

### Saving camera profiles

To save your current camera profile, follow these steps:

1. **Log in** to your Breakroom World.
2. Open the Settings window by typing **Ctrl + /** on your keyboard.
3. Click on the **Camera Controls tab**.
4. Click the **Save Profile to New Inventory Item button**.
5. A pop-up will appear confirming that a new **Camera Settings Group object** has been added to your Inventory. Click the **Okay button** to proceed.

You can find the saved Camera Settings Group object in your Inventory under **Settings > Camera.** You can save multiple camera profiles and share them with others using [in-world email](https://docs.breakroom.tech/communicating-with-other-users#receiving-email).&#x20;

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2Fe1sdJkmOrTIPx6e2TFbV%2FCamera_Settings_002.jpg?alt=media&#x26;token=e89c07a6-a286-4a87-9cc1-066aa8cf17c0" alt="A screenshot of a user Inventory, with a Camera Settings Group object highlighted." width="534"><figcaption><p>Pictured: Camera Settings Group objects, located in the Inventory window.</p></figcaption></figure></div>

### Loading camera profiles

To load a saved camera profile, follow the steps below.

1. **Log in** to your Breakroom World.
2. Click the **Inventory button** in the bottom toolbar.&#x20;
3. In the Inventory window that appears, locate the **Camera Settings Group object** you want to use.
4. Click on the **Camera Settings Group object**, and an action menu will appear. Click the **Use button**.

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FqnveMyKsdJ3xvaVyPVKM%2FCamera_Settings_003.jpg?alt=media&#x26;token=681b3f06-bf68-477c-ba71-6f986619f28c" alt="A screenshot of a user Inventory, with a Camera Settings Group object menu highlighted."><figcaption><p>Pictured: Camera Settings Group objects located in the Inventory window, and the location of the Use button.</p></figcaption></figure></div>

### Resetting the camera profile to default

To reset your camera profile, follow these steps.

1. **Log in** to your Breakroom World.
2. Open the Settings window by typing **Ctrl + /** on your keyboard.
3. Click on the **Camera Controls tab**.
4. Click the **Reset Camera Profile to Default button**.

Please note that clicking this button will **not** change your [global camera settings](#profile-settings-vs.-global-settings).

## Analytics and Marketing Preferences settings

<div data-with-frame="true"><figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2F7IU4dNtCd6nbHsDBaST0%2FBreakroom_GETTING_STARTED_SETTINGS_009_2026.jpg?alt=media&#x26;token=bccbd04b-64d8-45a0-a728-b50525b4441f" alt="The Settings window Analytics and Marketing Preferences tab, which contains options for changing privacy and marketing preferences."><figcaption></figcaption></figure></div>

The Analytics and Marketing Preferences tab allows you to change your privacy and marketing preferences whenever you like.

{% hint style="info" %}
Note: World Owners and World Administrators can[ mandate](https://docs.breakroom.tech/opening-the-doors/privacy-policies-eulas-and-data-collection) that Analytics and Marketing data be collected from user logins. In such cases, end users will not be able to opt out of certain types of data collection via the Settings panel.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.breakroom.tech/getting-started/settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.