7 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

NPC kit

Note

The content of this project and documentation can be used under Roblox's Limited Use License.

NPCs (non-player characters) can add a lot of depth to a game. All of the following NPCs can be visually customized, their behavior modified, and the zombie/soldiers can even defend an area by attacking players or other characters using a tag system to set behavior.

To use an NPC in your game:

1. Select one of the following NPC kits:

   

Drooling Zombie

Soldiers

RO-01 Robots

NP-C 9000 Robots

2. On the NPC's item page, click the green Get button and confirm the transaction.

3. In Studio, open the Toolbox.

4. Select your toolbox Inventory section.

   

5. Locate the NPC and click it to add it into the place.

Character structure

Each NPC model typically contains the following objects:

Note

Square brackets [] refer to the object in general and the name doesn't matter. For example, [Model] refers to the weapon's Model and you can rename it to whatever makes sense.

Design notes

When using the NPC kit, keep in mind the following design notes:

• The visual appearance of an NPC can be customized by adding/modifying various [BodyParts] objects and by adding Accessory objects.

• The Soldiers, Drooling Zombie, and NP-C 9000 Robots use Rthro as the base of their rig. However, the RO-01 Robots use a modified Rthro base that adds thruster parts connected to the UpperTorso using WeldConstraints. Using simple joints in this way lets you include extra geometry for your characters without changing the original base rig.

• At a basic level, NPC animations can be customized by modifying the AnimationId of existing Animation objects within the Animate script poses, or those within the Animations folder. Such a change is essentially an asset swap - to change the finer details, you can create custom copies of existing animations, and to play animations under different conditions, you can edit the Animate or NPC scripts directly. For more information, see Animation.

Animate

The Animate Script in the NPC Model handles animation related configurations and contains the following objects:

BodyParts

The BodyPart BasePart in the NPC Model represent the various character body parts and contains the following objects:

Configuration

Each NPC includes a Configuration object within its hierarchy which acts as a container of value objects. These are used by the NPC script to tune various behaviors. Unless otherwise specified, these apply to all of the characters.

Assign tags

The NPC script uses CollectionService tags to manage aggression toward other characters and players. Various tags from the following table can be assigned as follows:

• To assign tag(s) to another NPC, assign them to the NPC's top-level Model using the Tags section of its properties.

• To assign a tag to a Player character, you can add a Script to StarterCharacterScripts with a CollectionService:AddTag() call. For example:

  local CollectionService = game:GetService("CollectionService")
  
  CollectionService:AddTag(script.Parent, "SoldierEnemy")