The Tile movement behavior allows an object to be moved up, down, left and right, moving a fixed distance at a time, controlled by the arrow keys by default. This is useful for tilemap-based games, where the level is designed around a grid: by using the same grid size with the Tile movement, the controlled object will always be aligned with a grid cell.
The Tile movement aligns the object's origin with the grid. To ensure the object appears in the correct alignment with a visible grid, ensure the object size is the size of the cell, and place the origin in the top-left corner. Often it's easiest to make this object invisible, and place the player sprite on top so that it can keep its own size and origin, as is done in this example of the Tile movement behavior.
The Tile movement behavior is blocked by any objects with the Solid behavior.
To set up custom or automatic controls, see the behavior reference summary.
Tile movement properties
- Grid width
- Grid height
- The size of the movement grid cells, in pixels. The object moves in increments of this size. Normally this matches the size of a corresponding tilemap.
- Grid offset X
- Grid offset Y
- The offset of the movement grid, in pixels. This can be used to align with a tilemap that is not aligned with (0, 0) in the layout.
- Speed X
- Speed Y
- The speed of the movement on each axis, in pixels per second.
- Whether the behavior is initially enabled or disabled. If disabled, it can be enabled at runtime using the Set enabled action.
- Default controls
- If enabled, movement is controlled by the arrow keys on the keyboard. Disable to set up custom controls using the Simulate control action. For more information see the behavior reference summary.
- Check to enable an isometric grid movement, along diagonals. In this mode the "up" direction is towards the top-right. The default is unchecked, using a cartesian grid with horizontal and vertical movement.
Tile movement conditions
- Can move to
- Test if the object can move into a grid cell, given by its grid column and row. This is true if the cell is clear of any obstacles.
- Can move in direction
- Test if the object can move N cells in a given direction. Unlike the Can move to condition this checks for obstacles between the object and the destination.
- Is enabled
- Test if the behavior is currently enabled.
- Is moving
- Test if the behavior is currently moving in to a cell.
- Is moving in direction
- Test if the behavior is currently moving left, right, down or up. This is useful for setting the corresponding animation.
Tile movement actions
- Set enabled
- Enable or disable the movement. If disabled, the movement no longer has any effect on the object.
- Set grid dimensions
- Specify new values for the Grid width, Grid height, Grid offset X and Grid offset Y properties.
- Set grid position
- Set the object to a cell in the grid, given by its grid column and row. The Movement option allows the object to either be set to that position instantly, or animate over for a smooth movement over time.
- Set ignoring input
- Set whether input is being ignored. If input is ignored, pressing any of the control keys has no effect. However, unlike disabling the behavior, the object can continue to move.
- Set speed
- Specify new values for the Speed X and Speed Y properties.
- Simulate control
- Simulate one of the movement controls being held down. Useful when Default controls is disabled. See the behavior reference summary for more information.
Tile movement expressions
- Return the grid cell the object is currently moving towards, by its column and row.
- Return the current grid cell the object is in by its column and row.
- Return the current speed of the object on each axis, in pixels per second.
- Return the layout co-ordinates of the grid cell the object is currently moving towards, by its column and row.