Difference between revisions of "MUDL:Every zone reset"

From SlothMUD Wiki
Jump to: navigation, search
m (Example)
Line 4: Line 4:
 
= Overview =
 
= Overview =
  
This MUDL function gets called for each room in a zone when it is reset.
+
This MUDL function gets called for each room in an area/zone when it is reset.  Then it is called on the area.
  
  
Line 12: Line 12:
 
addproc room mudl
 
addproc room mudl
 
setproc room ## every_zone_reset
 
setproc room ## every_zone_reset
 +
 +
addproc area mudl
 +
setproc area ## every_zone_reset
 
</pre>
 
</pre>
 +
  
 
= Global Variables =
 
= Global Variables =
Line 36: Line 40:
 
| The index of the current MUDL procedure on the %parent variable.
 
| The index of the current MUDL procedure on the %parent variable.
 
|}
 
|}
 +
  
 
= Return Values =
 
= Return Values =
Line 44: Line 49:
 
= Triggered Scripts =
 
= Triggered Scripts =
  
Only room scripts are triggered by this event. They are triggered after the zone commands have been run for the room.
+
Zone resets trigger events in the following order:
 +
# Zone commands are executed on the rooms in the area.
 +
# Every_zone_reset scripts are triggered for each room.
 +
# Every_zone_reset scripts are triggered on the area.
  
  

Revision as of 14:14, 18 May 2017

Overview

This MUDL function gets called for each room in an area/zone when it is reset. Then it is called on the area.


Command Syntax

addproc room mudl
setproc room ## every_zone_reset

addproc area mudl
setproc area ## every_zone_reset


Global Variables

The following global variables are available:

Name Type Description
 %r / %room Room The room in the game where the script is being run. This value may be null if the script is attached to an area.
 %area Area The area (zone) in the game where the script is being run.
 %parent Room or Area The in-game element that the MUDL script is attached to. It will be identical to one of %room or %area.
 %procedure_index Integer The index of the current MUDL procedure on the %parent variable.


Return Values

The return value from this function is ignored.


Triggered Scripts

Zone resets trigger events in the following order:

  1. Zone commands are executed on the rooms in the area.
  2. Every_zone_reset scripts are triggered for each room.
  3. Every_zone_reset scripts are triggered on the area.


Example

addproc room mudl
setproc room 0 every_zone_reset

msg_room(%r, 'ZONE RESET!')
@


setproc room 0 PROC_ENABLED 1
compile