This document may be freely copied and distributed, provided that: this copyright notice is included, the entire body of text is included, and the textual content of this document is unchanged.

For written permission to use portions of this document in other publications, send email to bfree@graphcomp.com.

System and User-definable Variables

Variables are memory slots for storing and retrieving values. Variables are generally used within commands; you can send the contents of a variable to a MUD via the "say" command, or just display it in your window via the "note" command.

System Variables

MUTT(tm) Lite supports the following read-only, system variables:

CHARACTER

Evaluates to a string containing the name entered in the "character" field of the "Open..." dialog box.

COIN

Evaluates to 0 about 50% of the time and 1 the rest of the time.

CREATE

Evaluates to 0 if the user pressed the "OK" button when starting the MU* session or 1 if the "NEW" button was pressed.

TRIGGER_INDEX

Evaluates to a string representing a 1-based number indicating the index of the word in TRIGGER_LINE that caused a trigger event. May be used with "setword" to retrieve the trigger word.

TRIGGER_LINE

Evaluates to a string containing the text line received from the host when a trigger occurs.

TRIGGER_NEXT

Evaluates to TRIGGER_INDEX plus 1. May be used with "setword" to retrieve the word after the trigger word.

TRIGGER_PREV

Evaluates to TRIGGER_INDEX minus 1. May be used with "setword" to retrieve the word after the trigger word. See AA.MUT sample script.

PASSWORD

Evaluates to a string containing the text entered in the "password" field of the "Open..." dialog box.

VERSION

Evaluates to a string identifying the version; example: "0.1A".

User-definable Variables

The variable allocation format is as follows:

label = type, size [, dimension [, dimension [....]]]

"label" is a unique variable name with 16 characters or less and may not include spaces. "type" is either: "int", "dec" or "str". "size" is the number of bytes used by an element of this variable. "dimension" defines the dimension of the scalar/array/matrix variable.

Note: "\n" is interpretted as carriage-return line feed in "str" variables.

MUTT(tm) Lite only supports "str" variables, and does not support variable arrays.