Skip to main content

Actors

Actions​

Actor Interact​

The actor tries to interact with what is in front of them, it uses actor direction.
Actor Interact
Actor
Actor 1
  • Actor: The actor you want to activate.

Remove Actor From Scene​

Removes the actor from the scene, this disables everything and make it not collide, but this DOESN'T free the RAM until scene is not finished.
Remove Actor From Scene
Actor
Actor 1
  • Actor: The actor you want to activate.

Control Flow​

If Actor At Position​

Conditionally run part of the script if an actor is at a specified position.
If Actor At Position
Actor
Actor 1
X
0
Y
0
True
Add Event
  • Actor: The actor you want to check.
  • X: The horizontal position.
  • Y: The vertical position.

If Actor Collisions Enabled​

Conditionally run part of the script if an actor is collisions are enabled.
If Actor Collisions Enabled
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Facing Direction​

Conditionally run part of the script if an actor is facing in a specified direction.
If Actor Facing Direction
Actor
Actor 1
Direction
True
Add Event
  • Actor: The actor you want to check.
  • Direction: The actor direction.

If Actor Distance From Actor​

Conditionally run part of the script if an actor is within a certain distance of another actor.
If Actor Distance From Actor
Actor
Actor 1
Comparison
==
Distance
0
From
Actor 1
True
Add Event
  • Actor: The actor you want to check.
  • From: The actor to compare distance with.
  • Distance: The distance value.

If Actor Falling​

Conditionally run part of the script if an actor is falling (It's the same as velocityY > 0).
If Actor Falling
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Is Flipped on X Axis​

Conditionally run part of the script if an actor sprite is flipped on the X axis.
If Actor Is Flipped on X Axis
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Is Flipped on Y Axis​

Conditionally run part of the script if an actor sprite is flipped on the Y axis.
If Actor Is Flipped on Y Axis
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Is Visible​

Conditionally run part of the script if an actor sprite is visible.
If Actor Is Visible
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Jumping​

Conditionally run part of the script if an actor is jumping (It's the same as velocityY < 0).
If Actor Jumping
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Another Actor Local Variable​

Conditionally run part of the script if another actor specified local variable is what we want.
If Another Actor Local Variable
Actor
Actor 1
Variable
$Variable0
Comparison
<=
Value
0
True
Add Event
  • Actor: The actor you want to check.
  • Variable: The variable to use.
  • Comparison: The comparison operator to use e.g. 'Less Than' or 'Greater Than'.
  • Value: The value to set the selected variable to.

If Actor Movement Enabled​

Conditionally run part of the script if an actor is movement is enabled.
If Actor Movement Enabled
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Is Moving​

Conditionally run part of the script if an actor is moving.
If Actor Is Moving
Actor
Actor 1
Direction
Any
True
Add Event
  • Actor: The actor you want to check.

If Actor over One Way tile​

Conditionally run part of the script if the actor is on top of a ONE WAY tile (blue collision).
If Actor over One Way tile
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor On Screen​

Conditionally run part of the script if the actor is on screen (accounts for scrolling if any).
If Actor On Screen
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Touching Tile Type​

Conditionally run part of the script if the actor is touching a tile of the selected type.
If Actor Touching Tile Type
Actor
Actor 1
Tile Type
Tile Type 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Outside Scene​

Conditionally run part of the script if the actor is outside scene.
If Actor Outside Scene
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Outside Screen​

Conditionally run part of the script if the actor is outside screen (accounts for scrolling if any).
If Actor Outside Screen
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Is Pinned to the Screen​

Conditionally run part of the script if an actor is pinned to the screen.
If Actor Is Pinned to the Screen
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Platformer Enabled​

Conditionally run part of the script if an actor is platformer mode is enabled.
If Actor Platformer Enabled
Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.

If Actor Relative To Actor​

Conditionally run part of the script based on the position of one actor relative to another.
If Actor Relative To Actor
Actor
Actor 1
Comparison
Is Above
Other Actor
Actor 1
True
Add Event
  • Actor: The actor you want to check.
  • Comparison: The relative position comparison to use e.g. 'Is Above' or 'Is Below'.
  • Other Actor: The actor to compare position with.

Movement​

Enable Movement for an Actor​

Enable movement for an actor allowing gravity, velocity and acceleration to affect it's position.
Enable Movement for an Actor
Actor
Actor 1
  • Actor: The actor you want to activate.

Disable Movement for an Actor​

Disable movement for an actor stopping gravity, velocity and acceleration to affect it's position.
Disable Movement for an Actor
Actor
Actor 1
  • Actor: The actor you want to activate.

All Actors Set Position Relative​

Set the position of all actors relative to it's previous position, causing it to instantly move to the new location.
All Actors Set Position Relative
X
0
Y
0
  • X: The horizontal offset relative to the current position.
  • Y: The vertical offset relative to the current position.

Set Actor Velocity X​

Set the Velocity X value of an actor, causing it to start moving if movement is enabled on it (in pixel per frame).
Set Actor Velocity X
Actor
Actor 1
Value
0
  • Actor: The actor you want to update.
  • Value: The value you want to set.

Set Actor Velocity Y​

Set the Velocity Y value of an actor, causing it to start moving if movement is enabled on it (in pixel per frame).
Set Actor Velocity Y
Actor
Actor 1
Value
0
  • Actor: The actor you want to update.
  • Value: The value you want to set.

Set Actor Acceleration X​

Set the Acceleration X value of an actor, causing it to start moving if movement is enabled on it (in pixel per frame).
Set Actor Acceleration X
Actor
Actor 1
Value
0
  • Actor: The actor you want to update.
  • Value: The value you want to set.

Set Actor Acceleration Y​

Set the Acceleration Y value of an actor, causing it to start moving if movement is enabled on it (in pixel per frame).
Set Actor Acceleration Y
Actor
Actor 1
Value
0
  • Actor: The actor you want to update.
  • Value: The value you want to set.

Actor Set To Target Position​

Set the actor position and direction to the one requested by the latest scene change call if any was set.
Actor Set To Target Position
Actor
Actor 1
Set Direction
  • Actor: The actor you want to activate.
  • Set Direction: Set the direction as well.

Actor Make Immovable​

Make the actor immovable on the selected axis.
Actor Make Immovable
Actor
Actor 1
Immovable X
Immovable Y
  • Actor: The actor you want to update.
  • Immovable X: If the actor will move after a collision on the X axis
  • Immovable Y: If the actor will move after a collision on the Y axis

Actor Move Cancel​

Cancel any currently running 'Actor Move' events affecting this actor. Causes the actor to stop in its current location.
Actor Move Cancel
Actor
Actor 1
  • Actor: The actor you want to cancel movement for.

Actor Move Relative​

Move an actor relative to its current position.
Actor Move Relative
Actor
Actor 1
X
0
Y
0
Speed
Speed 2
Stop On Touch
  • Actor: The actor you want to move.
  • X: The horizontal offset relative to the current position.
  • Y: The vertical offset relative to the current position.
  • Movement Type: Choose if should move in horizontal/vertical axis first or if it should move diagonally to destination.
  • Speed: The movement speed.
  • Stop On Touch: Stop movement if we touch any solid surface in the movement direction, useful to avoid blocking the script.

Actor Move To​

Move an actor to a new position.
Actor Move To
Actor
Actor 1
X
0
Y
0
Speed
Speed 2
Stop On Touch
  • Actor: The actor you want to move.
  • X: The horizontal offset relative to the current position.
  • Y: The vertical offset relative to the current position.
  • Movement Type: Choose if should move in horizontal/vertical axis first or if it should move diagonally to destination.
  • Speed: The movement speed.
  • Stop On Touch: Stop movement if we touch any solid surface in the movement direction, useful to avoid blocking the script.

Actor Pin To Screen​

Pin the actor to the screen, will ignore camera scrolling.
Actor Pin To Screen
Actor
Actor 1
Pin To Screen
  • Actor: The actor you want to update.
  • Pin To Screen: Pin actor to Screen.

Set Actor Position​

Set the position of an actor, causing it to instantly move to the new location.
Set Actor Position
Actor
Actor 1
X
0
Y
0
  • Actor: The actor you want to update.
  • X: The horizontal position.
  • Y: The vertical position.

Set Actor Relative Position​

Set the position of an actor relative to it's previous position, causing it to instantly move to the new location.
Set Actor Relative Position
Actor
Actor 1
X
0
Y
0
  • Actor: The actor you want to update.
  • X: The horizontal offset relative to the current position.
  • Y: The vertical offset relative to the current position.

Properties​

Activate Actor​

Activate an actor, causing its OnUpdate script to start.
Activate Actor
Actor
Actor 1
  • Actor: The actor you want to activate.

Deactivate Actor​

Deactivate an actor, causing its OnUpdate script to not run.
Deactivate Actor
Actor
Actor 1
  • Actor: The actor you want to deactivate.

Enable Collisions for an Actor​

Enable collisions for an actor causing it to become solid again if collisions had previously been disabled.
Enable Collisions for an Actor
Actor
Actor 1
  • Actor: The actor you want to update.

Disable Collisions for an Actor​

Disable all collision checks for an actor allowing the player and all other actor's to pass through it while moving.
Disable Collisions for an Actor
Actor
Actor 1
  • Actor: The actor you want to update.

Actor Flicker​

Change the visible / hidden value each frame to create an effect.
Actor Flicker
Actor
Actor 1
Duration
0.5
  • Actor: The actor you want to activate.
  • Duration: The length of time to pause the script for in seconds or frames.

Enable OnCollide script for an Actor​

Enable OnCollide script for an actor, the script will be invoked when an overlap or collision happens.
Enable OnCollide script for an Actor
Actor
Actor 1
  • Actor: The actor you want to update.

Disable OnCollide script for an Actor​

Disable OnCollide script for an actor, the script won't be invoked when an overlap or collision happens.
Disable OnCollide script for an Actor
Actor
Actor 1
  • Actor: The actor you want to update.

Set Actor Collision Bounding Box​

Set the collision bounding box of an actor to a position and size.
Set Actor Collision Bounding Box
Actor
Actor 1
X
0
Y
0
Width
16
Height
16
  • Actor: The actor you want to update.
  • X: The horizontal position.
  • Y: The vertical position.
  • Width: The box width
  • Height: The box height

Set Actor Allowed Collisions​

Enables specific sides for a collision, actor needs to have Enable Collisions called as well for this to work.
Set Actor Allowed Collisions
Actor
Actor 1
Solid Sides:
Up
Down
Left
Right
Tick all boxes to use normal (red) collision.
  • Actor: The actor you want to activate.

Set Actor Direction​

Change the direction that an actor is currently facing.
Set Actor Direction
Actor
Actor 1
Direction
  • Actor: The actor you want to update.
  • Direction: The actor direction.

Set Actor Animation Frame​

Set an actor's animation to a specified frame value.
Set Actor Animation Frame
Actor
Actor 1
Animation Frame
0
  • Actor: The actor you want to update.
  • Animation Frame: The animation frame value.

Actor Set Palette​

Set the actor palette.
Actor Set Palette
Actor
Actor 1
Palette Slot
PAL0 (Background)
  • Actor: The actor you want to activate.
  • Palette Slot: The palette slot you want to use.

Sprite​

Actor Activate Sprite​

Activates an actor sprite, causing it to animate even during pause.
Actor Activate Sprite
Actor
Actor 1
  • Actor: The actor you want to update.

Hide All Actors​

Hide all actors, you can enable them back one by one or with Show All Actors event.
Hide All Actors
Hide all actors, you can enable them back one by one or with Show All Actors event.

Show All Actors​

Show all actors that were hidden.
Show All Actors
Show all actors that were hidden.

Actor Sprite Flip X​

Flip the actor sprite on the X axis.
Actor Sprite Flip X
Actor
Actor 1
Flip X
  • Actor: The actor you want to update.
  • Flip X: Flip Sprite on X axis

Actor Sprite Flip Y​

Flip the actor sprite on the Y axis.
Actor Sprite Flip Y
Actor
Actor 1
Flip Y
  • Actor: The actor you want to update.
  • Flip Y: Flip Sprite on Y axis

Resume Actor Animation​

Resume the animation that should be playing.
Resume Actor Animation
Actor
Actor 1
  • Actor: The actor you want to update.

Pause Actor Animation​

Pause the animation that should be playing.
Pause Actor Animation
Actor
Actor 1
  • Actor: The actor you want to update.

Actor Sprite Set Priority​

Set the actor priority flag.
Actor Sprite Set Priority
Actor
Actor 1
Priority
  • Actor: The actor you want to update.
  • Priority: They will appear over the foreground.

Actor Send to Front​

Send the actor to the top of the rendering queue so it renders on top of all other actors.
Actor Send to Front
Actor
Actor 1
  • Actor: The actor you want to use.

Actor Send to Back​

Send the actor to the back of the rendering queue so it renders bellow all other actors.
Actor Send to Back
Actor
Actor 1
  • Actor: The actor you want to use.

Set Actor Animation​

Set the animation that should be played by the actor.
Set Actor Animation
Actor
Actor 1
Animation
Idle
Loop Animation
  • Actor: The actor you want to update.
  • Animation: The animation to set
  • Loop Animation: Set if animation should loop.

Set Actor Animation By Index​

Set the animation that should be played by the actor by their numberic index.
Set Actor Animation By Index
Actor
Actor 1
Animation Index
0
Loop Animation
  • Actor: The actor you want to update.
  • Animation Index: The animation index from the sprite sheet.
  • Loop Animation: Set if animation should loop.

Set Actor Sprite Sheet​

Set the sprite that should be used to render the actor.
Set Actor Sprite Sheet
Actor
Actor 1
Sprite Sheet
Player
Load Palette
Palette Slot
PAL0 (Background)
  • Actor: The actor you want to update.
  • Sprite Sheet: The sprite to use for rendering the actor.
  • Palette Slot: The palette slot you want to use.

Actor Set Depth​

Set the actor depth on the rendering queue. From -255 to 255. Lower values means rendering higher on the queue.
Actor Set Depth
Actor
Actor 1
Value
0
Actors with lower depth are display in front of those with higher depth.
  • Actor: The actor you want to update.
  • Value: The value you want to set.

Variables​

Increment Another Actor Local Variable​

Increment a different actor Local Variable.
Increment Another Actor Local Variable
Actor
Actor 1
Variable
$Variable0
  • Actor: The actor you want to update.
  • Variable: The variable to use.

Decrement Another Actor Local Variable​

Decrement a different actor Local Variable.
Decrement Another Actor Local Variable
Actor
Actor 1
Variable
$Variable0
  • Actor: The actor you want to update.
  • Variable: The variable to use.

Store Actor Direction In Variable​

Store the current direction of an actor within a variable.
Store Actor Direction In Variable
Actor
Actor 1
Variable
$Variable0
  • Actor: The actor you want to check.
  • Variable: The variable to use for the direction.

Store Actor Position In Variables​

Store the current position of an actor within two variables, one to store the horizontal position and another to store the vertical position.
Store Actor Position In Variables
Actor
Actor 1
X
$Variable0
Y
$Variable0
  • Actor: The actor you want to check.
  • X: The variable to use for the horizontal position.
  • Y: The variable to use for the vertical position.

Set Another Actor Local Variable​

Set a different actor Local Variable to the selected value.
Set Another Actor Local Variable
Actor
Actor 1
Variable
$Variable0
Value
0
  • Actor: The actor you want to update.
  • Variable: The variable to use.
  • Value: The value to set the selected variable to.

Visibility​

Hide Actor​

Hide an actor, causing it to become invisible. Its OnUpdate script will continue to run while hidden.
Hide Actor
Actor
Actor 1
  • Actor: The actor you want to show.

Show Actor​

Unhide a previously hidden actor.
Show Actor
Actor
Actor 1
  • Actor: The actor you want to show.