Skip to content

Model Importer

YAHAHA Studio allows you to import 3D models, opening up a whole new range of possibilities for game development. While this feature is still in its alpha testing phase, we are excited to showcase how to import a 3D model into Studio in this tutorial.

Prepare a 3D model

Prepare a 3D model in the Filmbox (FBX) format that you want to import to Studio. Your model can consist of static meshes or include skeleton data with animations. However, you need to make sure it meets the model requirements.

Upload your model to Studio

Once your 3D model is ready, upload it to Studio:

  1. In Studio, choose My Resource>Uploaded models>Upload.


  2. Select the FBX file to import and click Open. An Importing files window will open to show upload statistics.

  3. Troubleshoot any import errors.

  4. After importing the FBX file, click it again to add it to the scene.

  5. Optional: If your model includes animations, an Animation pane containing information about the imported animation will appear in the Properties window. Verify the animation preview.


  6. In the menu_button menu, click Save to save the scene and start Cloud Build.


    Saving the scene only takes a few seconds, but publishing it to Asset Library requires you to wait until Cloud Build is finished, which usually takes less than 20 minutes. The duration, however, may vary depending on the server workload at the time.

Note that Cloud Build is a powerful YAHAHA service that automates the compilation, building, and packaging of imported assets. Once Cloud Build is complete, you can access the imported assets across devices using your Studio account; you can also publish these assets or the whole game to Asset Library to reach a wider audience.


If there are any issues with model imports in Studio, an error message will appear to alert you. The following table lists the error messages you might receive and their meanings:

Message Meaning
File not found Check whether the file exists.
Invalid format Only the FBX format is supported.
Failed to read file The FBX file is invalid.
File too large Maximum file size: 20 MB.
Upload failed Check the network connection status.
File is empty An empty file cannot be imported.
Failed to collect asset info -
Cache not found -
Failed to load Try again later.
Failed to create container -
Uploaded mesh count exceeded the allowed limit (100). -
Uploaded triangle count exceeded the allowed limit (100000). -
No mesh files detected Check whether the mesh files exist.
Animations do not match with the generic rigged skeleton. -
Animations do not match with the humanoid rigged skeleton. -
No more animation clips allowed. Recommended animation clip count: 30. The number of imported animation clips reached or exceeded the recommended limit (30).


  • To animate your 3D model after importing, read Animating a model.
  • To edit the material of your 3D model after importing, read Materials.