Components

These are the data components you will use most often from gameplay code. They are intentionally small and data-oriented so the systems can read exactly what they need.

Spatial

Transform

Transform defines where an entity is and how it is drawn.

Field	Default	Use
Position	(0, 0)	world position
Scale	(1, 1)	per-axis scale
Rotation	0	rotation in degrees
Pivot	(0, 0)	local rotation and scale pivot

GetMatrix()

Builds the full model matrix using:

1. position
2. pivot
3. rotation
4. scale
5. inverse pivot

Example

player.Transform().SetPivot(Vec2(16.0f, 16.0f));
player.Transform().Rotate(90.0f);

tip

Pivot is useful when you want to rotate around the center of a sprite or around a character's feet.

Visual

SpriteRenderer

SpriteRenderer controls the visual part of an entity.

Field	Default	Use
TextureName	empty	logical texture name
Color	white	RGBA tint
Visible	true	draw or not
RenderOrder	0	layer order
SourceRect	0,0,0,0	texture region in pixels
FlipX	false	horizontal mirroring
FlipY	false	vertical mirroring

Notes

• if TextureName is empty, the engine uses the fallback texture
• if SourceRect is empty, the full texture is drawn
• a lower RenderOrder is drawn first

Example

sprite.Sprite().SetColor(Colors::Blue());
sprite.Sprite().FlipX(true);
sprite.Sprite().SetRenderOrder(50);

Physics

Collider

Collider defines an axis-aligned box for physics and triggers.

Field	Default	Use
Size	(1, 1)	collider size
Offset	(0, 0)	offset relative to the transform
IsTrigger	false	sensor without physical blocking
callbacks	empty	trigger events

Important

Collider is axis-aligned.

• it does not rotate with Transform::Rotation
• it does not scale with Transform::Scale
• it is computed from Transform::Position + Offset and Size

Example

box.Collider().SetSize(Vec2(32.0f, 48.0f));
box.Collider().SetOffset(Vec2(0.0f, 8.0f));
box.Trigger().SetTrigger(true);

Rigidbody

Rigidbody controls the dynamic part of physics.

Field	Default	Use
Velocity	(0, 0)	current speed
IsStatic	false	whether the body moves through physics
UseGravity	false	whether global gravity affects it
GravityScale	25.0f	gravity multiplier

Example

player.Rigidbody().SetUseGravity(true);
player.Rigidbody().SetVelocity(Vec2(180.0f, 0.0f));

note

The engine's collisions are AABB based. If you need real rotating physics or complex colliders, the current public API does not expose them.

Animation

AnimationClip

AnimationClip describes how to read frames from a spritesheet.

Field	Default	Use
FrameSize	(0, 0)	size of each frame
FrameCount	0	total number of frames
FramesPerRow	0	horizontal layout
FPS	12.0f	playback speed
Loop	true	whether it loops
StartFrame	0	base frame inside the spritesheet

Animator

Animator stores the playback state and the clip map.

Field	Default	Use
Clips	empty	clip map by name
CurrentClip	empty	active clip
Playing	true	whether it advances
CurrentFrame	0	current frame
Accumulator	0.0f	time accumulated toward the next frame

Behavior

• if FramesPerRow is 0, the system uses 1
• if FrameCount <= 0, the clip does not advance
• if FPS <= 0, the clip stays on the current frame

Example

AnimationClip run(iVec2(32, 32), 6, 3, 10.0f, true, 0);

Particles

Particle

Particle stores the state of a live particle.

Field	Use
Velocity	current velocity
Lifetime	total lifetime
Age	time already lived
StartColor / EndColor	color interpolation
StartScale / EndScale	scale interpolation
GravityScale	per-particle gravity

ParticleEmitter

ParticleEmitter defines how particles are spawned.

Field	Default	Use
Active	true	whether it can emit
Loop	false	whether it auto-emits cyclically
AutoEmit	false	whether it emits over time
OneShot	false	whether it destroys itself after spawning
BurstCount	8	particles per burst
EmitRate	0.0f	bursts per second
Lifetime	0.75f	lifetime of each particle
Speed	80.0f	base speed
SpeedVariation	20.0f	random variation
Spread	180.0f	angular spread
RenderOrder	0	draw layer

Example

ParticleEmitter emitter;
emitter.BurstCount = 12;
emitter.AutoEmit = true;
emitter.EmitRate = 4.0f;

OneShot is useful for one-off effects like explosions or hit sparks, where the emitter should clean itself up after the spawn cycle finishes.