mbuyco/flame-core

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）