- 版权类型
- 原创
- 插件中文名称
- 定时指令
- 插件英文名称
- command-scheduler
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- 语言支持
- 多语言
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
[MD]
# CommandScheduler 定时指令插件
一个功能强大的 Minecraft 服务器定时执行指令插件,支持 1.16.5 及以上所有版本。
## 🚀 功能特点
- **定时执行**: 支持按指定间隔自动执行命令
- **灵活配置**: 可配置执行间隔、启动延迟和启用状态
- **占位符支持**: 支持 `%online_players%` 等动态占位符
- **权限控制**: 完整的权限系统,支持细粒度权限管理
- **热重载**: 支持运行时重新加载配置
- **任务管理**: 可以手动启动/停止指定任务
- **现代化API**: 使用最新的 Adventure API,兼容新版本
## 📋 系统要求
- **Minecraft版本**: 1.16.5 及以上
- **服务端**: Spigot/Paper/Purpur 等
- **Java版本**: 21+
## 🛠️ 安装方法
1. 下载插件jar文件
2. 将jar文件放入服务器的 `plugins` 文件夹
3. 重启服务器
4. 编辑 `plugins/CommandScheduler/config.yml` 配置文件
5. 使用 `/scheduler reload` 重新加载配置
## ⚙️ 配置文件
```yaml
tasks:
server_broadcast:
enabled: true
interval: 6000 # 5分钟 = 6000 tick
delay: 1200 # 启动延迟 1分钟
commands:
- "say §e[服务器公告] §a欢迎来到我们的服务器!当前在线玩家:%online_players% 人"
- "say §e[服务器公告] §b记得查看服务器规则哦!"
```
### 配置说明
- `enabled`: 是否启用该任务
- `interval`: 执行间隔(单位:tick,20 tick = 1秒)
- `delay`: 启动延迟(单位:tick)
- `commands`: 要执行的命令列表
### 可用占位符
- `%online_players%` - 当前在线玩家数量
## 🎮 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/scheduler` | 显示帮助信息 | `scheduler.use` |
| `/scheduler reload` | 重新加载配置 | `scheduler.reload` |
| `/scheduler list` | 显示所有任务 | `scheduler.list` |
| `/scheduler start <任务名>` | 启动指定任务 | `scheduler.control` |
| `/scheduler stop <任务名>` | 停止指定任务 | `scheduler.control` |
## 🔐 权限节点
- `scheduler.use` - 基础命令使用权限(默认:true)
- `scheduler.reload` - 重新加载配置权限(默认:op)
- `scheduler.list` - 查看任务列表权限(默认:op)
- `scheduler.control` - 启动/停止任务权限(默认:op)
- `scheduler.*` - 所有权限(默认:op)
## 📝 使用示例
### 1. 定时广播
```yaml
server_broadcast:
enabled: true
interval: 6000 # 每5分钟
delay: 1200 # 启动后1分钟开始
commands:
- "say §e[公告] §a当前在线玩家:%online_players% 人"
```
### 2. 自动保存
```yaml
auto_save:
enabled: true
interval: 72000 # 每小时
delay: 0
commands:
- "save-all"
- "say §e[系统] §a世界已自动保存"
```
### 3. 夜间时间调整
```yaml
night_time_fix:
enabled: true
interval: 1728000 # 每24小时
delay: 0
commands:
- "time set day"
- "weather clear"
```
## 🔄 版本更新
### v1.0.0
- ✅ 支持 Minecraft 1.16.5+ 所有版本
- ✅ 使用现代化 Adventure API 替代过时的 ChatColor
- ✅ 更新到 Java 21
- ✅ 修复所有过时API警告
- ✅ 完善的权限系统
- ✅ 支持热重载配置
## 🐛 故障排除
### 常见问题
1. **插件无法加载**
- 检查服务器版本是否为 1.16.5+
- 确认Java版本是否为 21+
2. **任务不执行**
- 检查配置文件中 `enabled` 是否为 `true`
- 使用 `/scheduler list` 查看任务状态
- 检查命令是否正确
3. **权限问题**
- 确认玩家拥有相应权限
- 检查权限插件配置
## 📞 支持与反馈
如果您在使用过程中遇到问题或有改进建议,请联系开发者。
---
**开发者**: 9C2211D
**版本**: 1.0.0
**兼容性**: Minecraft 1.16.5+
**最后更新**: 2024年
[/MD]