bonfire_bloc 0.0.1

Integration for the Bloc state management library to Bonfire games.

bonfire_bloc 🔥🧱

bonfire_bloc offers a simple and natural (as in similar to flutter_bloc) way to use blocs and cubits inside a Bonfire. It's inspired in flame_bloc

Intalling

Adds in your pubspec.yml:

  bonfire: ^3...
  flutter_bloc: ^8...

How to use

Lets assume we have a bloc that handles player inventory, first we need to make it available to our game.

We can do that by using BlocProvider or MultiBlocProvider of the flutter_bloc:

return BlocProvider(
    create: (context) => InventoryBloc(),
    child: BonfireWidget(
        ...
    )
);

Listening to states changes at the component level can be done with two approaches:

By using BonfireBlocListenable component:

class Player extends SimplePLayer
  with BonfireBlocListenable<PlayerInventoryBloc, PlayerInventoryState> {

  @override
  void onNewState(state) {
    updateGear(state);
  }
}

If all your component need is to simply access a bloc, the BonfireBlocReader mixin can be applied to a component:

class Coin extends GameDecoration
  with FlameBlocReader<PlayerInventoryBloc> {

  void takeHit() {
    bloc.add(const IncrementCoin());
  }
}

or

class Coin extends GameDecoration{

  void takeHit() {
    context.read<PlayerInventoryBloc>().add(const IncrementCoin());
  }
}

Note that one limitation of the mixin is that it can access only a single bloc.