命令计时器执行

命令调度器插件指南

描述

该插件允许你在 Hytale 服务器上调度命令的执行。你可以：

• 在特定时间后执行命令
• 定期执行命令（重复执行）
• 在指定时间执行命令

🌐 团队调度器的 Web 界面

📋 描述

该插件现在包含一个内置的 Web 界面，方便通过浏览器管理任务！

🚀 快速开始

1. 启动服务器，确保已安装插件
2. 打开浏览器，访问：http://localhost:8080
3. 准备就绪！ 你将看到精美的任务管理界面。

团队

1. /scheduledelay <秒数> <命令>

在指定秒数后调度命令的一次性执行。

示例： /scheduledelay 60 say 一分钟已过！ /scheduledelay 300 time set day /scheduledelay 10 give @a diamond 1

2. /schedulerepeating <初始延迟> <周期> <团队>

调度周期性命令执行。

参数：

• 初始延迟 - 多少秒后开始执行
• 周期 - 重复命令的间隔（秒）

示例： /schedulerepeating 0 60 say 一分钟已过！ /schedulerepeating 10 300 weather clear /schedulerepeating 5 120 give @a bread 1

3. /scheduleat <日期时间> <命令>

在指定时间调度命令执行。

日期/时间格式：

• 完整格式：yyyy-MM-dd HH:mm:ss（例如：2026-02-02 15:30:00）
• 仅时间：HH:mm:ss（例如：15:30:00 - 用于今天的日期）

示例： /scheduleat 2026-02-02 18:00:00 say 晚餐时间！ /scheduleat 15:30:00 say 下午点心时间！ /scheduleat 2026-02-03 09:00:00 time set day

4. /schedulelist

显示所有计划任务的列表。

输出示例： === 计划任务 === ID: 1 [ACTIVE] 命令: say 你好！ 类型: 一次性（60秒后） ───────────────────── ID: 2 [ACTIVE] 命令: time set day 类型: 重复（0秒后开始，周期300秒） ───────────────────── 总计任务数: 2

5. /schedulecancel <ID>

按 ID 取消计划任务。

示例： /schedulecancel 1 /schedulecancel 5

使用示例

示例 1：每 5 分钟自动公告

/schedulerepeating 0 300 say §6[服务器] §请别忘了保存进度！

示例 2：每 10 分钟设置白天时间

/schedulerepeating 0 600 time set day

示例 3：凌晨 4 点重启服务器

/scheduleat 2026-02-03 04:00:00 stop

示例 4：1 小时后奖励分发

/scheduledelay 3600 give @a diamond 10

示例 5：每天 20:00 的活动

/scheduleat 20:00:00 say §a[活动] 日常活动正在进行！

重要说明

1. 任务 ID - 每个任务都会获得一个唯一 ID，可用于取消
2. 服务器时间 - 所有时间均相对于服务器时间指定
3. 自动清理 - 一次性任务完成后会自动删除
4. 重复任务 - 会无限运行，直到被取消

插件构建

1. 在项目根文件夹中打开终端
2. 运行构建命令：

   ./gradlew build
   

3. 编译后的 JAR 文件将位于 lib/build/libs/ 目录下

安装

1. 将编译后的 JAR 文件复制到 Hytale 服务器的 plugins 文件夹
2. 重启服务器
3. 插件将自动加载

项目结构

lib/src/main/java/org/example/plugins/scheduler/
├── SchedulerPlugin.java # 插件主类
├── scheduler/
│   └── CommandScheduler.java # 命令调度器
├── task/
│   └── ScheduledTask.java # 任务类
└── commands/
    ├── ScheduleDelayCommand.java # 一次性执行命令
    ├── ScheduleRepeatingCommand.java # 周期性执行命令
    ├── ScheduleAtCommand.java # 指定时间执行命令
    ├── ScheduleListCommand.java # 查看任务列表命令
    └── ScheduleCancelCommand.java # 取消任务命令

支持

如果插件出现问题，请检查服务器日志。调度器的所有操作都会记录在日志中。

作者：beavulf 版本：0.1.0 日期：2026年2月2日