Differences

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

--- scripting [2012/03/23 03:27] – mit
+++ scripting [2025/05/28 16:34] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ~~DISCUSSION:off~~
-===== World Scripting Index =====
+~~NOTOC~~
+===== World Scripting Overview =====
-  * [[Scripting:Introduction|Scripting Introduction]]
-  * [[Scripting:Introduction to Events|Introduction to Events]]
-  * [[Scripting:Syntax|Syntax]]
-  * [[Scripting:Includes|Includes]]
-  * [[Scripting:Variables|Variables]]
-  * [[Scripting:Functions|Functions]]
-  * [[Scripting:System Values|System Values]]
-  * [[Scripting:System Functions|System Functions]]
-  * [[Scripting:Events Reference|Events Reference]]
-  * [[Scripting:Custom Events|Custom Events]]
+  * [[Scripting:Introduction to Events|Introduction to Scripted Events]]
+  * [[Scripting:Basic Syntax|Scripting Language Basic Syntax]]
+  * [[Scripting:Other Language Features|Other Important Language Features]]
+  * [[Scripting:System Values & Functions Overview|System Functions, Values & Variables]]
   * [[Scripting:ScriptedOSD|Scripted OSD]]
+  * [[Scripting:Cutscenes|Cutscenes Overview]]
+  * [[Scripting:Samples|Samples]]
+  * [[Scripting:Reference|Reference Index]]
-  * [[Scripting:Cutscenes|Cutscenes]]
+===== Introduction to World Scripting =====
+The Universal's world server program allows owners to control much of the game via script. Using the custom scripting language you can create new behaviours for items and scenes on your world, add screens, buttons, cutscenes and special effects. Although the scripting language is fairly simple, you will require some knowledge of programming to understand and make the most of the features on offer. Check [[scripting:basic_syntax|here]] for an introduction to the language, and a description of the general format and limitations, and for further in-depth specifications of the individual script commands, check the '[[scripting:Reference|Scripting Language Reference]]'.
-  * [[Scripting:Samples|Samples]]
+===== Event Scripting =====
+'Events' are triggered on the server when certain things happen on your world. For example, a certain event is triggered when someone builds a new building. In most circumstances, the server itself handles the normal processes involved in the event - i.e. When someone builds a new building, the server automatically handles the adding of the new building to the map etc - then the script is called so you can do extra custom things.
+As an initial example - perhaps you want to have a special building that when built, awards your players with a special item. The simple script to do this might look something like..
+<code>
+Event( "NewBuilding", "3" )
+{
+  *say %PLAYER% built building 3
+  *grantitem %PLAYER% Special Item
+}
+</code>
+If you've already been playing around with owner features on your world, then the *commands might already be familiar - Just about anything you can do using the commands on the server you can do through the scripting system - which leads to lots of possible clever features done in script.
+For details on the range of events supported see the [[scripting:introduction_to_events|Event Scripting Overview]] and for a full list of the *commands see the [[Reference|reference section]].
+===== Script Files =====
+The primary 'script' a server runs is stored in a file called ''Data\Scripts\ServerScript.mit'' - this is a text file that can contain commands and scripted events ( You can include other files (see [[scripting:other_language_features|#include]] docs) ). To change your script file, modify it in a text editor (or in the in-game editor when its finished) and then tell the server to reload it bt pressing F11 (or using the command ***reloadscript**).
+For a quick Hello World example.. Connect to your world, copy the code block below into your serverscript.mit, press f11 then type **&test**
+<code>
+Event( "&command", "test" )
+{
+    *say Hello World
+}
+</code>