Creating and uploading custom chairs

Overview

In order to offer your users a truly unique virtual experience, you may wish to create customized, functional chairs or other seating options that tie in with Breakroom's conference system. Please note that the instructions below presume a basic working knowledge of Unity, and that you must have Unity and the Breakroom SDK installed on your computer.

Creating an empty game object

In Unity, right click in the Hierarchy and create an empty parent game object. Change the transform and rotation values to 0/0/0 in the Inspector panel, and rename the object as required. We will use this empty game object as the "container" for Breakroom's Room Furniture and Virtual Good components, which we will install later in this tutorial.

Importing your chair model into Unity

There are two ways you can import the 3D model you want to use for your chair object into Unity.

1. Navigate to Assets > Import New Asset. This will launch a standard file import window. Select the 3D model file on your computer, and then click the Import Button.

2. Locate the 3D model file in Windows Explorer and click on it. Then drag the model file into Unity's Project Asset folder directly.

Both FBX and OBJ file types are supported. FBX is the preferred format.

Adding the chair model to the Hierarchy

Select the chair model file in the Project Asset folder, and drag it onto the empty parent game object in the Hierarchy. Make any needed changes to the position and rotation of the object, and then name the chair (see suggested naming conventions below).

While the chair model is still selected in the Hierarchy, click the Add Component button located at the bottom of the Inspector panel and add a mesh collider. We will use this further on in the tutorial.

Adding the Seat Position component

While your mouse cursor is positioned over the parent game object, right click and select the option to create a new empty game object. Name this object "Seat Position." We will use this object as a container for the Seat Position component, allowing us to move the seat animation independently from the chair model in order to make necessary adjustments.

Select the new Seat Position game object. In the Inspector panel, click the Add Component button near the bottom, and add the Seat Position component. You will notice a green rectangle appear over the chair model.

Adding animations to the chair

Animations can be imported into the Project Asset folder the same way you imported the chair model. After you import an animation file, ensure the animation is set to Humanoid animation type under the Rig tab. Drag the animation file into the Animation slot under the Seat Position component. You should now see a wireframe view of the animation appear within the green rectangle.

Once you add the animation, you may find that it forces your avatar through the chair, or otherwise needs to be adjusted. You can do this by selecting the Seat Position game object in the Hierarchy and moving it into the correct position using Unity's movement tools.

Making final adjustments

You can now make any final adjustments to the model or animation positions prior to uploading. The wireframe animation also serves as an excellent guide for adjusting the overall size of the chair model.

Adding the Room Furniture component

In order to upload the chair object to Breakroom, we will need to add the Room Furniture component. Select the parent game object in the Hierarchy, and then add the Room Furniture component by clicking the Add Component button located at the bottom of the Inspector panel. Breakroom requires that all chair objects be placed on the floor, so check the "Place on Floor" option under Placement.

Finally, select the chair model itself in the Hierarchy and drag it to the Main Collider slot. The chair model contains the mesh collider we installed earlier.

Adding the Virtual Good component

Next, we will add the Virtual Good component to the parent game object. This is the main settings component for the game object, and contains information such as the item's name, category, inventory image, etc.

Select the parent game object in the Hierarchy, and add the Virtual Good component by clicking the Add Component button located at the bottom of the Inspector panel. Pay close attention to the instructions in this component. A red warning icon indicates that required information is missing, while a yellow caution icon indicates that information is strongly advised, but not required.

For this tutorial, we will set the Type to Furniture, the Category to Furniture/Chair, and give the chair a name and description. We will also give it a brand name and author under the Author tab.

Prefab and upload

To complete your chair, you will need to drag the parent game object into the Project panel to create a prefab. You can then right click on that prefab and select Upload to Sinespace to upload the item.

Integrating custom chairs with the conference system

Useful information

Naming conventions

When integrating chairs into the conference system, Breakroom uses a nametag allow/ignore system. For ease of setup, we strongly advise that you institute and follow a simple naming convention. For example, a series of auditorium chairs might be named Auditorium_Chair 1, Auditorium_Chair 2, etc.

Multiple seat bundles

You can upload a group of seats/furniture as a single game object instead of uploading them individually. Just make sure that you follow a naming convention, as explained above.

Permitting in-world editing

You can permit furniture to be edited in-world by selecting Full from the Inworld Customization menu, which is located under the Details tab of the Virtual Good component.