NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #3646 most downloaded on pub.dev
Package to add SVG rendering support for the Flame game engine
Latest stable
2.0.0
Last release 1 months ago
06 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 53 of 53 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
65 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
FIX: Version flame_3d_component as a prerelease and move flame_lint to 1.5.0-dev.0 (#4100).
Note: This release has breaking changes.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/flame_svg/versions/3.0.0-dev.0
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/flame_test/versions/3.0.0-dev.0
Note: This release has breaking changes.
Note: This release has breaking changes.
Packages with breaking changes:
Packages with other changes:
flame_steering_behaviors@0.2.2+6
DOCS: Add AI assist badge to readme(s) (#3226).
FIX: SpriteAnimationWidget was resetting the ticker even when the playing didn't changed (#2891).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: Calculate zoom ratio before rendering svg (#3616).
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: SvgComponent should use drawImage on first render too (#3549).
Update a dependency to the latest release.
Update a dependency to the latest release.
DOCS: Fix workflow status badge paths (#3517).
DOCS: Remove AI assist badges (#3477).
Update a dependency to the latest release.
REFACTOR: Fix lint issues from latest flutter release (#3390).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
> Note: This release has breaking changes.
Note: This release has breaking changes.
FixedResolutionViewport and make withFixedResolution a redirect constructor (#2817). (3420d0e6)Offset with opacityFrom and opacityTo in ColorEffect (#2876). (0fd2662d)To specify start and end opacities for ColorEffect use the optional named parameters opacityFrom and opacityTo. So offset.dx should be set as opacityFrom and offset.dy should be set as opacityTo.
REFACTOR: Modernize switch; use switch-expressions and no break; (#3133).
FIX: Properly resize ScreenHitbox when needed (#2826).
FixedResolutionViewport and make withFixedResolution a redirect constructor (#2817). (3420d0e6)FIX: Remove deprecations for 1.10.0 (#2809).
component.removeFromParent method should use parent.remove internally (#2779). (bdb1c79a)IgnoreEvents mixin to ignore events for the whole subtree (#2811). (313411c3)FixedResolutionViewport (#2796). (4c762f94)REFACTOR: Enable DCM linting (#2667).
onRemove/onDetach being called for initial Gesture Detector addition (#2653). (d1721464)CameraComponent.priority to max (#2732). (820ece1c)FilterQuality.medium instead of high (#2733). (fc19890c)Vector2 in globalToLocal and localToGlobal (#2727). (9fb3bf8d)debugCoordinatesPrecision into a variable instead of a getter (#2713). (9918c051)onDispose to game.dart called from game_widget.dart (#2659). (2f44e483)SpriteSheet (#2754). (47722199)HasWorldReference mixin (#2746). (9105411d)pause and isPaused to SpriteAnimationTicker (#2660). (37271f5c)Forge2DGame to use CameraComponent (#2728). (7a3d5126)Packages with breaking changes:
Packages with other changes:
flame - v1.15.0flame_isolate - v0.5.1flame_riverpod - v5.2.0flame_test - v1.15.4flame_oxygen - v0.1.9+8flame_tiled - v1.18.4flame_fire_atlas - v1.4.8flame_audio - v2.1.8flame_spine - v0.1.1+10flame_bloc - v1.10.10flame_rive - v1.9.11flame_lottie - v0.3.0+8flame_markdown - v0.1.1+8flame_forge2d - v0.16.0+5flame_svg - v1.8.10flame_network_assets - v0.2.0+13Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flame_oxygen - v0.1.9+8flame_tiled - v1.18.4flame_fire_atlas - v1.4.8flame_audio - v2.1.8flame_spine - v0.1.1+10flame_bloc - v1.10.10flame_rive - v1.9.11flame_lottie - v0.3.0+8flame_markdown - v0.1.1+8flame_forge2d - v0.16.0+5flame_svg - v1.8.10flame_network_assets - v0.2.0+13Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: Minor issues due Flutter 3.16 (#2856).
Update a dependency to the latest release.
FIX: Do not render SVGs bigger than requested when pixelRatio > 1 and no match in _imageCache (#2795).
REFACTOR: Remove unused event "ScoreEventCleared" from flame_block example (#2380).
remove() method to fix the functionality issue in the FlameMultiBlocProvider (#2280). (6a818464)PERF: Improve performance of raycasts (#2617).
ComponentKeys to keep track of dispatchers (#2629). (ff59aa15)CameraComponent.canSee (#2616). (1cad0b23)CollisionProspects and remove some list creations from the collision detection (#2625). (e430b6cd)CameraComponent (#2615). (14f51635)FIX: Adds a check to confirm the component is not loaded (#2579).
mustCallSuper from onComponentTypeCheck (#2561). (bcae760c)> Note: This release has breaking changes.
Note: This release has breaking changes.
errorBuilder and loadingBuilder to constructors (#2526). (55ec0bc3)AnimationWidget (#2515). (0b68be8a)stepEngine to Game (#2516). (1ed2c5a2)CollisionType in hitbox constructor (#2509). (89926227)CameraComponent and events out of experimental (#2505). (87b8a067)SpriteAnimationTicker (#2457). (a50c80cf)In the future (maybe as early as v1.9.0) this camera will be removed, please use the CameraComponent instead.
This is the simplest way of using the CameraComponent:
Add variables for a CameraComponent and a World to your game class
final world = World();
late final CameraComponent cameraComponent;
In your onLoad method, initialize the cameraComponent and add the world
to it.
@override
void onLoad() {
cameraComponent = CameraComponent(world: world);
addAll([cameraComponent, world]);
}
Instead of adding the root components directly to your game with add,
add them to the world.
world.add(yourComponent);
(Optional) If you want to add a HUD component, instead of using PositionType, add the component as a child of the viewport.
cameraComponent.viewport.add(yourHudComponent);
FIX: Update sdk constraints to >=3.0.0 (#2554).
FEAT: Deprecate Component.changeParent (#2478).
HasTappables (#2496). (d51a612f)Component.changeParent (#2478). (bd3e7886)Packages with breaking changes:
ColorEffect (#2469). (6fa9e9d5)isDragged in DragCallbacks mixin (#2472). (de630a1c)Packages with breaking changes:
Packages with other changes:
flame - v1.7.1flame_isolate - v0.3.0+1flame_tiled - v1.10.1flame_audio - v1.4.2flame_svg - v1.7.3flame_test - v1.10.1flame_flare - v1.5.4flame_oxygen - v0.1.8+2flame_bloc - v1.8.4flame_fire_atlas - v1.3.5flame_forge2d - v0.13.0+1flame_rive - v1.7.1flame_noise - v0.1.1+1flame_network_assets - v0.2.0+1flame_lottie - v0.2.0+2Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flame_isolate - v0.3.0+1flame_tiled - v1.10.1flame_audio - v1.4.2flame_svg - v1.7.3flame_test - v1.10.1flame_flare - v1.5.4flame_oxygen - v0.1.8+2flame_bloc - v1.8.4flame_fire_atlas - v1.3.5flame_forge2d - v0.13.0+1flame_rive - v1.7.1flame_noise - v0.1.1+1flame_network_assets - v0.2.0+1flame_lottie - v0.2.0+2REFACTOR: Add new lint rules (#2477).
> Note: This release has breaking changes.
Note: This release has breaking changes.
SpriteComponent on sprite change (#2430). (158460d7)onLoad (#2452). (d1ac01f5)Component.removeWhere (#2458). (13cce4ae)HasCollisionDetection to be on Component (#2404). (637c258b)autoResize for SpriteAnimationComponent and SpriteAnimationGroupComponent (#2453). (dbeba238)autoResize for SpriteGroupComponent (#2442). (1576bd83)HasTimeScale mixin (#2431). (d2a8fe01)limit field mutable in the Timer class (#2358). (4e0a8c46)HasTappableComponents mixin is no longer needed (#2450). (b5bdf4ec)If you have components that rely on receiving onGameResize calls before they load, then you can retrieve the game's size in onLoad manually via findGame()!.size.
The HasDraggableComponents mixin is now empty & deprecated. If your game used this mixin overriding its methods onDragStart, onDragUpdate, etc -- then they will no longer work. If you want to receive drag events at the top level of the game, then simply add a DragCallbacks component to the top level of the game.
The HasTappableComponents mixin is now empty & deprecated. If your game used this mixin overriding its methods onTapDown, onTapUp, etc -- then they will no longer work. If you want to receive tap events at the top level of the game, then simply add a TapCallbacks component to the top level of the game.
Packages with breaking changes:
Packages with other changes:
flame - v1.21.0flame_fire_atlas - v1.6.0flame_test - v1.17.2flame_tiled - v1.21.0flame_audio - v2.10.5flame_forge2d - v0.18.2+2flame_oxygen - v0.2.3+2flame_rive - v1.10.5flame_texturepacker - v4.1.2flame_behavior_tree - v0.1.3+2flame_spine - v0.2.2+2flame_riverpod - v5.4.5flame_kenney_xml - v0.1.1+2flame_bloc - v1.12.3flame_noise - v0.3.2+2flame_lottie - v0.4.2+2flame_network_assets - v0.3.3+2flame_svg - v1.11.2flame_sprite_fusion - v0.1.3+2flame_markdown - v0.2.2+2flame_isolate - v0.6.2+2Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flame_audio - v2.10.5flame_forge2d - v0.18.2+2flame_oxygen - v0.2.3+2flame_rive - v1.10.5flame_texturepacker - v4.1.2flame_behavior_tree - v0.1.3+2flame_spine - v0.2.2+2flame_riverpod - v5.4.5flame_kenney_xml - v0.1.1+2flame_bloc - v1.12.3flame_noise - v0.3.2+2flame_lottie - v0.4.2+2flame_network_assets - v0.3.3+2flame_svg - v1.11.2flame_sprite_fusion - v0.1.3+2flame_markdown - v0.2.2+2flame_isolate - v0.6.2+2PERF: Avoid Vector2 creation in Sprite.render (#2261).
flame - v1.6.0Sprite.render (#2261). (736733d9)canSee method to the CameraComponent (#2270). (2347c8f5)moveBy to CameraComponent (#2269). (51e54ebe)onLoad() now returns FutureOr<void> (#2228). (d898b539)pushReplacement, pushReplacementNamed, and pushReplacementOverlay (#2249). (a2772b4e)REFACTOR: OpacityEffect now uses opacity instead of alpha internally (#2064).
@mustCallSuper (#2036). (c26d5da3)RectangleComponent (#2167). (4020d68b)@mustCallSuper added (#2001). (45a9d79b)GameWidget (#1725). (d1cd8517)Particles (#2097). (59bd7ebb)Vector2.zero() to Vector2(0, -1) in Vector2Extensions.fromRadians() (#2016). (801c683c)World constructor (#2093). (3af416dc)maintainState property to Route (#2161). (576ceaac)clampLength for Vector2 extension (#2190). (51a896b2)removed future + isRemoved field for Component (#2080). (9f322785)Packages with breaking changes:
Packages with other changes:
flame_svg - v1.11.13flame_texturepacker - v4.4.0flame_tiled - v3.0.4flame_behavior_tree - v0.1.3+13flame_oxygen - v0.2.3+13flame_isolate - v0.6.2+13flame_fire_atlas - v1.8.8flame_audio - v2.11.7flame_spine - v0.2.2+13flame_bloc - v1.12.14flame_kenney_xml - v0.1.1+13flame_lottie - v0.4.2+13flame_markdown - v0.2.4+6flame_console - v0.1.2+9flame_rive - v1.10.16flame_forge2d - v0.19.0+3flame_noise - v0.3.2+13flame_riverpod - v5.4.16flame_network_assets - v0.3.3+13flame_3d - v0.1.0-dev.13Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flame_behavior_tree - v0.1.3+13flame_oxygen - v0.2.3+13flame_isolate - v0.6.2+13flame_fire_atlas - v1.8.8flame_audio - v2.11.7flame_spine - v0.2.2+13flame_bloc - v1.12.14flame_kenney_xml - v0.1.1+13flame_lottie - v0.4.2+13flame_markdown - v0.2.4+6flame_console - v0.1.2+9flame_rive - v1.10.16flame_forge2d - v0.19.0+3flame_noise - v0.3.2+13flame_riverpod - v5.4.16flame_network_assets - v0.3.3+13flame_3d - v0.1.0-dev.13> Note: This release has breaking changes.
Note: This release has breaking changes.
REFACTOR: move broadphase-related functionality into separate subdir (#1943). (f23acd41)
REFACTOR: used simpler and more implicit widgets in GameWidget (#1862). (44d17c64)
PERF: SpriteAnimationWidget will re-render only when needed (#1876). (bb678301)
FIX: Hitbox children of a CompositeHitbox to return correct parent (#1922). (d518705e)
FIX: OpacityEffect rounding error calculation (#1933). (4cfcfa64)
FEAT: Make _ButtonState public for SpriteButtonComponent (#1941). (e80412c5)
FEAT: Add possibility for solid hitboxes (#1919). (205ac561)
FEAT: Adding callbacks for EffectController (#1926) (#1931). (8dcdf155)
FEAT: Add lookAt method for PositionComponent (#1891). (720c3566)
FEAT: add applyLifespanToChildren to Particle generate (#1911). (884d5190)
FEAT: Add broadphase generics to CollisionDetection (#1908). (f7714122)
FEAT: Add support for isometric staggered maps (#1895). (96be8408)
FEAT: RecycledQueue now supports modification during iteration (#1884). (01b59493)
FEAT: Allow children of ComposedParticle to have varied lifespan (#1879). (6db519ec)
FEAT: Possibility to ignore hitboxes for ray casting (#1863). (b22bc643)
DOCS: Added Style Guide and Test Writing Guide (#1897). (999caca1)
BREAKING FIX: Make all ComponentSet modifications internal (#1877). (f26a066d)
Migration instructions:
For most methods Component has the corresponding methods directly on it already.
For example, instead of using component.children.addAll you should do component.addAll.
BREAKING CHORE: Remove functions/classes that were scheduled for removal in v1.3.0 (#1867). (00ab347c) For each deleted function/method/class, the deprecation comment already specifies what functionality should be used instead.
REFACTOR: Use new "super"-constructors in ShapeComponents (#1752).
flame - v1.3.0componentsAtPoint (#1739). (f750d705)children argument to SpriteComponent.fromImage (#1793). (80a63362)Ray2 class to be used in raytracing/casting (#1788). (26196c01)HasAncestor mixin (#1711). (987a44f4)Note: This release has breaking changes.
Note: This release has breaking changes.
REFACTOR: Organize Component class (https://github.com/flame-engine/flame/issues/1608). ([069294f4](https://github.com/flame-engine/flame/commit/069294f44082a5d4ae6e9eff1d29be9cb06ee4a7))
REFACTOR: Remove unecessary copy operation on Camera (https://github.com/flame-engine/flame/issues/1708). ([94cc115a](https://github.com/flame-engine/flame/commit/94cc115a9ee6660d1f3a72378e8b35523b83bfad))
REFACTOR: Update and guarantee consistency on mocktail dev dependency version across repo (https://github.com/flame-engine/flame/issues/1701). ([f4a98878](https://github.com/flame-engine/flame/commit/f4a98878062dbd4fe8238a8b014e6be3e528c5d8))
REFACTOR: Add onComplete as optional parameter (https://github.com/flame-engine/flame/issues/1686). ([4ca65f8a](https://github.com/flame-engine/flame/commit/4ca65f8a2c330d61527e071434441f2df9deefb4))
REFACTOR: Added MultiDragListener - common API between HasDraggables and MultiTouchDragDetector (https://github.com/flame-engine/flame/issues/1668). ([801dbba1](https://github.com/flame-engine/flame/commit/801dbba1d8b6fd721d4e2fc752c70f97d4771198))
REFACTOR: Simplify Component.firstChild, .lastChild, and .findParent (https://github.com/flame-engine/flame/issues/1673). ([84f2f57e](https://github.com/flame-engine/flame/commit/84f2f57e5fddb82572177b2bcd0f8309a891ea4e))
REFACTOR: Replace some usages of fold<> with .sum (https://github.com/flame-engine/flame/issues/1670). ([dd05ecb6](https://github.com/flame-engine/flame/commit/dd05ecb6b8b105b4d1fc894dc6ce7ca3f8cf793e))
REFACTOR: Deprecate ComponentSet.createDefault() (https://github.com/flame-engine/flame/issues/1676). ([f37e3a20](https://github.com/flame-engine/flame/commit/f37e3a2028e16143d8bb3218691904c38fb848a4))
REFACTOR: Simplify HudButtonComponent (https://github.com/flame-engine/flame/issues/1647). ([30d84b7c](https://github.com/flame-engine/flame/commit/30d84b7caea128c7dc579dce170129e462bc03bf))
REFACTOR: Component's lifecycle futures moved into LifecycleManager (https://github.com/flame-engine/flame/issues/1613). ([39201c40](https://github.com/flame-engine/flame/commit/39201c40fa3eea5dbdbaa823309cdf8856f912a6))
REFACTOR: TextRenderer and TextPaint moved to separate files (https://github.com/flame-engine/flame/issues/1628). ([5e1f5966](https://github.com/flame-engine/flame/commit/5e1f59663bf7e09a02475979d1eded54dbaaefd7))
REFACTOR: Move to package imports (https://github.com/flame-engine/flame/issues/1625). ([843ddc36](https://github.com/flame-engine/flame/commit/843ddc36249272fcb518b44672e1012307dfa1b5))
REFACTOR: Improve tests (https://github.com/flame-engine/flame/issues/1609). ([f33b3986](https://github.com/flame-engine/flame/commit/f33b3986cd913416ae3955c922d6cc8b0db872e3))
FIX: Fix tile flips when using canvas.drawAtlas (https://github.com/flame-engine/flame/issues/1610). ([b4ad498f](https://github.com/flame-engine/flame/commit/b4ad498fe5488795deb2c2e098fcde357b448bf0))
FIX: Expose CompositeHitbox (https://github.com/flame-engine/flame/issues/1589). ([78775798](https://github.com/flame-engine/flame/commit/7877579868041f4844ebae885da559097b7aa8a5))
FIX: Anchor equality operator is now more reliable (https://github.com/flame-engine/flame/issues/1560). ([0d6581ef](https://github.com/flame-engine/flame/commit/0d6581ef1aaff4437b2a84f9e57d7d0e1d093d1f))
FIX: Deprecate Anchor.translate() (https://github.com/flame-engine/flame/issues/1672). ([80c648fc](https://github.com/flame-engine/flame/commit/80c648fc94dc00e37f2c0876fec39b2628b3128a))
FIX: Avoid leaks when using PictureRecorders (https://github.com/flame-engine/flame/issues/1643). ([d67065e5](https://github.com/flame-engine/flame/commit/d67065e52db453b0f4f190a7aec1bec6bc389e45))
FIX: Remove nonVirtual method shouldRemove (https://github.com/flame-engine/flame/issues/1707). ([1efd067e](https://github.com/flame-engine/flame/commit/1efd067e31ad425941e5b83891c7289ba063ec90))
FIX: Fix flame package example app (https://github.com/flame-engine/flame/issues/1709). ([bd2ef967](https://github.com/flame-engine/flame/commit/bd2ef967e10eb0309e0a468652a657cae3d5e7d5))
FIX: Subscription for events when game changes in GameWidget (https://github.com/flame-engine/flame/issues/1659). ([04f0d5d1](https://github.com/flame-engine/flame/commit/04f0d5d172ca5065e58e8b9b5536cbce706147d4))
FIX: performance improvements on SpriteBatch APIs (https://github.com/flame-engine/flame/issues/1637). ([4b19a1b2](https://github.com/flame-engine/flame/commit/4b19a1b203c5cfca5bb412b91c795fe6a215506e))
FIX: Removed warnings using flutter v3 (https://github.com/flame-engine/flame/issues/1640). ([69214827](https://github.com/flame-engine/flame/commit/69214827a0edb563468951256eccecab408f89df))
FIX: ParallaxComponent.update mustCallSuper (https://github.com/flame-engine/flame/issues/1635). ([9474ce74](https://github.com/flame-engine/flame/commit/9474ce7425ffc18f6b1a1a35c35f59b76f435166))
FIX: Isometric tile map component uses scale when getting block from position (https://github.com/flame-engine/flame/issues/1569). ([0c430786](https://github.com/flame-engine/flame/commit/0c430786e2774174424a21a13464e93d04c69295))
FIX: Dispose TextBoxComponent image cache properly (https://github.com/flame-engine/flame/issues/1579). ([c0e3257a](https://github.com/flame-engine/flame/commit/c0e3257a0b348885275f2659c351bacbfa5a8732))
FIX: ParentIsA missing mustCallSuper (https://github.com/flame-engine/flame/issues/1604). ([72129019](https://github.com/flame-engine/flame/commit/721290198cc7062f8cfb958cb8499e64be7a1e9c))
FIX: Component can now be removed in any lifecycle stage (https://github.com/flame-engine/flame/issues/1601). ([c0a14156](https://github.com/flame-engine/flame/commit/c0a141563b9e832b1a81bf32d860d4dfb2b359ae))
FIX: Export NotifyingVector2 (https://github.com/flame-engine/flame/issues/1633). ([aeaf9999](https://github.com/flame-engine/flame/commit/aeaf9999b0b4f69e394063d3af8e18f67dff5ed9))
FIX: RectangleHitbox should shrink to bounds (https://github.com/flame-engine/flame/issues/1596). ([60df3b9f](https://github.com/flame-engine/flame/commit/60df3b9f60f538fbad7a3d806f5d38262ab6d66c))
FIX: Components in uninitialized state can now be safely removed (https://github.com/flame-engine/flame/issues/1551). ([ba617790](https://github.com/flame-engine/flame/commit/ba617790e4a7ca4dc03f4a2e29de43d42efd3482))
FIX: Bug in "tty" TextBoxComponent (https://github.com/flame-engine/flame/issues/1619). ([6cc3e827](https://github.com/flame-engine/flame/commit/6cc3e82727509f8877873b095c84eef3543fe01e))
FIX: Component.loaded future sometimes failed to complete (https://github.com/flame-engine/flame/issues/1593). ([89ee9b98](https://github.com/flame-engine/flame/commit/89ee9b984bfc3784dedde1ada1daa992a9f0dedc))
FIX: correctly calculating frame length (https://github.com/flame-engine/flame/issues/1578). ([efda45e7](https://github.com/flame-engine/flame/commit/efda45e76c38a2d38a4cd0bb66ece9792f5832df))
FIX: Optimize AcceleratedParticle and MovingParticle (https://github.com/flame-engine/flame/issues/1568). ([5591c109](https://github.com/flame-engine/flame/commit/5591c109437309907cdac72f0bb479a6a6bfa00a))
FEAT: Method componentsAtPoint now reports the "stacktrace" of points (https://github.com/flame-engine/flame/issues/1615). ([e2398966](https://github.com/flame-engine/flame/commit/e239896624f1e2736de83148ff172ca1b0f97dae))
FEAT: Allow changing parent from null parent (https://github.com/flame-engine/flame/issues/1662). ([53268b5f](https://github.com/flame-engine/flame/commit/53268b5f5fd81f3822bfda9721b97be4e72e48e3))
FEAT: Callbacks in HudButtonComponent constructor and ViewportMargin mixin to avoid code duplication (https://github.com/flame-engine/flame/issues/1685). ([f55b2e0d](https://github.com/flame-engine/flame/commit/f55b2e0dc01c98718e4871430c6745472c221821))
FEAT: Add more lint rules (https://github.com/flame-engine/flame/issues/1703). ([49252f8e](https://github.com/flame-engine/flame/commit/49252f8ef29aa6b77144dcb97c24346f2f39380b))
FEAT: Keep stacktrace when rethrowing an error from GameWidget (https://github.com/flame-engine/flame/issues/1675). ([dd28183b](https://github.com/flame-engine/flame/commit/dd28183bc4ebe2ea2f80d1dab3b5ab22d11b8382))
FEAT: Aligned text in the TextBoxComponent (https://github.com/flame-engine/flame/issues/1620). ([c64aedae](https://github.com/flame-engine/flame/commit/c64aedaeb3fed908722b8872b71e288ff87bc761))
FEAT: Included completed completer in SpriteAnimation (https://github.com/flame-engine/flame/issues/1564). ([71999b19](https://github.com/flame-engine/flame/commit/71999b191af0285e8d61583b041da58afd40d8d2))
FEAT: Optional key for Images.load (https://github.com/flame-engine/flame/issues/1624). ([067c34b5](https://github.com/flame-engine/flame/commit/067c34b5f29e1a9bd51861d872092ae5ee0a551f))
FEAT: Bump to Flutter 2.10.0 (https://github.com/flame-engine/flame/issues/1617). ([beac9013](https://github.com/flame-engine/flame/commit/beac901313456cf0b39b6f4e6459f0feed183614))
FEAT: Add isFirstFrame and onStart event to SpriteAnimation (https://github.com/flame-engine/flame/issues/1492). ([701d0706](https://github.com/flame-engine/flame/commit/701d0706af74e6437d71376d468b32bb2537e5b7))
FEAT: Add FpsComponent and FpsTextComponent (https://github.com/flame-engine/flame/issues/1595). ([4c68c2b0](https://github.com/flame-engine/flame/commit/4c68c2b0a2660e705b30099234da4ab1eb4616d0))
FEAT: Added FollowBehavior and ability for the new Camera to follow a component (https://github.com/flame-engine/flame/issues/1561). ([b583388c](https://github.com/flame-engine/flame/commit/b583388ca432f799ad13b92a3a7bf25ddf98ceb0))
FEAT: Added componentsAtPoint() iterable (https://github.com/flame-engine/flame/issues/1518). ([b99e3512](https://github.com/flame-engine/flame/commit/b99e35120dc4fe81ebfedc89a666286ec489384c))
FEAT: Added AnchorToEffect and AnchorByEffect (https://github.com/flame-engine/flame/issues/1556). ([eff72794](https://github.com/flame-engine/flame/commit/eff72794afed73bdb1df8e14b17d50f0f446e92b))
FEAT: Added utility function solveCubic() (https://github.com/flame-engine/flame/issues/1696). ([31784ca0](https://github.com/flame-engine/flame/commit/31784ca0b05082042003f847be2b4004da83edb6))
FEAT: add FutureOr support on SpriteButton (https://github.com/flame-engine/flame/issues/1645). ([2e82dc95](https://github.com/flame-engine/flame/commit/2e82dc95ecd6d7298239cadad5a746341c37fcd9))
FEAT: MoveAlongPathEffect can now be applied to any PositionProvider (https://github.com/flame-engine/flame/issues/1555). ([a0ff2d18](https://github.com/flame-engine/flame/commit/a0ff2d18a1efc54f648a277453fa9cf6414ce44c))
FEAT: adding KeyboardListenerComponent (https://github.com/flame-engine/flame/issues/1594). ([c887c361](https://github.com/flame-engine/flame/commit/c887c3616e9f65209b8e29cb8575a0052db3e2bb))
FEAT: new flame bloc API (https://github.com/flame-engine/flame/issues/1538). ([f98970a9](https://github.com/flame-engine/flame/commit/f98970a91f91fe70e4a38834d7b69bfcb438d197))
FEAT: Added the onLongTapDown event (https://github.com/flame-engine/flame/issues/1587). ([ed302d89](https://github.com/flame-engine/flame/commit/ed302d89160cd7391e3aaf66a0038cd8f57ceca9))
FEAT: Add ability to add/remove multiple overlays at once (https://github.com/flame-engine/flame/issues/1657). ([0ac84c00](https://github.com/flame-engine/flame/commit/0ac84c0024338cbe87fcff264b83e01192aa355b))
FEAT: Helpers for whether a PositionComponent is flipped. (https://github.com/flame-engine/flame/issues/1700). ([cf67147e](https://github.com/flame-engine/flame/commit/cf67147ea37aed8e5f1dd12def442dccbe4576fd))
FEAT: World bounds for a CameraComponent (https://github.com/flame-engine/flame/issues/1605). ([abb497ab](https://github.com/flame-engine/flame/commit/abb497abe47f6366d27f44d25535924bd7de8a28))
FEAT: Implement tap events based on componentsAtPoint (https://github.com/flame-engine/flame/issues/1661). ([2711ba60](https://github.com/flame-engine/flame/commit/2711ba60c2c700984d8a90d90519e17850038ab4))
FEAT: add ParentIsA to force parent child relations (https://github.com/flame-engine/flame/issues/1566). ([2cdf3868](https://github.com/flame-engine/flame/commit/2cdf3868460f04cee76079e3f81cdd12fb407d3a))
FEAT: Adding classes for raw geometric shapes (https://github.com/flame-engine/flame/issues/1528). ([666a2b19](https://github.com/flame-engine/flame/commit/666a2b199fc740d02628321bb19511ba98de1700))
FEAT: Add solveQuadratic() utility function (https://github.com/flame-engine/flame/issues/1665). ([d8bbfc06](https://github.com/flame-engine/flame/commit/d8bbfc067e3885cedd133de47a98134fc15c9c82))
FEAT: allow external packages to await for game to be loaded (https://github.com/flame-engine/flame/issues/1699). ([a15eda0b](https://github.com/flame-engine/flame/commit/a15eda0b67d6020bcb72162f0186e3c5069674bb))
FEAT: Children as argument to FlameGame (https://github.com/flame-engine/flame/issues/1680). ([db336c03](https://github.com/flame-engine/flame/commit/db336c03b607b878faf618cb1ab5833cd859d0e6))
FEAT: Add range constructor on SpriteAnimationData (https://github.com/flame-engine/flame/issues/1572). ([e42b4958](https://github.com/flame-engine/flame/commit/e42b495805efd2e969cfe412b069ffcc6e828ad6))
FEAT: Add helper function for creating golden tests (https://github.com/flame-engine/flame/issues/1623). ([d0faaada](https://github.com/flame-engine/flame/commit/d0faaada2bb971c2dde5a37dfa20d316c532ea28))
FEAT: Added ability to render spritesheet-based fonts (https://github.com/flame-engine/flame/issues/1634). ([3f287898](https://github.com/flame-engine/flame/commit/3f2878988195606b90d9e48b981444792af08ebe))
BREAKING FIX: FixedResolutionViewport noClip -> clip (https://github.com/flame-engine/flame/issues/1612). ([02be4acd](https://github.com/flame-engine/flame/commit/02be4acd8798254eeaf832863d4000e1c5240db1))
BREAKING FEAT: Adding GameWidget.controlled (https://github.com/flame-engine/flame/issues/1650). ([7ef6a51e](https://github.com/flame-engine/flame/commit/7ef6a51ec60a70807a126b6121a1fd4379b8e19b))
BREAKING FEAT: remove onTimingsCallback for Flutter 3.0 (https://github.com/flame-engine/flame/issues/1626). ([0761a79d](https://github.com/flame-engine/flame/commit/0761a79df6c88a5a6ba74ec78d4f600983657c06))
BREAKING FIX: Game.mouseCursor and Game.overlays can now be safely set during onLoad (https://github.com/flame-engine/flame/issues/1498). ([821d01c3](https://github.com/flame-engine/flame/commit/821d01c3fab3cdd9e80d6ead8d491ea2e8ec0643)) Migration instructions: The mouseCursor property is now a plain property with a setter, not a ChangeNotifier. Consequently, instead of writing game.mouseCursor.value = ..., one needs to write game.mouseCursor = ... now.
BREAKING FEAT: Added anchor for the Viewport (https://github.com/flame-engine/flame/issues/1611). ([c3bb14b7](https://github.com/flame-engine/flame/commit/c3bb14b7ca9513fc75f51b0a5cbc9d986db48dd6)) Migration instructions: The coordinate system of the Viewport now always has the origin in the top-left corner of its bounding box (previously it was in the center) -- similar to the local coordinate system of a PositionComponent.
BREAKING FEAT: Add ability to render without loading on image related widgets (https://github.com/flame-engine/flame/issues/1674). ([40a061bc](https://github.com/flame-engine/flame/commit/40a061bcf06b5bf028911964617c1d1e2599460a)) Migration instructions: It only breaks SpriteButton when you are using future as a sprite or pressedSprite parameter. You should use SpriteButton.future if previously you are using future as a parameter.
BREAKING FEAT: Size effects will now work only on components implementing SizeProvider (https://github.com/flame-engine/flame/issues/1571). ([1bfed571](https://github.com/flame-engine/flame/commit/1bfed57132330fb948962261735a0545eb37e7b9)) Migration instructions: It only breaks SpriteButton when you are using future as a sprite or pressedSprite parameter. You should use SpriteButton.future if previously you are using future as a parameter.
FEAT: Deprecating Rect methods (#1455).
debugMode should be inherited from parent when mounted (#1469). (e894d201)Rect extension docs is out of date (#1451). (7e505722)@mustCallSuper missing on components (#1443). (e01b4b1a)ParallaxComponent should have static positionType (#1350). (cfa6bd12)priority argument for JoystickComponent (#1227). (23b1dd8b)strictMode = false (#1272). (72161ad8)SpriteComponent.fromImage (#1294). (254a60c8)prepareComponent should never run again on a prepared component (#1237). (7d3eeb73)strictMode for children (#1271). (6936e1d9)onCollisionStart for Collidable and HitboxShape (#1251). (9b95686b)transform to Rect (#1360). (1818be41)Component.childrenFactory can be used to set up a global ComponentSet factory (#1193). (223ab758)prepareComponent should never run again on a prepared component (#1237). (7d3eeb73)SpriteComponent.fromImage (#1294). (254a60c8)priority argument for JoystickComponent (#1227). (23b1dd8b)strictMode = false (#1272). (72161ad8)ParallaxComponent should have static positionType (#1350). (cfa6bd12)strictMode for children (#1271). (6936e1d9)onCollisionStart for Collidable and HitboxShape (#1251). (9b95686b)Component.childrenFactory can be used to set up a global ComponentSet factory (#1193). (223ab758)transform to Rect (#1360). (1818be41)Packages with breaking changes:
Packages with other changes:
flame_rive - v1.9.1flame_tiled - v1.13.0flame_isolate - v0.4.0+2flame_audio - v2.0.5flame_spine - v0.1.1+1flame_svg - v1.8.1flame_test - v1.12.1flame_oxygen - v0.1.8+5flame_bloc - v1.10.1flame_fire_atlas - v1.3.8flame_forge2d - v0.14.1+1flame_noise - v0.1.1+4flame_network_assets - v0.2.0+4flame_lottie - v0.2.1+1Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flame_isolate - v0.4.0+2flame_audio - v2.0.5flame_spine - v0.1.1+1flame_svg - v1.8.1flame_test - v1.12.1flame_oxygen - v0.1.8+5flame_bloc - v1.10.1flame_fire_atlas - v1.3.8flame_forge2d - v0.14.1+1flame_noise - v0.1.1+4flame_network_assets - v0.2.0+4flame_lottie - v0.2.1+1FIX: @mustCallSuper missing on components (#1443).
FIX: Setting images.prefix to empty string (#1437).
REFACTOR: Parent change and component removal logic (#1385).
FIX: Deprecate pause and resume in GameLoop (#1240).
ParallaxComponent should have static positionType (#1350). (cfa6bd12)priority argument for JoystickComponent (#1227). (23b1dd8b)strictMode = false (#1272). (72161ad8)SpriteComponent.fromImage (#1294). (254a60c8)prepareComponent should never run again on a prepared component (#1237). (7d3eeb73)strictMode for children (#1271). (6936e1d9)onCollisionStart for Collidable and HitboxShape (#1251). (9b95686b)transform to Rect (#1360). (1818be41)Component.childrenFactory can be used to set up a global ComponentSet factory (#1193). (223ab758)FIX: flame svg perfomance (#1373).
Note: This release has breaking changes.
Add ButtonComponent backed by two PositionComponents
ButtonComponent backed by two PositionComponentsSpriteButtonComponent backed by two SpritesEffectControllers and make them able to run back in timeupdateTree to follow the renderTree conventionParallax.load with different loading timesHitboxCircle when component is flippedColorEffectMoveAlongPathEffect can now be absolute, and can auto-orient the object along the pathScaleEffect.by now applies multiplicatively instead of additivelyisHud replaced with PositionTypedrawAtlas in SpriteBatch, but added flag useAtlas to activate itTakes priority as an argument on SvgComponent
renderPositionOne column per quarter.