Bukkit

Basics

Script files

A script means any text file, which has neither the .yml or .ini extenion, those ones are avoided by this plugin. Scripts contain commands, which are the lines of them. Writing or leaving the slash mark '/' on the beginning of commands has no effects.
For commands starting with double slash, like WorldEdit commands, write the full format - as would use ingame - with two slashes.

Target location

This plugin has only one target location, where the scripts are located. If it points to a file, then the plugin will check for that file only. If it exists, executes it, then delete it. In case the target location is a directory, then it is handled as the source of the folder based scheduling system.

Sorting scripts

To run a given script the time it shall be called, you must create folders. The name of the folder will determine when the scripts inside will be called, and what's their fate as for the future. The keywords are listed below, use them as folder names exactly as how the examples show.

Oneshot

Keyword: ON
Format: On year-month-day
Example: On 2016-11-17
Description: Once called on the given date.

Keyword: AT
Format: At year-month-day hour-min
Format: At year-month-day hour-min-sec
Example: At 2016-11-17 22-25
Description: Once called in the given time.

Keyword: BEFORE
Format: Before year-month-day
Example: Before 2016-11-17
Description: Once called before the given date comes.

Keyword: AFTER
Format: After year-month-day
Example: After 2016-11-18
Description: Once called after the given date came.

Repeating

Keyword: DAILY
Format: Daily
Description: Called once every day.

Keyword: WEEKLY
Format: Weekly
Description: Called once every week.

Keyword: MONTHLY
Format: Monthly
Description: Called once every month.

Interval

Keyword: UNTIL
Format: Until year-month-day
Example: Until 2016-11-17
Description: Called every day until the given date. On that day won't be called.

Keyword: FROM
Format: Before year-month-day
Example: Before 2016-11-17
Description: Will be called on the given day and all days after.

Modifiers

Prefix: #
Format: #<name>
Example: #Until 2016-11-17
Description: Comment out. The folder beginning with # will be left and not cared.

Prefix: $
Format: $<name>
Example: $After 2016-11-17
Description: Keep. It protects the folder from being deleted automatically. Repeating folders are not deleted, but the folders containing oneshot scripts get deleted after execution, unless they are signed with this sign. In that cast they are, the folder is signed as executed and however it will seem to be the same folder as before, but it won't be executed again.