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