flutter_flame_architecture
Use flutter(like) widgets inside Flame. Zoom, Scroll, Wrap, Grid, SafeArea, ... You can use them all in combination with flame thanks to this intuitive package!
Basics
Game development has some differences from normal Flutter development. A big difference is the build method is executed multiple times a second (fps). If you need to do calculations etc you can do this in the update function, that way if it takes longer, the UI is not interupted.
Another difference is the drawing on a canvas. Everything is drawn using a canvas with coordinates. Using the FlameWidget from this package you can use some helper methods like bounds, etc.
Contribution
Obviously contribution is encouraged, even if it's just by adding issues with ideas to further expand this package
Goal of the package
To support in the development of games using Flutter and Flame
Flame gives you the platform to develop games with Flutter, but it doesn't feel like Flutter anymore. The issue lies in the lack of widgets and existing structure.
This package attempts to fix this.
Next steps
To improve the game dev experience in Flutter/Flame, I'm planning on creating a template project. This would include admob, firebase, basic screens (main menu, etc), a clear folder structure, etc. The idea is to first develop a game with this package and then to strip the game to its essentials.
Progress
Redeveloping default Flutter widgets (with basic functionality) like:
xCenterxColumnxContainerxExpandedxGestureDetectorxPaddingxPositionedxRowxSizedBoxxSpacerxStackxTextxImage (FlameSprite)xSingleChildScrollView (note Both horizontal and vertical are supported at the same time!)xButton (For now a simplistic implementation is added)xGridViewxIsometricGridViewxSafeAreaxBuilderxValueListenableBuilderxWrapxChangeNotifierProviderxFlameScrollController
Extend Flame functionality with quality of life improvements
xCanvas widget (draw on the canvas)xZoom widget (child is zoomable using gestures or programmatically)xAutomate SpriteManager (Use the FlameSprite Widget with fileName)xNavigationxDialogs
BackPress for navigator:
MaterialApp(
home: WillPopScope(
onWillPop: () async {
FlameNavigator.pop();
return false;
},
child: GameWidget(
game: gameManager,
),
),
),
Examples
xBuild and put on GitHub pagesxBasic example (pong)xNavigationxSingleChildScrollViewxGridViewxIsometricGridViewxButtonxDialogsxZoomxWrapxFlameValueListenableBuilderFlameCanvas(that updates)FlameChangeNotifierProvider with a viewmodelFlameScrollController
Code documentation
CenterColumnContainerExpandedGestureDetectorPaddingPositionedRowSizedBoxSpacerStackTextImage (FlameSprite)ButtonCanvas widget (draw on the canvas)Automate SpriteManager (Use the FlameSprite Widget with fileName)NavigationSingleChildScrollViewDialogsValueListenableBuilderWrapFlameChangeNotifierProviderFlameScrollController