Skip to main content

Actors and behaviors

You can read or modify actors in various ways using a script. There are a few different ways to get a variable representing an actor in a script:

  • my - a special variable that always represents the current actor
  • triggeringActor in onMessage
  • castle.createActor("Wall", 0, 0)
  • castle.closestActorWithTag("tag")
  • castle.actorsWithTag("tag")

Each of these returns an actor type. Here's an example of setting some behavior properties on different actors:

This is the Golf Course kit with a script added to the "Ball" blueprint.

As you can see, the Ball blueprint and the Ground closest to it are both rotated.

Behavior properties

Any of the behavior properties that you can get or set from rules can be written from scripts. Here's an example that changes the Slingshot speed and the Gravity of the golf ball. Try shooting the golf ball:

This is the Golf Course kit with a script added to the "Ball" blueprint.

When you start typing in the editor, it will show you a list of properties that you can use. For example, if you start typing my.layout. it'll show you that you can use x, y, widthScale, heightScale, rotation, visible.

Try playing around with changing other properties!

Behavior property reference

You can find a list of all behavior properties available on actors here.