Flame Core Fundamentals
Flame Engine 核心基礎，涵蓋組件系統、輸入處理、碰撞檢測、相機、動畫與場景管理。
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<void> 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
需要了解組件系統？ → Read references/components.md
需要處理輸入？ → Read references/input.md
需要碰撞檢測？ → Read references/collision.md
需要相機設置？ → Read references/camera.md
需要動畫效果？ → Read references/animation.md
需要場景管理/UI？ → Read references/scenes.md
需要音效/音樂？ → Read references/audio.md
需要粒子特效？ → Read references/particles.md
需要效能優化？ → Read references/performance.md
需要除錯/日誌？ → 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）
