创游世界组件能力速查手册
一句话摘要
本文档按功能分类整理创游世界所有内置组件的核心能力、适用场景和关键参数，帮助开发者在设计游戏时快速查找和选用合适的组件。
适合谁阅读
- 需要快速查找组件能力的开发者
- 不确定某个组件能做什么的创作者
- 设计新系统需要参考组件组合的新手
- 想要了解组件分类体系的研究者
你将学到什么
- 创游世界组件的完整分类体系
- 每类组件的核心能力
- 组件之间的依赖关系
- 常见系统需要的组件组合
- 组件选用的决策参考
核心结论
- 组件决定"能做什么"：贴图决定外观，组件决定功能，不挂组件的物体只是静态图片
- 组件有依赖关系：某些组件依赖其他组件才能正常工作
- 同类组件通常互斥：一个物体通常只能挂一个同类功能组件
- 组件组合构建系统：战斗系统需要生命+伤害+武器槽，背包需要物体UI+脚本配合
组件分类总览
| 分类 | 说明 | 组件数量 |
|---|---|---|
| 通用组件 | 基础能力，几乎所有物体都可能用到 | 5+ |
| 角色控制 | 让物体可被玩家操控 | 3+ |
| 战斗系统 | 生命、伤害、武器、子弹 | 5+ |
| 交互控制 | 按钮、摇杆、互动 | 4+ |
| 机关装置 | 门、地板、机关 | 4+ |
| 显示特效 | 动效、粒子、特效 | 3+ |
| 物理能力 | 移动、碰撞、物理属性 | 3+ |
| UI绑定 | 物体UI、地图UI关联 | 2+ |
| 自定义组件 | 开发者编写的扩展组件 | 不定 |
一、通用组件
通用组件是其他组件的基础，定义了物体的基本物理和碰撞行为。
物理组件
核心功能：让物体具有物理属性，可以移动、受力、碰撞
| 参数 | 说明 | 常用值 |
|---|---|---|
| 质量 | 物体质量，影响受力效果 | 1-100 |
| 速度上限 | 最大移动速度 | 200-500 |
| 移动模式 | 2D横版/2D竖版/俯视角/自定义 | 根据游戏类型 |
| 是否受重力 | 是否受重力影响 | 是/否 |
| 是否可被推动 | 是否可以被其他物体推动 | 是/否 |
使用场景：几乎所有需要移动或被碰撞的物体都需要
依赖：无
注意：角色组件依赖物理组件
阻挡通行组件
核心功能：让物体成为障碍物，其他物体无法通过
| 参数 | 说明 |
|---|---|
| 阻挡模式 | 完全阻挡/只能站立/只能跳跃 |
| 碰撞层 | 和哪些层级的物体碰撞 |
使用场景：墙壁、障碍物、地形
依赖：物理组件
触发器组件
核心功能：检测其他物体进入或离开自身区域
| 参数 | 说明 |
|---|---|
| 触发形状 | 矩形/圆形/自定义 |
| 触发层级 | 检测哪些层级的物体 |
| 进入触发 | 物体进入时触发 |
| 离开触发 | 物体离开时触发 |
使用场景：区域检测、触发事件、机关激活
依赖：物理组件
二、角色控制组件
角色组件
核心功能：让物体成为可被玩家操控的角色
| 参数 | 说明 |
|---|---|
| 操作模式 | 方向键/摇杆/自定义 |
| 移动速度 | 角色移动速度 |
| 跳跃高度 | 跳跃能力 |
| 动画映射 | 移动/待机/跳跃对应哪个动画 |
使用场景：玩家角色、需要玩家控制的NPC
依赖：物理组件（必须先挂物理组件）
重要：没有物理组件，角色组件无法工作
移动摇杆组件
核心功能：提供虚拟摇杆控制
| 参数 | 说明 |
|---|---|
| 摇杆位置 | 屏幕上的位置 |
| 摇杆大小 | 摇杆尺寸 |
| 透明度 | 摇杆透明度 |
| 跟随手指 | 是否跟随手指移动 |
使用场景：移动端游戏、触屏操作
依赖：角色组件
技能摇杆组件
核心功能：提供技能释放方向的摇杆
| 参数 | 说明 |
|---|---|
| 位置 | 摇杆位置 |
| 大小 | 摇杆尺寸 |
| 透明度 | 透明度 |
使用场景：俯视角射击游戏、需要方向控制的技能
依赖：物理组件
三、战斗系统组件
生命组件
核心功能：让物体有血量，能受伤，能死亡
| 参数 | 说明 |
|---|---|
| 生命上限 | 最大生命值 |
| 初始生命 | 创建时的生命值 |
| 受伤表现 | 受伤时的视觉效果 |
| 死亡方式 | 死亡时的处理方式 |
使用场景：玩家、敌人、所有可被消灭的对象
依赖：物理组件
注意：受伤和死亡需要配合脚本处理
伤害组件
核心功能：让物体能造成伤害
| 参数 | 说明 |
|---|---|
| 基础伤害 | 每次伤害的数值 |
| 伤害类型 | 物理/魔法/真实 |
| 暴击率 | 暴击概率 |
| 暴击倍率 | 暴击伤害倍数 |
使用场景：近战武器、敌人攻击
依赖：物理组件
注意：伤害组件本身不造成伤害，需要配合触发时机或碰撞
武器槽组件
核心功能：让角色能装备武器
| 参数 | 说明 |
|---|---|
| 武器类型 | 近战/远程 |
| 攻击间隔 | 两次攻击的冷却 |
| 攻击范围 | 攻击距离 |
| 攻击角度 | 扇形攻击的角度 |
使用场景：需要装备武器的玩家或敌人
依赖：角色组件 + 物理组件
子弹组件
核心功能：发射远程攻击
| 参数 | 说明 |
|---|---|
| 移动速度 | 子弹飞行速度 |
| 存在时间 | 多久后自动销毁 |
| 穿透数量 | 能穿透几个敌人 |
| 追踪目标 | 是否追踪目标 |
使用场景：远程武器、魔法弹道
依赖：物理组件 + 伤害组件
注意：子弹需要配合伤害组件才有伤害
护盾组件
核心功能：提供额外的护盾值，优先于生命值承受伤害
| 参数 | 说明 |
|---|---|
| 护盾上限 | 最大护盾值 |
| 恢复速度 | 护盾恢复速度 |
| 恢复间隔 | 多久恢复一次 |
使用场景：需要护盾机制的RPG、高级战斗
依赖：生命组件
四、交互控制组件
可互动物体组件
核心功能：让物体可以被玩家交互
| 参数 | 说明 |
|---|---|
| 按钮文字 | 显示的交互提示 |
| 交互距离 | 多近才能交互 |
| 交互方式 | 点击/长按 |
使用场景：NPC对话、门、宝箱、机关触发
依赖：物理组件
注意：需要配合"当互动按钮被按下"触发时机使用
按钮组件
核心功能：提供可点击的按钮
| 参数 | 说明 |
|---|---|
| 按钮类型 | 普通/开关/单选 |
| 默认状态 | 开启/关闭 |
| 目标物体 | 控制的目标 |
使用场景：UI面板、开关控制
依赖：无
拖拽组件
核心功能：让物体可以被拖拽
| 参数 | 说明 |
|---|---|
| 拖拽模式 | 自由/固定轴/网格 |
| 释放行为 | 拖拽结束后的行为 |
使用场景：背包物品拖拽、拼图游戏
依赖：物理组件
五、机关装置组件
机关组件
核心功能：被触发时执行特定行为
| 参数 | 说明 |
|---|---|
| 机关类型 | 开关/触发器/延迟 |
| 目标物体 | 控制的目标 |
| 行为 | 激活/关闭/切换 |
使用场景：门、机关地板、陷阱
依赖：物理组件
机关门组件
核心功能：可开关的门
| 参数 | 说明 |
|---|---|
| 初始状态 | 开启/关闭 |
| 动画 | 开关动画 |
| 碰撞切换 | 开关时碰撞是否变化 |
使用场景：门、入口、通道
依赖：物理组件
机关地板组件
核心功能：踏上时触发机关
| 参数 | 说明 |
|---|---|
| 触发条件 | 玩家/敌人/所有 |
| 触发行为 | 激活关联机关 |
使用场景：压力机关、陷阱地板
依赖：物理组件
六、显示特效组件
动效组件
核心功能：播放动画序列
| 参数 | 说明 |
|---|---|
| 动画资源 | 使用的动画文件 |
| 播放模式 | 循环/一次/pingpong |
| 播放速度 | 动画速度 |
使用场景：角色动画、物体动画
依赖：无
粒子特效组件
核心功能：播放粒子效果
| 参数 | 说明 |
|---|---|
| 粒子资源 | 粒子配置文件 |
| 发射模式 | 一次性/持续 |
| 发射速率 | 每秒发射粒子数 |
使用场景：爆炸、火焰、烟尘、魔法效果
依赖：无
颜色组件
核心功能：改变物体颜色
| 参数 | 说明 |
|---|---|
| 颜色值 | RGB颜色 |
| 混合模式 | 正常/叠加/正片叠底 |
使用场景：变色效果、状态指示
依赖：无
七、UI绑定组件
物体UI组件
核心功能：让物体显示绑定的UI
| 参数 | 说明 |
|---|---|
| UI资源 | 绑定的UI文件 |
| 显示位置 | 头顶/身前/脚底 |
| 跟随模式 | 始终跟随/只在地图 |
使用场景：头顶血条、NPC名字、BOSS血条
依赖：无
常见搭配：配合生命组件显示血条
地图UI关联组件
核心功能：与地图UI进行数据绑定
| 参数 | 说明 |
|---|---|
| 绑定变量 | 绑定的数据变量 |
| 刷新时机 | 何时刷新UI |
使用场景：需要实时显示物体数据的UI
依赖：无
八、组件能力组合速查
玩家角色
| 组件 | 必要性 |
|---|---|
| 物理组件 | 必须 |
| 角色组件 | 必须 |
| 生命组件 | 推荐 |
| 武器槽组件 | 需要武器时 |
| 移动摇杆组件 | 移动端时 |
普通敌人
| 组件 | 必要性 |
|---|---|
| 物理组件 | 必须 |
| 生命组件 | 必须 |
| 伤害组件 | 必须（攻击型） |
| AI组件（脚本） | 推荐 |
| 物体UI组件 | 推荐（显示血条） |
子弹
| 组件 | 必要性 |
|---|---|
| 物理组件 | 必须 |
| 伤害组件 | 必须 |
| 子弹组件 | 必须 |
NPC
| 组件 | 必要性 |
|---|---|
| 物理组件 | 推荐 |
| 可互动物体组件 | 对话时必须 |
| 物体UI组件 | 显示名字时 |
门
| 组件 | 必要性 |
|---|---|
| 物理组件 | 必须 |
| 机关门组件 | 必须 |
| 阻挡通行组件 | 推荐 |
收集物（道具/金币）
| 组件 | 必要性 |
|---|---|
| 物理组件 | 推荐 |
| 触发器组件 | 推荐 |
| 动效组件 | 推荐（悬浮动画） |
九、组件选用决策树
需要物体能移动吗？
├── 是 → 需要物理组件
│ └── 是玩家操控吗？
│ ├── 是 → 加角色组件 + 移动摇杆（移动端）
│ └── 否 → 只是移动物体？
│ └── 是 → 只加物理组件
└── 否 → 只是静态显示？
└── 是 → 可能不需要物理组件
需要物体能受伤/死亡吗？
└── 是 → 加生命组件
需要物体能攻击吗？
├── 近战 → 加伤害组件 + 武器槽组件
└── 远程 → 加子弹组件 + 伤害组件
需要物体能被玩家点击吗？
└── 是 → 加可互动物体组件
需要物体显示UI吗？
├── 头顶血条 → 加物体UI组件
└── 背包格子 → 使用UI编辑器的格子组件十、常见问题
Q1：组件挂了很多但物体不动？
A：检查是否挂了"物理组件"。没有物理组件，其他组件可能无法正常工作。
Q2：角色组件挂不上？
A：确保先挂"物理组件"，再挂"角色组件"。角色组件依赖物理组件。
Q3：子弹没有伤害？
A：子弹需要同时挂"物理组件"+"伤害组件"+"子弹组件"，三者缺一不可。
Q4：物体UI不显示？
A：检查物体UI组件的绑定是否正确，确认UI资源已创建。
Q5：多个同类型组件能同时挂吗？
A：通常不建议。例如一个物体挂两个生命组件可能产生冲突。
相关页面
- 创游世界组件速查表 - 组件快速参考
- 创游世界组件系统完全指南 - 组件系统详解
- 脚本界面与积木知识索引 - 脚本编辑器
- 创游世界战斗系统设计入门 - 战斗系统设计
待验证问题
以下问题需要进一步验证：
| 问题 | 状态 | 验证方向 |
|---|---|---|
| 部分组件的具体参数范围和默认值 | 🔄 待验证 | 需要官方文档确认 |
| 新版本新增组件的能力说明 | 🔄 待验证 | 需要版本对比测试 |
| 组件组合使用的性能影响 | 🔄 待验证 | 需要实际项目测试 |
📝 说明：基本组件使用已稳定，以上内容属于进阶优化方向，不影响日常开发。
后续优化方向
- [ ] 补充组件截图和界面说明
- [ ] 补充组件之间的依赖关系图
- [ ] 添加更多组件组合示例
- [ ] 补充自定义组件的编写方法
导航入口
- 新手阅读路线 - 学习路线导航
- 创游世界知识库总导航 - 知识库总导航
- 自动生成文档目录 - 文档目录总览
维护报告
- 维护与报告导航 - 维护报告总入口
- AI自动维护复盘记录 - 维护复盘记录
- 错误点与优化点汇总 - 错误点汇总
- 待验证问题清单 - 待验证问题
- 后续研究路线图 - 研究路线图
最后更新：2026-06-16维护者：Azek431