Skip to content
AEOWUN
Docs Menu

Hierarchy

Organize Actors and their scripts.

Organize your project

The Project Explorer shows the project's folders, Actors and scripts. Open it from View → Project Explorer.

Folders make larger projects easier to manage. Create folders for related gameplay objects such as doors, enemies or interactive props, then move the relevant Actors and scripts into them.

Work with Actors

Actors are project objects with their own identity, transform, attributes and optional Character package. Select an Actor in the Project Explorer to inspect its properties.

Use Select, Move, Rotate and Scale to work with selected objects in the viewport. The corresponding properties are available in the Inspector.

Use meaningful Actor names when scripts need to find objects by name.

Add scripts to Actors

Keep an Actor's related scripts in its hierarchy when you want the script to run in that Actor's context.

An Actor-attached module can access its parent:

const actor = self.parent
debug.log(actor.name)

For standalone gameplay systems, keep scripts in the project's Scripts area. Use Player Scripts for player-attached controller modules.

See Actors and Modules for the scripting workflow.

Find objects from a script

Use proj.find(name) for a matching project object or proj.find.all(name) when you want all matching objects.

const guard = proj.find("Guard")
const switches = proj.find.all("Switch")

Folder handles can also search within that folder and its descendants. See Finding Objects for examples.

Use the Project Explorer's search field to narrow the list of items. Select an object to focus on its properties, and return to the full hierarchy when you want to reorganize its contents.

Next: Characters, Editor workspace and Finding Objects.