Integration

Customizer Guide

The Ava-Twin customizer is a web-based avatar UI that your players use to choose and personalize their in-game character. The Unity SDK connects everything automatically — no extra integration work required.

What the Customizer Is

The customizer is a polished, web-based interface players open from inside your game. They browse a library of avatars, personalize their look, preview the result in 3D, and save their choice. Once saved, the avatar is immediately available in your game — the Unity SDK loads it automatically.

Browse avatars

Scroll through a curated library of base characters and styles.

Customize appearance

Change hair, skin tone, outfit, and accessories in real time.

3D preview

Rotate and inspect the character in full 3D before committing.

Save and use

One click saves the choice and returns the avatar to your game.

Unity SDK Integration

With the Unity SDK, opening the customizer and loading the player's avatar is a single call. The SDK takes care of everything in between.

Load the player's avatar

using AvaTwin;

public class MyGame : MonoBehaviour
{
    async void Start()
    {
        var result = await SDK.OpenCustomizerAsync();

        // Avatar is ready — position it, enable controls, etc.
        Debug.Log("Avatar loaded: " + result.Root.name);
    }
}

The SDK uses an async/await pattern. Call SDK.OpenCustomizerAsync() and await the result — the returned AvatarResult gives you direct access to the loaded avatar once the player saves their choice.

Platform behavior: WebGL uses an iframe overlay. Mobile uses a native UI. In the Unity Editor, a random avatar auto-loads for testing.

See the Unity SDK Reference for the full setup guide and API surface.

Customizer Defaults

Defaults set the initial appearance for new players. Once a player saves their avatar, their saved choice takes priority on subsequent visits. Use defaults to match your game's art style — for example, the default outfit, hair color, or skin tone.

Configure defaults from your dashboard: open your app and scroll to the Customizer Playground section. Changes apply immediately — no SDK update or redeployment needed.

Where to find it

Log in to the Ava-Twin console, open your app, and go to Customizer Playground. Pick your defaults from the visual editor and save.

What Your Plan Unlocks

Your plan determines usage limits and which customizer features are available.

MAU limits (all plans)

Free: 50 monthly active users. Pro: 500. Business: 10,000. MAU is tracked per unique player_id per calendar month.

App limits (all plans)

Free: 1 app. Pro: 5 apps. Business: 30 apps. Each app has its own API keys and customizer settings.

Custom default appearance (Pro+)

Customize the default avatar appearance (outfit, hair, skin tone) that new players see when opening the customizer.

Hide branding (Business+)

Remove the Ava-Twin branding and login panel from the customizer for a fully white-labeled experience.

See the pricing page for a full breakdown of what each plan includes.