Blockly 积木参考
BlocklyAllay 提供了各种 Blockly 积木块，您可以使用它们为 Minecraft 类服务器创建脚本。这些积木块根据其功能按类别组织。
积木类别
事件
事件积木块允许您响应各种服务器和玩家事件：
- 脚本加载：脚本首次加载时运行
- 脚本卸载：脚本卸载时运行
- 玩家加入：玩家加入服务器时运行
- 玩家离开：玩家离开服务器时运行
- 玩家聊天：玩家发送聊天消息时运行
- 玩家交互：玩家与世界交互时运行
表单
表单积木块允许您为玩家创建交互式表单：
- 创建简单表单：创建带有文本和按钮的简单表单
- 创建模态表单：创建是/否确认对话框
- 创建自定义表单：创建带有各种输入字段的表单
- 向玩家显示表单：向特定玩家显示表单
- 表单提交处理：处理玩家的表单提交
世界
世界积木块允许您与游戏世界交互：
- 获取所有世界：检索服务器上所有可用的世界
- 按名称获取世界：通过名称获取特定世界
- 获取世界时间：检索世界中当前的时间
- 设置世界时间：更改世界中的时间
- 获取世界天气：检索世界中当前的天气
- 设置世界天气：更改世界中的天气
玩家
玩家积木块允许您与服务器上的玩家交互：
- 获取在线玩家：检索所有当前在线的玩家
- 按名称获取玩家：通过用户名获取特定玩家
- 向玩家发送消息：向玩家发送聊天消息
- 踢出玩家：从服务器移除玩家
- 给予玩家物品：给予玩家物品
- 获取玩家位置：检索玩家当前位置
- 传送玩家：将玩家移动到特定位置
调度器
调度器积木块允许您安排任务在特定时间运行：
- 延迟执行：延迟后运行任务一次
- 重复执行：以固定间隔重复运行任务
- 延迟重复执行：在初始延迟后重复运行任务
Boss 血条
Boss 血条积木块允许您创建和管理 Boss 血条：
- 创建 Boss 血条：创建带有标题的新 Boss 血条
- 设置 Boss 血条标题：更改现有 Boss 血条的标题
- 设置 Boss 血条进度：设置 Boss 血条的进度（0.0-1.0）
- 设置 Boss 血条颜色：更改 Boss 血条的颜色
- 设置 Boss 血条样式：更改 Boss 血条的样式
- 向玩家显示 Boss 血条：向玩家显示 Boss 血条
- 从玩家隐藏 Boss 血条：从玩家隐藏 Boss 血条
命令
命令积木块允许您注册自定义命令：
- 注册简单命令：注册带有处理程序的基本命令
- 注册带别名的命令：注册带有替代名称的命令
- 命令发送者检查：检查命令发送者是玩家还是控制台
- 向命令发送者发送消息：向运行命令的人发送消息
实体
实体积木块允许您与世界中的实体交互：
- 获取实体类型：检索实体的类型
- 获取实体位置：获取实体的坐标
- 获取实体生命值：检索实体的生命值
- 设置实体生命值：更改实体的生命值
物品
物品积木块允许您与物品交互：
- 获取物品类型：检索物品的类型
- 获取物品数量：获取物品堆中的物品数量
- 获取物品自定义名称：检索物品的自定义名称
工具
工具积木块提供各种实用功能：
- 日志消息：将消息写入服务器日志
- 读取文件：从文件中读取内容
- 写入文件：将内容写入文件
- HTTP 请求：向 URL 发出 HTTP 请求
- 解析 JSON：将 JSON 字符串转换为对象
- 序列化 JSON：将对象转换为 JSON 字符串
Blockly 工作区
当您打开 BlocklyAllay 时，您将看到 Blockly 工作区，您可以在其中拖放积木块来创建脚本。积木块在屏幕左侧工具箱中按类别组织。
要创建脚本：
- 从工具箱将积木块拖到工作区上
- 连接积木块以形成逻辑序列
- 通过单击积木块来配置积木块属性
- 通过在服务器上运行脚本来测试
积木脚本示例
这是一个简单的 Blockly 脚本示例，在玩家加入时向他们发送欢迎消息：
当玩家加入时
获取事件玩家
向玩家发送消息 "欢迎来到服务器！"
此脚本使用"玩家加入"事件积木块、"获取事件玩家"积木块和"向玩家发送消息"积木块来创建一个简单的欢迎消息系统。
最佳实践
- 使用注释和逻辑分组来保持脚本的组织
- 在将脚本部署到生产服务器之前彻底测试
- 使用描述性变量名使脚本更具可读性
- 利用事件创建响应式游戏体验
- 使用表单为玩家创建交互式界面