CommandTimer - 最全指令定时插件

CommandTimer 是一款功能全面的调度插件，支持按每日、每小时、仅限 OP 玩家、仅在特定区域等多种条件执行命令，几乎能满足所有定时任务需求。

本文档仅作简要介绍，完整功能请查阅官方文档。

💡使用说明

插件通过 计时器/任务 来管理各种命令配置。每个计时器可以包含一组具有相同执行条件的命令。例如，如果有 5 条命令都需要每分钟执行一次，就可以将它们放在同一个计时器中；如果某条命令需要不同的执行间隔或涉及权限条件，则需要创建另一个计时器。

• 使用 /cmt 命令开始配置，探索插件功能。
• 如有疑问或需要帮助，欢迎加入 Discord 服务器交流。

🎮功能列表

以下为部分核心功能，完整列表请查看 Wiki 文档：

• 在控制台执行命令
• 以玩家/OP 身份执行命令
• 为每位玩家在控制台执行命令
• 在代理端（Bungee/Waterfall）执行命令
• 按固定时间间隔执行命令
• 在特定小时/日期执行命令
• 根据游戏内时间执行命令
• 在特定时间范围内执行命令（例如下午 2 点至 4 点之间）
• 支持命令链配置，可在命令之间设置延迟
• 延迟执行命令
• 条件引擎：可根据玩家权限、玩家位置、WorldGuard 区域等条件决定是否执行命令（详见 Wiki）
• 限制命令执行次数
• 服务器启动时执行命令
• 支持 MySQL/MariaDB（测试版）
• 支持基于事件触发任务/命令（功能有限，请查看可用扩展）
• 支持 PlaceholderAPI（PAPI）
• 支持 Bungeecord/Velocity
• 提供 API，可创建新扩展/条件并接入自定义功能
• ……

✨扩展/条件

CommandTimer 支持通过扩展来新增条件规则，让你可以更精细地控制命令的执行时机。

官方扩展列表

完整扩展列表请访问

https://titivermeesch.github.io/CommandTimer/docs/extensions#official-extensions

🔧帮助与支持

如需进一步帮助，请通过 Discord 联系开发者或加入服务器交流。如果对插件满意，别忘了留下评价！

• 完整文档：https://titivermeesch.github.io/CommandTimer/
• Discord 支持：https://discord.gg/XyP5e2de5T

💡简介

CommandTimer 是一个强大的 Minecraft 插件，它允许你创建基于时间的循环，在特定时间间隔自动执行命令。无论是自动公告、定时奖励还是服务器维护，它都能轻松实现。

🎮命令

• /ct help - 显示帮助信息。
• /ct list - 列出所有已配置的计时器。
• /ct reload - 重新加载插件的配置文件。
• /ct start <计时器名称> - 启动指定的计时器。
• /ct stop <计时器名称> - 停止指定的计时器。
• /ct toggle <计时器名称> - 切换（启动/停止）指定计时器的状态。
• /ct info <计时器名称> - 显示指定计时器的详细信息。

✨功能特性

• 灵活配置：通过简单的 YAML 文件轻松创建和管理多个计时器。
• 精确控制：可以为每个计时器设置不同的时间间隔（支持 ticks、秒、分钟、小时）。
• 随机延迟：支持在固定间隔上添加随机延迟，让命令执行时间更自然。
• 条件执行：可以设置命令仅在特定世界或时间段内执行。
• 玩家变量：在命令中使用 {player} 变量，可以随机选择在线玩家或执行控制台命令。
• 跨版本兼容：支持从 Minecraft 1.8 到最新版本的多种服务器核心。

🔧配置教程

基本结构

配置文件 (config.yml) 中的每个计时器都是一个独立的配置块。以下是一个简单公告计时器的示例：

announcement:
  enabled: true
  interval: 5m
  commands:
  - 'broadcast &6这是一条自动公告！'

关键配置项说明

• enabled：计时器创建后是否立即启用。
• interval：命令执行的时间间隔。例如：100t (100 ticks), 30s, 5m, 2h。
• commands：要按顺序执行的命令列表。
• random-interval：在固定间隔上增加的随机延迟范围（例如 0s-30s）。
• worlds：计时器仅在列出的世界中生效。如果留空或设置为 []，则在所有世界生效。
• from-time 和 until-time：设置计时器每天生效的时间段（格式为 HH:MM）。

使用玩家变量

将 {player} 放置在命令中，插件会将其替换为随机在线玩家的名字。这对于需要指定玩家的命令非常有用。

**示例**

random-feed:
  interval: 1m
  commands:
  - 'give {player} minecraft:cookie 1'
  - 'tell {player} 你获得了一块饼干！'

❓常见问题

• 问：如何安装这个插件？
• 将下载的 CommandTimer.jar 文件放入服务器的 plugins 文件夹，然后重启服务器。

• 问：支持哪些服务器核心？
• 插件支持 Spigot、Paper 及其衍生服务端（如 Purpur）。确保你的服务器版本在 1.8 或以上。

• 问：计时器的时间格式是怎样的？
• 支持 ticks (t)、秒 (s)、分钟 (m)、小时 (h)。例如：6000t、60s、5m、1h。

• 问：命令是以谁的身份执行的？
• 默认情况下，命令以控制台身份执行，拥有最高权限。如果命令中包含 {player} 变量，则针对该玩家执行。

• 问：如何让计时器只在晚上运行？
• 使用 from-time: "18:00" 和 until-time: "06:00" 配置项来实现。

⭐注意事项

• 修改 config.yml 后，请使用 /ct reload 命令重载配置，无需重启服务器。
• 在命令中使用引号时，请确保使用单引号 (') 来避免 YAML 解析错误。
• 你可以在计时器命令中使用其他插件提供的占位符（如果安装了 PlaceholderAPI）。
• 请定期查看插件更新日志，以获取新功能和兼容性改进。

如需更多详细信息和高级配置示例，请访问插件的官方 Wiki 页面。