User Tools

Site Tools


scripting:introduction_to_events

This is an old revision of the document!


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 an item is used. You control events on your world server by script through the file Data/Script/ServerScript.mit.

Event Script Example

Here's an example of an event script file..

	Event( "NewBuilding", "3" ) 
	{ 
		*say %PLAYER% built building 3 
		*grantcash %PLAYER% 400 
	} 

	Event( "UseItem", "Bread" ) 
	{ 
		*say %PLAYER% used the kudos item 
		*grantkudos %PLAYER% 1 
		*resetpos %PLAYER%
	} 

This file defines 2 events. In the example above, whenever a player ('Bob' for instance) builds building type 3, the commands within { } braces are executed. i.e.

	*say Bob built building 3 
	*grantcash Bob 400 

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'.

For a full list of events, check the event reference

For a full list of all the '*' commands like say and grantcash, check the command reference.

scripting/introduction_to_events.1402160945.txt.gz · Last modified: (external edit)