User Tools

Site Tools


scripting:introduction_to_events

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
scripting:introduction_to_events [2014/06/06 11:40] – [Event Script Example] mitscripting:introduction_to_events [2025/05/28 16:34] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +~~NOTOC~~
 ===== Event Scripting Overview ===== ===== Event Scripting Overview =====
- +Events are triggered on your world server when various things happen - for instance, a 'UseItem' event is triggered when a player uses an item - and you add script for each event - for instance, adding a particle effect and changing a score whenever a particular item is used. You control events on your world server by script through the file ''Data/Script/ServerScript.mit''
-You can control events on your world server by script through the file ''Data/Script/ServerScript.mit''This section, and the accompanying reference, describe the types of 'events' you can specify and how they are used.  +
- +
-<note tip> +
-After making any changes to any of your script files you will need to use the command..  +
-<codedoc> +
- *reloadscript +
-</codedoc> +
-.. for the changes to take effect  +
-</note>+
  
 ===== Event Script Example ===== ===== Event Script Example =====
  
-Heres an example of an event script file.. +Here'an example of an event script file.. 
  
 <code> <code>
Line 22: Line 14:
  
  
- Event( "UseItem", "KudosItem1" ) + Event( "UseItem", "Bread" ) 
  
  *say %PLAYER% used the kudos item   *say %PLAYER% used the kudos item 
Line 35: Line 27:
  *grantcash Bob 400   *grantcash Bob 400 
 </code> </code>
-would be entered - the say message will appear in red for all players and 'Bob' will get an extra 40s. Similar procedure for the other event should someone use the kudos item.  +would be entered - the say message will appear in red for all players and 'Bob' will get an extra 40s. Similar procedure for the other event should someone use the 'Bread'.   
 + 
 +As well as triggering server commands from script, you can add logic, store persistent (per-player and global) values that can be accessed from other script events, call functions and set timers for events to occur later. 
 +===== Events Reference Links ===== 
 + 
 +For a full list of events, check the [[scripting:events_reference|event reference]] 
 + 
 +For a full list of all the '*' commands like **say** and **grantcash**, check the [[reference:server_commands:index|command reference]]. 
 + 
 +===== Next section ===== 
 +  * Go to [[scripting:basic_syntax|Scripting Language Basic Syntax]]
  
scripting/introduction_to_events.1402054818.txt.gz · Last modified: (external edit)