Realtime Schedules

Plugin Synopsis

This plugin runs on server-side, expands the command tree of /schedule:

/schedule
\
 -function
  \
   -<function>
    \
     -realtime
      \
      |-<magnitude>
      | \
      |  -(ms|s|min|h|d|a)
      |   \
      |    -[(append|replace)]
      \
       -at
        \
         -<time>
          \
           -[(append|replace)]

How to Use This Plugin

Load a world with this plugin running, and load some data pack functions, then you can use the command:

• Temporary realtime schedules
• /schedule function funct1 realtime 800 ms append – Append a schedule of funct1 that will be executed after 800 milliseconds
• /schedule function funct2 realtime 10.5 s – Clear all temporary realtime schedules of funct2 and append a schedule of funct2 that will be executed after 10.5 seconds
• /schedule function #tag1 realtime 3.14 min replace – Clear all temporary realtime schedules of #tag1 and append a schedule of #tag1 that will be executed after 3.14 minutes
• /schedule function #tag2 realtime 0.9 h append – Append a schedule of #tag2 that will be executed after 0.9 hours
• /schedule function funct3 realtime 1 d – Clear all temporary realtime schedules of funct3 and append a schedule of funct3 that will be executed after 1 day
• /schedule function funct4 realtime 0.25 a replace – Clear all temporary realtime schedules of funct4 and append a schedule of funct4 that will be executed after 0.25 Julian years
• Persistent realtime schedules
• /schedule function #tag3 realtime at "18:30" append – Append a schedule of #tag3 that will be executed at 18:30 “today”
• /schedule function #tag4 realtime at "24:30" – Clear all persistent realtime schedules of #tag4 and append a schedule of #tag4 that will be executed at 00:30 “tomorrow”
• /schedule function funct5 realtime at "12:34:56" replace – Clear all persistent realtime schedules of funct5 and append a schedule of funct5 that will be executed at 12:34:56 “today”
• /schedule function funct6 realtime at "03-14 15:09:26" append or /schedule function funct6 realtime at "14/3 15:09:26" – Append a schedule of funct6 that will be executed at 15:09:26 March 14 “this year”
• /schedule function #tag5 realtime at "2025-06-07 00:00:00" or /schedule function #tag5 realtime at "7/6/2025 00:00:00" – Clear all persistent realtime schedules of #tag5 and append a schedule of #tag5 that will be executed at 00:00:00 June 7, 2025

All unexecuted temporary realtime schedules will be discarded on server stopping. All unexecuted persistent realtime schedules will be saved to realtime-schedules.json at the root directory of the world on world saving. If a persistent realtime schedule has a execute time before the current time, it will be immediately executed. Realtime schedules will be executed even if the game is frozen by /tick freeze or paused (singleplayer).

License and Source Code

The Fabric version of this project is under GNU Lesser Generic Public License version 3. Its source code repository: https://github.com/IAmREGE/Realtime-Schedules
The Spigot version of this project is under GNU Generic Public License version 3. Its source code repository: https://github.com/IAmREGE/Realtime-Schedules-spigot
Due to Modrinth’s limitation, the page can only show one license (LGPL-3.0-or-later) and one source link.

Known Issues

Spigot Platform

• Executing /bukkit:reload can break this plugin with java.lang.IllegalStateException: zip file closed.