flame-core

Flame Core Fundamentals

Flame Engine core foundation, covering the component system, input handling, collision detection, camera, animation, and scene management.

Quick Start

flutter create my_game && cd my_game
flutter pub add flame
flutter pub add flame_audio       # Optional
flutter pub add flame_tiled       # Optional

import 'package:flame/game.dart';
import 'package:flutter/material.dart';

void main() => runApp(GameWidget(game: MyGame()));

class MyGame extends FlameGame with HasCollisionDetection { @override Future onLoad() async { camera.viewfinder.anchor = Anchor.topLeft; } }


## Reference Index

| Topic | File | Description |
|-------|------|-------------|
| **Components** | `references/components.md` | 組件生命週期、類型、最佳實踐 |
| **Input** | `references/input.md` | 觸控、鍵盤、搖桿輸入處理 |
| **Collision** | `references/collision.md` | 碰撞檢測、Hitbox 類型 |
| **Camera** | `references/camera.md` | 相機設置、跟隨、HUD |
| **Animation** | `references/animation.md` | 精靈動畫、Effects 系統 |
| **Scenes** | `references/scenes.md` | RouterComponent、Overlays、UI |
| **Audio** | `references/audio.md` | 音效、背景音樂、AudioPool |
| **Particles** | `references/particles.md` | 粒子系統、特效、爆炸效果 |
| **Performance** | `references/performance.md` | 效能優化、最佳實踐、常見問題 |
| **Debug** | `references/debug.md` | 除錯模式、日誌、效能監控 |

## AI Usage Guide

Need to understand the component system? → Read references/components.md Need to handle input? → Read references/input.md Need collision detection? → Read references/collision.md Need camera setup? → Read references/camera.md Need animation effects? → Read references/animation.md Need scene management/UI? → Read references/scenes.md Need sound effects/music? → Read references/audio.md Need particle effects? → Read references/particles.md Need performance optimization? → Read references/performance.md Need debugging/logging? → Read references/debug.md


## Component Types Quick Reference

| Type | Use Case |
|------|----------|
| `Component` | Logic only |
| `PositionComponent` | Has position/size |
| `SpriteComponent` | Static image |
| `SpriteAnimationComponent` | Animated sprite |
| `SpriteAnimationGroupComponent` | Multiple states |

## Related Skills

- `flame-systems` - 14 個遊戲系統（任務、對話、背包等）
- `flame-templates` - 遊戲類型模板（RPG、平台、Roguelike）

About this skill

Quick Start