游戏模板
模板是一个可以直接跑起来的游戏起点。它已经写好了基础规则、示例代码和配置文件,你不需要从零开始,只需要在它的基础上改。
你可以把模板当成一张"半成品地图":框架和素材都摆好了,你只需要替换内容、调整细节,就能做出属于自己的游戏。
模板能做成什么样的游戏
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 是空数组),表示它是最纯净的起点。
怎么把自己的项目变成模板
当你做出一套可复用的游戏起点,可以把它整理成模板分享给别人:
- 保留通用部分:规则、数据、场景、示例代码
- 删除私密内容:密钥、生产配置、无授权素材
- 写清楚说明:用途、版本、授权方式
- 空目录验证:在一个干净的地方创建一次工程,确认能正常启动
- 发布或交付:发到社区,或交给授权的合作方
整理模板的核心原则是:只保留别人真正需要的东西,去掉所有和你私人项目绑定的部分。当然你也可以把所有文件打包授权给其他人运营
关于授权
模板可以免费、付费、按项目授权,也可以只给指定合作方用。
无论你是发布者还是使用者,都要注意:
- 发布者要说明是否允许商用、修改、再分发、转授权
- 使用者要在获得授权后才能用,不能因为"能下载"就等于"能用"
- 模板里包含的素材、模块、第三方库,要分别确认它们的授权范围
技术上能拿到文件,不代表法律上允许使用。授权这件事一定要写清楚、看清楚。