Yahaha Assets Importer is a powerful plug-in that seamlessly imports prefabs and scenes from Unity into YAHAHA and binds them to your YAHAHA account. This plug-in enables you to import your Unity scenes to YAHAHA along with all of the assets and resources used in the scene, saving you time and effort and ensuring consistency between your Unity and Studio works.
In this tutorial, we will lead you through the main steps of importing scenes using Yahaha Assets Importer, including:
- Install Yahaha Assets Importer
- Prepare scenes
- Add and build scenes
- Import scenes
- Manage imported scenes
- Use imported scenes
YAHAHA Studio (Studio) does not support light maps. If you import a scene that includes light maps, they will not be rendered in Studio. This may result in the lighting appearing different or less realistic than it does in Unity. Additionally, if your scene uses a reflection probe, it's recommended to choose the Realtime type for optimal results in Studio.
Make sure that you have Unity version 2020.3.1 to 2020.3.31 installed, with 2020.3.30 being the recommended version. You can download the required version from the Unity download archive page or the LTS Release page.
All build platforms including Windows, macOS, Android, and iOS are installed. If you haven't installed them all, do so on the LTS Release page.
To avoid unwanted changes, it's best practice to create a new Unity project for exporting scenes.
The following dependencies need to be added to your Unity packages in either of the following ways: Open Package Manager and install these packages:
- Editor Coroutines from Unity Registry
- Universal RP from Unity Registry
- Newtonsoft Json from git URL (com.unity.nuget.newtonsoft-json) For more about the installation process, see Add from registry and Add from git URL.
Go to Project, right-click Packages, and find the file path. Then add the following dependencies to the file named manifest.json and save it:
- "com.unity.editorcoroutines": "1.0.0"
- "com.unity.nuget.newtonsoft-json": "3.0.2"
- "com.unity.render-pipelines.universal": "10.8.1"
Install Yahaha Assets Importer¶
Import Yahaha Assets Importer to Unity. For details on importing, see Import Package.
Before importing scenes into Studio, add the defaultRespawnPoint prefab to all scenes that you want to export from Unity.
Add and build scenes¶
Open Yahaha Assets Importer by choosing Yahaha Plugin>Import scene in the top menu.
Log in to Yahaha Assets Importer with your YAHAHA account.
On the Build Scenes tab choose + to add scenes.
All of your Unity scenes are displayed as a list. Select the scenes you want to import to Studio and click Add to confirm.
Then select the scenes to build and choose Build All to start building. While scenes are being built, no actions are allowed. After building them successfully, continue to import them.
In our example, we import one scene only. Choose the Import Scenes tab, select the scene, then click Import.
Manage imported prefabs¶
You can view and delete imported scenes on the Imported Scenes tab. To delete an imported scene, select or hover over it before clicking the Delete button. When you delete an imported scene, it will be automatically removed from YAHAHA as well.
Use imported scenes¶
To work on your imported scenes, open YAHAHA Desktop (Desktop) and go to the Projects tab. These scenes are now referred to as 'Projects'. Once you enter a Project, you can start working on it without affecting the original Unity scenes. However, if you make any changes to the Unity scenes and want to sync them to YAHAHA, you'll need to rebuild and re-import them using the Yahaha Asset Importer. This will create two separate scenes in Desktop.