# Region Editor best practices

{% embed url="<https://youtu.be/YUBB-Gwc-pM?feature=shared>" %}

## Using the desktop app <a href="#using-the-desktop-app" id="using-the-desktop-app"></a>

For the best possible experience when positioning objects in your Regions, we recommend using the Breakroom [desktop viewer](https://docs.breakroom.tech/opening-the-doors/desktop-viewers). You *can* use Region Editor with [World Stream](https://docs.breakroom.tech/opening-the-doors/world-stream)—the functionality is the same. However, the desktop viewer offers faster feedback and is slightly smoother to use.

## Positioning your camera <a href="#positioning-your-camera" id="positioning-your-camera"></a>

### Region Editor avatar and camera commands <a href="#region-editor-avatar-and-camera-commands" id="region-editor-avatar-and-camera-commands"></a>

While using the Region Editor, you will most likely want to focus your camera on a particular object or area. When you open Region Editor, the camera will be in *object mode* by default. To instantly focus your camera on a particular object, **click on the item** in your [Objects window](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor#the-objects-window), then move your cursor to a scene area and press the **F key**.

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FsGheuwN0ljyBRbAlCRXb%2FRe_Best_001.png?alt=media&#x26;token=b59a9a1c-8326-4b47-aeae-f43d33cce32e" alt=""><figcaption><p>Highlighted: The location of the Avatar Move button.</p></figcaption></figure>

Alternatively, you can click the [**Avatar Move button**](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor#object-positioning-and-editing-tools) to switch to *avatar mode*. This gives you the ability to move your avatar through the Region while you work, with the camera following you. Click the button again to lock your avatar into place.

### Fly cam <a href="#fly-cam" id="fly-cam"></a>

Fly cam is another useful way to explore your surroundings. To enable it, hold down your **right mouse button (RMB)**. You can then use the **A and D keys** to pan from side, the **R and C keys** to pan up and down, and the **W and S keys** to zoom in and out. You can also orbit items in this mode by moving your mouse. The camera can be returned to its original, avatar-locked position by pressing the **Esc key** twice.

### Latch cam <a href="#latch-cam" id="latch-cam"></a>

Latch cam allows you to choose a specific object as your current focus point. You can then move the camera around it using the commands detailed above. To "latch" your camera onto an object, hold down the **Alt key** and click on the object with your **right mouse button (RMB)**.

## Undo and Redo buttons <a href="#undo-and-redo-buttons" id="undo-and-redo-buttons"></a>

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FzJqdT4CTqTSJHLpadJoq%2FRe_Best_002.png?alt=media&#x26;token=4618a585-8ac8-4d86-be1f-d1da5e58b40f" alt=""><figcaption><p>Highlighted: The location of the Undo and Redo buttons.</p></figcaption></figure>

The Undo and Redo buttons in the Region Editor are comparable to the undo and redo buttons in a graphics editing application, and are designed to allow you to skip forwards and backwards in time for the current editing session. You can use the Undo button to correct mistakes in the moment—for example, if you rotate an object and decide you don't like how it looks, click the **Undo button** to restore it to its previous position. You can also undo your last step by pressing **Ctrl + Z** on your keyboard.

## Selecting and editing multiple objects <a href="#selecting-and-editing-multiple-objects" id="selecting-and-editing-multiple-objects"></a>

To select items within a Region for editing, you can either click on the item itself or click on its name in the [Objects window](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor#the-objects-window). To select multiple items at the same time, hold down the **Ctrl key** on your keyboard and click the items or item names you wish to edit.&#x20;

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FRtMvKvgGEmtb52UnChu1%2FRe_Best_003.png?alt=media&#x26;token=1e55f201-a03b-4f23-ae24-53f7e5d6e1fa" alt="" width="330"><figcaption><p>Pictured: Two items selected at the same time by holding down the Ctrl key.</p></figcaption></figure>

When two or more items are selected at once, you can edit their position as a group using the [Region Editor gizmos](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor/editing-and-moving-objects). They will move, rotate, and scale together.

You can also bulk-select items using the Objects window. To do so, **click the first item** in the series you would like to select. Then, while holding down the **Shift key**, c**lick the last item** in the series. This will highlight all of the objects at once.

## Changing object Display Names <a href="#changing-object-display-names" id="changing-object-display-names"></a>

If you add multiple copies of any object to your Region, you will notice that every copy is identified by the same *Display Name* in the [Objects window](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor#the-objects-window). By entering more descriptive object Display Names, you can make it easier to keep track of your items and locate them when needed.

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FaBxCk3n6Bdo0zkdNILmV%2FRe_Best_004.png?alt=media&#x26;token=9eedd65c-8807-456d-80ea-2c9f01d51dbf" alt=""><figcaption><p>Pictured: A Region that contains three copies of the same item (Stretch Statue #1). The Display Name for one of these objects has been changed. By changing an object's Display Name, you can more efficiently locate and identify items.</p></figcaption></figure>

To change the Display Name of an object, follow the steps below.

1. Open the [Region Editor](https://docs.breakroom.tech/customization/using-the-region-editor) by clicking the **Edit Region button** located in the [bottom toolbar](https://docs.breakroom.tech/getting-started/ui-tour#the-bottom-toolbar).
2. Click the **Objects Button** to launch the [Objects window](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor#the-objects-window).
3. In the Objects window, locate the object you want to edit. (Tip: You can use the search field at the top of the window to search for a specific object.) Click on the **object name** to launch the Inspector window.
4. In the Inspector window, locate the **Display Name field**. Enter the **display name** you want to use.
5. Click the **Save button** to store your changes, and the **Close button** to exit the Region Editor.

{% hint style="warning" %}
You cannot change the Display Name of breakout area, voice zone, and voice zone furniture objects.
{% endhint %}

## Changing Region templates <a href="#changing-region-templates" id="changing-region-templates"></a>

You can switch to another Region template from within the Region Editor. To do so, follow the instructions below.

1. Navigate to the Region you want to change.
2. Open the [Region Editor](https://docs.breakroom.tech/customization/using-the-region-editor) by clicking the **Edit Region button** located in the [bottom toolbar](https://docs.breakroom.tech/getting-started/ui-tour#the-bottom-toolbar).
3. Click the **Inventory button** to open the [Inventory window](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor#the-inventory-window).
4. Along the left side of the Inventory window, you will see several category tabs. Click on the **Region category.**
5. Click on the **Region template item** that you would like to use.
6. Confirm the change by clicking the **Swap Template button**.
7. Click the **Save button** to store your changes, and the **Close button** to exit the Region Editor.

{% hint style="danger" %}
When switching Region templates, all furniture objects you have set down and any custom changes you have made to the original Region will be erased. These lost changes cannot be recovered, so please consider this step carefully.
{% endhint %}

## Giving Region editing permissions to other users

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FkY23F3EMM1dGEX1ugKWX%2FUI_tour_004.png?alt=media&#x26;token=df0fedf9-19c1-4de3-977c-624864a7f45b" alt=""><figcaption><p>Pictured: The mini map.</p></figcaption></figure>

By making another user a [Region Administrator](https://docs.breakroom.tech/opening-the-doors/creating-and-managing-user-accounts/region-level-user-permissions#administrator), you can grant limited in-world editing permissions. Region Administrators can access the [Region Editor](https://docs.breakroom.tech/creating-custom-experiences/using-the-region-editor) for their assigned Region, as well as the [moderator tools](https://docs.breakroom.tech/running-your-event/moderator-tools) and the [Region Information window](https://docs.breakroom.tech/building-new-worlds/region-settings). However, they will not be able to log in to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).

Alternatively, you can appoint a [Region Developer](https://docs.breakroom.tech/opening-the-doors/creating-and-managing-user-accounts/region-level-user-permissions#developer) for any Region that you own. Region Developers have access to the Region Editor, and can decorate and modify the Region to which they are assigned. They do not occupy a [Developer seat](https://docs.breakroom.tech/opening-the-doors/seats-and-concurrency), and cannot upload content to your World.

To grant these advanced [Region-level permissions](https://docs.breakroom.tech/opening-the-doors/creating-and-managing-user-accounts/region-level-user-permissions), follow the steps below.

1. Click on the [**Region Information button**](https://docs.breakroom.tech/building-new-worlds/region-settings) located above the [mini map](https://docs.breakroom.tech/getting-started/ui-tour#the-mini-map). This will open the Region Information window.
2. Click on the **Members tab**, and then the **Add Members button**. This will open the "Add new members" dialog box.
3. Use the **search field** to search for the user's name. When you find it, click the **Add button**.
4. Once the user is added to the Region members list, check the **box** next to their name and then click on the **Set Role drop-down menu**. From this menu, select the permissions level you'd like to assign the user.

To revoke advanced Region-level permissions, follow steps 1-4 above, and select either the *Member* or *Guest* role. If you prefer, you can also [remove](https://docs.breakroom.tech/opening-the-doors/creating-and-managing-user-accounts/region-level-user-permissions#removing-region-members) the user from the members list entirely.

{% hint style="warning" %}
You should only assign Administrator or Developer status to trusted individuals who understand how to use the Breakroom tools. Changes made in the Region Editor may not be easy to revert.
{% endhint %}