Quartz4MC

Quartz4MC (Quartz for Minecraft) is a Fabric mod that allows you to schedule and automatically execute Minecraft commands using cron expressions. Built on top of the Quartz Scheduler for Java, it brings robust, flexible task scheduling to your Minecraft server.

Features

Schedule commands using standard Quartz cron expressions
Enable/disable tasks dynamically
Full command management with /quartz4mc
Built-in suggestions for common cron patterns
Automatic failure handling: disables a task after 5 consecutive failures
Logs execution status and errors in server console

Installation

Make sure Fabric is installed on your Minecraft server.
Place the quartz4mc-fabric-<version>.jar file in the mods folder.
Restart your server.
The configuration file will be generated at config/quartz4mc.json.

Commands

/quartz4mc reload
    Reload the configuration file

/quartz4mc list [enabled|disabled]
    List all tasks, optionally filtering by enabled or disabled

/quartz4mc add <id> <pattern> <command>
    Add a new cron task

/quartz4mc remove <id>
    Remove a cron task

/quartz4mc start <id>
    Enable and schedule a cron task

/quartz4mc stop <id>
    Disable a cron task

/quartz4mc details <id>
    Display detailed information about a task

/quartz4mc status
    Show the scheduler's status and total crons

Arguments

id : unique identifier for the task
pattern : cron expression (Quartz 6-field format)
command : Minecraft command to execute
enabled : whether the task is active

Aliases

Quartz4MC commands can also be used with /quartz and /cron aliases.

Configuration

The configuration file is generated at config/quartz4mc.json.
Example of a default cron entry:

{
  "id": "example_broadcast",
  "schedule": "0 * * * * ?",
  "command": "tellraw @a [{\"text\":\"[QuartzConfig] \",\"color\":\"light_purple\"}, {\"text\":\"Edit \", \"color\": \"gray\"}, {\"text\":\"config/quartz4mc.json\",\"color\":\"white\"}, {\"text\":\" to disable this default cron.\",\"color\":\"gray\"}]",
  "enabled": true
}

Scheduler and Logging

Quartz4MC is based on Quartz Scheduler for Java, ensuring reliable and precise execution of scheduled commands.
Failed tasks are logged in the server console.
After 5 consecutive failures, a task is automatically disabled to prevent infinite error loops.

Compatibility

Quartz4MC has been tested and confirmed to work on the following Minecraft and Fabric versions:

Minecraft	Fabric Loader	Fabric API
1.21.1	0.17.2	0.116.6+1.21.1

We maintain a list of supported versions in the README. New versions will be added as testing is completed.

Request Support

Quartz4MC is primarily developed and tested for Fabric. If you'd like to see support for additional Minecraft versions or other mod loaders such as Forge or NeoForge, feel free to open a discussion on the GitHub Discussions page. Your requests will help prioritize compatibility testing and new feature development.

Development and Contributions

Built with Fabric API for Minecraft
Open source and available under the MIT License
Contributions are welcome! Fork the repository and submit pull requests.

License

Quartz4MC is licensed under the MIT License. See the LICENSE file for details.

Credits

Developed by CaptainZiboo
Built on top of the Quartz Scheduler Java library
Adapted for Minecraft Fabric servers