Entity

Game entity that exists on a grid with sprite rendering.

Overview

An Entity is a game object that exists at a position on a Grid. Entities represent players, enemies, items, and other interactive objects. They render on top of tiles, support smooth animated movement, and integrate with the pathfinding and field-of-view systems.

Quick Reference

# Create an entity
player = mcrfpy.Entity(grid_pos=(10, 10), texture=texture, sprite_index=84)

# Add to a grid
grid.entities.append(player)

# Move to a new grid position
player.pos = (11, 10)  # Instant move
player.grid_pos = (11, 10)  # Same as above

# Animated movement
player.animate("x", 12.0, 0.2, "easeOutQuad")

# Pathfinding
if player.path_to(15, 10):
    print("Moving to target!")

# Field of view
visible = player.visible_entities(radius=8)
for enemy in visible:
    print(f"Can see: {enemy.name}")

Constructor

mcrfpy.Entity(grid_pos=None, texture=None, sprite_index=0, **kwargs)

Arguments:

• grid_pos (tuple, optional): Grid position as (x, y). Default: (0, 0)
• texture (Texture, optional): Texture object for sprite. Default: default texture
• sprite_index (int, optional): Index into texture atlas. Default: 0

Keyword Arguments:

• grid (Grid): Grid to attach entity to
• visible (bool): Visibility state. Default: True
• opacity (float): Opacity (0.0-1.0). Default: 1.0
• name (str): Element name for finding

Properties

Methods

Related