组件与对象系统导航
一句话摘要
这是一份聚合组件与对象系统核心文档的中文导航，帮助你快速找到对象、素材、组件、自定义组件的关系解析。
适合谁阅读
- 不清楚对象、素材、组件、脚本关系的初学者
- 想深入理解组件系统的创作者
- 需要做自定义组件的进阶用户
你将学到什么
- 素材、物体、组件、脚本的关系
- 组件的分类和功能
- 自定义组件的使用方式
- 常见组件错误使用方式
可信度：
[已确认]
核心文档入口
入门理解
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 创游世界对象_素材_组件_脚本关系总图 | 核心概念关系结构图 | 入门 |
| 官方教程知识索引 | 官方教程中的组件说明 | 入门 |
| 创游世界组件系统完全指南 | 组件系统完全指南 | 入门 |
组件研究
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 组件添加界面深度解析 | 组件添加界面与能力分类 | 入门/进阶 |
| 脚本界面与积木知识索引 | 脚本界面与积木块总览 | 进阶 |
| 脚本组件体系与能力分层深度研究 | 能力分层研究 | 进阶 |
自定义组件
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 自定义组件深度解析 | 自定义组件设计详解 | 进阶 |
| 系统级脚本能力解析 | 系统级能力解析 | 进阶 |
素材与实例化
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 素材实例化与地图物体关系解析 | 素材模板与实例关系 | 入门 |
| 素材系统与组件挂载解析 | 素材系统详解 | 入门 |
按问题找文档
1. 我不清楚对象、素材、组件、脚本的关系
2. 我想研究组件添加界面和能力分类
3. 我想理解自定义组件适合怎么用
组件六大分类速查
| 分类 | 主要组件 | 功能说明 |
|---|---|---|
| 通用 | 物理、阻挡通行、物体UI、碰撞盒 | 基础交互能力 |
| 战斗 | 生命、伤害、武器槽、子弹 | 战斗相关能力 |
| 装置 | 机关、机关门、机关地板、开关 | 机关设计 |
| 显示 | 粒子特效、动效、描边 | 视觉效果 |
| 交互 | 移动摇杆、技能摇杆、互动按钮 | 用户输入 |
| 自定义 | 自定义组件 | 自定义功能 |
核心概念速查
| 概念 | 解释 |
|---|---|
| 素材 | 放在地图前的模板资源，包含贴图和组件配置 |
| 物体 | 素材在地图中的实例 |
| 组件 | 赋予物体能力的模块（属性+指令+事件） |
| 脚本 | 用积木块组合组件能力 |
| 自定义组件 | 由创作者自定义的组件（属性+指令+触发时机） |
| 实例化 | 把素材模板变成地图中具体物体的过程 |
当前判断
[已确认]对象、组件、脚本关系是很多后续专题的基础，不搞清楚这一层，后面很容易只会抄教程不会搭系统。[高可信推断]组件与对象系统专题后续还可以继续拆出"组件职责边界""常见错误挂载方式""对象复用策略"等子专题。
常见误区
| 误区 | 后果 | 正确做法 |
|---|---|---|
| 不挂组件想让物体动起来 | 物体只是静态图片 | 需要挂载物理组件和角色组件 |
| 修改素材期望地图物体自动更新 | 地图物体是实例，不会自动同步 | 使用"应用到原素材"或重新摆放 |
| 组件越多越好 | 性能下降，逻辑混乱 | 按需挂载，只挂必要的组件 |
| 不理解自定义组件的适用范围 | 过度封装，代码难维护 | 优先使用内置组件，只在必要时自定义 |
关联阅读
待验证问题
[待验证]部分组件的详细参数说明[待验证]某些边界情况的术语定义
后续优化方向
- [ ] 补充"组件职责边界"专题
- [ ] 补充"常见错误挂载方式"专题
- [ ] 补充"对象复用策略"专题
- [ ] 添加更多组件的详细参数说明