Flutter Flame Game Specialist
IponeRacing/flutterFlameGameSpecialist
Cria jogos Flutter 2D production-ready com Flame, assets CC0 e physics.
Ver no GitHubAgent especializado em desenvolvimento de jogos 2D em Flutter usando a engine Flame. Domina sprites, tilemaps, física com Box2D, áudio, câmera com parallax e overlays HUD — com conhecimento profundo de fontes CC0 (Kenney, OGA, Itch).
Instalação
npx convez-ai IponeRacing/flutterFlameGameSpecialist1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolver jogos 2D indie com sprites e tilemaps
- Implementar mecânicas de física, colisão e câmera
- Integrar áudio, animações multi-state e HUD Flutter
- Estruturar projetos escaláveis com TexturePacker e asset management
Veredito

Agent robusto e prático para quem quer criar jogos 2D em Flutter sem se perder em decisões de assets. Conhecimento consolidado de Flame, CC0 e workflows reais, mas exige familiaridade prévia com Flutter e conceitos de game design.
README
A tradução para o português deste README ainda está na fila.
Flutter Flame Game Specialist
A Claude Code sub-agent that builds production-quality Flutter 2D games with the Flame engine — sprites, tilemaps, physics, audio, camera, parallax, and Flutter HUD overlays. Knows every major CC0/royalty-free asset source by game type and license.
What it delivers
| Feature | Technique |
|---|---|
| 🎮 Sprite rendering | SpriteComponent + FilterQuality.none for crisp pixel art |
| 🏃 Multi-state animation | SpriteAnimationGroupComponent<State> (idle/run/jump/attack) |
| 🗺️ Tilemap loading | TiledComponent + Tiled Editor workflow with Kenney tilesets |
| 🌅 Parallax backgrounds | ParallaxComponent with velocity multiplier per layer |
| 🔊 Audio | flame_audio pre-loaded in onLoad(), BGM + SFX |
| 🎯 Collision | RectangleHitbox + CollisionCallbacks + HasCollisionDetection |
| 📷 Camera | CameraComponent.withFixedResolution() + follow() + bounds |
| ⚙️ Physics | flame_forge2d Box2D with BodyComponent pattern |
| 🖥️ HUD / Menus | Flutter GameWidget overlays with ValueNotifier bridge |
| 🎨 Pixel fonts | Google Fonts Press Start 2P, VT323, Silkscreen |
| 📦 TexturePacker | flame_texturepacker for multi-atlas sprite sheets |
| 🧱 RPG extension | bonfire top-down RPG layer on Flame |
Free CC0 Asset Sources (built into agent knowledge)
🥇 Kenney.nl — The Gold Standard
License: CC0 (public domain) — zero attribution required
| Pack | Game type | Tile size |
|---|---|---|
| Platformer Pack | Platformer | 64×64 |
| Pixel Platformer | Pixel platformer | 16×16 |
| RPG Urban Pack | Top-down RPG | 16×16 |
| Tiny Town | Top-down RPG | 16×16 |
| Space Shooter Redux | Space shooter | varies |
| UI Pack | All games HUD | varies |
| Game Icons | All games | 64×64 |
| Interface Sounds | UI SFX | .ogg/.mp3 |
| RPG Audio | RPG SFX | .ogg/.mp3 |
60,000+ assets, all CC0, vectors included. Download from kenney.nl/assets.
🟢 Other CC0 Sources
| Source | Best for | URL |
|---|---|---|
| 0x72 (Itch.io) | Dungeon tileset + animated chars | 0x72.itch.io/dungeontileset-ii |
| OpenGameArt CC0 | Varied sprites, music, SFX | opengameart.org/content/cc0-resources |
| Superpowers Packs | Themed complete kits | github.com/sparklinlabs/superpowers-asset-packs |
| SONNISS GDC Bundle | Pro SFX library (20GB+/year) | sonniss.com/gameaudiogdc |
| Freesound.org | SFX (filter CC0) | freesound.org |
| Google Fonts | Pixel fonts (OFL) | fonts.google.com |
| Public Pixel Font | Multilingual pixel font | ggbot.itch.io/public-pixel-font |
🔵 Royalty-Free (attribution not required, cannot redistribute)
| Source | Quality | URL |
|---|---|---|
| CraftPix Freebies | ⭐⭐⭐⭐⭐ | craftpix.net/freebies |
| GameArt2D | ⭐⭐⭐⭐ | gameart2d.com/freebies.html |
| Mixkit SFX | ⭐⭐⭐⭐ | mixkit.co/free-sound-effects/game |
Installation
Project-level
mkdir -p your-project/.claude/agents
cp agents/flutter-flame-game-specialist.md your-project/.claude/agents/
Global (all Claude Code sessions)
mkdir -p ~/.claude/agents
cp agents/flutter-flame-game-specialist.md ~/.claude/agents/
Usage examples
Set up a Flame platformer project:
- Virtual resolution 640×360
- Kenney Pixel Platformer tileset loaded via Tiled
- Player with idle/run/jump animations (SpriteAnimationGroupComponent)
- Parallax background with 4 layers
- Coin pickup with SFX from Kenney Interface Sounds
- Score HUD as Flutter overlay with Press Start 2P font
Add flame_audio to the existing Flame game:
- Pre-load all SFX in onLoad()
- Background music loop with pause/resume on app lifecycle
- Coin collect, jump, hit, level complete sounds from Kenney CC0 packs
Build a top-down RPG level from a Tiled .tmx map:
- TiledComponent loading level_01.tmx
- Object layer to spawn Player, Enemies, Items
- Collision layer mapped to RectangleHitbox
- CameraComponent following the player within level bounds
Packages used
flame: ^1.20.0
flame_audio: ^2.10.0
flame_tiled: ^1.20.0
flame_texturepacker: ^1.9.0
flame_forge2d: ^0.19.0
bonfire: ^3.12.0 # optional: RPG extension
google_fonts: ^6.2.1
Anti-patterns prevented
| ❌ Common mistake | ✅ Correct |
|---|---|
images.load() in update() | Load once in onLoad(), store in field |
HUD drawn in Flame render() | Use GameWidget overlay (Flutter widgets) |
Legacy Camera class | CameraComponent.withFixedResolution() |
FilterQuality.high on pixel art | FilterQuality.none for crisp pixels |
No HasCollisionDetection mixin | Add to FlameGame — hitboxes won't fire without it |
| CC-BY asset without credits screen | Use CC0 only, or add proper attribution |
Large .wav audio files | .mp3 for music, .ogg for SFX |
Related agents
- flutter-ui-specialist — Candy gradients, liquid glass, spring animations for Flutter app UI (menus, onboarding, non-game screens)
- flutter-payment-specialist — Apple StoreKit 2, Google Play Billing, Stripe for monetizing your game
License
MIT — EngageEngine