脚本界面与积木知识索引
一句话摘要
本文档根据截图 OCR 与人工归纳整理，系统介绍创游世界脚本编辑界面、自定义组件界面、积木分类与典型脚本块能力，帮助构建可检索的脚本知识体系。
适合谁阅读
- 想深入理解脚本编辑器的创作者
- 需要系统了解组件与指令关系的进阶用户
- 想建立脚本能力边界的架构设计者
你将学到什么
- 组件分类结构与能力域划分
- 自定义组件的三大核心元素
- 变量作用域的四个层级
- 常见动作类脚本块的功能
- 渐变与时间控制脚本的用法
- 编辑器工作流与交互特征
核心结论
- 组件按功能域组织：通用、战斗、装置、显示、交互、自定义六大类
- 自定义组件是完整编程单元：兼具属性定义、行为入口、事件触发三大能力
- 脚本存在四层作用域：局部变量 → 自身属性 → 地图属性 → 系统属性
- 时间型脚本支持补间动画：渐变能力可实现属性平滑过渡
⚠️ 说明：内容基于截图转文本与人工纠错，部分术语仍可能受 OCR 影响，后续可继续校对。
1. 组件分类结构
从组件添加界面截图可确认，创游世界的组件系统至少包含以下分类：
- 通用
- 战斗
- 装置
- 显示
- 交互
- 自定义
这说明组件体系并不是平铺列表，而是按功能域组织，便于按用途挂载能力。
已识别的组件项
在“装置”相关组件截图中，可识别的组件包括：
- 物理
- 可互动
- 开关
- 物体检测器
- 阻挡通行
- 等级
- 告示牌
- 物体 UI
在“战斗”相关组件截图中，可识别的组件包括：
- 生命
- 伤害
- 武器槽
知识意义
- 不同组件分类代表不同子系统能力。
- 战斗类更偏生命、伤害、武器等逻辑。
- 装置类更偏交互、检测、阻挡、物理与界面。
- 自定义类意味着创作者可自扩展组件能力。
2. 自定义组件编辑结构
从多个截图可确认，自定义组件编辑器至少支持三类核心元素：
- 属性
- 指令
- 触发时机
已识别界面元素
例如：
- 组件名：
我的组件1 - 属性：
数字1、文本1 - 操作按钮：
+添加属性+添加指令+添加触发时机
- 底部功能：
数据保存试玩
知识意义
这说明自定义组件不仅是“静态数据容器”，而是一个完整的可编程扩展单元，兼具：
- 数据定义能力
- 行为入口定义能力
- 事件触发能力
也就是说，自定义组件本质上很接近“带状态与行为的可复用模块”。
3. 自定义指令与触发时机
截图中多次出现如下结构：
当执行“指令1”时当执行“指令2”时
这表明自定义组件中的“指令”可以作为一个可被调用的行为入口，而“当执行某指令时”则是其脚本实现区。
已识别脚本能力
在相关截图中可识别的行为包括：
- 新建局部变量
- 设置局部变量
- 设置自身属性
- 设置当前地图属性
- 设置系统属性
例如 OCR 中出现：
新建局部变量 为 1设置局部变量1为1设置自身属性1为1设置当前地图属性4为1设置系统属性4为1
可提炼的结构理解
自定义指令脚本中至少涉及以下作用域：
- 局部变量
- 自身属性
- 当前地图属性
- 系统属性
知识意义
这说明脚本执行时不是单一变量空间，而是存在多层作用域：
- 临时局部数据
- 组件/物体自身数据
- 地图级数据
- 系统级数据
这对理解脚本块的数据流、读写范围和联机同步影响都很重要。
4. 常见基础动作类脚本块
从脚本块选择界面截图中，已识别到一批动作/对象控制相关脚本块：
- 父物体
- 子物体
- 播放动效
- 查找最近的角（可能是角色/目标，待进一步校对）
- 播放动画
- 停止动画
- 沿角度移动
- 以角度面向
- 销毁自身
- 触发/发送广播
可推测所属能力域
这些脚本块主要覆盖：
- 对象层级访问
- 动画播放控制
- 方向/朝向控制
- 物体销毁
- 广播通信
知识意义
这说明创游脚本系统中，基础动作层已经覆盖了典型游戏对象操作闭环：
- 找对象
- 控动画
- 改方向
- 改移动
- 销毁
- 发送事件
5. 渐变 / 时间驱动脚本线索
截图 Screenshot_20260417_215639.jpg 中识别到近似文本：
1秒将自身...渐变至 1 并等待结束
虽然 OCR 不完整，但能较明确地看出：
- 存在时间型脚本块
- 存在渐变执行能力
- 存在“并等待结束”式同步流程控制
知识意义
这类脚本块通常意味着：
- 可做补间动画
- 可做属性平滑过渡
- 可把异步动画串入顺序逻辑
这对 UI 动画、物体淡入淡出、移动缓动等都很关键。
6. 编辑器工作流特征
从多个截图底部统一出现：
- 数据
- 保存
- 试玩
可推断脚本编辑器工作流强调：
- 修改数据或脚本
- 保存
- 立即试玩验证
知识意义
这与社区分析文档中“保存时可能生成脚本”的猜想可以互相印证：
- 至少从交互设计上看，保存是非常核心的一步
- 试玩和保存耦合紧密，适合边改边测
7. 当前可归纳的脚本系统结构
结合已有截图，可初步把脚本系统理解为以下几层：
组件层
- 内置组件
- 自定义组件
自定义扩展层
- 属性
- 指令
- 触发时机
变量作用域层
- 局部变量
- 自身属性
- 地图属性
- 系统属性
执行动作层
- 动画
- 动效
- 方向与移动
- 父子物体
- 广播
- 销毁
- 渐变
8. 适合 AI/RAG 的关键词
- 脚本界面
- 积木系统
- 自定义组件
- 添加属性
- 添加指令
- 添加触发时机
- 当执行某指令时
- 局部变量
- 自身属性
- 当前地图属性
- 系统属性
- 播放动画
- 停止动画
- 沿角度移动
- 以角度面向
- 销毁自身
- 广播
- 渐变
- 等待结束
9. 对知识库建设的建议
建议后续把 资料/基础写脚本界面截图/ 继续拆成以下专题：
- 组件添加界面专题
- 自定义组件专题
- 指令与触发时机专题
- 变量作用域专题
- 动画与动作脚本块专题
- 广播与事件脚本块专题
- 渐变与时间控制脚本块专题
这样更适合后续：
- 问答检索
- 教学整理
- 脚本能力盘点
- 与引擎版本变动做交叉索引
待验证问题
以下问题需要进一步验证：
| 问题 | 状态 | 验证方向 |
|---|---|---|
| 部分OCR内容的准确性 | 🔄 待验证 | 需要官方文档确认 |
| 脚本块完整分类体系 | 🔄 待验证 | 需要持续更新 |
| 新版本脚本能力变化 | 🔄 待验证 | 需要版本跟踪 |
📝 说明：脚本界面索引基于截图OCR，已尽力校对但仍有不确定性。
后续优化方向
- [ ] 补充更多截图证据
- [ ] 完善脚本块分类
- [ ] 更新引擎版本对应关系