# Using the Region Editor

## Overview

The Region Editor gives users with advanced [World-](https://docs.breakroom.tech/opening-the-doors/creating-and-managing-user-accounts/world-level-user-permissions) or [Region-level](https://docs.breakroom.tech/opening-the-doors/creating-and-managing-user-accounts/region-level-user-permissions) permissions the ability to edit existing Regions and any items that they contain. Plaster your exhibition hall with eye-catching posters, brand your vendor booths, or add appealing personal touches like potted plants and comfy sofas—with the Region Editor, almost anything is possible.

The videos, images, and tables below are designed to serve as a basic overview of the Region Editor. After you've grown comfortable accessing the Region Editor and utilizing the various tools it contains, you can expand your skillset by reviewing the additional pages in this section. There you'll learn more about [editing and moving objects](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/editing-and-moving-objects), and explore some of the Region Editor's advanced settings, such as creating [custom atmospheric and sky effects](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/editing-terrain-and-sky) and [swapping out materials](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/the-region-editor-advanced-window).

## Opening the Region Editor

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

***

<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%2FjFlo8WCPC8YrcxoGQWWf%2FRegion_Editor_001.png?alt=media&#x26;token=5fc0ffad-c2e3-48f7-91a7-8e5b5fc00cb6" alt="" width="275"><figcaption><p>Highlighted: The location of the Edit Region button.</p></figcaption></figure></div>

You can open your own user profile by clicking the **Edit Region button** in the [top toolbar](https://docs.breakroom.tech/getting-started/ui-tour#the-top-toolbar).

## The Region Editor UI

<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%2FQjHzlt7F3572gMFuehOe%2FRegion_Editor_002.png?alt=media&#x26;token=739b0560-9362-48f2-9bdd-dfa231b10746" alt="" width="563"><figcaption><p>Pictured: The Region Editor UI, which consists of multiple windows and panels.</p></figcaption></figure></div>

Once the Region Editor is launched, you'll see that it replaces the normal [Breakroom UI](https://docs.breakroom.tech/getting-started/ui-tour) on your screen. The tools in the Region Editor give you the ability to inspect and edit different parts of your Region. Let's take a look at each part of the Region Editor UI in greater detail.

### The Objects window

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

***

<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%2FJwKbGA9WFVpDGwqxt3Mk%2FRegion_Editor_003.png?alt=media&#x26;token=c92fad81-df71-4471-97b4-acb150844405" alt="" width="282"><figcaption><p>Pictured: The Objects window.</p></figcaption></figure></div>

The *Objects window* lists all of the virtual objects in your Region. These objects are sorted onto different *floors,* depending on who added them and when they were added.

The *room floor* (labeled "Floor\_roomfloor" in the image above) contains any conference system components that you have permission to remove or edit, as well as any objects that *you* have manually placed in the Region.

Meanwhile, the *Region floor* (here labeled "Breakroom Gallery") contains the individual 3D assets used to build the Region template. The contents of this floor will vary.

{% hint style="info" %}
*Region floor* objects were uploaded into Breakroom as a whole, as part of one cohesive Region. You may be able to toggle visibility on some of these objects, or edit their settings if the original Region uploader elected to make that possible. However, you may not be able to make changes to all of the Region floor components.
{% endhint %}

{% hint style="danger" %}
All Breakroom [Region templates](https://docs.breakroom.tech/building-new-worlds/region-template-descriptions) contain a *HIDDEN FLOOR* as part of the Region floor. This floor contains the essential conference system components, and cannot be deleted or edited.
{% endhint %}

#### Objects window icons

In the Objects window, you'll notice that the room and Region floors have different icon sets associated with them. Here's a quick breakdown of what those icons mean.

<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%2FvqfBnEf0lA8aimAbYUQj%2FRegion_Editor_004.png?alt=media&#x26;token=170b04a1-b6f3-4e1b-ba8f-812ea731a320" alt="" width="311"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="178">Room floor icon</th><th>Function</th></tr></thead><tbody><tr><td>Eye</td><td>Toggling this icon changes the object's visibility <em>without deleting it</em>. If disabled, the object will not render (it will not be visible to users), and any scripts it contains will not run.</td></tr><tr><td>Lock</td><td>Toggling this icon locks or unlocks an item. Locked items cannot be moved from their current position, and no further changes can be made to their components.</td></tr><tr><td>Trash</td><td>Clicking this icon deletes the item from the Region.</td></tr></tbody></table>

<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%2FBwrZzuE8Wz6eMkDIzowB%2FRegion_Editor_005.png?alt=media&#x26;token=87f10136-fb69-4c81-bf8d-cd2a72566ab0" alt="" width="317"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="183">Region floor icon</th><th>Function</th></tr></thead><tbody><tr><td>Eye</td><td>Toggling this icon changes the object's visibility <em>without deleting it</em>. If disabled, the object will not render (be visible to users), and any scripts it contains will not run.</td></tr><tr><td>Lock</td><td>Toggling this icon locks or unlocks an item. Locked items cannot be moved from their current position, and no further changes can be made to their components.</td></tr><tr><td>Reload</td><td>Clicking this icon reloads an item so that any changes will be pushed forward.</td></tr></tbody></table>

#### Locating objects using the Objects 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%2F5ZrkFMq8TkOvpVbMiwo2%2FRegion_Editor_006.png?alt=media&#x26;token=92f92b71-5fef-450d-bcaa-1af496a91f50" alt="" width="337"><figcaption><p>Pictured: The Objects window with the Objects type drop-down menu expanded.</p></figcaption></figure></div>

You can use the **Objects type drop-down menu** located at the top of the Objects window to filter your objects list. You can also search for a specific object using the **search field**.

### The Inspector window

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

***

<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%2FDATJKcUlxhDci6K3odvu%2FRegion_Editor_007.png?alt=media&#x26;token=1c248671-bd7b-425c-86ba-8b40cee52eaa" alt=""><figcaption><p>Pictured: The Inspector window displayed next to a selected object.</p></figcaption></figure></div>

The *Inspector window* shows more specific information about the individual objects that make up your Region. You can open the Inspector window by clicking on an **object** while in the Region Editor, or by clicking on that object's **name** in the [Objects window](#the-objects-window).

In the image above, a breakout room has been selected as the active object. You can see that the object is surrounded by a green *collider box*, and a [*movement gizmo*](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/editing-and-moving-objects) is hovering inside. In the Inspector window, you can see that this object contains a number of *components*. Expanding a component reveals details about this particular breakout room, such as its location and scale.

The Inspector window is an advanced tool that generally tells you what components exist *within* or *on* a selected object. If the object is a seat, it will contain a Seat Position component. If the object is a solid wall, it will have a Collider component so that avatars can't pass through it. If the object contains a Lua script, it will have a Script Runtime component attached to it. These individual components can be examined, managed, and potentially modified via the Inspector window.

All objects contain a [*Transform component*](https://docs.breakroom.tech/creating-custom-experiences/editing-and-moving-objects#editing-the-transform-component) which allows you to alter their rotation, position, and scale. This is useful to know, as it gives you a great amount of control over where objects appear in your Region.

At the top of the window, you will notice an **On/Off toggle** labeled with the object's name, as well as an **"Is Active" checkbox option**. These controls are the same. If the toggle is on/box is checked, the object is active and will be rendered and scripted in your Region as normal. If the toggle is off/box is unchecked, the object (and all of its children) will not be rendered or scripted for users.

### The Inventory window

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

***

<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%2FDcMBjIUVFqnQykgNqVlA%2FRegion_Editor_008.png?alt=media&#x26;token=12591490-4b3c-4ee5-bd30-98e42cdebe2c" alt=""><figcaption><p>Pictured: The Inventory window, with the location of the View button highlighted.</p></figcaption></figure></div>

The *Inventory window* lists all of the virtual objects you currently own. There are two ways to place an object in your Region while using the Region Editor.

1. **Left click** on the item in your Inventory window and then hover your cursor over the ground in your Region. You will see the item appear in real time. The item will follow your cursor, allowing you to position it. Click the **left mouse button** when you want to set the item down.
2. **Left click and hold** on the item in your Inventory window and drag it into the Region. Release the **left mouse button**, and your item will be placed in the indicated position.

You can switch between Icon view and List view in the Inventory window by clicking the pink **View button** (highlighted in the image above). You can also use the **Search field** to find any items you need.

{% hint style="success" %}
The [Breakroom Toolkit](https://docs.breakroom.tech/creating-custom-experiences/exploring-the-breakroom-toolkit) includes video players, web browsers, posters, and other media and branding assets to place wherever you like. You can also find unique items to dress up your Regions in the [Sinewave Shop](https://docs.breakroom.tech/getting-started/customizing-your-avatar/using-the-sinewave-shop)—such as stylish pieces of furniture, works of art, or quirky conversation starters.
{% endhint %}

### The Advanced 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%2Fc682ms2uDeOVLUQrlUMc%2FRegion_Editor_009.png?alt=media&#x26;token=20912dee-50ce-4e4d-90d2-1e5bce52c294" alt=""><figcaption><p>Highlighted: The location of the Advanced button.</p></figcaption></figure></div>

Advanced settings can be accessed by clicking the **Advanced button** located in the [function button tray](#function-buttons). By editing these settings, you can:

* Change who owns the room floor
* Change or reset Region materials \*
* Change or reset Region lighting \*
* Enable or disable Region options \*
* Reset the Region as a whole

Please see our [Advanced window](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/the-region-editor-advanced-window) page for more information.

{% hint style="warning" %}
Some Advanced window settings, including swappable materials, are only available on certain [Breakroom Region templates](https://docs.breakroom.tech/building-new-worlds/region-template-descriptions).
{% endhint %}

### Object positioning and editing tools

<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%2FukhzfHsESs5OIFP8DRfQ%2FRegion_Editor_010.png?alt=media&#x26;token=ee40dd65-5c9d-463c-99ca-e2dc14e5e655" alt=""><figcaption></figcaption></figure></div>

The buttons in this tray are designed to help you move and manipulate the virtual objects that make up your Region. From left to right, here's a brief overview of what each button does. You can find more comprehensive information about these tools on our dedicated [object editing page](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/editing-and-moving-objects).

<table><thead><tr><th width="189">Button</th><th>Function</th></tr></thead><tbody><tr><td>Move</td><td>Activates the movement gizmo, allowing you to move an object. (You can also toggle this by pressing the <strong>Alt + W keys</strong> on your keyboard.)</td></tr><tr><td>Rotate</td><td>Activates the rotate gizmo, allowing you to rotate an object. (You can also toggle this by pressing the <strong>Alt + E keys</strong> on your keyboard.)</td></tr><tr><td>Scale</td><td>Activates the scale gizmo, allowing you to resize an object. (You can also toggle this by pressing the <strong>Alt + R keys</strong> on your keyboard.)</td></tr><tr><td>Node Mode</td><td>If <em>node mode</em> is activated and "snap nodes" have been installed in both a Region and an object, then objects will naturally snap into place when you move them.</td></tr><tr><td>Grid Mode</td><td>With <em>grid mode</em> activated, you can orient objects on a local grid.</td></tr><tr><td>Move Object to Camera</td><td>Moves the currently selected object to your camera position.</td></tr><tr><td>Local Mode / Global Mode Toggle</td><td>With <em>local mode</em> activated, objects can be moved relative to their own position and rotation. With <em>global mode</em> activated, objects can be moved relative to the Region itself.</td></tr><tr><td>Center / Mesh Pivot Toggle</td><td>With <em>center</em> <em>mode</em> activated, gizmos will appear within the object's bounding box (or at their "center of mass"). With <em>mesh pivot mode</em> activated, gizmos will appear at the object's pivot point.</td></tr><tr><td>Undo</td><td>Undo your last action.</td></tr><tr><td>Redo</td><td>Redo your last undone action.</td></tr><tr><td>Avatar Move</td><td>If enabled, this feature locks your avatar into place while you edit the Region. Disabling it gives you the freedom to move your avatar around the Region as you edit.</td></tr></tbody></table>

### Deleting, duplicating, and deselecting objects

<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%2FMnLYcjtlVWBRZ3VhkI4o%2FRegion_Editor_011.png?alt=media&#x26;token=1b0826fb-a82a-43d4-8b05-1c1783eb8d8d" alt=""><figcaption></figcaption></figure></div>

If you have no object selected, the buttons pictured above will not appear. Once you select an object, these buttons will give you the option to delete the object, duplicate it, or deselect all of your currently selected objects.

You can also delete a selected object by pressing the **Delete key** on your keyboard. You can duplicate a selected object by pressing **Ctrl + D.**

### Function buttons

<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%2Fy9zPbcn0NwyVrHsrPGW4%2FRegion_Editor_012.png?alt=media&#x26;token=f0f7e4f4-06be-4917-a9c5-b2690adc1bcd" alt=""><figcaption></figcaption></figure></div>

Finally, the Region Editor function buttons let you manage the windows described above and push your changes forward. From left to right, here's a brief overview of what each button does.&#x20;

<table><thead><tr><th width="159">Button</th><th>Function</th></tr></thead><tbody><tr><td>Inventory</td><td>Calls up the <a href="#the-inventory-window">Inventory window</a>.</td></tr><tr><td>Advanced</td><td>Calls up the <a href="#the-advanced-window">Advanced window</a>.</td></tr><tr><td>Objects</td><td>Calls up the <a href="#the-objects-window">Objects window</a>.</td></tr><tr><td>Terrain</td><td>Launches the Terrain editing window.</td></tr><tr><td>Sky</td><td>Launches the <a href="using-the-region-editor/editing-terrain-and-sky">Sky editing window</a>.</td></tr><tr><td>Floor menu</td><td>Allows you to select which <a href="#the-region-editor-ui">floor</a> items will be placed on. Set the drop-down menu to your desired floor, and any objects you set out will be "filed" under that floor in the Objects window.</td></tr><tr><td>Save</td><td>Saves your Region editing progress.</td></tr><tr><td>Close</td><td>Closes the Region Editor. You will be asked whether you want to save your changes.</td></tr></tbody></table>

<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%2FEVFTUH9fcEpNra7gqmGR%2FRegion_Editor_013.png?alt=media&#x26;token=57d34cfd-d348-4e01-b583-0d9af7212390" alt="" width="287"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="161">Button</th><th>Function</th></tr></thead><tbody><tr><td>Reset Zones</td><td>Resets all <a href="../running-your-event/understanding-the-conference-system/voice-zones-zone-types-and-conference-permissions">voice zones</a> (and related navigation UIs) in order to push forward any changes made in the Region Editor.</td></tr><tr><td>Visibility</td><td>Toggles voice zone/object collider visibility. Useful for when you want to edit the objects inside a voice zone without running into camera issues.</td></tr></tbody></table>