Unity Plugin
ShapesXR Unity Integration Manual
The Unity plugin allows importing ShapesXR's spaces in Unity Editor. You can add interactivity, replace models, add a particle system, and so on.
It's not possible to export spaces back to ShapesXR.
Installation
Install the Unity
To install the Unity: Install Unity Hub from the official Unity Page (click the “Download Unity Hub” button). If you already have it installed - skip to the next step.
Create a project
Open the Unity Hub and click the arrow icon next to “New” button
Choose the “3D” template, set the project name and location, then click “Create”
4. Import Shapes Unity Integration Package
Once Unity opens, go to Window -> TextMeshPro -> Import TMP Essential Resources
Click Import in the opened window
It is recommended (but not mandatory) to set the Linear color space to make sure that imported colors are correct. To do so go to Edit -> Project Settings -> Player -> Other Settings and set Color Space to Linear. If you need the Gamma color space you can skip this step.
Go to Assets -> Import Package -> Custom Package and select the ShapesXR Unity Integration package you’ve downloaded
Click “Import” in the next window
Usage
To import your space you have to open the importer window by going to ShapesXR -> Importer. You can dock this window wherever you want (e.g. next to Inspector tab)
In the importer window put your access code (8 characters) into the input field and click the “Import Space” button. Access is not case sensitive.
After the space is imported, you will see a new gameobject on the scene representing your space
You can also expand the “Settings” panel in the importer window to change the imported data storage directory, material import mode and the material mapper. Material mapper allows you to use your custom shaders instead of the built-in ones. Open any material mapper asset in the inspector to see how you can map your own materials if needed. Built-In and URP material mappers are included in the package by default.
Space gameobject has all the stages and viewpoints inside it. It also has a “Space Descriptor” script that allows you to see the access code, quickly cycle through stages, and reimport (with complete wipe) your space. You can safely remove this component in case you don’t need this functionality.
It’s still possible to use the plugin in Unity 2020 with .Net 4.x compatibility enabled in player settings.
GLB/GLTF formats support
Please note that we don’t support multiple texture per material as of yet and your models must comply with import recommendations for best results.
You can import GLB/GLTF models from your space to Unity.
In order to import them in Unity you need to install a GLB/GLTF plugin. We recommend glTFast (GitHub - atteneder/glTFast: Efficient glTF 3D import / export package for Unity)
In case you’re using another plugin, you should add a name for shader property for your main texture, since every plugin might generate and use different materials/shaders.
Tutorial: Unity Plugin for ShapesXR
Last updated
