The Universal World Owner's Manual

Sometimes you'll want to script events that happen at a certain time (e.g. A minigame that runs every hour, or a special script that runs every Thursday at 7pm).

The main events for hourly events are “OnTheHour” (called every hour with no parameter) and “RealTimeClock” (where the event parameter specifies the time for this event - i.e. Event( “RealTimeClock”, “14” ) is triggered once a day at 2pm.

You can use the sys function sysRealTime to get the current realtime date (or you can also use the system value $gRealTimeDayOfWeek to get the day of the week - 1 is Sunday, 7 is Saturday.)

Example

$maDaysOfWeek[] = {  "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" }

Event( "RealTimeClock", "14" )
{
    *say It is 2pm on $maDaysOfWeek[$gRealTimeDayOfWeek]  !!
}

Example

Event( "OnTheHour", "" )
{
    $numBongs = sysRealTime("Hour")
    if ( $numBongs > 12 )
    {
        $numBongs -= 12
    }
    $loop = 0
    while ( $loop < $numBongs )
    {
       	*customsoundall 1
       Sleep(10)
       $loop += 1
    }
}

Example:

Event( "UseItem", "Tea" )
{
   $hour = sysRealTime( "Hour" )
   if ( $hour < 18 )
   {
      *msg %PLAYER% Tea can only be used at tea-time (6pm - 8pm)
    }
    else if ( $hour >= 20 )
    {
      *msg %PLAYER% Tea can only be used at tea-time (6pm - 8pm)    
    }
    else
    {
        *notifylarge %PLAYER% Tea-time!
    }
}