Built-in Components

The engine ships a set of built-in components for common game features. They are attached to entities the same way as custom components, through the entity manager or archetypes. See Adding Entities to the Scene.

The components are grouped into three categories.

General purpose

ComponentDescription
TransformDefines an entity’s position, scale, and rotation in the game world.
AnimatorManages sprite animations through a map of named animations.
AudioPlayerPlays, pauses, and stops audio sources.
ButtonAn interactive button that can be clicked or pressed.
TiledWrapperWraps a Tiled map editor tilemap for use with tilemap components.

Physics

See Physics for how these components work together.

ComponentDescription
RigidBodyEnables physics movement under velocity, acceleration, and gravity.
BoxColliderRectangular collision shape.
BallColliderCircular collision shape.
PolygonColliderConvex polygon collision shape.
EdgeColliderCollision shape made of connected line segments.
TilemapColliderCollision shapes generated from a tilemap’s edges.

Rendering

See Rendering for how cameras, layers, and render components work together.

ComponentDescription
CameraControls which layers are rendered to the screen.
SpriteRendererRenders images (sprites).
TextRendererRenders text.
TilemapRendererRenders tile-based maps from a tileset image.
MaskRendererRenders filled shapes (rectangle, circle, polygon).
GeometricRendererRenders hollow (stroke-only) shapes and lines.
LightRendererRenders a circular light source. Requires a DarknessRenderer in the scene.
DarknessRendererRenders a darkness mask, affected by light renderers.
VideoRendererRenders video content.