Asset Manager in Studio

Upload custom outfits in Studio and make them available in your apps.

Asset Manager in Ready Player Me Studio allows Ready Player Me partners to upload, validate, publish, and manage custom assets for avatars within the Studio dashboard in a self-serve manner.

Note: Uploaded assets will only be available in your applications.

Asset Manager is currently in the Open Beta stage. During this time, you might experience unexpected bugs. In such cases, please submit your feedback here: https://support.readyplayer.me/kb-tickets/new

Benefits

• Personalize the user experience by uploading custom assets.

• Validate custom assets automatically upon upload.

• Enable or disable custom assets in your applications.

• Can be used by anyone on the team. No coding skills required.

Features

• Model type

  • There are several different asset types that you can upload. Select the one you want to upload. Learn more about them in Create Custom Assets.

• Model upload

  • Only GLB (.glb) files are accepted.

  • File size: up to 10MB.

• Validation

  • Upon upload, your model is automatically validated to check the asset for errors.

• Model preview

  • Display of the uploaded model.

• Gender

  • Choose whether the uploaded asset is for masculine, feminine, or all (Neutral) avatar models. If you want to make the same asset available for both gender stereotypes, you need select Neutral. If Neutral is not available for a certain asset type, you'd need to upload a separate version for each gender stereotype.

• Preview icon

  • Upload an icon of your asset that will be displayed in the asset list of the avatar editor.

  • Max icon dimensions: 256x256 pixels.

  • You can use PNG files with transparency.

  • File size: up to 5MB. We recommend a small icon (< 1MB) to improve UI download speed for users.

• Assign to application

  • To make an asset available to users, assign it to one or more of your applications.

  • If you do not assign the asset to an application, you can save it, but it will not be available to your users.

• Edit uploaded assets

  • Saved custom assets can be edited by removing the current model or icon and uploading a different one.

  • Important: Editing existing assets will immediately affect users that use them. For example, if a user has your custom asset equipped, it will be changed once you edit it.

• Asset Manager overview

  • List of your uploaded assets. You can sort by status, gender, and last updated.

  • Search assets by name.

  • Filter by gender and app.

  • Active (checkmark) means the asset is available in one of your apps. Inactive (x) means the asset is saved but not assigned to an application.

• Deleting assets

  • You can delete assets after they have been unassigned from the application to fully remove them from Asset Manager.

Steps for uploading and managing custom assets

1. Go to Ready Player Me Studio and login.

2. In the side navigation, click Asset Manager.

3. Click Add new asset.

4. Fill in the information on the Add new asset screen, as described below.

• Asset name: Name of the asset.

• Gender: If your asset only fits the masculine or feminine templates, you need to select "Male" or "Female" respectively. If it fits both models, you need to select "Neutral" if available, otherwise you need to create an asset for each gender stereotype.

• Model: Upload a .glb file (< 10MB) of the custom assets.

• Preview icon: Upload a square-shaped icon (< 5MB, 256x256 max) that will be displayed as a preview of your assets in the avatar editor, as shown below.

• Applications: List of your applications. Check an application to make your asset available to users of this application.

  • If you don't select an application, the asset is saved, but it won't be available to users.

• Add or Save button: The new or edited asset is validated and saved.

  • If validation fails, you receive a notification, and a pink outline marks the asset preview. Below the asset preview (you may need to scroll), click Validation log to open a JSON file of your errors. See Error handling for details.

  • If validation is successful, you receive a “Validation successful” notification and the uploaded model preview is displayed.

Once you have saved your new asset, you are returned to the Asset Manager page.

Managing custom assets

The Asset Manager page lists your custom assets.

• Name and preview icon identify your asset.

• Active: Indicates whether the asset is assigned to an application. Active (checkmark) means the asset is available in one of your apps. Inactive (x) means the asset is saved but not assigned to an application.

• Gender: Asset fits male, female, or both ("neutral") models.

• Type: Type of the asset.

• Last updated: Date and time of the last changes.

To edit an asset, click its name.

Note: If you replace the model, it will go through validation again before you can save the asset.

Error handling

If asset validation fails, you receive a notification, and a pink outline marks the asset preview.

1. Below the asset preview (you may need to scroll), look for the Validation log button.

2. Click Validation log to see a summarized list of actionable items based on the errors.

3. Click Expand full .json log to see a JSON file of your errors in detail.

4. Click Copy log to copy the file contents to your clipboard.

5. Paste the contents into a text file and save it for further use.