One of the most fundamental entities within Foundry Virtual Tabletop is the Actor. Actors are the protagonists, allies, monsters, antagonists, and persons within the World that you create. The game System being used has control to define the exact types of actors which are relevant for it’s gameplay, but for most tabletop roleplaying systems these actors will represent the characters which the player Users impersonate and the foes they encounter.


Actor Creation and Configuration

To create a new Actor, visit the Actors Directory in the sidebar by clicking on the icon that looks like a group of people. At the bottom of this directory tab you can create a new Actor, or first create a Folder that you can use to organize many actors.

Actor configuration is handled through the Actor Sheet which is opened by left clicking on an Actor entry in the sidebar directory or by double-clicking on a token within a Scene. The Actor Sheet itself is usually a system-specific implementation, so the details of what can be configured at an Actor level will vary by game system.

Example Actor Sheet
An example Actor Sheet, taken from the implementation of the D&D 5th Edition game system.

Actor Permission Levels

Each Actor can have permissions configured at an individual User level. Actor permissions control which User or Users may see or edit that Actor, or impersonate it’s Token. To modify the permissions configured for an Actor, right-click on the Actor entry in the sidebar and select the Permissions option.

A single permission level may be assigned to all users at once, or individually user-by-user. A permission given to a specific User will override the level of permission given to all Users.

None

The User is not able to see the Actor in the sidebar, open its’ sheet, or control its’ Token. This is the default permission level.

Limited

The User is able to see the Actor entry in the sidebar, and observe limited (but not full) details regarding that Actor. Users with limited permission cannot control the Actor’s token.

Observer

The User is able to see the Actor’s entry in the sidebar directory and open it’s character sheet. The User is also able to see through the Token’s perspective on the active Scene, but not control that Token.

Owner

The User has full control over the actor and can open and edit their Actor sheet as well as control and see from the perspective of their Token.


Prototype Token

The Prototype Token Configuration sheet controls and customizes how an Actor is represented within a Scene. Each Actor has a default (prototype) token configuration which defines a template for that Token when it is placed. Once a Token is actually placed, it is an independent copy which can be configured differently from the Actor’s prototype.

To modify the default token configuration for an Actor, you may either:

  1. Click the Configure Token button in the header of an Actor sheet.
  2. Edit the configuration for an existing Token and, while having that configured token selected, click Assign Token in the header of the Actor sheet.

To modify a Token which has already been placed within the Scene, double right-click the token to access the Token Configuration menu.

For more information on configuring Tokens, please refer to the Tokens article.


API References

To interact with Actors programmatically, consider using the following API concepts: