Scheduler

A minecraft plugin that runs console commands on cron schedules.

Configuration

schedules:

  my-schedule:
    cron: "*/10 * * * *"   # every 10 minutes
    parallel: false         # run commands one after another
    commands:
      - "save-all flush"
      - "broadcast Server saved!"

  another-schedule:
    enabled: false          # set to true to activate
    cron: "0 2 * * *"      # every day at 02:00
    parallel: true          # run all commands at the same time
    commands:
      - "broadcast Nightly task running"
      - "say Hello from cron"

Schedule fields

Field	Required	Description
cron	✅	Standard 5-field cron expression
commands	✅	List of console commands to run (no leading /)
parallel	❌	true = all commands fire at once, false (default) = sequential
enabled	❌	Set to false to disable a schedule without deleting it (default: true)

Cron syntax

Five space-separated fields: minute hour day-of-month month day-of-week

Field	Range	Special characters
Minute	0–59	* , - /
Hour	0–23	* , - /
Day of month	1–31	* , - /
Month	1–12	* , - /
Day of week	0–6 (0 = Sunday)	* , - /

Examples

Expression	Meaning
* * * * *	Every minute
*/5 * * * *	Every 5 minutes
0 * * * *	Every hour (at :00)
0 2 * * *	Every day at 02:00
0 0 * * 0	Every Sunday at midnight
0 9-17 * * 1-5	Every hour 09:00–17:00, Monday–Friday
0 12 1,15 * *	Noon on the 1st and 15th of each month

Parallel vs sequential

• parallel: true — all commands are dispatched in the same server tick.
• parallel: false — commands are dispatched one per tick in order, so each command's synchronous side-effects complete before the next one starts.

Commands

All commands require the cronscheduler.admin permission (default: op).

Command	Alias	Description
/cronscheduler reload	/cs reload	Reload config.yml without restarting
/cronscheduler list	/cs list	Show all active schedules
/cronscheduler run <name>	/cs run <name>	Immediately trigger a schedule by name

Permissions

Permission	Default	Description
cronscheduler.admin	op	Access to all plugin commands