3 releases (breaking)

0.2.0 Jun 1, 2023
0.1.0 Jan 18, 2023
0.0.0 Jan 1, 2023

#1762 in Game dev

Download history 162/week @ 2023-08-12 159/week @ 2023-08-19 163/week @ 2023-08-26 170/week @ 2023-09-02 151/week @ 2023-09-09 131/week @ 2023-09-16 122/week @ 2023-09-23 144/week @ 2023-09-30 121/week @ 2023-10-07 88/week @ 2023-10-14 85/week @ 2023-10-21 94/week @ 2023-10-28 93/week @ 2023-11-04 85/week @ 2023-11-11 93/week @ 2023-11-18 49/week @ 2023-11-25

336 downloads per month
Used in 2 crates


4.5K SLoC


Documentation Crates.io docs.rs License Discord

A work-in-progress, opinionated game meta-engine built on Bevy.

Under development for future use in the Jumpy game, and possibly other FishFolk games.

Check out Fishfolk.org for more documentation and tutorials.


Bones ECS

Bones is designed around a simple, custom Entity Component System ( ECS ), designed to make it easier to get a few features that are important to us:

  • Determinism: Bones ECS is deterministic by default, making it easier to get a re-producible and predictable gameplay.
  • Snapshot/Restore: The Bones ECS world can be trivially snapshot and restored.
  • Modding/Scripting ( future ): Bones ECS is simple enough that we can feasibly provide a C API for integration with other languages and scripting.

Determinism and Snapshot/Restore are also key features for getting excellent network play with the rollback networking model, while requiring no changes to the core game loop implementation.

Game Core

Using bones_lib, which includes bones_ecs and other useful utilities, you write your "game core".

This game core is mostly isolated from anything outside of the ECS world. This is important so that the entire game core can be snapshot/restored.

This means that to collect input, you must read those inputs from an ECS resource, and to render sprites, map tiles, etc., you must create entities with specific components that tell Bones how to render them.

Bevy Renderer

Once you have your game core, you can render the core in a Bevy game using the bones_bevy_renderer crate.

This lets you utilize the power and plugin ecosystem of Bevy to interact with rendering, input, etc. while keeping your core game deterministic, snapshot-able, and moddable.

You are also free to create your own rendering components that you synchronize with Bevy to support any custom rendering/audio use-cases, etc.

Note: Bones ECS as well as bones_lib can technically be used without Bevy. Right now we are focusing on Bevy, and support for alternative uses may not be well polished/complete yet, but it's still within the realm of possibility to render Bones cores with any framework you want.

Bones App ( Future )

As we get a feel for how things fit together with the use of Bones in Jumpy, we hope to be able to create a standardized game runner around Bones game cores. This would allow the Bones app to handle common things like localization, asset loading, input mapping, settings menu, networking, etc., allowing you to focus on writing what makes your game unique.

Similar Projects

Our architecure has many things in common with these other awesome projects:


~1M SLoC