#entity-component #message #gamedev #architecture #entities #handler #ecm

palkia

Entity Component Message architecture a la Caves of Qud

29 releases

0.13.1 Nov 17, 2023
0.12.1 Aug 20, 2023
0.12.0 Jul 25, 2023
0.10.0 Jan 19, 2023
0.3.0 Jul 25, 2022

#623 in Game dev


Used in dialga

MIT license

105KB
2.5K SLoC

Palkia

An Entity-Component-Message architecture crate.

What's an Entity-Component-Message architecture?

Here's an excert from the blog post I wrote on it:

Like in ECS, under ECM you have entities, which are lists of components. But, instead of linking behavior of different components with systems, you do it by passing messages.

When you implement Component for a struct, you implement a method that registers that struct with different message types. Then, from a message handler, you can fire messages to other entities.

When an entity gets a message, it runs through its components in order, and if that component type registers a handler for that message type, it runs the handler and passes the updated value to the next component, and so on … and then finally returns the modified message to the caller.

And there’s a method on World to pass a message to all entities, as your entrypoint.

Check out the tests or examples for more, I guess.

Why is it called Palkia?

I've been naming the helper crates for Foxfire after Pokemon, just because there's a lot of them and I don't want to spend tons of time coming up with names. I picked Palkia specifically because the crate provides a method of organizing data, and Palkia controls space.


Dependencies

~5.5MB
~97K SLoC