Pure Python, simple to use Entity Component System(ECS) for pygame
Project description
Pygame_ecs
An Pure Python, simple to use ECS library for pygame.
How it works
Entities are just saved as integers
entity = entity_manager.add_entity(component_manager)
Components are just classes that hold data
class Position(pygame_ecs.BaseComponent):
def __init__(self, x: int, y: int):
super().__init__()
self.x = x
self.y = y
Systems are just classes that hold logic
class BallPhysics(pygame_ecs.BaseSystem):
def __init__(self, screen) -> None:
super().__init__(required_component_types=[Position, Velocity])
self.dt = 0
self.screen = screen
def update(self, entity_components):
pos: Position = entity_components[Position] # type: ignore
vel: Velocity = entity_components[Velocity] # type: ignore
pos.x += vel.vec.x * self.dt # type: ignore
pos.y += vel.vec.y * self.dt # type: ignore
if pos.x > WIDTH or pos.x < 0:
vel.vec.x *= -1
if pos.y > HEIGHT or pos.y < 0:
vel.vec.y *= -1
Example Usage
import pygame
import pygame_ecs
import random
class Position(pygame_ecs.BaseComponent):
def __init__(self, x: int, y: int):
super().__init__()
self.x = x
self.y = y
class BallRenderer(pygame_ecs.BaseComponent):
def __init__(self, radius: int, color) -> None:
super().__init__()
self.radius = radius
self.color = color
class BallDrawSystem(pygame_ecs.BaseSystem):
def __init__(self, screen) -> None:
super().__init__(required_component_types=[Position, BallRenderer])
self.screen = screen
def update(self, entity_components):
pos: Position = entity_components[Position]
ball_renderer: BallRenderer = entity_components[BallRenderer]
pygame.draw.circle(
self.screen, ball_renderer.color, (pos.x, pos.y), ball_renderer.radius
)
screen = pygame.display.set_mode((800, 600))
clock = pygame.time.Clock()
entity_manager = pygame_ecs.EntityManager()
component_manager = pygame_ecs.ComponentManager()
system_manager = pygame_ecs.SystemManager()
ball_draw_system = BallDrawSystem(screen)
component_manager.init_components()
entities = []
for _ in range(100):
center = (
random.randint(0, screen.get_width()),
random.randint(0, screen.get_height()),
)
radius = random.randint(4, 18)
color = [random.randint(0, 255) for _ in range(3)]
vel = pygame.math.Vector2(
(random.random() - 0.5) * 400 / 1000,
(random.random() - 0.5) * 400 / 1000,
)
entity = entity_manager.add_entity(component_manager)
component_manager.add_component(entity, Position(center[0], center[1]))
component_manager.add_component(entity, BallRenderer(radius, color))
entities.append(entity)
while True:
for event in pygame.event.get():
if event.type == pygame.QUIT:
raise SystemExit
system_manager.update_entities(entities, component_manager, ball_draw_system)
pygame.display.update()
clock.tick(60)
pygame.display.set_caption(f"FPS: {clock.get_fps()}")
Credits
I'd like to give credit to https://www.youtube.com/watch?v=71RSWVyOMEY and https://github.com/seanfisk/ecs
As well as dickerdackel
from pgc server and SamieZaurus#8030
from UnitOfTime's server.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pygame_ecs-0.2.0.tar.gz
(34.1 kB
view hashes)
Built Distribution
Close
Hashes for pygame_ecs-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1826df9c2025422e906788d3caa7954e73de751fb982cf52ae2718473baa197c |
|
MD5 | 65f753915845df80130626642e2d8ca8 |
|
BLAKE2b-256 | 552fda64f2ae43b0cb9d24ca3dcb8da7a0cefa0e44bf3ba4da36a02197b03cda |