创游世界组件速查卡
一句话摘要
创游世界的组件系统是赋予物体能力的关键机制。本文用快问快答的形式，帮助你快速查找常用组件的用途、配置方法和典型使用场景。
适合谁阅读
- 不知道该用什么组件的初学者
- 遇到组件配置问题的开发者
- 需要快速查阅组件用法的制作者
你将学到什么
- 组件的分类体系
- 常用组件的用途和配置
- 不同场景下组件的选择建议
- 组件使用的常见问题与解决
一、组件分类体系
创游世界的组件可以分为以下几大类：
| 类别 | 说明 | 典型组件 |
|---|---|---|
| 通用组件 | 基础能力 | 物理组件、碰撞盒 |
| 战斗组件 | 战斗相关 | 生命组件、武器组件、子弹组件 |
| 交互组件 | 交互相关 | 可互动物体、互动按钮 |
| 显示组件 | UI显示 | 文字标签、按钮、物体UI组件 |
| 移动组件 | 移动相关 | 移动摇杆、跟随组件 |
| 自定义组件 | 用户自定义 | 自定义组件 |
二、核心组件快问快答
Q1：物理组件有什么用？
A： 物理组件让物体具有物理特性，包括移动、碰撞、重力等能力。
| 属性 | 说明 | 典型值 |
|---|---|---|
| 质量 | 物体重量 | 1 |
| 阻力 | 移动阻力 | 0 |
| 重力 | 是否受重力影响 | 是 |
| 是否固定 | 是否固定不动 | 否 |
常见用途：
- 让角色可以移动
- 让物体可以受碰撞影响
- 让子弹可以飞行
添加组件：物理组件
设置质量：1
设置阻力：0
设置重力：是Q2：角色组件有什么用？
A： 角色组件让物体可以被玩家控制，具备移动、跳跃等能力。
前置要求： 物体必须先有物理组件。
| 属性 | 说明 |
|---|---|
| 角色朝向 | 初始朝向（左/右） |
| 移动速度 | 移动速度倍率 |
| 跳跃力 | 跳跃高度 |
| 碰撞盒大小 | 角色碰撞范围 |
添加组件：物理组件
添加组件：角色组件
设置移动速度：1.0
设置跳跃力：300Q3：生命组件有什么用？
A： 生命组件让物体具有血量，可以受伤、死亡。
| 属性 | 说明 | 典型值 |
|---|---|---|
| 最大生命 | 最大血量 | 100 |
| 当前生命 | 当前血量 | 100 |
| 防御力 | 减伤值 | 0 |
| 无敌时间 | 受伤后无敌时间 | 0.5秒 |
添加组件：生命组件
设置最大生命：100
设置防御力：10触发时机：
- 当受到伤害时
- 当死亡时
- 当生命值改变时
Q4：子弹组件有什么用？
A： 子弹组件让物体可以作为子弹发射，具备飞行、碰撞、造成伤害等能力。
| 属性 | 说明 |
|---|---|
| 速度 | 飞行速度 |
| 伤害 | 造成伤害 |
| 生命周期 | 存在时间 |
| 碰撞触发 | 碰撞后行为 |
添加组件：子弹组件
设置速度：500
设置伤害：20
设置生命周期：3秒触发时机：
- 当碰撞时
- 当创建时
Q5：武器组件有哪些类型？
A： 创游世界支持多种武器组件：
| 组件 | 用途 |
|---|---|
| 近战武器组件 | 刀、剑等近战武器 |
| 远程武器组件 | 弓、枪等远程武器 |
| 盾牌组件 | 防御武器 |
| 法杖组件 | 魔法武器 |
添加组件：近战武器组件
设置伤害：30
设置攻击范围：50
设置攻击间隔：0.5秒Q6：UI组件有哪些类型？
A： 创游世界提供多种UI组件用于界面交互：
| 组件 | 用途 |
|---|---|
| 文字标签 | 显示文字 |
| 按钮组件 | 可点击按钮 |
| 图片组件 | 显示图片 |
| 列表组件 | 显示列表 |
| 物体UI组件 | 绑定到物体的UI |
添加UI：地图UI
添加组件：文字标签
设置文字："金币：0"
设置位置：居中Q7：可互动物件组件有什么用？
A： 可互动物件组件让物体可以被玩家交互，显示互动按钮。
| 属性 | 说明 |
|---|---|
| 互动按钮文字 | 按钮上显示的文字 |
| 互动范围 | 可以互动的距离 |
| 互动方式 | 点击/长按 |
添加组件：可互动物件
设置按钮文字："交互"
设置互动范围：3米触发时机：
- 当互动按钮被按下时
Q8：怎么使用自定义组件？
A： 自定义组件是用户自己定义的能力模块。
创建步骤：
- 选择物体
- 添加自定义组件
- 设置组件名称
- 添加属性和指令
- 编写组件逻辑
自定义组件：商店组件
├─ 属性
│ ├─ 商品列表
│ └─ 当前选中
│
├─ 指令
│ ├─ 打开商店
│ └─ 购买商品
│
└─ 触发时机
└─ 当收到广播时三、组件组合使用
3.1 玩家角色
玩家对象
├─ 物理组件（必须）
├─ 角色组件（可控制移动）
├─ 生命组件（可受伤）
├─ 武器槽组件（可拿武器）
└─ 自定义组件（额外能力）3.2 敌人
敌人对象
├─ 物理组件
├─ 生命组件
├─ 武器组件（近战/远程）
├─ AI组件（行为逻辑）
└─ 碰撞盒组件3.3 子弹
子弹对象
├─ 物理组件
├─ 子弹组件
├─ 特效组件（可视化）
└─ 碰撞盒组件四、组件配置常见问题
Q1：角色走不动怎么办？
A： 检查是否同时添加了以下组件：
✓ 正确配置：
添加组件：物理组件
添加组件：角色组件
✗ 缺少角色组件：
添加组件：物理组件
→ 无法控制移动Q2：子弹不发射怎么办？
A： 检查子弹配置：
✓ 正确配置：
添加组件：物理组件（必须）
添加组件：子弹组件
设置速度 > 0
✓ 发射脚本：
生成子弹对象
设置子弹方向Q3：受伤没效果怎么办？
A： 检查生命组件和触发时机：
✓ 正确配置：
添加组件：生命组件
✓ 受伤脚本：
当碰撞时
如果 碰撞对象.标签 == "子弹" 那么
设置生命 -= 碰撞对象.伤害
结束
结束五、组件速查表
| 组件类型 | 作用 | 必要属性 |
|---|---|---|
| 物理组件 | 提供物理能力 | 质量、重力 |
| 角色组件 | 可被玩家控制 | 移动速度、跳跃力 |
| 生命组件 | 血量管理 | 最大生命 |
| 子弹组件 | 子弹能力 | 速度、伤害 |
| 近战武器 | 近战攻击 | 伤害、范围、间隔 |
| 远程武器 | 远程攻击 | 伤害、射程 |
| 可互动物件 | 玩家交互 | 按钮文字、范围 |
| 物体UI | 物体绑定UI | 无特殊要求 |
| 自定义组件 | 自定义能力 | 按需求设置 |
相关页面
- 创游世界组件速查表 - 组件完整参考
- 创游世界组件系统完全指南 - 组件系统详解
- 创游世界自定义组件完全指南 - 自定义组件
- 常见问题与避坑指南 - 常见问题解决
待验证问题
以下问题需要进一步验证：
| 问题 | 状态 | 验证方向 |
|---|---|---|
| 部分组件的具体参数默认值 | 🔄 待验证 | 需要官方文档确认 |
| 不同版本中组件功能的差异 | 🔄 待验证 | 需要多版本对比 |
📝 说明：组件速查核心用法已稳定，进阶参数属于进阶内容。
后续优化方向
- [ ] 补充更多组件的详细参数
- [ ] 添加组件组合示例
- [ ] 完善组件调试方法