Chrono

A lightweight task scheduler plugin for servers. Schedule commands to run on a timer, at specific times, or chain them together.

Why Chrono?

Most scheduler plugins are either overkill or barely functional. Chrono hits the middle ground: powerful enough for complex setups, simple enough that you can set it up in 30 seconds without reading a wiki.

Features

• Interval scheduling — run a command every 30 seconds, 10 minutes, 2 hours, whatever you need
• Cron scheduling — run at exact clock times like daily-at-03:00 or weekly-monday-08:00
• Task chaining — run task B automatically after task A completes, with optional delay between them
• Chain-only tasks — tasks with no schedule, meant to be triggered by other tasks
• Delays — add a wait before a task fires (delay:30s)
• Enable/disable — pause tasks without deleting them
• Manual trigger — run any task on demand for testing
• GUI — in-game inventory view with click controls
• Execution logs — see when each task last ran and whether it succeeded
• Import/export — back up and restore tasks as JSON
• Tab completion — every argument is tab-completable
• JSON storage — tasks are saved to tasks.json, survive restarts, no database setup

Commands

/chrono add name:AutoSave command:save-all interval:10m
/chrono add name:Restart command:restart cron:daily-at-03:00
/chrono add name:Notify command:say Done!
/chrono chain AutoSave Notify
/chrono list
/chrono info <name>
/chrono remove <name>
/chrono enable <name>
/chrono disable <name>
/chrono run <name>
/chrono edit <name> <field> <value>
/chrono logs <name>
/chrono gui
/chrono export
/chrono import <file>
/chrono reload
/chrono help

Schedule Formats

Interval — counts from when the task was created:

| Format | Meaning |
|--------|---------|
| 30s | every 30 seconds |
| 10m | every 10 minutes |
| 2h | every 2 hours |
| 1d | every day |

Cron — fires at specific clock times:

| Format | Meaning |
|--------|---------|
| hourly | every hour at :00 |
| midnight | every day at 00:00 |
| noon | every day at 12:00 |
| daily-at-HH:MM | e.g. daily-at-08:30 |
| every-Nmin | e.g. every-5min |
| every-Nh | e.g. every-2h |
| weekly-DAY-HH:MM | e.g. weekly-monday-08:00 |

Task Chaining

Chain tasks together to build sequences:

/chrono add name:Save command:save-all interval:6h
/chrono add name:Announce command:broadcast Server saved! delay:2s
/chrono chain Save Announce

Announce fires 2 seconds after Save completes, every 6 hours. No extra config.

Chains are cycle-safe — Chrono blocks any chain that would loop.

Permissions

| Node | Description |
|------|-------------|
| chrono.admin | Full access to everything |
| chrono.add | Create tasks |
| chrono.remove | Delete tasks |
| chrono.edit | Edit tasks |
| chrono.enable / chrono.disable | Toggle tasks |
| chrono.run | Manually trigger tasks |
| chrono.list | View tasks |
| chrono.reload | Reload plugin |
| chrono.gui | Open GUI |
| chrono.export / chrono.import | Backup and restore |

Requirements

• Paper/Spigot/Bukkit/Purpur 1.21.x
• Java 21

Source

github.com/DamianDaniel/chrono