JavaScript 脚本系统

QueDP 使用 JavaScript 作为脚本语言，让你能够使用标准的编程语法控制地牢的各种行为。

为什么使用 JavaScript?

• 标准语法: 使用标准 JavaScript ES6+ 语法，易于上手。
• 功能强大: 支持变量、条件判断、循环、函数等高级特性。
• 高性能: 脚本预编译和缓存，异步执行，不影响服务器性能。
• 智能提示: 提供 VSCode 扩展，支持代码补全和语法检查。

脚本引擎信息

属性	说明
引擎	GraalJS JavaScript Engine
标准	ECMAScript 2021 (ES6+)
执行	同步执行，上下文隔离
缓存	自动缓存已编译脚本

IMPORTANT

GraalJS 注意事项：

• 访问 Java 对象需要使用方法调用：player.getName() 而不是 player.name
• action.wait() 后的代码在新上下文执行，局部变量会丢失
• 需要跨 wait 使用的数据必须用 setVar/getVar 保存

在哪里使用脚本?

你可以在地牢的各个配置文件中使用脚本：

文件	用途	示例
scripts.yml	生命周期	地牢开始、完成、失败时的逻辑
monsters.yml	怪物事件	怪物组生成时、全部击杀后的逻辑
obstacles.yml	障碍物	障碍物创建、删除、玩家触碰时的逻辑
tasks.yml	定时任务	倒计时、循环检查、特定事件触发
interacts.yml	交互	玩家点击方块、踩踏区域时的逻辑

开发工具

我们提供了专门的 VSCode 扩展插件，强烈推荐安装！

• ✅ 语法高亮: 清晰的代码着色
• ✅ 智能补全: 自动提示 Action API 和参数
• ✅ 代码片段: 快速插入常用代码模板
• ✅ 语法检查: 实时发现错误

[!BUTTON] 加入 QQ 群获取插件

文档导航

基础入门

• 基础概念: 学习选择器、变量系统、基本语法
• 完整示例: 复制即用的实战代码片段

动作参考

• 消息类动作: 发送消息、标题、通知
• 玩家类动作: 传送、物品、状态、技能
• 特效类动作: 音效、粒子、闪电
• 地牢类动作: 副本控制、怪物组、奖励
• 世界类动作: 时间、天气、方块
• 流程控制: 等待、循环、条件

高级功能

• MythicMobs 集成: MM 技能与副本动作双向交互