17 releases (11 breaking)

0.11.0 Jan 11, 2024
0.10.3 Dec 23, 2023
0.9.2 Dec 5, 2023
0.8.0 Nov 18, 2023

#1897 in Game dev


Used in 4 crates (2 directly)

MIT/Apache

6KB
90 lines

Koe's Bevy toolkit

A collection of bevy tools.

Contents

ECS

  • System callers for invoking systems as if they were functions (requires &mut World).
  • Entity callbacks.
  • Utilities for adding/removing components from entities (requires &mut World).
  • Reactive framework managed by ReactCommands: React components, ReactRes resources, and reactive events (with ReactEventReader). See the documentation for more information.
  • AutoDespawner resource for garbage collecting entities.

UI

  • StyleStack provides style inheritance, which is especially useful for setting up and overriding prefab styles. You style_stack.add() a style to the current 'frame', and it will be available for all child frames. Then you style_stack.push()/.pop() to add/remove frames. At startup you can initialize the stack with a bundle of default styles, then when building a UI branch you can 'unwrap' styles with style_stack.add(style_stack.style::<X>().my_inner_style.clone()); (e.g. if you need a special font for some widget, you pull that font onto the stack by unwrapping your widget's special style which was inserted on init).
  • UiBuilder bundles useful system parameters for building UI: a ReactCommands, a lunex ui tree handle, the bevy asset server, a despawner utility for entity GC, and the StyleStack resource. The builder exposes div() and div_rel() which are convenience methods for managing StyleStack frames.
  • InteractiveElementBuilder lets you add interaction callbacks to an entity, which are auto-invoked by an interaction pipeline system. It is quite opinionated and assumes you are using bevy_lunex, but has a fairly large API and should work as-is for most normal use-cases (it needs a major refactor to unlock the remaining use-cases). Unlike bevy_mod_picking where you add callbacks ad hoc, InteractiveElementBuilder adds callbacks 'all at once', enabling more built-in functionality. The builder's supporting code makes it possible to define different interaction sources (currently all hit tests are tied to lunex widgets, pending a refactor [this is the biggest usability issue at the moment]).

Misc

Utils

Bevy compatability

bevy bevy_kot
0.12 0.9.0 - master
0.11 0.0.1 - 0.8.0

bevy_lunex compatability

lunex bevy_kot
0.0.9 0.9.0 - master
0.0.6 0.0.2 - 0.8.0
0.0.5 0.0.1

Dependencies

~24MB
~456K SLoC