grid-movement

Grid Movement in FlatRedBall2

Not TopDownBehavior — TopDownBehavior produces continuous analog velocity-based movement. For tile-by-tile grid movement, implement the pattern below directly. Do not load the top-down-movement skill for this use case.

Grid movement has three invariants:

1. The entity always sits on a tile boundary (position snapped to multiples of TileSize).
2. Input is locked while a move is in progress.
3. A pre-move collision check prevents entering blocked tiles.

Minimal Implementation

private const float TileSize = 16f;
private bool _moving = false;

public override void CustomInitialize()
{
    X = MathF.Round(X / TileSize) * TileSize;  // snap to grid on spawn
    Y = MathF.Round(Y / TileSize) * TileSize;
}

public override async void CustomActivity(FrameTime time)
{
    if (_moving) return;                          // gate: one move at a time

    var (dx, dy) = ReadDirectionalInput();
    if (dx == 0 && dy == 0) return;

    float targetX = X + dx * TileSize;
    float targetY = Y + dy * TileSize;

    if (IsBlocked(targetX, targetY)) return;      // pre-move collision check

    _moving = true;
    await TweenTo(targetX, targetY, 0.12f);       // animate the step
    X = targetX; Y = targetY;                     // snap to exact grid position
    _moving = false;
}

Pre-Move Collision Check

Use TileShapes.GetTileAtWorld(x, y) to test the target tile before committing:

private bool IsBlocked(float x, float y)
    => _solidTiles.GetTileAtWorld(x, y) != null;

TileShapes is injected from the screen after spawning via a method on the entity. See the levels skill for how to generate it from a TMX layer.

Namespace gotcha — TileShapes lives in FlatRedBall2.Collision, not FlatRedBall2.Tiled. Add using FlatRedBall2.Collision; to any file that declares a TileShapes field.

Tween Helper

A lerp tween using Engine.Time.CurrentScreenTime (accessible from any entity via Engine):