Studio's Importer lets you import 3D assets into your projects, such as avatar clothing, accessories, and character bodies. The following instructions provide guidance on how to import a full character model into Studio as a Model object that you can save to use in your game, share with others, or upload to the Marketplace.
If you are using a single-mesh character body for the Roblox Auto-Setup tool, see Avatar auto-setup.
While the 3D Importer provides object previews and error-checking to ensure that your asset meets Roblox's general 3D requirements, it's important to ensure that your character model meets Roblox's avatar character specifications to use or sell this asset as an avatar-ready character model, otherwise you can encounter errors at different points in the workflow.
To import your asset as a character model:
In the Home tab, click the Import button to open the 3D Importer. A file browser opens.
Select your rigged character's .fbx or .gltf file. The 3D Importer loads a preview of the character model.
- If textures don't load for your asset, you can manually import your textures later.
- For additional information on import settings and troubleshooting, see 3D importer.
In the Rig General section,
- Set Rig Scale to the appropriate Body Scale of your character.
- Set Constraint Type to Joint Upgrade.
Select Import. The asset populates in your workspace as a Model with the appropriate textures applied as a SurfaceAppearance or MeshPart.TextureID.
If textures didn't load correctly, add them manually. You may need to save and publish your game in order to access the Asset Manager.
In the Asset Manager, click the Import button.
Upload your image files.
If you are using a single basic texture, set the MeshPart.TextureID property to your uploaded texture image.
If you are using PBR textures:
Add a SurfaceAppearance child to your MeshPart.
In the SurfaceAppearance properties, click each property value and assign the appropriate texture image from the asset dropdown:
- Set the ColorMap to the _ALB texture image.
- Set the MetalnessMap to the _MTL texture image.
- Set the NormalMap to the _NOR texture image.
- Set the RoughnessMap to the _RGH texture image.
After successful import, your model object should populate in your project as a Model with the appropriate textures applied.
After successful fitting and converting, your 3D model should populate in your project as an Model.
Character creation is a complex process that requires lots of testing and iteration. See Test characters for steps on importing your character model into a test place and verifying your avatar and related components.
With this new character Model, you can perform any of the following:
If your character includes a higher-fidelity rig, add a HumanoidRigDescription and/or DigitsRigDescription objects for Marketplace and animation requirements. You may need to use the Adaptive Animation plugin to remap your joints and set a baseline t-pose reference to better support your animations.
Begin the process of uploading and publishing the character model to the Marketplace. This involves some additional validation and moderation steps.
Use the model in your current game and modify the model's appearance with HumanoidDescription.
- Playtest as the character by renaming the Model to StarterCharacter and moving the Model to the StarterPlayer folder in the Explorer before play testing.
Save the model to your Toolbox or make it public on the Creator Store to share or use within any of your games.