SRV-Cron

# SRV-Cron Continuation of the well-known Cron plugin — (https://www.spigotmc.org/resources/mc-cron-scheduler-jobs-bungeecord-support.37632/). All credits go to the original author — **TheTadeSK**. SRV-Cron is an all-in-one Minecraft server scheduler that has many features to schedule jobs for certain times or in-game events. It is a continuation of the well-known Cron plugin MC-Cron, with many additional and expanded features that the original MC-Cron plugin does not provide, such as PlaceholderAPI support, sending commands as players, variable actions, and condition checking. --- # Features These are some of the features that this plugin provides. - Customizable jobs - Various command execution - Execute commands by every online player - Send title messages to every online player - Play sounds to every online player - Filter command action receivers by a condition or permission - Event jobs & commands - Start-up commands - Delayed command execution with `/timer` - **BungeeCord** support - **PlaceholderAPI** support ## Available Events Use these values in the configuration: - `join-event` - `quit-event` - `weather-change-event` - `world-load-event` - `player-bed-enter-event` - `player-change-world-event` - `player-gamemode-change-event` - `player-kick-event` - `chat-event` - `command-event` - `item-pickup-event` - `player-advancement-done-event` ## Built-in Placeholders - `{player_name}` — for events that relate to a player - `{world_name}` — for events that relate to a world And many more event-specific placeholders. Read more here: https://github.com/M0diis/SRV-Cron/wiki/Configuration#events You can use both placeholders if the event relates to both a player and a world, for example `player-change-world-event`. > **BungeeCord has only two events available: join and quit.** --- # Commands & Permissions ## Run command after specified seconds Command: ```text /timer <seconds> <command> ``` Permission: ```text srvcron.command.timer ``` ## Reload configuration & jobs Command: ```text /srvcron reload ``` Permission: ```text srvcron.command.reload ``` ## Run cron or event job manually Command: ```text /srvcron run <job-name> /srvcron run event <event-name> ``` Permission: ```text srvcron.command.run ``` ## Suspend job execution Command: ```text /srvcron suspend <job-name> ``` Permission: ```text srvcron.command.suspend ``` ## Resume job execution Command: ```text /srvcron resume <job-name> ``` Permission: ```text srvcron.command.resume ``` ## Job information Command: ```text /srvcron jobinfo <job-name> ``` Permission: ```text srvcron.command.jobinfo ``` ## Job & event list Command: ```text /srvcron list ``` Permission: ```text srvcron.command.list ``` --- # Configuration Configuration is pretty simple and easy to understand. For a more detailed explanation, visit the GitHub Wiki: **(https://github.com/M0diis/SRV-Cron/wiki/Configuration)** ## Default Configuration ```yaml jobs: save: time: every 1 hour commands: - say Saving world! - save-all - say Save Complete! restart: time: every 1 day of week at 6:00 commands: - say Server restart in 10 seconds! - timer 10 stop tps: time: every 30 minutes commands: - tps # If you do not want to use any event jobs, use: # event-jobs: { } event-jobs: join-event: welcome: time: 1 commands: - tell {player_name} Hello! - <ALL> Hello {player_name}! quit-event: bye: time: 5 commands: - say {player_name} left the game few seconds ago. player-gamemode-change-event: notify: time: 0 commands: - '<ALL> Player {player_name} changed his gamemode from {from_gamemode} to {to_gamemode}.' startup: commands: - say Server was started! - timer 60 say Server is online for 1 minute! - save-all schedule: # Controls numeric weekdays in expressions like: every day of week in 1,5 at 12:00 # Supported: monday-first (default, ISO), sunday-first (legacy), iso, legacy weekday-numbering: monday-first debug: false silent-start: false notify-update: true log-to-file: true locale: 'en' ``` ## Syntax ```yaml # named weekdays time: every wednesday at 00:00 time: every monday,friday at 18:30 # list/range support time: every day of week in 1,3,5 at 12:00 time: every day of week in 2..6 at 07:45 time: every day of month in 1..5 at 09:00 # plain intervals time: every 30 seconds time: every 5 minutes time: every 1 hour time: every 2 days # multiple times per day time: every day at 08:00,12:00,18:00 # time windows time: every 15 minutes from 09:00 to 17:00 time: every 20 minutes from 23:00 to 03:00 # nth / last weekday in month time: every 2nd monday of month at 10:00 time: every last friday of month at 22:00 # relative calendar keywords time: every weekday at 09:00 time: ever