SideXP - Scene Refs (Unity)¶

One of the historical flaws of Unity is that SceneAsset, the type that represents the actual asset of a scene, is declared in UnityEditor, making this kind of asset available only in the editor.

Scene references assets (or SceneRef) fix this flaw, and allow you to use asset references instead of names or ids when it comes to load your scenes at runtime.

Features¶

SceneRef assets
Automatic processor to keep names, paths and ids of scenes in sync

Dependencies¶

🔗 Requires our Core library package

Installation¶

Option 1: Using the Package Manager¶

In your Unity project, go to Window > Package Management > Package Manager (or Window > Package Manager for Unity 6.0-)
Click on the + icon in the top-left corner, and select Install package from Git URL...
In the text field, enter the URL to this package's repository (including the *.git extensions), and click Install
Wait for Unity to get the files, and you're ready to go!

Tip: if you need to use a specific version of this package for your project, add #<tag-name> to the URL before clicking on the Install button.

Option 2: Extracting archive manually¶

Go to this project's /releases list
Download the ZIP file archive of your desired version
Extract the content of that archive into the Packages/ folder of your Unity project
Wait for Unity to reload the solution, and you're ready to go!

Tip: to avoid any path issue, make sure the folder that contains the package content has the same name as the name property defined in its package.json file.

Documentation & Help¶

If you need help or just want to chat with the community and the Sideways Experiments core team, you're welcome to join our Discord server!

Contributing¶

Do you want to get involved in our projects? Check our contributing guidelines to learn more!

License¶

This project is licensed under the MIT License.

Crafted and maintained with love by Sideways Experiments