#gamedev #macros #derive #macro

nightly macro palkia_macros

Proc macros for Palkia

3 unstable releases

new 0.13.1 Nov 17, 2023
0.13.0 Nov 17, 2023
0.1.0 Jul 18, 2023

#1680 in Game dev

21 downloads per month
Used in palkia

MIT license

77 lines


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.


  • serde enables "convenient," "easy-to-use" wrappers for serializing and deserializing worlds. (Disabled by default.)

... and possibly more to follow.

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.

This crate is built alongside and for my W.I.P. roguelike Foxfire.


~19K SLoC