UnitySDK
More actions
This is an official Resonite project. Report issues with it on GitHub
The Resonite Unity SDK is a tool designed to make it possible to use the Unity Editor to create Resonite items, avatars, and worlds and transfer them into Resonite directly. It is intended to make importing existing .unitypackage avatars and worlds made for other platforms easier for those already comfortable with the editor as well as providing another creation tool.
It uses ResoniteLink as the interface between the Unity SDK and Resonite's DataModel. This method allows scenes to be either imported with a press of a button or real-time as edits happen, allowing in world users to see the results. This also fully decouples Resonite from Unity allowing swapping out of the rendering engine at a later stage without breaking this tool.
Installation and Setup
The Resonite Unity SDK requires Unity 2022 or newer and a project in the Built In Rendering Pipeline.
For install guide see: https://learn.unity.com/tutorial/install-the-unity-hub-and-editor
Installing the Resonite Unity SDK package is as simple as dropping the ResoniteSDK.unitypackage file into the Assets pane in your project and choosing to import all files from the package.
Usage
Sending a scene from Unity is as simple as connecting to a Resonite session with ResoniteLink enabled, and pressing the Send Current Scene button.
Materials will only be sent to Resonite if they are a supported material. Currently only Standard and Unlit materials are fully supported. You may convert an object to use these by selecting all of the object’s materials and selecting either from the material editor dropdown.
An experimental Poiyomi converter is now included as of v0.0.8 and should be able to handle most basic uses of this shader.
Manual
Sending an avatar requires attaching a BipedAvatarDescriptor to your avatar’s root GameObject.
At this point most avatars should automatically have the references be filled in and placed in the correct locations, but it is very important to ensure that the head and hand references in the scene are correctly positioned on your avatar’s head and hands. They are visible in the scene as a yellow orb for the head, and blue and red hands for the left and right hand respectively.
After configuring the BipedAvatarDescriptor, pressing the Send Current Scene button will send the avatar into Resonite, ready to be equipped.
User Tutorials
Mostly a set of notes/steps, but might help some users: Tutorial:UnitySDK
Avatar Wizard
As of v0.0.8 there is now a Avatar Setup Wizard. See video bellow for usage.
Limitations
The SDK requires specifically made converters for Unity components and shaders, so not all components or shaders will translate correctly at present. You may contribute to creating these converters on the Github repository.
While ResoniteLink supports bidirectional traffic, this SDK doesn't support this mode for the moment. Once implemented, it will allow multiple people with the editor open to collaborate along with people in world. It also won't support transferring of meshes out of the game until implementation of Hard Permissions
Contributing
While being an official project, one of the goals for this SDK is to encourage community members to improve the importation and conversion, as such contributions towards workflow and conversion as well as other aspects are very welcome. See here for more details.
Tutorials
Flux showing how to import an avatar using the Avatar Setup Wizard.
Development
Frooxius documented the development of the SDK on his YouTube channel, it serves as a good overview.
The reference/test world below: https://go.resonite.com/record/U-Frooxius/R-019cdecf-e13a-7c9e-9dc0-eea0fe2f8108
Frooxius on the Future of Unity SDK after the switch to a non Unity Renderer