ADVANCED - Uploading your own room items

If you have a specific design vision for your Breakroom world, you may want to upload your own furniture, animations, and avatars through Unity. Learn how to import and edit room items here.

Overview

A room item is any item that is not a full region. Common room items include chairs and other furniture items, but you might also choose to create and upload a special decor item, an avatar animation, or a 3D model (such as your company logo). Once these items are uploaded to your world, you can deploy them through the use of the Room Editor and other means.

Below you will find instructions for uploading a room item. You may also find it useful to consult our instructions on uploading clothing items and uploading custom regions.

In order to upload custom regions and items, your Breakroom subscription must include a Developer seat. To upgrade your subscription plan, please reach out to our Sales Team.

In order to follow the steps outlined below, you must already have Unity and the Sinespace SDK installed. See here for instructions.

Import or create your room item in Unity

Merging items in Unity

Here we have created a simple sculpture -- a globe on top of a cube.

As an example object, we will take the globe sculpture pictured above. It consists of two items -- a sphere placed on top of a cube. To merge these two items into a single item and upload it to your world, first right click on an empty area in the Hierarchy and select the Create Empty option. Rename this object to something meaningful -- for example, "My First Object."

Now drag the cube and the sphere into My First Object.

The original sphere and cube items, now merged under "My First Object."

Turning your item into a virtual good

The Sinespace drop-down menu, with the Virtual Goods section expanded.

Click on My First Object, then go to the Sinespace drop-down menu. Expand it, and select Virtual Goods > Turn selection into furniture. Doing this will convert your object into a virtual good that can be uploaded to your world. You do not need to alter the Room Furniture component that was just added.

"My First Object," with the VirtualGood and RoomFurniture components added.

Editing the Virtual Good options

Scroll down to the Virtual Good component, where you will see a number of tabs and fields. You will need to change the options under most of these tabs.

The Basic tab

First, fill in the required information under the Basic tab. You must specify the item's category, name, description, and brand name. This would normally be the name of your company.

The Virtual Good component, with the Basic tab active.

The Detail tab

Next, click on the Detail tab. The settings listed under this tab are optional, and usually can be left in their default state -- except for the Inworld Customization setting. You will need to set this to "Full."

The Inworld Customization setting, under the Detail tab. This must be set to "Full."

The Pricing tab

Now click the Pricing tab. Check the box to enable the Not for Sale option.

The Pricing tab, with the "Not for Sale" option checked.

The Icons tab

You can skip the Icons tab, as this is only used if the item will be sold in the in-world shop.

The Author tab

Click the Author tab. Fill in the details that best suit your upload. If in doubt, leave the item's Unique Status as "Available Elsewhere," edit the Developer's Name field to include your name (as the world owner), and edit the Copyright field to include your company name.

The Author tab, where you can specify creation details about your item.

The Upload tab

Lastly, click the Upload tab. In the Grid field, add your Breakroom world's unique grid number.

The Upload tab, with the Grid field highlighted.

Converting your item to a Unity prefab

Create a new folder in your Unity project. Call it "Uploads," and double-click into this new folder.

How to create a new folder in your Unity project.

Now drag the parent object from the Hierarchy to the "Uploads" folder in the Project window.

Dragging the parent object from the Hierarchy into the "Uploads" folder.

Next, right click on this new prefab object and select the Upload to Sinespace option.

Finally, confirm the upload.

Confirm the upload by clicking the "Upload Item" button.

You will be asked to save the scene before the upload can proceed. We do recommend saving, as you may have other items in the scene and this will make editing the item easier in the future.

More Information

As next steps, you'll want to test your item on the preview server and then push it to the live server. You can find instructions for doing both at the links below.