EVENT

Command: #event {event type}

         Events allow you to create triggers for predetermined client events.

         Use #event without an argument to see a list of possible events with
         a brief description. Use #event %* to see the current list of defined
         events. Use #info {events} {on} to see events get thrown.

         To enable mouse events use #config mouse_tracking on, to see mouse
         events use #config mouse_tracking info.

         Some events can be prefixed with CATCH to interrupt default behavior.

         Some events can be prefixed with GAG to gag default messages.

         CATCH <EVENT>
         CHAT MESSAGE           %0 default %1 plain
         CLASS ACTIVATED        %0 class name
         CLASS DEACTIVATED      %0 class name
         DATE                   %1 month - %3 day   %4 hour : %5 minute
         DAY <DAY>              %3 day of the month
         DOUBLE-CLICKED <VAR>   %0 row %1 col %2 -row %3 -col %4 word %5 line
         END OF PATH
         GAG <EVENT>
         HOUR                   %4 hour
         IAC <VAR> <VAR>
         IAC SB GMCP <MODULE>   %0 data     %1 raw data
         IAC SB MSSP            %0 variable %1 value
         IAC SB MSDP            %0 variable %1 value %2 plain value
         IAC SB MSDP <VAR>      %0 variable %1 value %2 plain value
         IAC SB NEW-ENVIRON     %0 variable %1 value
         IAC SB ZMP <VAR>       %0 value
         IAC SB <VAR>           %0 raw text %1 raw data
         KEYPRESS               %0 character %1 unicode index
         LONG-CLICKED <VAR>     %0 row %1 col %2 -row %3 -col %4 word %5 line
         MAP ENTER MAP          %0 new vnum
         MAP ENTER ROOM         %0 new vnum %1 old vnum
         MAP ENTER ROOM <VAR>   %0 new vnum %1 old vnum
         MAP EXIT MAP           %0 old vnum
         MAP EXIT ROOM          %0 old vnum %1 new vnum
         MAP EXIT ROOM <VAR>    %0 old vnum %1 new vnum
         MAP FOLLOW MAP         %0 old vnum %1 new vnum %2 exit name
         MAP MOUSE LOCATION                   %2 -row %3 -col %5 vnum %6 info
         MAP REGION             %0 row %1 col %2 -row %3 -col %5 vnum %6 info
         MAP ROOM               %0 row %1 col %2 -row %3 -col %5 vnum %6 info
         MAP UPDATED VTMAP
         MINUTE                 %5 minute
         MONTH                  %1 month
         MOVED <VAR>            %0 row %1 col %2 -row %3 -col %4 word %5 line
         PORT CONNECTION        %0 name %1 ip %2 port
         PORT DISCONNECTION     %0 name %1 ip %2 port
         PORT MESSAGE           %0 data %1 plain data
         PORT LOG MESSAGE       %0 name %1 ip %2 port %3 data %4 plain data
         PORT RECEIVED MESSAGE  %0 name %1 ip %2 port %3 data %4 plain data
         PRESSED <VAR>          %0 row %1 col %2 -row %3 -col %4 word %5 line
         PROGRAM START          %0 startup arguments
         PROGRAM TERMINATION    %0 goodbye message
         READ ERROR             %0 filename %1 error message
         RECEIVED INPUT         %0 raw text
         RECEIVED KEYPRESS      %0 raw text %1 unicode index
         RECEIVED LINE          %0 raw text %1 plain text
         RECEIVED OUTPUT        %0 raw text
         RECEIVED PROMPT        %0 raw text %1 plain text
         RELEASED <VAR>         %0 row %1 col %2 -row %3 -col %4 word %5 line
         SCAN CSV HEADER        %0 all args %1 arg1 %2 arg2 .. %99 arg99
         SCAN CSV LINE          %0 all args %1 arg1 %2 arg3 .. %99 arg99
         SCAN TSV HEADER        %0 all args %1 arg1 %2 arg3 .. %99 arg99
         SCAN TSV LINE          %0 all args %1 arg1 %2 arg3 .. %99 arg99
         SCREEN FOCUS           %0 focus (0 or 1)
         SCREEN LOCATION        %0 rows %1 cols  %2 height %3 width
         SCREEN MOUSE LOCATION  %0-3 screen row/col %4-7 cell row/col %8 loc
         SCREEN RESIZE          %0 rows %1 cols %2 height %3 width
         SCREEN SPLIT           %0 top row %1 top col %2 bot row %3 bot col
         SCREEN UNSPLIT         %0 top row %1 top col %2 bot row %3 bot col
         SCROLLED <VAR>         %0 row %1 col %2 -row %3 -col %4 word %5 line
         SECOND                 %6 second
         SEND OUTPUT            %0 raw text %1 size
         SENT OUTPUT            %0 raw text %1 size
         SESSION ACTIVATED      %0 name
         SESSION CONNECTED      %0 name %1 host %2 ip %3 port
         SESSION CREATED        %0 name %1 host %2 ip %3 port
         SESSION DEACTIVATED    %0 name
         SESSION DISCONNECTED   %0 name %1 host %2 ip %3 port
         SESSION TIMED OUT      %0 name %1 host %2 ip %3 port
         SHORT-CLICKED <VAR>    %0 row %1 col %2 -row %3 -col %4 word %5 line
         SWIPED <DIR>
           %0 dir %1 button %2 row %3 col %4 -row %5 -col %6 row %7 col %8 -row
           %9 -col %10 rows %11 cols
         SYSTEM ERROR           %0 name %1 system msg %2 error %3 error msg
         TIME                   %4 hour : %5 minute : %6 second
         TRIPLE-CLICKED <VAR>   %0 row %1 col %2 -row %3 -col %4 word %5 line
         UNKNOWN COMMAND        %0 raw text
         VARIABLE UPDATE <VAR>  %0 name %1 new value
         VARIABLE UPDATED <VAR> %0 name %1 new value
         VT100 SCROLL REGION    %0 top row %1 bot row %2 rows %3 cols %4 wrap
         WEEK <DAY>             %2 day of the week
         WRITE ERROR            %0 filename %1 error message
         YEAR                   %0 year

         To see all events trigger use #event info on. Since this can get
         rather spammy it's possible to gag event info messages.

Example: #event {SESSION CONNECTED} {#read mychar.tin}

Comment: You can remove an event with the #unevent command.

Related: button, delay and ticker.