# 在哪些地方会看到脚本

当前编辑器里，脚本入口已经分散在很多地方，最常见的是：

• 控件的 高级
• 事件的 JS
• 场景的 解锁脚本
• 组合属性的 脚本
• 字符串 / 图标的 脚本
• 地图插件里的格子脚本
• AI 智能体插件里的需求脚本和触发脚本

# 最常见的脚本分几类

可以先按用途把它们分成四类：

类型	常见位置	主要作用
判断脚本	控件 / 事件需求脚本、场景解锁脚本	决定能不能显示、能不能触发、能不能进入
计算脚本	组合属性脚本	算出一个数值
文本脚本	字符串 / 图标脚本	返回一段文本或图标内容
行为脚本	控件、事件、地图、AI 的触发脚本	在触发前后继续补联动

# 控件和事件里最常见的脚本

当前控件和事件最常见的脚本入口是这四个：

• 前置需求脚本
• 触发需求脚本
• 触发前脚本
• 触发后脚本

如果你只是在做普通玩法，大多数时候先接触到的就是这四类。

# 场景也有脚本

当前场景编辑页里有单独的 解锁脚本。

界面提示已经写得很明确：

• 这里主要控制场景是否解锁
• 脚本需要返回 true / false
• 如果没有脚本，才会回到下面的解锁需求属性

# 组合属性和字符串也有脚本

当前这两个位置也都已经有单独脚本入口：

# 组合属性脚本

适合用来：

• 计算一个数值结果
• 代替复杂公式

# 字符串 / 图标脚本

适合用来：

• 返回一段动态文本
• 返回图标内容
• 直接控制字符串显示结果

# AI 智能体里也能写脚本

在 AI智能体插件 里，当前已经有这些脚本入口：

• 输入需求脚本
• 后悔需求脚本
• 重置需求脚本
• 发送输入前脚本
• 输出后脚本
• 后悔时脚本
• 重置时脚本

所以 AI 插件不只是填提示词，也可以继续补行为规则。

# 脚本编辑器里会看到什么

当前脚本编辑器统一提供这些能力：

• 语法检查
• 常用补全
• 调试运行
• 日志查看

在一些位置，界面上还会直接提示：

• 哪些脚本更适合只做读取
• 哪些脚本需要返回固定类型

# 什么时候适合先用设置，什么时候适合写脚本

一个简单判断方式：

# 第一次学脚本，可以先看什么

1. 先看自己当前要改的是控件、事件、场景、字符串还是组合属性
2. 再确认这个位置有没有现成脚本入口
3. 如果只是判断能不能显示，先看需求脚本
4. 如果只是算一个值，先看组合属性脚本
5. 如果只是改一段文本，先看字符串脚本

# 阅读顺序

继续往下看时，可以按这个顺序：

1. player 对象
2. objects 对象
3. tools 对象
4. 脚本挂载点与返回值
5. 再进入各个专题脚本页

# 下一步

继续看：

• player 对象
• objects 对象
• tools 对象