Links

Creating and managing regions

Breakroom offers a wide selection of region templates, each designed to make event logistics a breeze. Learn how to create, enable, and manage multiple default landing and featured regions.

Overview

Breakroom's Region Customization options, available under the World Customization > Regions tab on Dashboard.
Making a region accessible to your users is a multi-step process. At its most basic, it consists of:
  1. 1.
    Creating a new region.
  2. 2.
    Enabling the region.
  3. 3.
    Featuring the region.
On this page you will find detailed instructions for accomplishing these tasks, as well as discussion of the various region management options available.

Creating and managing regions

Creating a new region

The Create Region panel.
To create a new region, follow the steps below.
  1. 1.
    Navigate to your Dashboard.
  2. 2.
    Click on the World Customization tab.
  3. 3.
    Click on the Regions tab.
  4. 4.
    Click the Create Region button located in the upper right corner. This will launch the Create Region panel.
  5. 5.
    In the Create Region panel, start by giving your region a name and a description.
  6. 6.
    Next, choose a region template. If you have uploaded any custom regions, you can find them by using the Template drop-down menu to show All Templates or Uploaded Templates. (Tip: You can also use the search bar to locate a region template by name.)
  7. 7.
    Finally, if you want to replace the loading image (which will be displayed in the Explore window and appear while users are teleporting to the region), you can do so by clicking the Browse button. This will launch a standard file import window. Find the image you want to use on your computer, click on it to select it, and then click the Open button.
  8. 8.
    When you are finished, scroll down and click the Create button.
It's important to note that new regions created through the Dashboard are not enabled or featured automatically, which means that users—including the world Owner—will not be able to find or access them in-world. You can learn more about enabling and featuring regions elsewhere in our documentation.
Breakroom supports JPG and PNG images. The recommended dimensions for loading images are 1920x1080, or a 2:1 ratio, with a maximum file size of 5MB.
Note: You can use the Dashboard to create multiple regions that use the same template. (For example, you can have multiple Conference or Desert Island regions.)
However, you cannot use the Dashboard to create a copy of an existing region setup. (For example, if you set out items for a birthday party in one Desert Island region, those items and details will not transfer should you then create a second Desert Island region.)

Editing a region

Highlighted: The Edit region action.
To make changes to a region after you have created it, follow these steps.
  1. 1.
    Navigate to your Dashboard.
  2. 2.
    Click on the World Customization tab.
  3. 3.
    Click on the Regions tab.
  4. 4.
    Locate the region you want to edit and click on the vertical ellipses icon next to the region's name.
  5. 5.
    In the action menu that appears, click Edit region. This will take you back to the Create Region panel.
  6. 6.
    Perform your desired changes. You can enter a new region name, edit the region description, upload a new loading image, or select a new region template.
  7. 7.
    When you are finished, click the Save button.
If you use the Edit region function to change a region's default template, all changes made to the previous template will be deleted and the new, blank template will replace them. Your deleted changes will be unrecoverable. Please think carefully before taking this step.

Deleting a region

Highlighted: The Remove action.
To delete a region after you have created it, follow these steps.
  1. 1.
    Navigate to your Dashboard.
  2. 2.
    Click on the World Customization tab.
  3. 3.
    Click on the Regions tab.
  4. 4.
    Locate the region you want to delete and click on the vertical ellipses icon next to the region's name.
  5. 5.
    In the action menu that appears, click Remove.
  6. 6.
    In the confirmation pop-up that appears, click Yes.
Note: Your default landing region is protected, and will not display the Remove action automatically. To delete it, you will first need to appoint another region as your replacement default landing region.

Locating region IDs

Each region in your world has a unique region ID. If you need to locate and copy this number, you can do so by following these steps.
  1. 1.
    Navigate to your Dashboard.
  2. 2.
    Click on the World Customization tab.
  3. 3.
    Click on the Regions tab.
  4. 4.
    Locate the region ID you need. This number is displayed below each region loading image.
  5. 5.
    To copy a region ID to your computer clipboard, click the copy icon located to the right of the number.

Enabled regions

When regions are first created, they are not automatically enabled. In order to access a region or open it to other users, you will first need to enable it through the Dashboard or the Breakroom viewer.
Once enabled, users can search for a region if they know it exists, but may not otherwise be able to easily discover it. This can prove useful—for example, if you want to set up private areas for VIP functions. If you want to make a region easier for users to find, you may want to feature it.
A freshly created region. Note how it is not enabled, featured, or set as the default landing area.

Enabling regions through the Dashboard

You can enable a region through the Dashboard by following these steps.
  1. 1.
    Navigate to your Dashboard.
  2. 2.
    Click on the World Customization tab.
  3. 3.
    Click on the Regions tab.
  4. 4.
    Locate the region you want to enable. In the upper right corner of the region loading image, you will see the "Enable Region" toggle.
  5. 5.
    Click this toggle to enable the region. You will see the region loading image display in full color to indicate that the region is enabled and accessible.

Enabling regions through the viewer

An example of how the Region List window may appear.
You can enable a region through the viewer by following these steps.
  1. 1.
    Click on the Regions button located in the bottom toolbar. This will launch the Region List window.
  2. 2.
    Locate the region you want to enable and click the Enable button. You will see the Enter button display in full color to indicate that the region is enabled and accessible.

Disabling regions through the Dashboard

To disable an enabled region through the Dashboard, follow these steps.
  1. 1.
    Navigate to your Dashboard.
  2. 2.
    Click on the World Customization tab.
  3. 3.
    Click on the Regions tab.
  4. 4.
    Find the region you want to disable. From here, you can either:
    1. 1.
      Click the toggle in the upper right corner.
    2. 2.
      Click on the vertical ellipses icon next to the region's name. In the action menu that appears, toggle the "Enable Region" option.
In both cases, you will see the region loading image desaturate and the "Enable Region" toggle return to gray. These visual cues indicate that the region is now disabled.

Disabling regions through the viewer

You can also disable a region through the viewer by following these steps.
  1. 1.
    Click on the Regions button located in the bottom toolbar. This will launch the Region List window.
  2. 2.
    Locate the region you want to disable and click the Disable button. You will see the Enter button display in gray to indicate that the region is disabled and inaccessible.
Note: The region allowance included with your subscription plan applies only to enabled regions. Disabled regions do not count against your region limit, and any custom changes you make to a region will be preserved if you disable it without deleting it. This gives you the ability to create, "store," and activate custom regions as necessary.