创游世界自定义组件完全指南
一句话摘要
自定义组件是创游世界脚本系统中最重要的可复用单元，它把属性、指令和触发时机三者合一，让你能够封装可复用的游戏逻辑模块，像"搭积木"一样在不同物体上复用同一套能力。
适合谁阅读
- 想要封装可复用逻辑的创作者
- 需要理解自定义组件结构的进阶用户
- 想建立自己组件库的项目设计者
你将学到什么
- 自定义组件的三大核心元素
- 属性、指令、触发时机的用法
- 自定义组件的复用模式
- 自定义组件的最佳实践
- 常见问题与避坑方法
核心结论
- 自定义组件 = 属性 + 指令 + 触发时机：三者结合形成完整的可复用模块
- 属性是数据槽：可以在编辑器或脚本中设置默认值，也可以在运行时动态修改
- 指令是行为入口：通过"执行指令"积木在外部调用，触发组件内部的脚本逻辑
- 触发时机是自动逻辑：在特定条件下自动执行，无需外部调用
- 复用核心是解耦：把通用逻辑封装进组件，物体只负责"有没有挂载这个组件"
一、自定义组件的三大核心元素
从自定义组件编辑器界面可以确认，一个自定义组件至少支持以下三类核心元素：
1.1 属性（Properties）
属性是组件的数据槽，用于存储配置和状态。
典型用途：
- 配置组件行为（如伤害值、冷却时间、动画名称）
- 存储运行时状态（如剩余冷却、技能是否可用）
- 暴露给编辑器调整的参数
使用方式：
设置自身属性 伤害值 为 100
如果 自身属性 冷却时间 > 0 那么
等待 1 秒
结束1.2 指令（Instructions）
指令是组件对外提供的行为入口。通过"执行指令"积木块，外部可以调用组件内部的逻辑。
典型用途：
- 定义组件可被调用的能力（如"施放技能"、"打开宝箱"、"切换状态"）
- 解耦调用方和实现方
使用方式：
// 在组件内定义指令
当执行 "施放技能" 时
如果 自身属性 冷却时间 == 0 那么
播放 技能动画
设置自身属性 冷却时间 为 5
广播 "skill_used"
结束
// 在外部调用指令
当 点击时
执行 "施放技能"1.3 触发时机（Triggers）
触发时机是组件在特定条件下自动执行的逻辑，不需要外部显式调用。
典型用途：
- 监听属性变化并自动响应
- 处理碰撞、点击等事件
- 实现自动化的状态管理
使用方式：
当 属性 自身属性 生命值 改变时
如果 自身属性 生命值 <= 0 那么
播放 死亡动画
等待 1 秒
销毁 自身
结束二、自定义组件编辑器界面结构
从多个截图可以确认，自定义组件编辑器至少包含以下界面元素：
| 元素 | 说明 |
|---|---|
| 组件名 | 组件的显示名称，如"我的组件1" |
| +添加属性 | 添加新的属性字段 |
| +添加指令 | 添加新的指令入口 |
| +添加触发时机 | 添加新的触发时机 |
| 数据 | 查看/编辑属性默认值的区域 |
| 保存 | 保存组件修改 |
| 试玩 | 进入试玩模式验证效果 |
三、自定义组件的典型用法
3.1 用作可复用技能模块
场景：多个敌人都有不同的技能，如果每个敌人都单独写脚本会非常繁琐。
解决方案：创建"技能组件"，封装通用逻辑：
// 技能组件
属性：技能名称、伤害值、冷却时间、动画
指令：施放技能、刷新冷却
触发时机：当执行"施放技能"时
当 执行 "施放技能" 时
播放 自身属性 动画
对目标造成 自身属性 伤害值 点伤害
设置自身属性 冷却时间 为 5不同敌人只需要挂载同一个技能组件，设置不同的属性值：
- 敌人A：技能名称=火球术，伤害值=50
- 敌人B：技能名称=冰刺术，伤害值=30
3.2 用作状态容器
场景：需要管理角色在不同状态之间的切换（如站立、行走、攻击、死亡）。
解决方案：创建"状态机组件"：
// 状态机组件
属性：当前状态、上一状态、动画映射
指令：切换状态、检查状态
触发时机：当属性改变时
当 属性 当前状态 改变时
停止 当前动画
播放 当前状态对应动画
广播 "state_changed"3.3 用作数据收集器
场景：需要统计玩家行为（如击杀数、获得金币、完成任务）。
解决方案：创建"统计组件"：
// 统计组件
属性：击杀数、金币数、任务完成数
指令：记录击杀、记录金币、记录任务
触发时机：当广播"刷新统计"时
当 执行 "记录击杀" 时
设置自身属性 击杀数 为 自身属性 击杀数 + 1
广播 "stats_updated"
当 广播 "刷新统计" 时
设置金币UI文字 为 "击杀：" + 自身属性 击杀数四、自定义组件与普通脚本的区别
| 特性 | 普通脚本 | 自定义组件 |
|---|---|---|
| 可复用性 | 低，需要复制粘贴 | 高，挂载到不同物体即生效 |
| 状态存储 | 依赖物体属性 | 自带属性定义，可灵活配置 |
| 接口暴露 | 无 | 通过指令暴露行为入口 |
| 自动响应 | 需要手动添加触发时机 | 可在组件内定义触发时机 |
| 数据封装 | 逻辑和数据混在一起 | 逻辑和数据封装在一起 |
| 适用场景 | 单物体特定逻辑 | 多物体通用逻辑 |
五、自定义组件的最佳实践
5.1 保持组件职责单一
每个组件应该只负责一个功能领域：
- 好：创建一个"受伤处理组件"，封装受伤逻辑
- 差：创建一个"所有功能组件"，包含移动、攻击、UI、统计所有功能
5.2 使用语义化的属性和指令命名
// 好命名
指令：施放技能、打开宝箱、切换状态
属性：伤害值、冷却时间、动画名称
// 差命名
指令：do1、do2、执行1
属性：数字1、文本2、属性A5.3 使用属性暴露可配置参数
把会经常调整的值设为属性，方便在编辑器中修改：
// 好：把关键数值设为属性
属性：伤害值（默认100）、攻击范围（默认50）、冷却时间（默认3秒）
// 差：把数值写死在脚本里
当 执行 "攻击" 时
对目标造成 100 点伤害 // 写死，难以调整5.4 通过广播解耦组件间通信
组件之间通过广播通信，避免直接引用：
// 受伤组件
当 死亡时
广播 "enemy_dead"
// 统计组件
当 广播 "enemy_dead" 时
执行 "记录击杀"5.5 在试玩中验证组件逻辑
保存组件后，记得点击"试玩"验证效果。常见的验证点：
- 属性默认值是否符合预期
- 指令是否能正确执行
- 触发时机是否在正确的条件下触发
- 不同物体挂载同一组件是否表现一致
六、自定义组件的进阶用法
6.1 组件嵌套
一个组件可以调用另一个组件的指令：
// 技能组件
当 执行 "施放技能" 时
// 调用特效组件播放特效
对目标 执行 "播放受击特效"
// 调用音效组件播放音效
对目标 执行 "播放受击音效"6.2 组件继承（伪）
虽然没有直接的继承机制，但可以通过组合实现类似效果：
- 创建基础组件（如"基础属性组件"包含生命值、防御值等）
- 在此基础上添加特定功能组件（如"战斗组件"、"移动组件"）
6.3 组件模板库
将常用组件保存为模板，方便在新项目中复用：
- 受伤处理组件
- 状态机组件
- 技能释放组件
- 统计收集组件
- 冷却管理组件
七、常见问题
Q：自定义组件和普通脚本块有什么区别？
A：普通脚本块是直接写在物体上的逻辑，而自定义组件是可复用的封装单元。组件可以被多个物体挂载，每个物体都能使用相同的逻辑，但配置不同的属性值。
Q：可以在同一个物体上挂载多个自定义组件吗？
A：可以。一个物体可以挂载多个自定义组件，每个组件独立运行、互不干扰。但要注意组件之间的冲突，避免多个组件同时修改同一个属性。
Q：自定义组件的属性默认值在哪里设置？
A：在组件编辑器的"数据"区域中，可以设置每个属性的默认值。这些默认值会在物体挂载组件时自动应用。
Q：修改自定义组件会影响已经挂载的物体吗？
A：会。修改自定义组件会影响所有使用该组件的物体。这既是优点（一次修改全局生效），也是风险点（可能意外影响其他物体）。建议在修改前先备份或使用版本控制。
Q：自定义组件能否在运行时动态添加或移除？
A：[待验证] 具体行为需进一步测试确认。
八、相关页面
九、待验证问题
[待验证]自定义组件在运行时动态添加或移除的具体行为[待验证]组件之间的属性优先级规则[待验证]复杂组件嵌套的性能影响
十、后续优化方向
- [ ] 补充更多组件复用的实战案例
- [ ] 添加组件模板库的完整示例
- [ ] 补充组件调试技巧和常见错误排查
- [ ] 添加组件与联机环境的交互说明