Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Area2D

Inherits: CollisionObject2D < Node2D < CanvasItem < Node < Object

A region of 2D space that detects other CollisionObject2Ds entering or exiting it.

Description

Area2D is a region of 2D space defined by one or multiple CollisionShape2D or CollisionPolygon2D child nodes. It detects when other CollisionObject2Ds enter or exit it, and it also keeps track of which collision objects haven't exited it yet (i.e. which one are overlapping it).

This node can also locally alter or override physics parameters (gravity, damping) and route audio to custom audio buses.

Tutorials

• Using Area2D

• 2D Dodge The Creeps Demo

• 2D Pong Demo

• 2D Platformer Demo

Properties

float	angular_damp	1.0
SpaceOverride	angular_damp_space_override	0
StringName	audio_bus_name	&"Master"
bool	audio_bus_override	false
float	gravity	980.0
Vector2	gravity_direction	Vector2(0, 1)
bool	gravity_point	false
Vector2	gravity_point_center