Meta Developers

Open your world in the Desktop Editor.
To create a Scripted Avatar NPC, navigate to Gizmos > NPC.
Click NPC. A new NPC is added into your world. When the Scripted Avatar NPC instance is added to your world, it may initially appear in a single flat color.
Position your Scripted Avatar NPC in the world.
1. Place the NPC gizmo on the ground of your world.
2. Do not locate Scripted Avatar NPCs above or below the surface of the world.
Navigate to the Properties panel. Next to the Appearance property, click Edit Avatar.
In the new web browser window, you can edit several features of your NPC.
When you have completed editing, select Done editing. For more information, see Edit Scripted Avatar NPC Appearance.
In the Desktop Editor, select the Scripted Avatar NPC. In the Properties panel, click the Refresh button.
Enter a new name for your NPC under Character name.
From the Toolbar menu, enter Preview mode. You may have to enter Preview mode twice to see updates to your Scripted Avatar NPC.
Your NPC’s avatar appears in the Desktop Editor. Your Scripted Avatar NPC in the world

Scripted Avatar NPC Properties

The following properties can be modified for the Scripted Avatar NPC.

Property	Description
Name	Name of the entity in the world. This value is displayed in the Hierarchy panel.
NPC Properties
Character name	The display name of the Scripted Avatar NPC in your world. This value is what players see.
Spawn on Start	When enabled, this Scripted Avatar NPC is spawned when the world is started.
Appearance	To change your NPC’s appearance, click Edit Avatar. To update your NPC’s appearance in the Desktop Editor from the currently saved version on the Avatar web editor, click Refresh. Note: Updates do not appear in the Desktop Editor until you click Refresh. See Edit Scripted Avatar NPC Appearance.
Attributes
Position	Coordinates for the position of the Scripted Avatar NPC in your world.
Rotation	Coordinates for the Scripted Avatar NPC’s rotation. Default is `(0,0,0)`.
Scale	Scale values for the NPC. Default is `(1,1,1)`. Note: Changing the scale values on the NPC entity may require changes to some of the properties on the Navigation Profile. For more information, see Build Navigation for Scripted Avatar NPCs.
Script
Attached Script	Select the script to attach to the Scripted Avatar NPC.

Duplicate Scripted Avatar NPC

To duplicate a Scripted Avatar NPC, right-click it in the Hierarchy panel and select Duplicate.

Note: Adding a Scripted Avatar NPC has the same performance impacts as adding another player.

Note: When a Scripted Avatar NPC is duplicated, the copy is a deep copy, meaning that the duplicate NPC has no connection to the original.

Note: If a script is attached to the source NPC, it is also referenced in the duplicate instance of the source.

Delete Scripted Avatar NPC

To delete a Scripted Avatar NPC, right-click the entity in the world or its entry in the Hierarchy panel and select Remove.

The Scripted Avatar NPC instance is removed from the world.

Create NPC Asset Template

When you have configured your Scripted Avatar NPC to your satisfaction, you may want to turn it into an asset template. Creating an asset template allows you to:

Share the same asset across multiple worlds
Modify the Scripted Avatar NPC and propagate those changes to all spawned instances.
Apply changes to NPC properties for spawned instances of the NPC asset template.

Note: In a non-File Backed Scripts world, creating an instance of an asset template creates a deep copy of any attached script. If you create 10 Scripted Avatar NPCs from an asset template in a non-FBS world, you must manage 10 independent scripts.

To create an asset template, right-click the Scripted Avatar NPC in the Hierarchy panel. Select Create Asset.

Tip: When you modify the appearance of an NPC that is based on an asset template, you can choose to apply those changes back to the template. Select Apply Overrides in the Properties panel to apply changes back to the template. Other instances that consume the asset template update receive your updates, even if they are in a different world.

To break the link between an asset instance and its template, right-click the Scripted Avatar NPC in the Hierarchy panel and select Unlink instance root.

For more information, see Asset Templates.

Publish World

You can publish your world as normal.

Note: After you publish your world, subsequent changes to your Scripted Avatar NPCs do not affect the published world. To apply changes to the published world, you must publish again.

For more information, see Publish Your World.