flame-core

Flame Core の基礎

Flame Engine のコア基礎であり、コンポーネントシステム、入力処理、衝突判定、カメラ、アニメーション、シーン管理を網羅しています。

クイックスタート

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;
  }
}

リファレンス索引

トピック	ファイル	説明
コンポーネント	references/components.md	コンポーネントのライフサイクル、型、ベストプラクティス
入力	references/input.md	タッチ、キーボード、ジョイスティック入力の処理
衝突	references/collision.md	衝突判定、Hitbox の種類
カメラ	references/camera.md	カメラ設定、フォロー、HUD
アニメーション	references/animation.md	スプライトアニメーション、Effects システム
シーン	references/scenes.md	RouterComponent、Overlays、UI
オーディオ	references/audio.md	効果音、BGM、AudioPool
パーティクル	references/particles.md	パーティクルシステム、エフェクト、爆発エフェクト
パフォーマンス	references/performance.md	パフォーマンス最適化、ベストプラクティス、よくある問題
デバッグ	references/debug.md	デバッグモード、ログ、パフォーマンス監視

AI 活用ガイド

需要了解組件系統？ → 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	ロジックのみ
PositionComponent	位置/サイズを持つ
SpriteComponent	静止画像
SpriteAnimationComponent	アニメーションするスプライト
SpriteAnimationGroupComponent	複数の状態

関連スキル

• flame-systems - 14 個のゲームシステム（クエスト、会話、インベントリなど）
• flame-templates - ゲームジャンルのテンプレート（RPG、プラットフォーマー、Roguelike）