Skip to main content

AR Game Controller

The AR Game Controller template is a customizable foundation for building interactive AR experiences. It includes a script component that controls both the UI and 3D character assets, all managed through a parent node for easy organization. Simply swap in your own assets to personalize and create your own unique AR game.

demo

Open the Template

To use this template in your Effect House project:

  1. Go to Templates
  2. Select the AR Game Controller template
open template

Hierarchy

The Hierarchy panel consists of the following render groups:

  • AR Tracking contains AR camera, AR plane, character, and scene lighting
  • 2D Foreground contains the 2D camera and UI controls
open template

Customize the Template

You can customize this template by swapping out the assets with some of your own!

tip

Follow the steps below to recreate the effect, or download the completed project file to see the final setup.
Project file: ARGameController.zip

Import Assets

First, let's import your images into the Assets panel.

To import your own assets:

  1. Go to the Assets panel
  2. Click the Add asset button [+]
  3. Go to Import and click From Computer
import assets
  1. Select your images and click Open
tip

To add multiple images at the same time, Command + click (Mac) or Control + click (Windows) onto the images you'd like to select before clicking Open. You can also simply drag the images directly from your computer folder into the Assets panel.

import assets demo

Swap Assets

Now that your images are imported, you can now swap them out in the ARGameCharacterController component.

To swap the assets:

  1. Go to the Hierarchy panel
  2. Click AR Plane
swap assets
  1. Drag your new assets into the AR Plane section of the Hierarchy panel
drag assets
tip

To make previewing your effect easier, you can temporarily hide assets in the Hierarchy panel by unchecking the box next to them. uncheck assets

Assign Character Components

Next, we'll assign the corresponding Character Object and Character Animator Object:

  1. Go to the Inspector panel
  2. Go to ARCharacterController
assign character components
  1. Click on Character Object and Character Animator Object
  2. Choose your new assets
  3. Click Ok
assign character components demo

Animation Order

The Animation component should follow the same sequence of animations:

  1. Idle
  2. Walk
  3. Run
  4. Action 1
  5. Action 2
animation order

Adjust UI Assets

Replace or adjust UI elements as needed to match your new assets.

adjust UI assets

The AR Game Controller template is now updated with your new creation!

adjust UI assets

Asset Preparation Recommendations

Before importing your assets, follow the guidelines below to help ensure optimal performance and efficient file sizes.

Export Assets as Prefabs

Export assets as a Prefab from a separate Effect House project before importing them into your main project. This helps keep projects organized and avoids unnecessary dependencies.

Maintain Efficient Asset Sizes

Keep individual assets within the 3 MB to 4 MB range to help keep the overall effect size optimized.

asset size

Use Opacity Maps for Transparency

When creating transparent materials, use Opacity maps instead of PNG transparency. This helps reduce file size and improves rendering performance.

Use JPG Textures for Most Materials

Texture assets should be exported as JPEG or JPG files whenever possible to help reduce the final package size.

use jpeg textures 1   use jpeg textures 2

Use PNG for Normal Maps

Normal map textures should be exported as PNG files to avoid visual artifacts and preserve detail.

use png for normal maps 1   use png for normal maps 2

Optimize Animation Curve

If you notice discrepancies between exported and imported animations, try disabling Optimize Animation Curve before exporting.

optimize animation curve
Copyright © 2026 TikTok. All rights reserved.
About TikTokHelp CenterCareersContactLegalTerms of ServicePrivacy PolicyCookies