genre-pack-topdown

Genre Pack: Top-Down 2D

Movement, AI, aiming, and camera for top-down 2D games.

Top-down move component

class_name TopDownMoveComponent
extends Node

@export var max_speed: float = 200.0
@export var acceleration: float = 1500.0
@export var friction: float = 1200.0

var body: CharacterBody2D

func _ready() -> void:
    body = get_parent() as CharacterBody2D
    assert(body, "TopDownMoveComponent parent must be CharacterBody2D")

func physics_step(delta: float, input_dir: Vector2) -> void:
    if input_dir.length_squared() > 0.01:
        body.velocity = body.velocity.move_toward(input_dir.normalized() * max_speed, acceleration * delta)
    else:
        body.velocity = body.velocity.move_toward(Vector2.ZERO, friction * delta)
    body.move_and_slide()

Player code:

func _physics_process(delta: float) -> void:
    var input_dir := Input.get_vector("move_left", "move_right", "move_up", "move_down")
    _move.physics_step(delta, input_dir)

Snap-to-grid movement (turn-based / tactical)

class_name GridMover
extends Node

const TILE_SIZE := 32.0

@export var move_duration: float = 0.15

var body: Node2D
var _tween: Tween
var is_moving: bool = false

func _ready() -> void:
    body = get_parent() as Node2D

func step(direction: Vector2i) -> bool:
    if is_moving or direction == Vector2i.ZERO:
        return false
    var target := body.position + Vector2(direction) * TILE_SIZE
    if _is_blocked(target):
        return false
    is_moving = true
    if _tween:
        _tween.kill()
    _tween = create_tween()
    _tween.tween_property(body, "position", target, move_duration)
    _tween.finished.connect(func() -> void: is_moving = false)
    return true

func _is_blocked(_target: Vector2) -> bool:
    # check tilemap or other obstacles
    return false

Twin-stick aiming

# In _physics_process or _process
var aim_dir: Vector2

# Mouse aiming (top-down with mouse)
aim_dir = (get_global_mouse_position() - global_position).normalized()

# Right-stick aiming (gamepad)
var stick := Input.get_vector("aim_left", "aim_right", "aim_up", "aim_down")
if stick.length_squared() > 0.04:  # deadzone
    aim_dir = stick.normalized()

# Apply to weapon / cursor
$WeaponPivot.rotation = aim_dir.angle()