Entity Annotations & Architecture Matrix¶

LITIENGINE uses declarative Java annotations to define static metadata (bounding boxes, movement velocity, combat stats, render layers) when entities are instantiated from map objects or spawned in code.

Interactive Collision Box & Pivot Visualizer¶

Experiment with entity dimensions and @CollisionInfo alignments to see how bounding boxes align with character feet in 2.5D top-down games:

@EntityInfo(width = 32, height = 32)
@CollisionInfo(collisionBoxWidth = 16, collisionBoxHeight = 12, collisionBoxValign = Valign.DOWN)

Built-in Entity Architecture Matrix¶

LITIENGINE includes 9 pre-built entity classes optimized for 2D level design and physics partitioning:

Render Layer Hierarchy¶

Entities are sorted and rendered in strict depth order to guarantee proper occlusion:

graph TD
    A["RenderType.BACKGROUND<br/>(Parallax sky, distant mountains)"] --> B["RenderType.GROUND<br/>(Base terrain tiles, floors, paths)"]
    B --> C["RenderType.SURFACE<br/>(Ground decals, rugs, static shadows)"]
    C --> D["RenderType.NORMAL<br/>(Creatures, Props, Walls — Y-Sorted)"]
    D --> E["RenderType.OVERLAY<br/>(Tree canopies, roofs, dynamic lighting, weather)"]
    E --> F["RenderType.UI<br/>(HUD, healthbars, dialog text, inventory)"]

Available Annotation Reference¶

1. @EntityInfo¶

Configures dimensions and render layer placement:

@EntityInfo(
    width = 32, // Entity width in pixels
    height = 32, // Entity height in pixels
    renderType = RenderType.NORMAL // Rendering layer
)
public class Player extends Creature { ... }

2. @CollisionInfo¶

Configures physics bounding box dimensions, collision type, and alignment:

@CollisionInfo(
    collision = true,
    collisionBoxWidth = 16,
    collisionBoxHeight = 12,
    collisionBoxAlign = Align.CENTER,
    collisionBoxValign = Valign.DOWN
)
public class Chest extends Prop { ... }

3. @MovementInfo¶

Configures locomotion speeds and steering characteristics:

@MovementInfo(
    velocity = 80, // Pixels per second
    acceleration = 20, // Acceleration rate
    deceleration = 40, // Deceleration rate
    turnOnMove = true // Face movement heading
)
public class Goblin extends Creature { ... }

4. @CombatInfo¶

Configures health attributes and faction alignment:

@CombatInfo(
    hitpoints = 500,
    team = 2,
    isIndestructible = false,
    isTarget = true
)
public class Boss extends Creature { ... }

5. @AnimationInfo¶

Binds spritesheet naming prefixes for automatic state animation:

@AnimationInfo(
    spritePrefix = "hero",
    spriteBatched = true
)
public class Hero extends Creature { ... }

See Also¶