BASIC Inline Scripting usage for MudMagic

I     BASIC Definition
II    BASIC commands available
	1. Expressions
	2. Commands
	3. External Variables
	4. External Functions
III   BASIC script flow techniques
IV    Variable usage and creation
V     BASIC Examples

I. BASIC Definition
-----------------------
When you create a Trigger or Alias, you are prompted to select either 'Use python script file' or 'Use MudMagic 
Scripting'. If you select to use the MudMagic scripting engine, this help file is where you want to be. For 'Use python 
script file', see the Python Scripting help.


MudMagic BASIC scripting follows the normal BASIC style, that is:

IF ... THEN
ELSE
  ....
END

For Example:

IF $1 = "Somevalue" THEN
    print "say You said $1"
ELSE
    print "say You said something else"
END


II. Basic commands available
-----------------------
There are certain commands available in the scripting engine. Below is an index outline.

  	1. Expressions
	------------------
An expression is something that applies two values togeather. To check is value FOO is equal to value BAR, you'd use 
FOO = BAR

	For numerical operands: + - / * = < > <= => <>
	For string operands: + = <>

	2. Commands:
	-------------------
All lines within a script are considered to be a command entry to the scripting engine. Blank lines are ignored. 

		REM commentary, this is ignored - so you can put notes to yourself here
		
		PRINT strings, expression
		SEND  strings, expression (print and send are identical)
			if two tokens separates by ',' - space will be insert
			if two tokens separates by ';' - tab will be insert
			if PRINT ended by ',' or ';', "new line symbol" will not be inserted after last token
			into strings in PRINT command external variables may be appears
	

		IF condition THEN
		 ...
		ELSE
		 ...
		END
	
	3. External variables:
	--------------------
An external variables are read in with the $ symbol. You can pass external variables to your script with regular 
expression.
		Name starts by '$'.
For example. To capture 2 variables in the statement:  test one two. You could write a regular expression such as:

^test (.*) (.*)   

This will match any sentence you input in the command line that starts with the word test, and catches the first two 
words after test. You can then use:

FIRST_WORD = $1
SECOND_WORD = $2
in your script.

	3. External functions:
	----------------------
External functions are special MudMagic functions which interact with the client. There is currently only 1 MudMagic 
external function to date.

		Name starts by '$'.
		
		$MESSAGEBOX string or expression

III   BASIC script flow te
----------------------------------
There are numerous methods of writing your scripts. You can use multiple IF .. THEN .. ELSE statements, or you could 
end each IF check in order. Trial and error will be your guide. For example:

NUMBER_ONE = 10
NUMBER_TWO = 20

IF NUMBER_ONE > 5 THEN
	PRINT "Number one " NUMBER_ONE;
ELSE
	IF NUMBER_TWO < 100
		print "Number two is less than 100"
	ELSE
		print "Number two is " NUMBER_TWO
	END
END

The important thing to remember is to close your checks in sequential order. If not, you will receive syntax errors 
when your script executes.

IV    Variable usage and creation
---------------------------------
Variables in the client are assigned locally and through regular expression. A variable can be either a string value, 
or numerical value; and are treated accordingly. If a variable contains only digits - it is considered a numerical 
variable and can process mathmatical equations. Please review the examples below for the scope of variable usage.

V     BASIC Examples
---------------------------------


