创游世界实战项目模板
一句话摘要
本文提供一个可直接使用的游戏项目结构模板，涵盖目录组织、文件命名规范、脚本分层架构和典型系统示例，帮助你快速建立可维护的项目基础。
适合谁阅读
- 已经学会基础操作，想要开始做完整项目的创作者
- 项目做到一半变得混乱，想要重构的项目开发者
- 需要参考项目结构的教程学习者
你将学到什么
- 如何组织项目的目录结构
- 如何命名和管理素材、物体、脚本
- 如何分层设计项目架构
- 如何建立可复用的系统模板
- 如何避免常见的项目混乱问题
核心结论
- 目录结构要清晰：把同类资源放在一起，方便查找和维护
- 命名要统一规范：使用一致的命名风格，避免混淆
- 分层要明确：UI 层、地图层、组件层、系统层各司其职
- 广播要解耦：通过广播连接不同层，避免硬绑死
- 配置要集中：把同类配置放在一起，便于调整
1. 项目目录结构
1.1 推荐目录组织
一个结构良好的创游世界项目，推荐按以下方式组织目录：
项目文件夹
│
├── 📁 素材库（按功能分类）
│ ├── 📁 角色
│ │ ├── 玩家_默认
│ │ ├── 敌人_近战
│ │ └── 敌人_远程
│ ├── 📁 道具
│ │ ├── 消耗品
│ │ └── 装备
│ ├── 📁 场景
│ │ ├── 地块
│ │ ├── 装饰
│ │ └── 机关
│ ├── 📁 UI素材
│ │ ├── 按钮
│ │ ├── 图标
│ │ └── 背景
│ └── 📁 特效
│ ├── 粒子
│ └── 动效
│
├── 📁 地图
│ ├── 📁 主界面
│ │ └── 主界面_地图
│ ├── 📁 关卡
│ │ ├── 关卡1_草地
│ │ ├── 关卡2_森林
│ │ └── 关卡3_洞穴
│ └── 📁 特殊场景
│ ├── 战斗场景
│ └── 结算场景
│
├── 📁 组件库（自定义组件）
│ ├── 📁 通用
│ │ ├── 血量管理
│ │ ├── 伤害计算
│ │ └── 状态机
│ ├── 📁 UI
│ │ ├── 刷新逻辑
│ │ └── 动画控制
│ └── 📁 系统
│ ├── 存档管理
│ └── 任务追踪
│
├── 📁 脚本库（常用脚本模板）
│ ├── 📁 UI脚本
│ ├── 📁 地图脚本
│ └── 📁 工具脚本
│
└── 📁 文档（项目说明）
├── 系统设计说明.md
└── 广播命名规范.md1.2 目录命名规范
| 类型 | 命名规则 | 示例 |
|---|---|---|
| 素材文件夹 | 功能_类型 | 角色_怪物、道具_消耗品 |
| 地图文件夹 | 场景_编号_名称 | 关卡1_草地、主界面_大厅 |
| 组件文件夹 | 系统_功能 | 通用_血量管理、UI_刷新逻辑 |
| 脚本文件夹 | 类型_功能 | UI脚本_背包、工具_随机事件 |
1.3 素材命名规范
| 类型 | 命名规则 | 示例 |
|---|---|---|
| 角色素材 | 角色类型_名称 | 玩家_战士、敌人_哥布林 |
| 道具素材 | 道具类型_名称 | 消耗品_血瓶、装备_武器 |
| 地块素材 | 地块类型_名称 | 地面_草地、障碍_石头 |
| UI素材 | UI类型_名称 | 按钮_确定、图标_金币 |
2. 脚本分层架构
2.1 四层架构模型
创游世界项目推荐采用以下四层架构：
┌─────────────────────────────────────────┐
│ UI 层（表现层） │
│ - 负责显示和接收输入 │
│ - 通过广播通知地图层处理请求 │
│ - 不直接修改核心数据 │
└─────────────────────────────────────────┘
↓ 广播
┌─────────────────────────────────────────┐
│ 地图层（逻辑层） │
│ - 负责处理业务逻辑 │
│ - 集中管理地图级数据 │
│ - 发送结果广播通知 UI 更新 │
└─────────────────────────────────────────┘
↓ 广播/指令
┌─────────────────────────────────────────┐
│ 组件层（能力层） │
│ - 封装可复用的功能模块 │
│ - 提供属性、指令、触发时机 │
│ - 通过广播与外界通信 │
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ 数据层（持久层） │
│ - 存储项目配置 │
│ - 管理存档和云变量 │
│ - 提供数据读写接口 │
└─────────────────────────────────────────┘2.2 各层职责定义
UI 层职责
| 职责 | 说明 | 不做 |
|---|---|---|
| 显示信息 | 显示玩家、金币、背包等 | 不存储核心数据 |
| 接收输入 | 按钮点击、滑动操作 | 不直接处理业务逻辑 |
| 反馈动画 | 按钮按下效果、获得提示 | 不控制地图状态 |
| 发送请求 | 发广播通知地图处理 | 不修改玩家变量等核心数据 |
地图层职责
| 职责 | 说明 | 不做 |
|---|---|---|
| 处理业务逻辑 | 扣金币、发道具、判定胜负 | 不直接操作 UI 细节 |
| 管理地图状态 | 波次、时间、开关状态 | 不做 UI 动画 |
| 协调多对象 | 敌人行为、触发器逻辑 | 不单独处理每个敌人 |
| 发送结果通知 | 发广播让 UI 刷新 | 不改 UI 元素属性 |
组件层职责
| 职责 | 说明 | 不做 |
|---|---|---|
| 封装功能 | 把通用能力封装成组件 | 不直接调用其他组件 |
| 提供接口 | 定义指令供外部调用 | 不处理复杂流程 |
| 响应事件 | 当触发时机发生时执行 | 不管理全局状态 |
数据层职责
| 职责 | 说明 |
|---|---|
| 配置管理 | 静态配置放配置表 |
| 存档管理 | 玩家数据存玩家变量 |
| 数据校验 | 检查数据合法性 |
2.3 层间通信规范
UI → 地图：发送请求广播
示例：发送广播 "请求购买" 并携带文本 "物品ID"
地图 → UI：发送结果广播
示例：发送广播 "购买完成" 并携带文本 "结果"
地图 → 组件：调用指令
示例：向目标 执行"扣血" 并携带数字 50
组件 → 地图：发送事件广播
示例：发送广播 "角色死亡" 并携带文本 "角色ID"3. 广播命名规范
3.1 命名格式
推荐使用「动作_对象_具体内容」的命名格式：
| 类型 | 格式 | 示例 |
|---|---|---|
| 请求广播 | 请求_功能 | 请求购买、请求使用道具 |
| 事件广播 | 事件_对象 | 道具获得、敌人死亡 |
| 结果广播 | 结果_功能 | 购买完成、使用成功 |
| 刷新广播 | 刷新_目标 | 刷新UI、刷新背包 |
3.2 推荐命名示例
UI 发给地图的请求
请求购买（参数：物品ID）
请求使用道具（参数：道具ID）
请求切换武器（参数：武器槽）
请求打开菜单
请求存档地图发给 UI 的结果
购买成功（参数：物品ID）
购买失败（参数：错误原因）
道具已使用（参数：道具效果）
UI刷新_背包
UI刷新_货币系统事件广播
玩家死亡（参数：玩家ID）
任务完成（参数：任务ID）
关卡开始（参数：关卡ID）
关卡结束（参数：结算数据）3.3 不推荐的命名
❌ 刷新
❌ 更新
❌ 通知
❌ 1
❌ test
❌ 广播1
❌ 调一下4. 典型系统模板
4.1 商店系统模板
【UI脚本】
当按钮_购买 被点击时
→ 发送广播 "请求购买" 并携带文本 物品ID
当收到广播 "购买成功" 时
→ 显示获得提示
→ 发送广播 "刷新UI_背包"
当收到广播 "购买失败" 时
→ 显示失败原因
【地图脚本】
当收到广播 "请求购买" 并携带文本 物品ID 时
→ 获取 物品表 的第 X 行
→ 获取玩家变量 金币
→ 如果 金币 >= 物品价格 则
→ 设置玩家变量 金币 = 金币 - 物品价格
→ 发送广播 "获得道具" 并携带文本 物品ID
→ 发送广播 "购买成功" 并携带文本 物品ID
→ 否则
→ 发送广播 "购买失败" 并携带文本 "金币不足"4.2 背包系统模板
【UI脚本】
当界面被显示时
→ 发送广播 "请求背包数据"
当收到广播 "背包数据" 时
→ 更新背包显示
当道具被拖拽时
→ 发送广播 "请求整理背包"
【地图脚本】
当收到广播 "请求背包数据" 时
→ 获取玩家变量 背包数组
→ 发送广播 "背包数据" 并携带文本 背包数组
当收到广播 "请求整理背包" 时
→ 执行背包整理逻辑
→ 发送广播 "背包数据" 并携带文本 整理后数组4.3 任务系统模板
【自定义组件：任务管理器】
属性：
- 当前任务ID（数字）
- 任务进度（数字）
- 任务目标（文本）
指令：接取任务
当执行"接取任务"时
→ 设置自身属性.当前任务ID = 参数[任务ID]
→ 设置自身属性.任务进度 = 0
→ 发送广播 "任务已接取" 并携带文本 当前任务ID
指令：更新进度
当执行"更新进度"时
→ 设置自身属性.任务进度 = 自身属性.任务进度 + 参数[增加量]
→ 发送广播 "任务进度更新" 并携带数字 任务进度
→ 如果 任务进度 >= 任务目标 则
→ 发送广播 "任务完成" 并携带文本 当前任务ID
【地图脚本】
当收到广播 "任务完成" 并携带文本 任务ID 时
→ 执行奖励发放逻辑
→ 发送广播 "UI刷新_任务"5. 变量管理规范
5.1 变量命名规范
| 类型 | 命名示例 | 说明 |
|---|---|---|
| 玩家变量 | 金币、背包、任务进度 | 跨地图持久 |
| 地图属性 | 当前波次、地图时间 | 同地图内共享 |
| 组件属性 | 敌人血量、武器伤害 | 单对象私有 |
| 局部变量 | 临时计算、循环计数 | 单次执行使用 |
5.2 变量存储位置选择
| 场景 | 推荐存储位置 | 原因 |
|---|---|---|
| 玩家金币 | 玩家变量 | 跨地图持久 |
| 敌人血量 | 组件属性 | 每个敌人独立 |
| 当前波次 | 地图属性 | 同地图内多对象访问 |
| 临时计算结果 | 局部变量 | 用完即消失 |
| 关卡配置 | 配置表 | 不常变化 |
| 玩家进度 | 玩家变量 | 存档需要 |
6. 项目维护建议
6.1 开发前
- 画系统关系图：在动手前画出各系统之间的关系
- 确定广播命名规范：统一命名风格并写在文档里
- 规划目录结构：把素材、地图、组件分类整理
- 建立组件库：把可复用功能封装成组件
6.2 开发中
- 保持目录整洁：及时整理新增素材
- 记录广播用途：在每个广播发送处注释用途
- 避免硬编码：把配置数据放配置表
- 定期备份项目：防止意外丢失
6.3 开发后
- 检查重复资源：合并相似的素材和组件
- 优化性能瓶颈：检查循环和广播使用
- 整理文档：更新项目说明和广播规范
- 测试各系统：确保各功能正常工作
7. 常见问题与解决
问题1：项目做到一半变得混乱
原因：没有统一的目录结构和命名规范
解决：
- 停下手头工作，整理目录结构
- 按功能重新分类素材
- 建立命名规范文档
- 逐步重构现有资源
问题2：广播满天飞，不知道谁发给谁
原因：广播命名混乱，职责不清
解决：
- 建立广播命名规范文档
- 给每个广播加上用途注释
- 画出广播流程图
- 合并职责相同的广播
问题3：变量放错位置导致数据丢失
原因：不清楚变量作用域
解决：
- 复习变量作用域概念
- 明确每个数据的用途
- 选择正确的存储位置
- 测试切地图后数据是否保持
8. 相关页面
- 创游世界项目维护与代码组织规范 - 维护最佳实践
- 创游世界广播驱动项目结构实战 - 广播架构详解
- 创游世界UI数据同步架构 - UI数据分层
- 脚本作用域与数据流深度研究 - 变量作用域详解
- 创游世界广播机制完全指南 - 广播使用详解