Creating Schedulers

Creating a Schedule

• This tutorial will explain how to create a sumo schedule with the /axsumo schedulers command!

• First open the menu with the previously mentioned command, it should look something like this (by default you will have 0 or 1 schedule):

  

• Now create a new schedule with the button shown on the last image!

• Give it a name, for example I gave tutorial schedule to it! You should not include any none english or special characters. ('-' is okay)

  

• Click on the paper to confirm! You should see that now we have a new schedule in the menu:

  

• Open this newly created schedule by left clicking. You should see something like this:

  

Making the Schedule Work

• If you are in the schedule editor, first you should add all the sumos that you want this schedule to activate!

• To add a sumo, click on the oak sign and write the name of the sumo in the chat! If you did this successfull, you should see it:

  

• Next up, you need to define how often this schedule should be triggered. This requires you to use the cron format.

• Don't worry, it is not that difficult, you can also use an online generator to make it easier! https://crontab.guru/

• If you need help with creating an expression, check out this section below: Understanding the CRON format

• Next click on the clock in the GUI and just like when you selected the sumo, write the CRON expression in the chat!

  

• That's all, everything should work now! To make sure, you should test if it works:

  • Try the placeholder out! For example: /papi parse me %axsumo_next_tutorial-schedule_formatted%

Understanding the CRON format

• The cron format is a very powerful format which can allow you to create any kind of schedulers.

• It is made out of 5 segments, which are:

  

  Image source: https://linuxhandbook.com/crontab/

• Important: CRON uses the 24-hour clock format

• Some simple examples & explanation:

  • 0 18 * * * - runs at 6pm exactly (because minute is 0, hour is 18, rest of them are set to "every")

  • 0 0 * * * - runs at midnight exactly (because minute is 0, hour is 0, rest of them are set to "every")

  • 30 12 * * * - runs 30 minutes past noon exactly (because minute is 30, hour is 12, rest of them are set to "every")

  • 0 10,12,14 * * * - runs at 10am, 12pm and 2pm (because minute is 0, hour is 10 or 12 or 14, rest of them are set to "every")

  • 0 2-4 * * * - runs at 2am, 3am and 4am (because minute is 0, hour is between 2 and 4, rest of them are set to "every")

  • 0 0/2 * * * - runs every 2 hours starting midnight (because minute is 0, hour is starting at 0 and every 2 hours, rest of them are set to "every")

  • 0 1/2 * * * - runs every 2 hours starting 1am (because minute is 0, hour is starting at 1 and every 2 hours, rest of them are set to "every")

  • 0 * * * SAT,SUN - runs every hour on saturday and sunday (because minute is 0, day of week is saturday or sunday, rest of them are set to "every")