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）