SRV-Cron

插件

· 作者 M0diis

SRV-Cron 是一款全功能的 Minecraft 服务器调度器,具有多种功能,可安排任务在特定时间或游戏内事件发生时执行。

0 本站下载 0 关注 更新于 1 个月前

最新 2.13.0 · 26.2 · Paper / Purpur

一键开服(送7天)

SRV-Cron

知名 Cron 插件 MC-Cron 的延续版本。

所有荣誉归于原作者 — TheTadeSK。

SRV-Cron 是一款功能齐全的一体化 Minecraft 服务器调度器,具备多种功能,可按特定时间或游戏内事件安排任务执行。

它是知名 Cron 插件 MC-Cron 的延续版本,提供了原版 MC-Cron 插件所不具备的许多额外和扩展功能,例如 PlaceholderAPI 支持、以玩家身份发送命令、变量操作以及条件检查。


功能

以下是该插件提供的一些功能。

  • 可自定义的任务
  • 控制台、玩家和管理员命令执行
  • 让每个在线玩家执行命令
  • 发送消息、标题和操作栏文本
  • 播放音效并生成粒子效果
  • 广播消息并写入计划日志
  • 按权限、PlaceholderAPI 值或记分板分数过滤操作
  • 事件任务与命令
  • 启动命令
  • 使用 /timer 延迟执行命令
  • BungeeCord 支持
  • PlaceholderAPI 支持

命令操作与条件

默认情况下,计划的命令以控制台身份运行。在命令前添加前缀可以发送消息、显示标题或操作栏、播放音效、生成粒子、让玩家聊天或运行命令、以管理员身份运行、广播或写入日志消息。支持的前缀包括 [MESSAGE]/[TEXT]、[TITLE]、[ACTIONBAR]、[SOUND]、[PARTICLE]、[CHAT]、[PLAYER]、[OP]、[CONSOLE]、[BROADCAST]、[LOG] 以及 [LOG <file>]。

消息、标题、操作栏和广播支持 MiniMessage 以及传统的 &/§ 颜色代码(包括 RGB 格式)。前缀条件支持权限检查、PlaceholderAPI 比较(需安装 PlaceholderAPI)、记分板分数,以及使用 && 和 || 的组合条件:

- '{IF:hasPermission:vip} [MESSAGE] <gold>Welcome, %player_name%!'
- '{IF:placeholder:%vault_eco_balance%>=1000} [CONSOLE] give %player_name% diamond 1'
- '{IF:score:points>=10} [ACTIONBAR] &aYou have enough points.'

条件需要一个玩家上下文,例如事件任务或针对 <ALL>/<ALL+> 分发的命令。现有的动作头过滤器(如 [TEXT (PERMISSION:staff)] ...)仍然受支持。

可用事件

在配置中使用以下值:

  • join-event
  • quit-event
  • weather-change-event
  • world-load-event
  • player-bed-enter-event
  • player-change-world-event
  • player-gamemode-change-event
  • player-kick-event
  • chat-event
  • command-event
  • item-pickup-event
  • player-advancement-done-event

内置占位符

  • {player_name} — 用于与玩家相关的事件
  • {world_name} — 用于与世界相关的事件

以及许多其他特定于事件的占位符。

在此阅读更多:

如果事件同时涉及玩家和世界(例如 player-change-world-event),你可以同时使用这两个占位符。

BungeeCord 仅提供两个可用事件:加入和离开。


命令与权限

指定秒数后运行命令

命令:

/timer <seconds> <command>

权限:

srvcron.command.timer

重载配置与任务

命令:

/srvcron reload

权限:

srvcron.command.reload

手动运行 cron 或事件任务

命令:

/srvcron run <job-name>
/srvcron run event <event-name>

权限:

srvcron.command.run

暂停任务执行

命令:

/srvcron suspend <job-name>

权限:

srvcron.command.suspend

恢复任务执行

命令:

/srvcron resume <job-name>

权限:

srvcron.command.resume

任务信息

命令:

/srvcron jobinfo <job-name>

权限:

srvcron.command.jobinfo

任务与事件列表

命令:

/srvcron list [events]

权限:

srvcron.command.list

配置

配置非常简单易懂。

如需更详细的说明,请访问 GitHub Wiki:

Configuration · M0diis/SRV-Cron Wiki

默认配置

jobs:
  save:
    time: every 1 hour
    commands:
      - say Saving world!
      - save-all
      - say Save Complete!
  restart:
    time: every 1 day of week at 6:00
    commands:
      - say Server restart in 10 seconds!
      - timer 10 stop
  tps:
    time: every 30 minutes
    commands:
      - tps

# 如果你不想使用任何事件任务,请使用:
# event-jobs: { }
event-jobs:
  join-event:
    welcome:
      time: 1
      commands:
        - tell {player_name} Hello!
        - <ALL>[CHAT] Hello {player_name}!
  quit-event:
    bye:
      time: 5
      commands:
        - say {player_name} left the game few seconds ago.
  player-gamemode-change-event:
    notify:
      time: 0
      commands:
        - '<ALL> [TEXT (PERM:staff.notify.gamemode)] Player {player_name} changed his gamemode from {from_gamemode} to {to_gamemode}.'

startup:
  commands:
    - say Server was started!
    - timer 60 say Server is online for 1 minute!
    - save-all

schedule:
  # 控制类似 "every day of week in 1,5 at 12:00" 表达式中的数字星期几
  # 支持:monday-first(默认,ISO)、sunday-first(旧版)、iso、legacy
  weekday-numbering: monday-first

debug: false
silent-start: false
notify-update: true
log-to-file: true
locale: 'en'

语法

# 命名星期几
time: every wednesday at 00:00
time: every monday,friday at 18:30

# 列表/范围支持
time: every day of week in 1,3,5 at 12:00
time: every day of week in 2..6 at 07:45
time: every day of month in 1..5 at 09:00

# 纯间隔
time: every 30 seconds
time: every 5 minutes
time: every 1 hour
time: every 2 days

# 每天多次
time: every day at 08:00,12:00,18:00

# 时间窗口
time: 09:00 至 17:00,每 15 分钟一次
time: 23:00 至 03:00,每 20 分钟一次

# 每月第 N 个/最后一个工作日
time: 每月第 2 个周一 10:00
time: 每月最后一个周五 22:00

# 相对日历关键词
time: 每个工作日 09:00
time: 每个周末 11:00
time: 每月最后一天 23:55

# 月份名称计划
time: 每年 1 月、3 月的第 1 天 08:00

# 开始/结束约束
time: 2026-06-01 至 2026-09-01 之间,每小时一次

# 每个任务的时区和抖动
# 选项顺序为:... [between ...] [jitter ...] [timezone ...]
time: 每天 09:00 timezone Europe/Berlin
time: 每 5 分钟 jitter 30s
time: 每 10 分钟 jitter 2m timezone Europe/Berlin

# 一次性执行
time: 2026-06-10 14:30

# 经典 Cron 表达式(需显式启用)
time: "cron: 0 0 * * 3"
time: "cron: */15 9-17 * * mon-fri"

注意:

  • Cron 格式为 minute hour day-of-month month day-of-week。
  • Cron 支持在每个字段中使用 *、列表(,)、范围(-)和步长(/)。
  • 支持 Cron 的月份/星期几名称(例如 jan、mon-fri)。
  • 星期几 DSL 数字与现有配置保持兼容(1=星期日 ... 7=星期六)。
  • 为了向后兼容,仍接受旧版表达式:
    • every 4 day of week at 00:00(或省略 at,默认为 00:00)
    • every 1 day of month at 09:00(或省略 at,默认为 00:00)

API

如需更详细的说明,请访问 GitHub Wiki:

API · M0diis/SRV-Cron Wiki

目前有 3 个事件会在特定操作时触发:

您还可以与 API 进行交互。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源