Back to Details

flame-game-dev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Flame Game Development

Flame游戏开发

Flame Engine 遊戲開發完整指南，包含核心基礎、14 個遊戲系統、3 種遊戲類型模板。
Flame Engine游戏开发完整指南，包含核心基础、14个游戏系统、3种游戏类型模板。

Sub-Skills Index

子技能索引

SkillDescriptionReference Count
flame-core引擎核心基礎10 references
flame-systems14 個遊戲系統14 references
flame-templates遊戲類型模板3 references
技能描述参考文档数量
flame-core引擎核心基础10份参考文档
flame-systems14个游戏系统14份参考文档
flame-templates游戏类型模板3份参考文档

Quick Navigation

快速导航

flame-core (核心基礎)

flame-core（核心基础）

components.md   - 組件生命週期、類型
input.md        - 觸控、鍵盤、搖桿
collision.md    - 碰撞檢測、Hitbox
camera.md       - 相機、HUD、視口
animation.md    - 精靈動畫、Effects
scenes.md       - RouterComponent、Overlays、UI
audio.md        - 音效、背景音樂
particles.md    - 粒子系統、特效
performance.md  - 效能優化、最佳實踐
debug.md        - 除錯模式、日誌
components.md   - 组件生命周期、类型
input.md        - 触控、键盘、摇杆
collision.md    - 碰撞检测、Hitbox
camera.md       - 相机、HUD、视口
animation.md    - 精灵动画、特效
scenes.md       - RouterComponent、Overlays、UI
audio.md        - 音效、背景音乐
particles.md    - 粒子系统、特效
performance.md  - 性能优化、最佳实践
debug.md        - 调试模式、日志

flame-systems (遊戲系統)

flame-systems（游戏系统）

quest.md        - 任務系統         achievement.md - 成就系統
dialogue.md     - 對話系統         shop.md        - 商店系統
localization.md - 多語言系統       crafting.md    - 製作系統
inventory.md    - 背包系統         procedural.md  - 程序生成
paperdoll.md    - 紙娃娃系統       multiplayer.md - 多人連線
combat.md       - 戰鬥系統         leveleditor.md - 關卡編輯器
skills.md       - 技能系統
saveload.md     - 存檔系統
quest.md        - 任务系统         achievement.md - 成就系統
dialogue.md     - 对话系统         shop.md        - 商店系统
localization.md - 多语言系统       crafting.md    - 制作系统
inventory.md    - 背包系统         procedural.md  - 程序生成
paperdoll.md    - 纸娃娃系统       multiplayer.md - 多人连线
combat.md       - 战斗系统         leveleditor.md - 关卡编辑器
skills.md       - 技能系統
saveload.md     - 存档系统

flame-templates (遊戲模板)

flame-templates（游戏模板）

rpg.md          - 回合制/動作 RPG
platformer.md   - 橫向卷軸平台遊戲
roguelike.md    - 程序生成地下城
rpg.md          - 回合制/动作RPG
platformer.md   - 横向卷轴平台游戏
roguelike.md    - 程序生成地下城

AI Usage Guide

AI使用指南

undefined
undefined

基礎問題

基础问题

需要了解 Flame？ → 先讀 flame-core/SKILL.md 需要特定功能？ → 根據 flame-core 索引讀取對應 reference
需要了解Flame？ → 先阅读 flame-core/SKILL.md 需要特定功能？ → 根据flame-core索引读取对应参考文档

系統實作

系统实现

需要任務/對話系統？ → 讀 flame-systems/references/quest.md 或 dialogue.md 需要戰鬥系統？ → 讀 flame-systems/references/combat.md + skills.md 需要存檔功能？ → 讀 flame-systems/references/saveload.md 需要多人連線？ → 讀 flame-systems/references/multiplayer.md
需要任务/对话系统？ → 阅读 flame-systems/references/quest.md 或 dialogue.md 需要战斗系统？ → 阅读 flame-systems/references/combat.md + skills.md 需要存档功能？ → 阅读 flame-systems/references/saveload.md 需要多人连线？ → 阅读 flame-systems/references/multiplayer.md

完整遊戲

完整游戏

要做 RPG？ → 讀 flame-templates/references/rpg.md 要做平台遊戲？ → 讀 flame-templates/references/platformer.md 要做 Roguelike？ → 讀 flame-templates/references/roguelike.md
要做RPG？ → 阅读 flame-templates/references/rpg.md 要做平台游戏？ → 阅读 flame-templates/references/platformer.md 要做Roguelike？ → 阅读 flame-templates/references/roguelike.md

部署發布

部署发布

要發布遊戲？ → 參考下方「部署平台」章節
undefined
要发布游戏？ → 参考下方「部署平台」章节
undefined

Quick Start

快速开始

bash
flutter create my_game && cd my_game
flutter pub add flame
flutter pub add flame_audio       # 選用
flutter pub add flame_tiled       # 選用
dart
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;
    // 開始建構你的遊戲！
  }
}
bash
flutter create my_game && cd my_game
flutter pub add flame
flutter pub add flame_audio       # 可选
flutter pub add flame_tiled       # 可选
dart
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;
    // 开始构建你的游戏！
  }
}

部署平台

部署平台

Flame 基於 Flutter，支援多平台部署：
平台發布管道指令
iOSApp Store
flutter build ios --release
AndroidGoogle Play
flutter build apk --release
Webitch.io / GitHub Pages
flutter build web --release
macOSApp Store / 獨立
flutter build macos --release
WindowsSteam / 獨立
flutter build windows --release
LinuxSteam / 獨立
flutter build linux --release
Flame基于Flutter，支持多平台部署：
平台发布渠道命令
iOSApp Store
flutter build ios --release
AndroidGoogle Play
flutter build apk --release
Webitch.io / GitHub Pages
flutter build web --release
macOSApp Store / 独立分发
flutter build macos --release
WindowsSteam / 独立分发
flutter build windows --release
LinuxSteam / 独立分发
flutter build linux --release

發布到 itch.io (Web)

发布到itch.io（Web）

bash
undefined
bash
undefined

1. 建置 Web 版本

1. 构建Web版本

flutter build web --release --web-renderer canvaskit
flutter build web --release --web-renderer canvaskit

2. 上傳 build/web 資料夾到 itch.io

2. 上传build/web文件夹到itch.io

3. itch.io 設置

3. itch.io设置

- Kind of project: HTML

- 项目类型：HTML

- Embed options: Click to launch in fullscreen

- 嵌入选项：点击全屏启动

undefined
undefined

發布到 Google Play (Android)

发布到Google Play（Android）

bash
undefined
bash
undefined

1. 建立 keystore

1. 创建keystore

keytool -genkey -v -keystore ~/my-game.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-game
keytool -genkey -v -keystore ~/my-game.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-game

2. 設定 android/key.properties

2. 配置android/key.properties

storePassword=<password> keyPassword=<password> keyAlias=my-game storeFile=/Users/you/my-game.jks
storePassword=<password> keyPassword=<password> keyAlias=my-game storeFile=/Users/you/my-game.jks

3. 建置 App Bundle

3. 构建App Bundle

flutter build appbundle --release
flutter build appbundle --release

4. 上傳 build/app/outputs/bundle/release/app-release.aab

4. 上传build/app/outputs/bundle/release/app-release.aab

undefined
undefined

發布到 Steam (Desktop)

发布到Steam（桌面端）

bash
undefined
bash
undefined

1. 建置 Desktop 版本

1. 构建桌面版本

flutter build windows --release # 或 macos / linux
flutter build windows --release # 或macos / linux

2. 使用 Steamworks SDK 打包

2. 使用Steamworks SDK打包

- 設定 app_build.vdf

- 配置app_build.vdf

- 上傳到 Steam Partner

- 上传到Steam Partner

3. 建議加入 Steam 成就整合

3. 建议整合Steam成就

flutter pub add steamworks

flutter pub add steamworks

undefined
undefined

Dependency Graph

依赖关系图

flame-game-dev (總索引)
    │
    ├── flame-core (核心基礎)
    │   └── 10 reference files
    │
    ├── flame-systems (遊戲系統)
    │   └── 14 reference files
    │
    └── flame-templates (遊戲模板)
        └── 3 reference files
flame-game-dev (总索引)
    │
    ├── flame-core (核心基础)
    │   └── 10份参考文档
    │
    ├── flame-systems (游戏系统)
    │   └── 14份参考文档
    │
    └── flame-templates (游戏模板)
        └── 3份参考文档

Best Practices

最佳实践

  1. 按需載入 - 只讀取需要的 reference，節省 token
  2. 核心優先 - 先熟悉 flame-core，再擴展系統
  3. 模板參考 - 用模板作為起點，按需添加系統
  4. 模組化 - 每個系統獨立，可組合使用
  1. 按需加载 - 只读取需要的参考文档，节省token
  2. 核心优先 - 先熟悉flame-core，再扩展系统
  3. 模板参考 - 以模板为起点，按需添加系统
  4. 模块化 - 每个系统独立，可组合使用

Version History

版本历史

  • v2.2.0 - 新增部署平台指南（itch.io、Google Play、Steam）
  • v2.1.0 - 新增 Audio、Particles、Performance references
  • v2.0.0 - 重構為三個子 skills，模組化架構
  • v1.0.0 - 初始版本（單一大檔案）
  • v2.2.0 - 新增部署平台指南（itch.io、Google Play、Steam）
  • v2.1.0 - 新增Audio、Particles、Performance参考文档
  • v2.0.0 - 重构为三个子技能，模块化架构
  • v1.0.0 - 初始版本（单一大文件）