API与脚本接口导航
一句话摘要
这是一份聚合API与脚本接口核心文档的中文导航，帮助你快速找到积木块、参数、指令、触发时机等接口相关内容。
适合谁阅读
- 想了解有哪些API和接口能力的创作者
- 需要查阅脚本指令参数的开发者
- 想设计自定义组件接口的研究者
你将学到什么
- 创游世界脚本接口的整体结构
- 积木块的分类和参数格式
- 自定义组件的接口设计方式
- 触发时机与返回值的使用
可信度：
[已确认]关联入口：脚本系统研究导航、脚本界面与积木知识索引
核心文档入口
API总览
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 创游世界 API 整理 | 当前最直接的API汇总入口 | 进阶 |
接口机制基础
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 自定义组件深度解析 | 自定义组件接口设计 | 进阶 |
| 组件添加界面深度解析 | 组件添加界面与能力 | 入门/进阶 |
| 系统级脚本能力解析 | 系统级脚本能力 | 进阶 |
数据与作用域背景
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 脚本作用域与数据流深度研究 | 数据流与接口调用 | 进阶 |
| 4.54.0数据类型与脚本能力升级解析 | 新版本数据类型能力 | 进阶 |
积木块与脚本
| 文档 | 说明 | 适合阶段 |
|---|---|---|
| 脚本界面与积木知识索引 | 脚本编辑器与积木块总览 | 入门 |
| 脚本组件体系与能力分层深度研究 | 能力分层研究 | 进阶 |
按问题找文档
1. 我想知道有哪些API和积木块
2. 我想了解参数、返回值、触发时机
3. 我想设计自定义组件接口
积木块分类速查
| 分类 | 示例 | 功能 |
|---|---|---|
| 动作类 | 移动、播放动画、销毁 | 控制物体行为 |
| 控制类 | 等待、循环、条件判断 | 控制执行流程 |
| 数据类 | 获取属性、设置变量 | 操作数据 |
| 事件类 | 发送广播、调用指令 | 触发其他逻辑 |
| 数学类 | 加减乘除、随机数 | 数学运算 |
| 逻辑类 | 且、或、非 | 逻辑判断 |
触发时机类型速查
| 类型 | 触发时机 | 触发条件 |
|---|---|---|
| 事件型 | 当被创建时 | 对象创建时 |
| 事件型 | 当被销毁时 | 对象销毁时 |
| 事件型 | 当受到伤害时 | 受到伤害时 |
| 交互型 | 当被点击时 | 被点击时 |
| 交互型 | 当互动按钮被按下时 | 玩家按下互动时 |
| 交互型 | 当接近时 | 玩家接近时 |
| 广播型 | 当收到广播时 | 收到指定广播时 |
| 循环型 | 重复执行直到 | 重复直到满足条件 |
| 条件型 | 当满足条件时 | 条件满足时 |
自定义组件三大元素
| 元素 | 说明 | 示例 |
|---|---|---|
| 属性 | 存储数据 | 数字1、文本1 |
| 指令 | 可调用的行为入口 | 当执行"指令1"时 |
| 触发时机 | 响应事件 | 当被创建时、当受到伤害时 |
当前可确认的API观察框架
[已确认]创游世界的"API"并不完全等同于传统代码函数表。[已确认]更接近"组件 + 属性 + 指令 + 触发时机 + 作用域 + 动作块"的复合接口系统。[已确认]自定义组件是API化程度最高、最适合整理成接口视角的一类内容。[待验证]仍有部分OCR低清页、未逐图补齐的接口项，不能宣称已经做到全量完整手册。
后续应继续补的字段
建议后续继续为API文档补充：
| 字段 | 说明 |
|---|---|
| 名称 | API或积木块的名称 |
| 分类 | 所属分类（动作、控制、数据等） |
| 参数 | 输入参数类型和说明 |
| 返回值 | 返回值类型和说明 |
| 作用域 | 适用的作用域层级 |
| 是否可等待 | 是否支持等待执行结束 |
| 来源截图编号 | 对应OCR截图编号 |
| 适用版本 | 适用的引擎版本 |
| 可信度 | 证据等级（已确认/待验证） |
关联阅读
核心研究
- 核心研究导航 - 核心研究总导航
- 核心概念速查手册 - 核心概念速查
- 核心概念速查 - 核心概念快速索引
- 脚本系统研究导航 - 脚本系统专题入口
- 数据、变量与作用域导航 - 数据系统入口
- 广播与事件机制导航 - 事件驱动系统入口
- 组件与对象系统导航 - 组件体系入口
脚本系统
- 脚本系统导航 - 脚本系统总入口
- 脚本界面与积木知识索引 - 积木块总览
- 自定义组件深度解析 - 自定义组件详解
- 系统级脚本能力解析 - 系统级能力
- 脚本作用域与数据流深度研究 - 数据流研究
项目设计
教程资料
- 教程资料导航 - 教程资料总入口
- 常见问题与避坑指南 - 常见API问题
- 创游世界触发时机速查卡 - 触发时机速查
- 创游世界广播使用速查卡 - 广播速查
OCR资料
- OCR资料导航 - OCR资料导航
- 基础写脚本界面截图转文本 - 脚本界面OCR原文
导航入口
- 新手阅读路线 - 学习路线导航
- 创游世界知识库总导航 - 知识库总导航
待验证问题
以下问题需要进一步验证：
| 问题 | 状态 | 验证方向 |
|---|---|---|
| 部分低质量OCR页面的接口项是否完整 | 🔄 待验证 | 需要继续OCR重读 |
| 某些接口的返回值类型是否准确 | 🔄 待验证 | 需要官方文档确认 |
| 新版本新增的API/积木块 | 🔄 待验证 | 需要版本跟踪 |
后续优化方向
- [ ] 完善API文档的字段级信息
- [ ] 补充更多积木块的参数说明
- [ ] 建立按功能域索引的API总表
- [ ] 补充触发时机的详细说明
最后更新：2026-06-10维护者：Azek431