Avatar Gallery

Avatar Gallery is a web hosting solution for avatars, allowing you to store, browse, mange and import avatars into your Unity projects.

This guide provides step-by-step instruction on how to setup an Avatar Gallery by uploading avatar models to a local website hosted using XAMPP.

Other hosting solution can be used (for local or remote hosting). Just modify the paths accordingly and ensure to have write access to the remote folder.

1 - Install and Configure XAMPP

Download and Install XAMPP from this link .
Setup the Avatar Gallery Directory:
- Copy the content of Package/AvatarReady/Tools/AvatarImporter/www
- Paste them into the XAMPP web location (htdocs folder)
Start XAMPP Apache server:
- Open XAMPP Control Panel
- Start the Apache server.

2 - Configure AvatarReady Settings in Unity

In the Unity Editor, go to: Edit > Project Settings > Avatar Ready Settings
Set Avatar Gallery link: http://localhost/Avatar
Enable HTTP requests in Unity, go to: Project Settings > Player > Other Settings, locate Allow downloads over HTTP and set it to allowed.

(The last step is required since Unity blocks non-HTTPS requests, if your hosting solution supports https requests this step should be skipped)

3 - Download an Avatar and Setup the folder structure

Download a RocketBox Avatar:
- Visit Microsoft RocketBox Github .
- Download the full repository or use an external tool to download a specific avatar folder.
Create the following folder structure in your Unity project: Assets/AvatarReady/Avatars/RocketBox/
Drag the desired avatar folder into the RocketBox folder.

4 - Configure the Avatar Importer Paths

Open AvatarReady > Avatar Importer
Set the Unzip Exe path to an unzip tool. Example for 7zip default install: C:/Program Files/7-Zip/7z.exe
Set the Server Upload Path: [XAMPP location]xampphtdocsAvatar

5 - Configure the Avatar Importer Configuration:

Set Avatars Configuration > Provider to RocketBox
Adjust the following settings Pipeline Configuration:
- Download Avatars: False
- Import Avatars / Create prefab: True
- Create Preview Image: True
- Import As Resources: False
- Build Avatars: True
- Upload Avatars: True
- Upload FBX: True
- Upload Metadata: True
- Upload Preview: True
Click on select Avatars to display available models. Select the model you added in step 3 and press Confirm.
Execute Pipeline

An Asset Bundle has been uploaded to the Avatar Gallery location, as well as a zip of the model, a preview image and a metadata file for the avatar. The avatar will now be available for download using Avatar Gallery.