Actors – Ylands

Overview

Unlike Entities, Actors can use AI Behaviour to seem alive. There are 4 categories of Actors:

• NPCs
• Animals
• Mutants
• Monsters

Properties

• Like Entities, Actors have Position, Rotation, HP, and Interactions. They can be placed in a Group. Like Unique Entities, Actors can have Placed Particles.
• Unlike Entities, they cannot have a Stack Value, cannot be set to Pickable, cannot be set as Animated, nor put in a Weld. All Actors can have AI Behaviour. They can have a Description which appears below the Actor's name and a Health Bar or Text above their heads.
• Animals, Mutants, and Monsters have Color, Damage and Resistances sections. The drops for these can be removed by unchecking "Destroyed Entities in World Drop Items" in the Game Settings.
• Animals and Mutants can be Domesticated and their Default Domestication Level can be set.
• Only NPCs can have an editable Appearance, Equipment and Inventory. There is also an option to Drop Items on Death. Their Default Interaction is Trading unless it is removed using scripting or overwritten with a custom interaction.

Related Game Logic

• AI Behaviour

Actor Events

All actors have some unique Event Tiles:

• On Damage Received/On Do Damage
• On Kill/On Was Killed
• On Custom Interaction
• On Color Change
• On Color Revert

Animals, Mutants, and Monsters:

• On Attack

Animals and Mutants:

• On Feed Animal
• On Mount/On Dismount

NPCs:

• On Trade

Related Instructions

Most of the Script Tiles relating to entities (See the full list here) can be used on Actors, but there are some script tiles that are more relevant:

• Get AI Behaviour/Set AI Behaviour
• Get Health Bar Visibility/Set Health Bar Visibility

For Animals and Mutants:

• Domestication
• Animal Owner
• Character Controlled Entity

For NPCs:

• Get Character Inventory
• Get Character Equipment
• Can Character Trade
• Play Emote

Notes

• Although Actors cannot be animated or use script tiles related to animation, such as Aim or Follow, they can be moved and rotated with Set Position and Set Rotation or Transform Position and Transform Rotation.
• Set Position followed by Set AI Behaviour to Stand will usually make the NPC walk to the correct position and the other Actors will teleport to that position. If the AI is set to stand before the position is set, the Actor will teleport to the set position and then walk back to the original location they were when the AI behaviour was changed to Stand. This can be fixed by using a separate AI Behaviour Game Logic set to Stand.