找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
跳到内容
FlexCore开发者社区

学习与实践

文档中心

从入门操作到版本更新,找到适合当前阶段的说明。

游戏模板

模板是一个可以直接跑起来的游戏起点。它已经写好了基础规则、示例代码和配置文件,你不需要从零开始,只需要在它的基础上改。

你可以把模板当成一张"半成品地图":框架和素材都摆好了,你只需要替换内容、调整细节,就能做出属于自己的游戏。


模板能做成什么样的游戏

FlexCore 的目标是"通用游戏引擎",所以模板能覆盖的玩法非常广。你可以想象这些方向:

🌍 MMO / 共享世界

一个大世界里很多人同时在线。

  • 地图、传送、频道切换
  • 实体同步、AOI 视野
  • 怪物刷新、装备掉落
  • 公会、组队、交易

想象一下:玩家从新手村出发,穿过城门进入野外,遇到其他玩家组队打 Boss,掉落的装备可以交易——这些是共享世界项目需要实现的玩法目标,当前 basic 模板不包含这套完整玩法。

🃏 卡牌 / 策略

回合制对局、卡牌组合、策略博弈。

  • 对局流程(开局、抽牌、出牌、结算)
  • 卡牌数据结构(费用、效果、稀有度)
  • 房间匹配、排行榜

想象一下:每张卡是一份数据定义,效果用脚本写;对局房间是一个隔离的 World;胜负结算后更新排名。卡牌项目需要逐步搭建这套流程,再扩充卡牌内容。

🏭 经营 / 养成

资源循环、生产链、长期养成。

  • 资源产出与消耗(金币、材料、人口)
  • 建筑/单位的生产规则
  • 升级树、科技树
  • 离线收益、定时事件

想象一下:农场每小时产出小麦,小麦可以加工成面粉,面粉可以做成面包卖给 NPC——整条生产链由模板里的规则驱动,你只需要定义新的产品。

📖 剧情 / 互动

对话、选择、分支、任务。

  • 对话系统(选项、表情、立绘)
  • 分支剧情、好感度
  • 任务流程、成就
  • 存档与读档

想象一下:玩家和 NPC 对话时选择不同选项,会触发不同剧情分支,影响最终结局。剧情项目需要准备对话与事件流程,再接入故事内容。

🎉 社交 / 派对

多人小游戏集合、房间玩法。

  • 房间创建与匹配
  • 多个小游戏轮换
  • 积分、奖励、好友
  • 实时语音/表情互动

想象一下:玩家进入一个大厅,选择想玩的小游戏(你画我猜、躲猫猫、答题),每局几分钟,结束后回到大厅。派对项目需要自行组织房间和轮换机制。

🧪 空白创作

完全自由的起点,没有任何预设玩法。

  • 只有最基础的脚本入口
  • 你从零定义一切
  • 适合实验新想法、做原型

想象一下:你有一个全新的游戏点子,不想被任何预设束缚——空白模板给你一张白纸,从"打印一行 Hello"开始。


当前有哪些模板

上面这些方向是可逐步实现的游戏设计方向,并非已提供对应成品模板的承诺,但目前内置的模板还很少:

类型模板名说明
服务端basic最基础的服务端起点,包含可运行的示例代码
客户端blank空白客户端起点

内置模板会陆续丰富。在那之前,你可以用 basic 作为起点,参考上面的方向自己一步步改成想要的玩法。社区和团队也可能提供更多模板。


怎么使用模板

整个过程分三步:选模板 → 创建工程 → 运行并修改。

第一步:创建工程

# 创建服务端工程(不指定模板时使用默认的 basic 模板)
fc-tools server init --project ./my-game/server --install --engine-root ./engine

# 创建客户端工程(不指定模板时使用默认的 blank 模板)
fc-tools client init --project ./my-game/client --engine-root ./engine

上述 ./engine 代表你选择的已解压引擎目录,可换成自己的路径。服务端 --install 从所选引擎离线恢复 SDK 和配套编译器;客户端同样从 --engine-root 恢复配套输入。普通 npm install 不保证得到随包预发布 SDK。

--template 是可选的。不写就用默认模板;写了就用你指定的模板。

# 指定模板(内置模板名或外部路径)
fc-tools server init --project ./my-game/server --install --engine-root ./engine --template basic
fc-tools server init --project ./my-game/server --install --engine-root ./engine --template /path/to/your-template

第二步:启动示例

创建完成后,工程里已经有一份能直接跑的示例代码。先跑起来看看效果,确认一切正常。

basic 模板创建出来的服务端工程大概长这样:

my-game/server/
├── scripts/
│   ├── main.ts       ← 游戏逻辑入口
│   └── schema.ts     ← 数据结构定义
└── config/
    └── game.json     ← 基础配置

入口脚本 main.ts 会注册一个最简单的玩法模块,启动时打印一行日志、初始化世界——这就是你的第一个"能跑的游戏"。

第三步:改第一个内容

不要一上来就大改。先改一个最小的地方——比如改一行打印、换一个数值、加一个属性——看到改动生效了,再继续扩展。

这种"小步快跑"的方式能让你少踩很多坑。


怎么获取更多模板

除了内置模板,你还可以通过这些方式获得模板:

  • 社区模板:其他开发者分享的模板
  • 团队模板:你所在团队或合作方提供的模板
  • 自制模板:把做好的项目整理成模板复用

使用外部模板时,直接把路径传给 --template:

fc-tools server init --project ./my-game/server --install --engine-root ./engine --template /path/to/your-template

工具链会对外部模板做安全检查(防止符号链接攻击、路径越界等),确认安全后才会应用。


模板的内部结构

如果你好奇模板里面到底有什么,或者想自己制作模板,这一节会帮到你。

服务端模板和客户端模板不一样

服务端模板和客户端模板是两套独立的东西,文件格式、字段名、内容都不同。

服务端模板用一个叫 game-template.json 的文件描述自己。它告诉工具链:这个模板叫什么、入口脚本在哪、要复制哪些文件、依赖哪些玩法模块。

下面是服务端模板清单的结构示意(摘要占位不能直接用于导入):

{
  "formatVersion": 1,
  "id": "@flexcore/basic-server",
  "version": "1.0.0",
  "displayName": "FlexCore 基础服务端模板",
  "entry": "scripts/main.ts",
  "schema": "scripts/schema.ts",
  "projectFiles": [
    {
      "source": "project/scripts/main.ts",
      "target": "scripts/main.ts",
      "checksum": "sha256:..."
    }
  ],
  "gameplayModules": []
}

每个字段的作用:

字段作用
formatVersion模板清单的格式版本(当前是 1,必填)
id模板唯一标识
version模板版本号
displayName给人看的模板名称
entry游戏逻辑入口脚本
schema数据结构定义入口
projectFiles创建工程时要复制的文件清单
gameplayModules依赖的玩法模块(可以为空)

客户端模板用 template.yaml 描述,字段和服务端完全不同。客户端模板更关心渲染、资源、场景这些事。

服务端关心"规则和数据怎么跑",客户端关心"画面和交互怎么呈现"。所以两者用不同的模板格式。

关于 projectFiles

projectFiles 是模板最核心的部分。它决定了"创建工程时会复制哪些文件"。

每个文件条目包含三个字段:

  • source:模板里的源文件位置
  • target:复制到工程后的目标位置
  • checksum:文件指纹,用来验证复制是否完整

一个重要行为:如果工程里已经存在同名文件,模板不会覆盖它。这是为了保护你已经写好的代码——即使你重复执行 init,也不会丢东西。

关于 gameplayModules

有些模板会依赖额外的"玩法模块"(比如登录系统、背包系统、战斗系统等其他人发布的NPM库)。模板可以在 gameplayModules 里声明这些依赖。

创建工程时,工具链会自动把这些模块安装到你的工程里,你不需要手动一个个装,可以像搭积木一样来实现自己的游戏世界。

当前的 basic 模板没有声明任何模块(gameplayModules 是空数组),表示它是最纯净的起点。


怎么把自己的项目变成模板

当你做出一套可复用的游戏起点,可以把它整理成模板分享给别人:

  • 保留通用部分:规则、数据、场景、示例代码
  • 删除私密内容:密钥、生产配置、无授权素材
  • 写清楚说明:用途、版本、授权方式
  • 空目录验证:在一个干净的地方创建一次工程,确认能正常启动
  • 发布或交付:发到社区,或交给授权的合作方

整理模板的核心原则是:只保留别人真正需要的东西,去掉所有和你私人项目绑定的部分。当然你也可以把所有文件打包授权给其他人运营


关于授权

模板可以免费、付费、按项目授权,也可以只给指定合作方用。

无论你是发布者还是使用者,都要注意:

  • 发布者要说明是否允许商用、修改、再分发、转授权
  • 使用者要在获得授权后才能用,不能因为"能下载"就等于"能用"
  • 模板里包含的素材、模块、第三方库,要分别确认它们的授权范围

技术上能拿到文件,不代表法律上允许使用。授权这件事一定要写清楚、看清楚。

Archiver|小黑屋|FlexCore开发者社区

GMT+8, 2026-11-20 00:20 , Processed in 0.099909 second(s), 5 queries .

Powered by Discuz! X5.0

© 2001-2026 Discuz! Team.

返回顶部