Archon Help

CoffeeMud 5.8

ABILITY_PREREQS

Ability Prerequisites is a comma delimited list of skills or skill masks that
describe what skills or set of skills must be learned, and at what optional
proficiency, before a player of a given class can learn that skill. The list
is comma delimited, and each item in the list consists of a valid Ability ID
(like Spell_Fireball), or a wildcard mask of Ability_IDs (like Spell_F* to
select all Ability IDs beginning with Spell_F). Following the Ability_ID is an
optionally number in parenthesis, which would represent the minimum proficiency
of the aforementioned Ability that is required.
Example:
Skill_Trip(50),Fighter_*(10)
The above means that the current ability requires that the player have Trip at
50% proficiency and any Fighter skill at 10% proficiency or better.

AFFECT

Command : AFFECT
Usage : AFFECT ([TARGET])
Example : affect
Example : affect room
Example : affect area
Example : affect orc
Short(s): AFF
List the spell or other affects that your character is currently under the
influence of. If targeted, it will show what the given target is affected by.

AFTER

Command : AFTER
Usage : AFTER (EVERY/STOP/LIST) [NUMBER] [SECONDS/TICKS/MINUTES/HOURS]
[COMMAND]
Example : after 5 seconds smile
Example : after every 5 seconds at bob smile
Example : after 10 minutes shutdown noprompt
Example : after stop
Example : after list
Short(s):
A command to delay the execution of a command. The every parameter may be used
to make a command automatically recurring. after stop should be used to cancel
commands created with the every parameter.

AHELP

Command : AHELP
Usage : AHELP [TOPICNAME]
Example : ahelp ahelp
Short(s):
A command to view the Administrative help commands.

ANNOUNCE

Command : ANNOUNCE
Usage : ANNOUNCE message
Usage : ANNOUNCETO [ALL/HERE/PLAYER NAME] message
Usage : ANNOUNCEMSG new personalized announce message prefix
Example : announce A new area is discovered!
Example : announceto all A new area is discovered!
Example : announceto bob Hi Bob!
Example : announcemsg A squeeky voice screeches
Short(s):
A command to make annoucements to players -- even those who don't want to be
announced to. This command can be used to announce to all players or selected
players using the announceto syntax. This is also the command used to
personalize your announce prefix message by using the announcemsg syntax.

AREAS

See the normal HELP AREAS for usage information. The Archon version of this
command will color the area names based on whether the area is active or
passive, frozen or stopped. Also, area names will be in parenthesis if they
are currently Hidden from normal users.

AS

Command : AS
Usage : AS [PLAYERNAME/MOBNAME] (HERE) [COMMAND]
Example : as "bob" inventory
Example : as bob here drop all
Example : as bob cast fireball monster
Short(s):
A command that allows one to issue other commands as if they were another
player or mob. This is the best way to manage a players inventory or bank
accounts from the command line. The optional "here" parameter should follow the
name if the command is to be issued with the player in the same room as the
archon.

ASSIST

A COMMAND JOURNAL.  See Archon Help (AHELP) on COMMAND JOURNALS

AT

Command : AT
Usage : AT [ROOM ID/DESC/MOB/AREA] [COMMAND]
Example : at "the greasy pub" smile
Example : at Midgaard#3001 bow
Example : at bob cast fireball bob
Short(s):
A command that allows one to issue other commands elsewhere in the mud.

ATOPICS

Command : ATOPICS
Usage : ATOPICS [TOPICNAME]
Example : atopics
Short(s):
A command to view the Administrative help topics.

BAN

Command : BAN
Usage : BAN [PLAYER TYPE/IP ADDRESS]
Example : ban bob
Example : ban io.com
Example : ban isp3.io.com
Example : ban 123.32.23.1
Example : ban 123.32.23.*
Example : ban *the great
Example : ban *penis*
Short(s):
A command to ban the given player or ip address from the system. See also
LIST, DESTROY

BANISH


Skill : Banish
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : BANISH
Usage : BANISH [PLAYER NAME] ([MAP ROOM]) (RL TIME)
Example : banish gunther
Example : banish gunther Midgaard#3001
Example : banish gunther 3 hours
Example : banish gunther 14 years
From anywhere on the map, the player with this skill can send the target
mob/player to a prison from which they can never escape. Use this skill again
on the same player to release them. The Archon can optionally specify a room
on the map which this skill will copy and use as the jail. The Archon can also
optionally end the command with the number of seconds, ticks, minutes, hours,
days, weeks, or years in which to keep the player imprisoned.

BEACON

Command : BEACON
Usage : BEACON ([PLAYER TYPE])
Example : beacon
Example : beacon bob
Short(s):
A command to change the start room of a player. If no player is named, this
command will change their own start room to the room they occupy. If a player
is named, this command changes the players start room to the room the player
currently occupies.

BOOT

Command : BOOT
Usage : BOOT [PLAYER NAME/IP ADDRESS]
Example : boot bob
Example : boot 192.168.0.1
Short(s):
A command to boot off a player.

BUG

A COMMAND JOURNAL.  See Archon Help (AHELP) on COMMAND JOURNALS

CATALOG

Command  : CATALOG
Usage : CATALOG LIST (MOBS/ITEMS/) (NAME MASK)
Usage : CATALOG (DELETE) [ITEM/MOB NAME]
Usage : CATALOG (ROOM/AREA/WORLD) (MOBS/ITEMS/)
Usage : CATALOG EDIT [ITEM NAME]
Usage : CATALOG SCAN/DBSCAN (ROOM/AREA/WORLD) (MOBS/ITEMS/)
Usage : CATALOG OVERLOOK/DBOVERLOOK (ROOM/AREA/WORLD) (MOBS/ITEMS/)
Example : catalog list
Example : catalog list mobs the st
Example : catalog the waiter
Example : catalog delete the waiter
Example : catalog edit the sword
Example : catalog room mobs
Example : catalog scan area
Example : catalog dboverlook area mobs
Short(s) :
This command is used to manage your muds global catalog of generic mobs and/or
items. The catalog is a place where you can store templates of mobs and items
for reuse, or for quick global modification and analysis. Mobs and items in
your catalog can be changed globally simply by creating and then changing any
instance of one of them. You can create new instances of a cataloged object
simply by entering CREATE <cataloged object name>. Your catalog is keyed by
name, so once the name of a cataloged item or mob is set, it should not be
changed.

You may review the objects in your catalog using the catalog list command. You
can also check the catalog synchronicity of the objects in your live rooms with
scan, or your saved rooms with dbscan. You can check for uncataloged objects
in live rooms with the overlook parameter, or in your saved rooms with
dboverlook.

You may delete an object from your catalog to stop using it as a global
template. Deleting an object from the catalog only detaches instances of a
cataloged object from all others, but does not destroy any actual instances.

The catalog is also used to manage a global random item-drop table. Items can
be set to randomly appear in the inventories of selected mobs when those mobs
are brought to life, or at the moment of their death. Use CATALOG EDIT <item
name> to change drop settings.

CHARGEN

Skill    : CHARGEN
Usage : CHARGEN
Example : chargen
Short(s) :
A little utility designed to give example characters of various levels, for
comparison with MOBs of similar level.

CLOAK

Command  : CLOAK
Usage : CLOAK (OFF)
Example : cloak
Example : cloak off
Short(s) :
Cloak makes the player unable to be seen in the WHO list. They can still be
seen by players in the same room, however.

CMFS

CoffeeMud File System
The CoffeeMud File System is a means of accessing files inside your main
CoffeeMud folder along side files stored in your CoffeeMud database. Files in
the CMFS can be stored either in the local file system, in CoffeeMud's
database, or in both. The CMFS sees both sets of files and folders/directories
as if they were part of a single file system.

Normally, the files required for operation of CoffeeMud, such as text files,
class files, help files, images, and other files, are loaded from the
appropriate directories on your LOCAL file system inside the main CoffeeMud
folder. If you installed CoffeeMud into D:\games\engines\coff, for instance,
the file intro.txt (the intro screen) would be loaded from
D:\games\engines\coff\ resources\text\intro.txt.

Under the CoffeeMud system, however, you should always think of your CoffeeMud
folder as a file system unto itself. The same file discussed above, even when
referring to the local file system inside CoffeeMud, would be accessed using
the path: resources/text/intro.txt. You'll notice that the path separators are
forward slashes / like in UNIX, instead of the normal back-slashes \ used in
DOS. This is the standard for the CMFS. You'll also notice that the resources
directory is accessed as if it were at the root of its own drive. This is also
part of the CoffeeMud File System. Because of this, CoffeeMud is utterly
unable to access any files outside of its installation directory. Keep this in
mind!

Within this installation directory structure, CoffeeMud is able to store files
both on your local file system drive, and in your database (VFS Files). The
VFS, or Virtual File System, refers specifically to files and folders which are
saved in your database, and accessible through the MUDGrinder's File Browser,
or the MUD's SHELL command (see HELP SHELL). When the CoffeeMud directory
structure is viewed through those two screens, files in the CoffeeMud database
and files in the local file system are both viewable as if they were part of a
single file system, the CMFS.

The files referenced in CoffeeMud are case-insensitive, except where dealing
with the local file system, where it may be case-sensitive depending upon your
operating system. Any filename or path may be preceded by a :: string to
denote forced VFS/database access, or // to denote forced local file-system
access. When neither is specified for a given file path, the VFS file is
always preferred over the local one. For instance, the path
::resources/text/intro.txt would refer ONLY to a copy of the intro.txt file
stored in the database as a VFS file. If that file is not in the database when
the :: string is used, the file will not be found. The path
//resources/text/intro.txt would refer ONLY to the copy of the intro.txt file
stored in the local file system, even if the same file appears in the VFS. The
path resources/text/intro.txt will use the copy of intro.txt stored in the VFS
*if* it exists there, or the one on the local file system otherwise.

The / character is always used to separate directory paths and folders, such as
/resources/text/intro.txt would refer to the file down.txt in the text folder,
which in turn is in the resources folder, which in turn is located in the root
directory.

So, as we've seen, whenever you need to refer to a file in CoffeeMud, you
should keep this system in mind. Files which are part of your CMFS may be in
the VFS database, or in the local file system. They may even be in both! This
system provides security for the server in which CoffeeMud is being run, and
provides for the ability to grant folder-level (or even VFS-folder-level)
security to builders and other administrative users.

COLORCODES

The following codes are available for channels definitions:
WHITE, LIGHTGREEN, LIGHTBLUE, LIGHTRED, YELLOW, LIGHTCYAN, LIGHTPURPLE, GREY,
GREEN, BLUE, RED, BROWN, CYAN, PURPLE, DARKGREY, BLACK, NONE, BOLD, UNDERLINE,
BLINK, ITALICS, BGWHITE, BGGREEN, BGBLUE, BGRED, BGYELLOW, BGCYAN, BGPURPLE,
BGBLACK, BGDEFAULT

COLORLIST

Below are a list of the standard color codes for CoffeeMud.

^N Normal
^! Bold
^H Highlight
^_ Underline
^* Blink
^/ Italics
^. Reset (turns off reverse)
^^ Generates an untranslated "^" character
^? Restores previous color
^f You-Fight
^e Fight-You
^F Fight
^S Spell
^E Emote
^T Talk
^Q Channel Background
^q Channel Foreground
^x Important message 1
^X Important message 2
^Z Important message 3
^O Room Title
^L Room Description
^D Direction
^d Door
^I Item
^M MOB
^w White
^g Green
^b Blue
^r Red
^y Yellow
^c Cyan
^p Purple
^W Dark White
^G Dark Green
^B Dark Blue
^R Dark Red
^Y Dark Yellow
^C Dark Cyan
^P Dark Purple
^U Unexplored Direction
^u Unexplored Door
^~w^~w White Background
^~g^~g Green Background
^~b^~b Blue Background
^~r^~r Red Background
^~y^~y Yellow Background
^~c^~c Cyan Background
^~p^~p Purple Background
^#rgb 256 foreground (r=red, g=green, b=blue: 0 to 5 only)
^##xx 256 foreground (xx = hex number from 00 - ff)
^|rgb 256 color background (r=red, g=green, b=blue: 0 to 5 only)
^||xx 256 color background (xx = hex number from 00 - ff)

* Note: when using background colors, the foreground must always come first.

COMMAND_JOURNALS

Usage      : [JOURNAL_NAME] (REVIEW/TRANSFER) [MSG NUMBER]
Example : list ideas
Example : ideas review 10
Example : ideas transfer 10 bugs
A command journal is a special kind of command that can be created and modified
from the MUDGrinder Control Panel or the coffeemud.ini file. It is a special
kind of journal that users can write to from the command line with the command
journal command word, such as BUG, or IDEA, or TYPO. The Command Journal's
entries can then be listed by those with the necessary security clearance by
using the LIST [JOURNALNAME] command. Entries can also be stepped through
using the command [JOURNALNAME] REVIEW ([MSG NUMBER]) syntax. They can be
transferred from the step-through menu to other journals, or they can be
transferred directly from the command line with [JOURNALNAME] TRANSFER [MSG
NUMBER] [2ND_JOURNALNAME]. Lastly, entries in a command journal can be deleted
from the step-through menu, or by entering DESTROY [JOURNALNAME] [MSG NUMBER].

COMPONENTS

Components refers to spell components/materials.  This is an optional system in
CoffeeMud where you can create spell material, equipment, or component
requirements for the casting of spells, or usage of skills. Archons, mobs, and
those with the COMPONENTS security flag are exempt. You can enter LIST
COMPONENTS to see current definitions, or CREATE COMPONENT to see how to define
a new one. You can DESTROY them too, of course. The list of components is
maintained in resources/skills/components.txt

COPY

Command : COPY
Usage : COPY ([NUMBER]) [ITEM TYPE]/[DIRECTION]
Example : copy joe
Example : copy beast sword
Example : copy Longsword@room
Example : copy Longsword@an orc
Example : copy east
Short(s):
A command for the creation of items, mobs, and rooms. Enter COPY for more
information on command usage.

CREATE

Command : CREATE
Usage : CREATE [ITEM TYPE] ...
Example : create room e StdRoom
Example : create item Longsword
Example : create item Longsword@room
Example : create item Longsword@an orc
Example : create StdExit east
Example : create news
Short(s):
A command for the creation of items, mobs, quests, rooms, polls, exits,
classes, races, etc. Enter CREATE for more information on command usage on
items, mobs, components, and exits. Use AHELP QUESTS for more information on
creating quests.

DESTROY

Command : DESTROY
Usage : DESTROY [ITEM TYPE] ...
Example : destroy room e
Example : destroy orc
Example : destroy item longsword
Example : destroy item longsword@an orc
Short(s):
A command for the destruction of items, quests, components, mobs, rooms, exits,
polls, classes, races, and listed bugs, typos, ideas, and ban. Enter DESTROY
for more information on command usage.

DEVIATIONS

Command : DEVIATIONS
Usage : DEVIATIONS [MOBS/ITEMS/BOTH] [MASK]/ROOM/AREA
Example : deviations mobs area
Short(s):
A command for showing items in a room or area, and how they deviate from
established norms for their type and level.

DUMPFILE

Command  : DUMPFILE
Usage : DUMPFILE (RAW) [USER/ALL] [FILENAME]
Example : dumpfile all classes.txt
Short(s) :
Unloads most resource text and help files for easy refreshing.

EXPERTISES

Expertises are flags that modify the effects of the numeric/gradiant aspects of
spells, skills, prayers etc. This includes things like range, durations, cost,
damage, etc. Players can gain expertises to enhance their skills by spending
trains using the GAIN command. You can enter LIST EXPERTISE to see current
definitions, or CREATE EXPERTISE to see how to define a new one. You can
DESTROY them too, of course. The list of components is maintained in
resources/skills/expertises.txt

EXPIRE

Command : EXPIRE
Usage : EXPIRE [PLAYERNAME] ([NEW DAYS REMAINING])
Example : expire bob
Example : expire bob 15
Short(s):
This command sets and displays the amount of active days a user has left. This
command is only relevant if the account expiration system is enabled in your
coffeemud.ini file.

EXPORT

Command : EXPORT
Usage : EXPORT (AREA/ROOM/WORLD/PLAYER) (DATA/ITEMS/MOBS/WEAPONS/ARMOR)
([FILE]/SCREEN/EMAIL)
Example : export room myroom
Example : export area /home/users/myarea
Example : export area weapons /home/users/myarea
Example : export area screen
Example : export area email
Example : export world data /exportfiles/
Example : export player bob
Short(s):
The export command will generate the official coffeemud area files, whose
extension is "*.cmare". This command may also be used to export individual
rooms, player data, or unique items or mobs as well. If the second parameter
(ITEMS/MOBS/WEAPONS/etc) is NOT specified, export will produce full room data
for the scope of the first parameter (AREA, ROOM, or WORLD). If the second
parameter IS specified, then only the specified data will be generated.
The results will be written to the file given in the last argument, or to the
screen if "screen" is given as the last argument, or sent to your email address
if that is enabled. The extension need not be included, as coffeemud will add
it if not present. If a directory name is given (no file name), the system
will reference the AREA ARCHIVE file name for an Area, assuming EXPORT AREA or
EXPORT WORLD is used. The default directory for this command is the CoffeeMud
root.

FREEZE


Skill : Freeze
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : FREEZE
Usage : FREEZE [PLAYER NAME]
Example : freeze gunther
From anywhere on the map, the player with this skill can render the target
mob/player unable to move. Use this skill again on the same player to release
them. Magic won't help the player, though the TRANSFER Archon command will
still work.

GENERATE

Command : GENERATE
Usage : GENERATE [OBJ TYPE] [ID] (FROM [FILENAME]) ([VAR]=[VAL]...)
([DIRECTION])
Example : generate area maze_dungeon from randareas/example.xml areasize=50
areaname=test level_range=10?20 aggrochance=50 theme=kobolds south
Example : generate string list

This command uses an xml file to generate random content for your mud. This
content can be anything from whole areas, to rooms, mobs, items, or simple
strings. By default, the content is built from the file in
resources/randareas/example.xml, though the builder may specify his or her own
xml file path as one of the many arguments. The arguments, briefly, are:

OBJ TYPE: One of the following: AREA, ROOM, MOB, ITEM, or STRING.

ID : one of the "id" xml attributes defined on any tag in the XML file.
Use GENERATE STRING LIST for a list of all "id" attributes defined in your
file.

FROM "F": An optional argument to specify your own xml file, with the resources
directory being the default root.

VAR=VAL : One or more variables and their definitions. Many tags will have a
specific set of required variables which must be defined in order for the
content to be generated. Failing to specify one of the required variables will
cause an error message listing the variables which must be defined, and the
type of data required for the variable. Variable types which list numbers as
their data types may also have math expressions values (so you can use random
numbers). See the help on MATH EXPRESSION for more information on this. In
addition to required variables, you may also use the space to enter one or more
"override" values. Many object fields (such as LEVEL for mobs and items, or
NAME, etc) as well as the XML id tags, can have their "random" values
overridden by defining them using the generate command.

DIRECTION: This applies only to ROOM and AREA object types. The object, if
successfully generated, will be linked to the current room that the player is
standing in, in the direction they specify.

In closing, the GENERATE command is an interesting way to deliver large amounts
of dynamic content for your world, though it can never replace the caring touch
of a real, creative builder. If anyone is interested in writing their own xml
content, please open up the /resources/randareas/example.xml file and begin
reading. Use that file as an example on how to construct your own.

GMODIFY

Command : GMODIFY
Usage : GMODIFY (AREA/ROOM/WORLD) [FIELD=VAL](&&/||[...])
(CHANGE=[FIELD=VAL])
Example : gmodify area class=genmob&&name=the cityguard change=name=the guard
Example : gmodify world class=[cs]GenMob&&name=[ss]city change=name=[ss]
Example : gmodify ?
Short(s):
A command to select objects in a given area, room, or the whole world based on
the specified field values, and optionally change some of those specified
fields.

Searching the entire world is implied, but the first parameter may be the word
AREA or ROOM to narrow the search. You may also enter WORLD to make the world
search explicit.

The next parameter is the search criteria. The key phrase WHEN= may optionally
precede it to make explicit that you are specifying the search criteria. The
search criteria fields may be separated by && strings to specify that all of
the preceding criteria AND the next single criteria must be true. The criteria
fields may also be separated by || strings to specify that all of the preceding
criteria OR the next single criteria may be true. One of those strings must be
present when specifying more than one criteria.

Each field in the search criteria must be of the form FIELD=VALUE,
FIELD!=VALUE, FIELD$VALUE, FIELD>VALUE, FIELD<VALUE, FIELD>=VALUE, or
FIELD<=VALUE. Where FIELD must be a valid search field. Enter GMODIFY ?
for a complete list of all valid fields. Not all fields will apply to all
object types, so take this into account especially when using < or !=
operators. The operators are all normal except for the new one, $, which means
that the value is really a regular expression. The VALUE portion of the
criteria may be prefixed with modifiers, which include:
[ss] to specify that the value refers to a substring of the fields whole value.
[cs] to specify that the search is case sensitive (case insensitive is
implied).

The last parameter is the optional change specifications. These specifications
must be prefixed with the key phrase CHANGE=. If these specifications are not
included, GMODIFY will display the results of the search. The change
specifications are similar to the search criteria in that they consist of
groupings of FIELD=VALUE separated by && strings. Unlike search criteria,
however, operators other than =, and strings other than || have no special
meaning. The fields, like in the search criteria, must be valid fields for the
options selected by the search criteria. The fields on the object will be
changed to the specified value UNLESS the following conditions are met: the
VALUE portion of a field is prefixed with the modifier [ss], and the VALUE
portion of an identical field in the search criteria was also prefixed with the
modifier [ss]. Under those special conditions, instead of substituting the
entire field value on the object with the new value, ONLY the portion of the
string selected in the search criteria will be substituted.

GOTO

Skill    : GOTO
Usage : GOTO [ROOM ID/DESC/MOB/AREA]/PREVIOUS (!)
Example : goto Midgaard#3001
Example : goto #3001
Example : goto north
Example : goto hassan
Example : goto temple of mota
Example : goto midgaard
Example : goto previous
Short(s) :
The invoker and his or her followers will be transported, with very little
fanfare, to the destination listed. This ability is not magical in nature, and
is thus not affected by no-teleport areas and rooms. Appending an exclaimation
point to the room will ADD fanfare to the entrance.

HOLIDAYS

Holidays are a special/reserved quest defined by file
/resources/quests/holidays/holidays.quest. They are very simple Scriptless
quests that can be started at random intervals, or on certain mud dates, or
real-life dates. The holidays will only impact the areas specified by the
holiday settings, and only the mobs in those areas specified in the settings,
and only with the features you specify. Use LIST HOLIDAYS to see a list of all
defined holidays and the areas hey are defined for. By default, 3 special-case
weather related holidays are included which impact any area that meets their
criteria. You can use MODIFY HOLIDAY <name> to change the settings for a
holiday, DESTROY HOLIDAY <name> to delete one, or CREATE HOLIDAY name to create
a new one that will automatically apply to the area the creator is standing in.

HUSH


Skill : Hush
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : HUSH
Usage : HUSH [PLAYER NAME]
Example : hush gunther
From anywhere on the map, the player with this skill can render the target
mob/player unable to communicate on any channels, or use the tell command. Use
this skill again on the same player to release them.

I3

This refers to the InterMud3 system, which may or may not be available on your
system. Enter I3 by itself for a list of available commands. For more help,
enter HELP I3 LIST, HELP I3 CHANNELS, HELP I3 ADD, HELP I3 DELETE, HELP I3
LISTEN, HELP I3 LOCATE, HELP I3 SILENCE, or HELP I3 INFO.

I3_ADD

Command : I3 ADD
Usage : I3 ADD [REMOTE CHANNEL NAME]
Example : i3 add BADCHAN
Short(s):
Sends an add-channel message to the InterMud3 router. The channel listed must
already appear in your coffeemud.ini file.

I3_CHANNELS

Command  : I3 CHANNELS
Usage : I3 CHANNELS
Example : i3 channels
Short(s) :
Lists all the channels available on the InterMud3 network, even those which
your mud does not subscribe to.

I3_DELETE

Command : I3 DELETE
Usage : I3 DELETE [LOCAL CHANNEL NAME]
Example : i3 delete BADCHAN
Short(s):
Sends a remove-channel message to the InterMud3 router. The channel listed
must already appear in your coffeemud.ini file.

I3_INFO

Command : I3 INFO
Usage : I3 INFO [MUD NAME]
Example : i3 info coffeemud
Short(s):
Give some special information about the InterMud3 mud listed.

I3_LIST

Command : I3 LIST
Usage : I3 LIST
Example : i3 list
Short(s):
Lists all the muds available on the InterMud3 channels.

I3_LISTEN

Command : I3 LISTEN
Usage : I3 LISTEN [REMOTE CHANNEL NAME]
Example : i3 listen BADCHAN
Short(s):
Sends a listen-channel message to the InterMud3 router. The channel listed
must already appear in your coffeemud.ini file.

I3_LOCATE

Command : I3 LOCATE
Usage : I3 LOCATE [NAME]
Example : i3 locate bob
Short(s):
Sends a player locate message to the InterMud3 router, which will hopefully
respond some day with the name of a mud where a player of the given name is
located.

I3_SILENCE

Command : I3 SILENCE
Usage : I3 SILENCE [REMOTE CHANNEL NAME]
Example : i3 silence BADCHAN
Short(s):
Sends a no-listen-channel message to the InterMud3 router. The channel listed
must already appear in your coffeemud.ini file. This command will silence all
traffic to your server from that channel.

IDEA

Command : IDEA
Usage : IDEA [MESSAGE]/REVIEW (STARTING MSG)
Example : idea nothing is spelled right in this room!
Example : idea review
Example : idea review 7
Short(s):
This command can be used to submit ideas to the system. When the REVIEW
parameter is given, the ideas will be iterated through one at a time to give
the archon a chance to delete, comment on, or email each one. An optional
starting number can be given to REVIEW.

IMPORT

Command  : IMPORT
Usage : IMPORT (NOPROMPT) (NODELETE) (AREATYPE=TYPE) [FILE NAME(S)]
Example : import /areas/myarea.cmare
Example : import noprompt nodelete /areas/midgaard.are
Example : import areatype=stdthininstance /areas/midgaard.are
/areas/school.are
Example : import noprompt /areas/areas.lst
Example : import noprompt /areas/
Short(s) :
The import command will allow you to import official coffeemud area files,
whose extension is "*.cmare"
CoffeeMud may also import, with varying levels of success, the "*.are" files
used by other muds. Some formats are better supported than others, so be sure
to carefully examine the imported area afterwards.
The import command will auto detect, based on the file given, whether the file
refers to a coffeemud area file, room file, a "*.are" from another mud, or a
"*.lst" list of other area files.
The CoffeeMud "resources" directory is the default path. Remember that all
paths in CoffeeMud treat the install directory as "root'. This means that the
files being imported must be copied into a folder underneath your install
directory before use. See the help on VFS for more information on this
concept.

INJURE


Skill : Injure
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : INJURE
Usage : INJURE [PLAYER NAME] [body part]
Example : injure gunther left hand
From anywhere on the map, the player with this skill can cause the target to
have one of their body parts instantly injured by 20%.

JRUN

Command  : JRUN
Usage : JRUN [FILENAME] [PARM1] ...
Example : jrun resources/myscript.js parm1 parm2
Short(s) :
Runs the given file as Javascript. See the Programming Guide for more
information on how to write Javascript for CoffeeMud.

LINK

Command : LINK
Usage : LINK [ROOMID] [DIRECTION]
Example : link midgaard#3001 north
Example : link Smurfy Road east
Example : link midgaard#3001#(3,2) north
Short(s):
A command for the linking of rooms to each other, including grid rooms.

LIST

Command : LIST
Usage : LIST ([SHOPKEEPER])
Example : list
Example : list quests
Example : list reports
Example : list areas
Example : list log last 10
Short(s):
The normal player version of this command will display the items which a
particular shopkeeper MOB may be selling, along with the prices being offered
to your characters.

The Admin version can also be qualified with UNLINKEDEXITS, ITEMS, ARMOR,
ENVRESOURCES, WEAPONS, MOBS, ROOMS, AREA, LOCALES, BEHAVIORS, EXITS, RACES,
CLASSES, STAFF, SPELLS, SONGS, PRAYERS, PROPERTIES, THIEFSKILLS, COMMON,
JOURNALS, SKILLS, QUESTS, DISEASES, POISONS, TICKS, MAGIC, TECH, CLANITEMS,
COMMANDJOURNAL, TITLES, NOPURGE, BANNED, RACECATS, LOG, USERS, LINKAGES,
REPORTS, THREADS, RESOURCES, ONEWAYDOORS, CHANTS, POWERS, SUPERPOWERS, CLANS,
GOVERNMENTS, FACTIONS, MATERIALS, OBJCOUNTERS, POLLS, CONTENTS, BUGS, TYPOS,
IDEAS, TASKS, NEWS, AREAS, SESSIONS, or ASSISTS. depending upon the listers
security.

Additional help *may* be available by entering HELP LIST [X] where X is one of
the above.

LIST_ACCOUNTS

Command  : LIST
Usage : LIST ACCOUNTS ([COLUMN NAME])
Example : list accounts
Example : list accounts email
If your mud is using the account system, this will list all the accounts in the
game, along with their last login date, email address, and all players
associated with that account. If you specify a column name of NAME, LAST,
EMAIL, or IP, then that column will be shown if it is not available, and the
list will be sorted by that column.

LIST_ALLQUALIFYS

Command  : LIST
Usage : LIST ALLQUALIFYS
Example : list allqualifys
Lists all the multi-class-qualified skills defined in your All-Qualifies list
in your game, along with the level of the skill, whether it is auto-gained or
not, the default proficiency, and a qualifying mask.

LIST_AREA

Command  : LIST
Usage : LIST AREA
Example : list area
Lists all the rooms in the current area, along with the locale type of each
room.

LIST_AREARESOURCES

Command  : LIST
Usage : LIST AREARESOURCES
Example : list arearesources
Lists all the rooms int the current area, along with the locale id, and the
type of raw resource that can be gathered in that room at this moment.

LIST_AREAS

Command  : LIST
Usage : LIST AREAS (SORTBY [COLUMN]...) (COLS [COLUMN]...))
Example : list areas
Example : list areas sortby name cols name population
Example : list areas sortby name
Lists all the standard areas in your game. By default, it also shows whether
the area is Hidden, how many rooms are in the area, whether it is in a passive
or active state, its current population, and the median level. If the sortby
parameter is used, then you can follow it with the order of columns to sort by.
Valid columns include: NAME, AUTHOR, DESCRIPTION , ROOMS, STATE, HIDDEN,
POPULATION, MIN_LEVEL, MAX_LEVEL, AVG_LEVEL, MED_LEVEL, AVG_ALIGNMENT,
MED_ALIGNMENT, TOTAL_LEVELS, TOTAL_INTELLIGENT_LEVELS, VISITABLE_ROOMS,
INDOOR_ROOMS. If the columns parameter is used, then you can follow it with
columns to substitute in the table.

LIST_ARMOR

Command  : LIST
Usage : LIST ARMOR
Example : list armor
Shows the armor java classes (item ids) available to archons.

LIST_BANNED

Command  : LIST
Usage : LIST BANNED
Example : list banned
Lists the player names, ip addresses, or ip masks that are banned from your
mud.

LIST_BEHAVIORS

Command  : LIST
Usage : LIST BEHAVIORS
Example : list behaviors
Shows the list of behavior java classes (behavior ids) available to archons.

LIST_CHANTS

Command  : LIST
Usage : LIST CHANTS
Example : list chants
Shows all the chant spell java class names (ability ids) available to your
archons.

LIST_CLANITEMS

Command  : LIST
Usage : LIST CLANITEMS
Example : list clanitems
Shows the list of clan item java classes (item ids) available to archons.

LIST_CLANS

Command  : LIST
Usage : LIST CLANS
Example : list clans
Lists all the clans in your mud, along with the number of members each clan
has.

LIST_CLASSES

Command  : LIST CLASSES
Usage : LIST CLASSES (SHORT)
Example : list classes
Example : list classes short
Shows the list of char class java classes (charclass ids) available to archons.
Charclasses will have their base classes shown in () next to the ID.
Charclasses with an * next to them are Generic. Adding the short parameter
will only show a simple list of char class ids.

LIST_COMMANDJOURNAL

Command  : LIST
Usage : LIST COMMANDJOURNAL
Example : list commandjournal
Further help is not yet available. May be unimplemented.

LIST_COMMON

Command  : LIST 
Usage : LIST COMMON
Example : list
Shows the list of common skill java classes (ability ids) available to archons.

LIST_COMPONENTS

Command  : LIST
Usage : LIST COMPONENTS
Example : list components
Lists all the Ability IDs (skills, spells, etc) for which a physical component
requirement has been defined using the engine's component system. It will also
list a friendly description of what those component requirements are.

LIST_CONQUERED

Command  : LIST
Usage : LIST CONQUERED
Example : list conqured
Lists all the areas in the game, along with the names of the clans that control
them. Areas that list "The Archons" as controllers are un-conquerable (do not
have the Conquerable behavior on them). Others are as listed, or blank for
unconquered-at-present.

LIST_CONTENTS

Command  : LIST
Usage : LIST CONTENTS (AREA/[AREA NAME])
Example : list contents
Lists all the mobs and items in the current room, along with their level and
alignment. Adding an AREA parameter will do this for the whole current area, or
you can enter the name of a particular area.

LIST_CURRENTS

Command  : LIST
Usage : LIST CURRENTS
Example : list currents
Lists all the the electronic devices receiving electronic current processing in
the game. This could be groups of computers in a lab, or devices aboard a
single space ship.

LIST_DEBUGFLAG

Command  : LIST
Usage : LIST DEBUGFLAG
Example : list debugflag
Lists all the debug flags that have been turned on in your system. These flags
cause extra messaging to appear in your mud log (mud.log), assuming DBGMSGS has
been appropriately set in your coffeemud.ini file.

LIST_DISABLEFLAG

Command  : LIST
Usage : LIST DISABLEFLAG
Example : list disableflag
Lists all the disabled subsystems in your mud.

LIST_DISEASES

Command  : LIST
Usage : LIST DISEASES
Example : list diseases
Shows the list of all diseases (ability ids) available to archons.

LIST_ENVRESOURCES

Command  : LIST
Usage : LIST ENVRESOURCES (SHORT)
Example : list envresources
Example : list envresources short
Lists all the raw material resources defined for your mud, along with its
material type, money value, frequency of occurrence, strength, and what kinds
of Locales the resource may be gathered from using the appropriate skill.

Adding the short parameter just shows a raw list of resource names.

LIST_EXITS

Command  : LIST
Usage : LIST EXITS
Example : list exits
Shows the list of exit java classes (exit ids) available to archons.

LIST_EXPERTISES

Command  : LIST
Usage : LIST EXPERTISES
Example : list expertises
Lists all the expertise IDs, along with their friendly names and requirements
to learn.

LIST_EXPIRES

Command  : LIST
Usage : LIST EXPIRES
Example : list expires
Lists all the rooms in the current area, along with when that room expires (or
*).

LIST_FACTIONS

Command  : LIST
Usage : LIST FACTIONS
Example : list factions
Lists the friendly names of all the factions defined in your game, along with
the file/path that defines that faction.

LIST_GOVERNMENTS

Command  : LIST
Usage : LIST GOVERNMENTS
Example : list governments
Lists all the clan governments that have been defined in your mud.

LIST_HELPFILEREQUESTS

Command  : LIST
Usage : LIST HELPFILEREQUESTS
Example : list helpfilerequests
Lists all the entries in your help help log, if your mud is configured to keep
one.

LIST_HOLIDAYS

Command  : LIST
Usage : LIST HOLIDAYS
Example : list holidays
Lists all the official Holidays defined in your game, along with the areas that
they are specified to apply in (or *special* if they are multi-area).

LIST_ITEMS

Command  : LIST
Usage : LIST ITEMS
Example : list items
Shows the item java classes (item ids) available to archons.

LIST_JOURNALS

Command  : LIST 
Usage : LIST JOURNALS
Example : list
Shows the list of all Journals (message/note areas) that exist in your
database, along with the number of entries in each journal.

LIST_LINKAGES

Command  : LIST
Usage : LIST LINKAGES (WORLD)
Example : list linkages
This bizarre command will list area rooms, showing number of rooms, number of
mobs, average mob levels, and average alignment. It will also show how many
groups of rooms refer back to other rooms in the area, and which areas rooms in
this area link to. If you add the WORLD parameter, then all areas are listed.

LIST_LOCALES

Command  : LIST
Usage : LIST LOCALES
Example : list locales
Shows the list of room java classes (locale ids) available to archons.

LIST_LOG

Command  : LIST
Usage : LIST LOG (FRONT [NUMBER]/BACK [NUMBER]/SKIP [NUMBER])
Example : list log
Example : list log first 10
Example : list log last 20
Example : list log skip 50
Displays the server log. If you use the first X param, it will only show the
first X lines of the log. If you use the last X param, it will only show the
last X lines. If you use the skip X param, it will show the entire log after
the first X lines.

LIST_MAGIC

Command  : LIST
Usage : LIST MAGIC
Example : list magic
Shows the list of magic item java classes (item ids) available to archons.

LIST_MATERIALS

Command  : LIST
Usage : LIST MATERIALS
Example : list materials
Lists all the base material types. Use list ENVRESOURCES for what you probably
want.

LIST_MOBS

Command  : LIST
Usage : LIST MOBS
Example : list mobs
Shows the mob java classes (mob ids) available to archons.

LIST_NEWS

Command  : LIST
Usage : LIST NEWS ([ENTRY NUMBER]/NEW/ALL)
Example : list news
Example : list news 5
Example : list news new
Example : list news all
Lists all the news items currently active in your game (these are the bulletins
seen at login). If a number is specified, only that full news item will be
shown. If the NEW parameter is used, then only NEW news is shown. If the ALL
parameter is used, all news is shown.

LIST_NOPURGE

Command  : LIST
Usage : LIST NOPURGE
Example : list nopurge
Lists the names of accounts or players who are exempt from the account/player
purging rules defined in your coffeemud.ini file. In short, these users will
never be deleted, even if they never ever log in again.

LIST_OBJCOUNTERS

Command  : LIST
Usage : LIST OBJCOUNTERS
Example : list objcounters
Deprecated, but may be revived again in the future if I start seeing memory
consumption issues.

LIST_ONEWAYDOORS

Command  : LIST
Usage : LIST ONEWAYDOORS (LOG)
Example : list onewaydoors
Example : list onewaydoors log
Lists all the rooms in your world with at least one direction where it links to
another room, but that room does NOT link back to it. Could be indicative of a
problem? Adding a log parameter will dump this list to your mud.log.

LIST_PLANETS

Command  : LIST
Usage : LIST PLANETS (SORTBY [COLUMN]...) (COLS [COLUMN]...))
Example : list planets
Example : list planets sortby name cols name population
Example : list planets sortby name
Lists all the planets in your game. By default, it also shows whether the
planet is Hidden, how many rooms are in the planet, whether it is in a passive
or active state, its current population, and the median level. If the sortby
parameter is used, then you can follow it with the order of columns to sort by.
Valid columns include: NAME, AUTHOR, DESCRIPTION , ROOMS, STATE, HIDDEN,
POPULATION, MIN_LEVEL, MAX_LEVEL, AVG_LEVEL, MED_LEVEL, AVG_ALIGNMENT,
MED_ALIGNMENT, TOTAL_LEVELS, TOTAL_INTELLIGENT_LEVELS, VISITABLE_ROOMS,
INDOOR_ROOMS. If the columns parameter is used, then you can follow it with
columns to substitute in the table.

LIST_POISONS

Command  : LIST
Usage : LIST POISONS
Example : list poisons
Shows the list of all poisons (ability ids) available to archons.

LIST_POLLS

Command  : LIST
Usage : LIST POLLS
Example : list polls
Lists all the player polls currently defined in the game.

LIST_POWERS

Command  : LIST
Usage : LIST POWERS
Example : list powers
Shows all the superpower java class names (ability ids) available to your
archons.

LIST_PRAYERS

Command  : LIST 
Usage : LIST PRAYERS
Example : list prayers
Shows the list of prayer java classes (ability ids) available to archons.

LIST_PROPERTIES

Command  : LIST 
Usage : LIST PROPERTIES
Example : list properties
Shows the list of property java classes (ability ids) available to archons.

LIST_QUESTS

Command  : LIST 
Usage : LIST QUESTS
Example : list quests
Lists all the quests being managed by the quest manager, along with the current
status of the quest (running, or not), and if it is time-delayed, how long
until the quest will attempt to start again.

LIST_RACECATS

Command  : LIST
Usage : LIST RACECATS (SHORT)
Example : list racecats
Example : list racecats (short)
Lists the unique racial categories of all the races in coffeemud. Adding the
short param will just make the list look different.

LIST_RACES

Command  : LIST
Usage : LIST RACES (SHORT)
Example : list races
Example : list races short
Shows the list of race java classes (race ids) available to archons. Races will
have their racial categories shown in () next to the ID. Races with an * next
to them are Generic. Adding the short parameter will only show a simple list
of race ids.

LIST_REALESTATE

Command  : LIST
Usage : LIST REALESTATE (/AREA/WORLD) ([OWNER NAME])
Example : list realestate
Example : list realestate world bob
Example : list realestate area
Lists all the rooms for sale in the current area, along with the current name
of the room, the current owner (if any) and the price.

LIST_RECIPES

Command  : LIST
Usage : LIST RECIPES ([SKILL ID])
Example : list recipes
Example : list recipes Cooking
By default, this will list the names of all the common skills (ability ids)
that have editable recipe lists. If a valid ability id is specified as a
parmeter, then it will list all the editable recipes for that common skill.

LIST_REPORTS

Command  : LIST
Usage : LIST REPORTS
Example : list reports
Shows a brief report on resource usage of your mud, such as memory, total cpu
times, average cpu times for ticking objects, number of tick groups and ticking
objects, etc. It will also enumerate the several main service threads of the
mud, and show their status as well.

LIST_RESOURCES

Command  : LIST
Usage : LIST RESOURCES ([MASK])
Example : list resources
Example : list resources dragons den
Lists all the cached binary and text data objects in your mud. This will
include stuff like parsed MOBPROG programs, MOBPROG variables, text files, help
files, area statistics, and so forth. Adding a mask parameter will limit the
view of resources only to those with those keywords.

LIST_ROOMS

Command  : LIST
Usage : LIST ROOMS
Example : list rooms
Lists all the rooms in the current area, along with the short display name of
each room.

LIST_SCRIPTS

Command  : LIST
Usage : LIST SCRIPTS COUNT/DETAILS/CUSTOM
Example : list scripts count
Example : list scripts details
Example : list scripts custom
Lists all the scripts in use in your game. The COUNT param will show all the
scripts, and how many objects are referring to that script. List scripts
details will show the first part of the script name, the name of the object
that it is attached to, and the room where that object is located. List
scripts custom will show all the objects with custom scripts, the objects
location, and a full listing of the custom script (a custom script is simply
one that is hard coded into the behavior instead of coming from a file).

LIST_SESSIONS

Command  : LIST
Usage : LIST SESSIONS (STATUS/VALID/NAME/IP/IDLE)
Example : list sessions
Example : list sessions name
Lists the players online, their idle time, status, and ip address. An optional
parameter may be given to sort by one of the fields.

LIST_SKILLS

Command  : LIST 
Usage : LIST SKILLS
Example : list skills
Shows the list of all skills (ability ids) available to archons.

LIST_SONGS

Command  : LIST 
Usage : LIST SONGS
Example : list songs
Shows the list of song java classes (ability ids) available to archons.

LIST_SPACESHIPS

Command  : LIST
Usage : LIST SPACESHIPS (SORTBY [COLUMN]...) (COLS [COLUMN]...))
Example : list spaceships
Example : list spaceships sortby name cols name population
Example : list spaceships sortby name
Lists all the spaceships in your game. By default, it also shows whether the
ship is Hidden, how many rooms are in the planet, whether it is in a passive or
active state, its current population, and the median level. If the sortby
parameter is used, then you can follow it with the order of columns to sort by.
Valid columns include: NAME, AUTHOR, DESCRIPTION , ROOMS, STATE, HIDDEN,
POPULATION, MIN_LEVEL, MAX_LEVEL, AVG_LEVEL, MED_LEVEL, AVG_ALIGNMENT,
MED_ALIGNMENT, TOTAL_LEVELS, TOTAL_INTELLIGENT_LEVELS, VISITABLE_ROOMS,
INDOOR_ROOMS. If the columns parameter is used, then you can follow it with
columns to substitute in the table.

LIST_SPELLS

Command  : LIST 
Usage : LIST SPELLS
Example : list spells
Shows the list of spell java classes (ability ids) available to archons.

LIST_STAFF

Command  : LIST
Usage : LIST STAFF
Example : list staff
Lists all the areas, along with any Area SubOps defined for those areas.

LIST_TECH

Command  : LIST
Usage : LIST TECH
Example : list tech
Shows the list of tech item java classes (item ids) available to archons.

LIST_THIEFSKILLS

Command  : LIST 
Usage : LIST THIEFSKILLS
Example : list
Shows the list of thief skill java classes (ability ids) available to archons.

LIST_THREADS

Command  : LIST
Usage : LIST THREADS (SHORT)
Example : list threads
Example : list threads short
Lists all the threads running in the mud, along with what they are doing, if
that information is available. Threads are generally idle, so that should be
reflected most of the time. The short parameter is mostly useless in later
versions of CoffeeMud, since all threads are always active.

LIST_TICKS

Command  : LIST
Usage : LIST TICKS ([GROUP NUMBER]/ACTIVE/PROBLEMS/[MASK]) (COL)
Example : list ticks
Example : list ticks 7
Example : list ticks active
Example : list ticks problems
Shows the list of ticking objects in the game. A ticking object is simply one
that may get thread time at some point from the engine. By default, each entry
consists of a group id, the name of the object that is ticking, the ID of the
tick-type, and a status or ! if the object is not ticking.

Valid parameters include a tick group number, the word "active" to only show
ticks that are currently receiving thread time, "problems" to receive a list of
the ticks that have consumed the most average thread time, or a string mask to
filter by object name.

The last column of each report may be replaced by adding a valid column name to
the end of the list command. Valid columns include: tickername, tickerid,
tickerstatus, tickerstatusstr, tickercodeword, tickertickdown,
tickerretickdown, tickermillitotal, tickermilliavg, tickerlaststartmillis,
tickerlaststopmillis,tickerlaststartdate, tickerlaststopdate,
tickerlastduration, tickersuspended

LIST_TITLES

Command  : LIST
Usage : LIST TITLES
Example : list titles
Lists all the auto-applied player titles defined in your game, along with the
requirements, that is, the trigger, that will make them available.

LIST_UNLINKEDEXITS

Command  : LIST
Usage : LIST UNLINKEDEXITS (LOG)
Example : list unlinkedexits
Example : list unlinkedexits log
Lists all the rooms which have directions for which an exit has been defined,
but does not link to any room. Adding the log parameter will dump all that
stuff to your mud.log

LIST_USERS

Command  : LIST
Usage : LIST USERS (COLUMN NAME)
Example : list users
Example : list users ip
Lists all the players in your game database, showing by default their race,
current class, level, hours played, last login time/date, and name. If you
specify a column name of NAME, CLASS, RACE, LEVEL, AGE, LAST, EMAIL, or IP,
then that column will be shown if it is not available, and the list will be
sorted by that column.

LIST_WEAPONS

Command  : LIST
Usage : LIST WEAPONS
Example : list weapons
Shows the weapon java classes (item ids) available to archons.

LIST_WORLD

Command  : LIST
Usage : LIST WORLD (SORTBY [COLUMN]...) (COLS [COLUMN]...))
Example : list world
Example : list world sortby name cols name population
Example : list world sortby name
Lists all the areas in your current world, meaning areas that share the same
time zone. By default, it also shows whether the area is Hidden, how many
rooms are in the area, whether it is in a passive or active state, its current
population, and the median level. If the sortby parameter is used, then you
can follow it with the order of columns to sort by. Valid columns include:
NAME, AUTHOR, DESCRIPTION , ROOMS, STATE, HIDDEN, POPULATION, MIN_LEVEL,
MAX_LEVEL, AVG_LEVEL, MED_LEVEL, AVG_ALIGNMENT, MED_ALIGNMENT, TOTAL_LEVELS,
TOTAL_INTELLIGENT_LEVELS, VISITABLE_ROOMS, INDOOR_ROOMS. If the columns
parameter is used, then you can follow it with columns to substitute in the
table.

LOAD

Command : LOAD
Usage : LOAD [OBJECT TYPE] [PATH/NAME]
Example : load resource banned.ini
Example : load ability /myclasses/blah.class
Example : load weapon /myclasses/blah2.class
Example : load class com.planet_ink.coffee_mud.Items.Weapons.Sword.class
Example : load weapon com/planet_ink/coffee_mud/Items/Weapons/Sword.java
Short(s):
A command for the loading of resources, faction ini files, or class files of
java or javascript.

Use LIST RESOURCES to see a list of resources.

For class files, the LIST command can also show whats already loaded. This
command will automatically attempt to unload a class if it is already loaded.
If the specified class is a java source file or javascript, it will attempt to
compile it first. For loading classes, the second parameter may be the word
"class" and the system will attempt to correct your ambiguity. If it is unable
to determine the type of class being loaded, however, you may get an error. It
is therefore better just to use the load [CLASS-TYPE] syntax instead.

MASKS

In numerous parameters, places, and input fields, CoffeeMud will ask you for
something called a "Zapper Mask". The mask is used to help select particular
mobs, items, etc from the universe of available selections by "filtering out"
those you don't want. For example, if you wanted to only select mobs named Bob,
you would compose a mask that Disallows non-mobs, and Disallows things that
dont have the name Bob. This is done using the Zapper Mask syntax, shown
below:
+SYSOP (allow archons to bypass the rules)
-SYSOP (always disallow archons)
+SUBOP (allow archons or area staff to bypass the rules)
-SUBOP (always disallow archons and area staff)
-PLAYER (disallow all players)
-MOB (disallow all mobs/npcs)
-CLASS (disallow all classes)
-CLASS +thief +mage +ranger (create exceptions)
-BASECLASS (disallow all base classes)
-BASECLASS +thief +mage +ranger (create exceptions)
-thief -mage -ranger (disallow only listed classes)
-RACE (disallow all races)
-RACE +elf +dwarf +human +half +gnome (create exceptions)
-elf -dwarf -human -half -gnome (disallow only listed races)
-RACECAT (disallow all racial categories)
-RACECAT +elf +insect +humanoid +canine +gnome (create exceptions)
+RACECAT (do not disallow all racial categories)
+RACECAT -elf -insect -humanoid -canine -gnome (create exceptions)
-ALIGNMENT (disallow all alignments)
-ALIGNMENT +evil +good +neutral (create exceptions)
-evil -good -neutral (disallow only listed alignments)
-GENDER (disallow all genders)
-GENDER +male +female +neuter (create exceptions)
-male -female -neuter (disallow only listed genders)
-FACTION (disallow all faction and values, even a lack of faction)
-FACTION +myfactionrange +faction.rangename (create exceptions)
-rangename -faction.rangename (disallow only faction range named)
-TATTOOS (disallow all tattoos, even a lack of a tattoo)
-TATTOOS +mytatto +thistattoo +anytattoo etc.. (create exceptions)
+TATTOOS (do not disallow any or no tattoos)
+TATTOOS -mytattoo -anytatto, etc.. (create exceptions)
-EXPERTISES (disallow all expertises, even a lack of a edus)
-EXPERTISES +myedu +thisedu +anyedu etc.. (create exceptions)
+EXPERTISES (do not disallow any or no expertises)
+EXPERTISES -myedu -anyedu, etc.. (create exceptions)
-SECURITY (disallow all security flags, even a lack of a security)
-SECURITY +cmdrooms +area cmditems etc.. (create exceptions)
+SECURITY (do not disallow any or no expertises)
+SECURITY -cmdrooms +area cmditems, etc.. (create exceptions)
-MOOD +grumpy +normal (disallow all except those with given moods)
+MOOD -grumpy -normal (disallow only those with subtracted moods)
-LEVEL (disallow all levels)
-LEVEL +=1 +>5 +>=7 +<13 +<=20 (create exceptions)
-=1 ->5 ->=7 -<13 -<=20 (disallow only listed levels range)
-NAMES (disallow everyone)
-NAMES +bob "+my name" etc.. (create name exceptions)
+NAMES (do not disallow anyone who has a name)
+NAMES -bob "-my name" etc.. (create name exceptions)
-CLAN (disallow anyone, even no clan)
-CLAN +Killers "+Holy Avengers" etc.. (create clan exceptions)
+CLAN (do not disallow anyone, even non clan people)
+CLAN -Killers "-Holy Avengers" etc.. (create clan exceptions)
-DEITY (disallow anyone, even no deity)
-DEITY +Apollo "+Grothon The Great" etc.. (create deity exceptions)
+DEITY (do not disallow anyone, even non deity worshipping people)
+DEITY -Apollo "-rothon The Great" etc.. (create deity exceptions)
-ANYCLASS (disallow all multi-class combinations)
-ANYCLASS +thief +mage +ranger (exceptions, allow any class)
+ANYCLASS (do not disallow all multi-class combinations)
+ANYCLASS -thief -mage -ranger (exceptions, disallow any class)
-STR X (disallow those with strength greater than X)
+STR X (disallow those with strength less than X)
-INT X (disallow those with intelligence greater than X)
+INT X (disallow those with intelligence less than X)
-WIS X (disallow those with wisdom greater than X)
+WIS X (disallow those with wisdom less than X)
-CON X (disallow those with constitution greater than X)
+CON X (disallow those with constitution less than X)
-CHA X (disallow those with charisma greater than X)
+CHA X (disallow those with charisma less than X)
-DEX X (disallow those with dexterity greater than X)
+DEX X (disallow those with dexterity less than X)
+-ADJSTR...ADJCON (Same as above, but uses current values)
-GROUPSIZE X (disallow those in groups larger than X)
+GROUPSIZE X (disallow those in groups smaller than X)
-AREA (disallow in all areas)
-AREA "+my areaname" etc.. (create exceptions)
+AREA (do not disallow any areas)
+AREA "-my areaname" etc.. (create exceptions)
-HOME (disallow in all home/beacon areas)
-HOME "+my home/beacon areaname" etc.. (create exceptions)
+HOME (do not disallow any home/beacon areas)
+HOME "-my home/beacon areaname" etc.. (create exceptions)
-ITEM "+item name" etc... (disallow only those with an item name)
-WORN "+item name" etc... (disallow only those wearing item name)
-EFFECTS (disallow anyone, even no effects)
-EFFECTS +Sleep "+Wood Chopping" etc.. (create name exceptions)
+EFFECTS (do not disallow anyone, even non effected people)
+EFFECTS -Sleep "-Wood Chopping" etc.. (create name exceptions)
-SKILLS (disallow anyone, even those with no skill)
-SKILLS +Spell_Sleep(75) etc.. (create exceptions with proficiency)
+SKILLS (do not disallow anyone, even non skilled people)
+SKILLS -Spell_Sleep(75) etc.. (create exceptions with proficiency)
-MATERIAL "+WOODEN" etc.. (disallow only items of added materials)
+MATERIAL "-WOODEN" etc.. (Do not disallow items of -materials)
-RESOURCES "+OAK" etc.. (disallow only items of added resources)
+RESOURCES "-OAK" etc.. (Do not disallow items of -resources)
-JAVACLASS "+GENMOB" etc.. (disallow only objects of +java class)
+JAVACLASS "-GENITEM" etc.. (Do not disallow objs of -classes)
-ABILITY X (disallow those with magical ability less than X)
+ABILITY X (disallow those with magical ability greater than X)
-IF <CONDITION> (disallow, unless they meet Scriptable conditions)
+IF <CONDITION> (never disallow anyone who meets Scriptable cond)
-VALUE X (disallow those with value or money less than X)
+VALUE X (disallow those with value or money greater than X)
-WEIGHT X (disallow those weighing less than X)
+WEIGHT X (disallow those weighing more than X)
-ARMOR X (disallow those with armor bonus less than X)
+ARMOR X (disallow those with armor bonus more than X)
-DAMAGE X (disallow those with damage bonus less than X)
+DAMAGE X (disallow those with damage bonus more than X)
-ATTACK X (disallow those with attack bonus less than X)
+ATTACK X (disallow those with attack bonus more than X)
-WORNON "+TORSO" etc.. (disallow only items wearable on +locations)
+WORNON "-NECK" etc.. (Do not disallow items wearable on -locations)
-DISPOSITION "+ISHIDDEN" etc.. (disallow only with +dispositions)
+DISPOSITION "-ISHIDDEN" etc.. (Do not disallow only with sub disp)
-SENSES "+CANSEEDARK" etc.. (disallow only those with +senses)
+SENSES "-CANSEEDARK" etc.. (Do not disallow those with -senses)
-HOUR +X (disallow always, unless the hour is X)
+HOUR -X (disallow those only when the hour is X)
-SEASON +FALL (disallow those only when season is FALL)
+SEASON -SPRING (disallow those whenever the season is SPRING)
-MONTH +X (disallow those only when month number is X)
+MONTH -X (disallow those whenever the month number is X)
-DAY +X (disallow those only when day number is X)
+DAY -X (disallow those whenever the day number is X)
-WEATHER +DROUGHT (disallow those only when weather is DROUGHT)
+WEATHER -BLIZZARD (disallow those whenever the weather is BLIZZARD)
-QUESTWIN "+MY QUEST" (disallow those who have not my MY QUEST)
+QUESTWIN "-MY QUEST" (disallow those who have won MY QUEST)
-SKILLFLAG (disallow anyone, even those with no skills)
-SKILLFLAG +ENCHANTMENT etc.. (create exceptions to -skillflag)
+SKILLFLAG (do not disallow anyone, even non skilled people)
+SKILLFLAG -ENCHANTMENT etc.. (create exceptions to +skillflag)
-CHANCE 50 (disallow the given % of the time)

MATH_FORMULA

In certain fields and specifications, CoffeeMud will allow you to enter a
mathematical formula in place of a simple number in order to calculate a number
at run-time. This is useful for occasions where you want the number to have a
random element, or where the value of the number is calculated based on certain
variables only available at run-time.

The formulas can be anything from a simple number, to numbers combined with
mathematical operators + - \ *, grouped with parenthesis ( ), and may also
include certain special operators.

One special operator, ? , is for generating a random number (ex: 2?5 refers to
a random number between 2 and 5). Another special operator, >, is for bounding
the result of an operation (ex: 5 * 10 > 10 will evaluate to the greater of 10
or 5 * 10. The < operator does the opposite.

MERGE

Command  : MERGE
Usage : MERGE (AREA/ROOM) (CHANGE=[FIELD,..]) (ON=[FIELD,..])
(IGNORE=[FIELD,..]) [PATH & FILE NAME]
Usage : MERGE (AREA/ROOM) DATABASE (MOBS/ITEMS/ROOMS) DBCLASS=[JAVACLASS]
DBSERVICE=[DB SERVICE URL]
: DBUSER=[USERNAME] DBPASS=[PASSWORD] (IGNORE=[FIELD,..])
(MASK=[ZAPPERMASK])
Example : merge /myfiles/myitems.cmare
Example : merge change=damage,level,ability /myfiles/myweapons.cmare
Example : merge area change=material ignore=level /myfiles/myweapons.cmare
Example : merge change=damage on=name /myfiles/weapons.cmare
Example : merge area database dbclass=com.mysql.jdbc.Driver
dbservice=jdbc:mysql://localhost:3306/db
: dbuser=username dbpass=password ignore="IMG,ATTACK" MASK="-NAMES
+Bob"
Short(s) :
Allows you to selectively modify all instances of a mob or item in the world
based on the contents of a CMARE file containing items or mobs, or another
CoffeeMud database.

When using CMARE files, the files must be generated using the EXPORT
(WORLD/AREA/ROOM) (ITEMS/WEAPONS) command. The first parameter specifies
whether the items in the text file are to be merged with those in the entire
world, in your current area, or just the room. The second parameter (CHANGE) is
implied to be ALL unless specified otherwise. It denotes which fields in the
existing items may be changed based on what changes are seen to the item inside
the CMARE file. The third parameter (ON) is implied to be ALL unless
specified otherwise. It denotes how an item in the CMARE file is matched with
an existing item in your world. If the listed fields from the CMARE file and
the existing item are equal, the items will be considered a match for the
purposes of merging. The fourth parameter (IGNORE) is implied to be NONE
unless specified otherwise. It denotes exceptions to the (ON) parameter,
namely which fields are allowed to differ between items in the CMARE file and
an existing item in cases where they would otherwise be considered a match
according to the (ON) parameter. Matched items in your existing world, in
every room, will be modified accordingly, and the room will be resaved to your
database. The log will reflect all changes made to your world. Every room in
every area in your world will be reloaded from the database prior to any
evaluations or changes.

When using a database as a source, the merge command will compare and match the
database version of the room contents with the local world. The user is then
given the opportunity to make changes to the local world depending on
differences. The merge requires DBCLASS, DBSERVICE, DBUSER, and DBPASS
parameters be set. The IGNORE parameters is a comma delimited list of fields
to ignore when displaying differences. To mask the types of objects checked,
the user can specify mobs, items, or the whole rooms after the word database,
and a zappermask can be included after the mask parameters.

MESSAGE_TYPES

The following are valid message codes in CoffeeMud.  They are usable as such in
Scriptable for the EXECMSG_PROG and CNCLMSG_PROG triggers:

"AREAAFFECT", "PUSH", "PULL", "RECALL", "OPEN", "CLOSE", "PUT", "GET",
"UNLOCK", "LOCK", "WIELD", "GIVE", "BUY", "SELL", "DROP", "WEAR", "FILL",
"DELICATE_HANDS_ACT", "VALUE", "HOLD", "NOISYMOVEMENT", "QUIETMOVEMENT",
"WEAPONATTACK", "LOOK", "READ", "NOISE", "SPEAK", "CAST_SPELL","LIST", "EAT",
"ENTER", "FOLLOW", "LEAVE", "SLEEP", "SIT", "STAND", "FLEE", "NOFOLLOW",
"WRITE", "FIRE", "COLD", "WATER", "GAS", "MIND", "GENERAL", "JUSTICE", "ACID",
"ELECTRIC", "POISON", "UNDEAD", "MOUNT", "DISMOUNT", "OK_ACTION", "OK_VISUAL",
"DRINK", "HANDS", "PARALYZE", "WAND_USE", "SERVE", "REBUKE", "ADVANCE",
"DISEASE", "DEATH", "DEPOSIT", "WITHDRAW", "EMOTE", "QUIT", "SHUTDOWN", "VIEW",
"RETIRE", "RETREAT","PANIC", "THROW", "EXTINGUISH", "TELL", "SITMOVE", "KNOCK",
"PRACTICE", "TEACH", "REMOVE", "EXPCHANGE", "DAMAGE", "HEALING", "ROOMRESET",
"RELOAD", "SNIFF", "ACTIVATE", "DEACTIVATE", "FACTIONCHANGE", "LOGIN", "LEVEL",
"EXAMINE", "BORROW", "HUH",
"LIFE","BID","CLANEVENT","UNLOAD","DUELCHALLENGE","LEGALWARRANT".

And here are some general message code types that may also be used:
"TO



























SOUND","GENERAL","MAGIC","DELICATE","MALICIOUS","CHANNEL","OPTIMIZE","INTERMSG"

METACRAFT

Usage    : METACRAFT (EVERY) [ITEM NAME] ([MATERIAL NAME]) (TO SELF/HERE/FILE
[FILENAME])
Example : metacraft wagon oak
Example : metacraft wagon
Example : metacraft "every sword" bronze
Example : metacraft "every sword"
Example : metacraft "every sword" iron to file /items.cmare
This skill will allow you to create any item that is craftable from the
numerous common skills. The item created may be made of a material specified,
or automatically crafted by a random material valid to the appropriate skill.
You can also specify the destination of the items, whether it be the room, your
inventory, or an xml file.

MODIFY

Command : MODIFY
Usage : MODIFY [ITEM TYPE] ...
Example : modify room name The Grassy Knole
Example : modify mob orc
Example : modify item longsword
Example : modify item "longsword@an orc"
Example : modify jscript
Example : modify news
Short(s):
A command for the modification of items, mobs, users, quests, rooms, polls,
classes, races, news, areas, and exits. Enter MODIFY for more information on
command usage.

MPRUN

Command  : MPRUN
Usage : MPRUN ([USER]:[PASS]) [SCRIPT]
Example : mprun once_prog;mpecho hello!;~;
Example : mprun load=mine.script
Example : mprun archons:password once_prog;mpecho hello!;~;
Short(s) :
Runs the given script as per the Scriptable behavor. Since Scriptable scripts
are event-triggered, any commands executed must be in a ONCE_PROG trigger (or
perhaps a RAND_PROG).

For use as part of automated testing, MPRUN can also be executed by
unauthorized users so long as they know the username and password of an
authorized user. Any failed attempts to use this command will cause the user
to be marked as unable to use this command for two minutes.

MULTIWATCH

Ability    : Multiwatch
Usage : MULTIWATCH (AUTO/STOP/ADD [NAME] ... [NAME])
Example : multiwatch add playerone playertwo
Example : multiwatch auto
Example : multiwatch stop
Description:
This is an archon skill to assist in determining if a set of players who are
connected from the same ip address are the same person. It does this by
tracking certain pieces of data which together may be taken as rather
circumstantial evidence of someone multiplaying. The definition of the numbers
are as follows:
SYNC - The number of commands entered by more than one member of an IP group
within a single 4 second period.
SPEECH - This refers to SAY commands, broken into three sections. The first
number represents the number of SAY commands done in the same room with a
player who has the same IP address. The second number represents the number of
SAY commands directed at another player. The last number is the number of SAY
commands total.
SOCIALS - These are also divided into three numbers where, again, the first is
the number of socials in the same room with a player with the same IP, the
second being socials directed at another player, and the last being the number
of total socials.
CMD - The number of commands entered which are different than the previous
command entered.
ORDER - The number of times one of the players in the group gave an ORDER to
another player in the group. A sure sign indeed.

NEWS

The channel where logon news is shown.  Try LIST NEWS and MODIFY NEWS.

NOPURGE

Command : NOPURGE
Usage : NOPURGE [PLAYER NAME]
Example : nopurge bob
Short(s):
Makes a player inelligible for purging by the autopurge system. Use LIST
NOPURGE, or DESTROY NOPURGE for maintaining the list.

NOWIZINFO

Command : NOWIZINFO
Usage : NOWIZINFO
Example : nowizinfo
Short(s):
Turn off the automatic information channel available to admins and area admins.

NOWIZINV

Command  : WIZARD INVISIBILITY
Usage : VISIBLE
Example : visible
Short(s) : nowizinv
Wizard Invisibility makes the invoker completely undetectable by other mobs or
players. This command turns wizard invisibility off. See WIZINV for more
information.

ORDER

Command : ORDER
Usage : ORDER [TARGET NAME] [COMMAND(S)]
Example : order dog flee
Short(s):
This command will allow you to force a mob to perform any command listed in the
COMMANDS or SOCIALS list.

PAUSE

Command : PAUSE
Usage : PAUSE [ROOM/AREA/OBJECTNAME]
Example : pause
Example : pause area
Example : pause orc
Short(s):
This very powerful and dangerous command allows you to suspend all thread and
ticking services in the entire mud. It can be a quick and easy way to discern
locked up threads, or to free up CPU time for other purposes. Enter PAUSE
alone to suspend and resume all objects, or specify room, area, or an object
name to suspend the ticking of just that object.

PLAYERVERSUSPLAYER

PLAYERKILL

POOF

Command : POOF
Usage : POOF
Short(s):
For players with access to the GOTO command, this command will allow the admin
to change the messages seen when they leave and enter a room via GOTO. The
S-NAME, S-HIM-HER and other codes may be used so that the admins name is
properly presented. Remember to surround the codes with the less-than and
greater-than tag markers!

POSSESS

Skill    : POSSESS
Usage : POSSESS [MOB NAME]
Example : possess dragon
Short(s) :
This command will allow your character to possess and control any given mob.
That mob will be controlled as if it were your own character. Use the QUIT
command to return to your own characters body. Should the mob die, you will be
returned automatically. POSSESS does not transfer your security levels to the
possessed mob UNLESS you have turned on your SYSMSGS flag before possessing.

PURGE

Command : PURGE
Usage : PURGE [ITEM TYPE] ...
Example : purge orc
Example : purge item longsword
Example : purge item longsword@an orc
Short(s):
This command is a weak form of DESTROY, allowing only items and mobs to be
destroyed. Rejuvinating mobs will still rejuvinate when purge is used, unlike
destroy.

PVP

PLAYERKILL

QUESTS

Quests are defined as a definable tasks which are completed by players for
prizes. These tasks, the monitoring of their completion and status, as well as
their availability, can all be automated by CoffeeMud.

A quest is created using the CREATE QUEST [SCRIPT] command. Where [SCRIPT] is
a either a complete quest script, where each command line is terminated by a
semicolon (;), or a load command of the form LOAD=[SCRIPT PATH]. An example of
a create script using a load command is as follows: CREATE QUEST
LOAD=/resources/quests/myquest.txt. To load one of the built-in quests, for
instance, use CREATE QUEST LOAD=quests/robbed/robbed.quest.

Quests may be started manually, or by making them autoquests using the SET WAIT
and SET INTERVAL commands below. Quests may be started manually by using the
MODIFY QUEST [QUEST NAME] command. Quests can be listed, to see their status,
using the LIST QUESTS command. Quests can be removed from the list using the
DESTROY QUEST [QUEST NAME] command. Quests can be saved using the SAVE QUESTS
command. Quests saved this way will be restored during the next CoffeeMud
reboot.

When creating a new quest using the CREATE QUEST [SCRIPT] command, whether you
use the load command to specify an external script, or include the script
directly into the create command, the quest script commands are as follows:

SET NAME [QUEST NAME] - the *unique* name of your quest. This is a required
command!

SET DURATION [#TICKS] - # of ticks (4 second periods) the quest will last once
started. 0=eternal. This is a required command!

SET WAIT [#TICKS] - minimum # ticks to wait between auto-starts of the quest.
Required for auto-quests only!

SET DATE [#DAY]-[#MONTH] - The real-life start-date of the quest. This is a
valid substitute for the SET WAIT requirement.

SET MUDDAY [#DAY]-[#MONTH] - The start mud-date of the quest, according to the
default global mud calendar. This is a valid substitute for the SET WAIT
requirement.

SET INTERVAL [#TICKS] - random # ticks (1-#TICKS) to wait between auto-starting
the quest, AFTER the WAIT period (see above) is over. Required for auto-quests!

SET MINPLAYERS [#PLAYERS] - Minimum number of players who must be online for a
timed quest to automatically start. See SET PLAYERMASK.

SET PLAYERMASK [MASKSTRING] - If this string is empty or not specified, then
anyone is considered a player for the purposes of the MINPLAYERS setting above.
However, you can specify a "zapper mask" to narrow down the definition of a
player. See HELP ZAPPERMASKS for the list of valid mask values to put here.

SET RUNLEVEL [#LEVEL] - Normally, a timed quest will always run when its time
comes up. Setting a value above -1 will prevent this quest from running when
its time comes up if another quest is also running at the same or LOWER run
level.

IMPORT MOBS [XML FILE PATH] - this will import a list of custom mobs from a
.CMARE file generated using the EXPORT ROOM MOBS command. The parameter must be
the path and file name of the file, using the same format as the LOAD= command
mentioned above. This list can then be accessed with the LOAD MOB, or LOAD
MOBGROUP command.

IMPORT ITEMS [XML FILE PATH] - this will import a list of custom items from a
.CMARE file generated using the EXPORT ROOM ITEMS command. The parameter must
be the path and file name of the file, using the same format as the LOAD=
command mentioned above. This list can then be accessed with the LOAD ITEM or
LOAD ITEMGROUP command.

SET AREA ([AREA NAME OR NAMES]) - will set the current designated area to the
area specified. Although this does nothing in itself, it is important for the
several commands which load mobs and items. The area name ANY may be given to
choose a random area. Several area names may be specified as choices by setting
the first area name as ANY, followed by your other area name choices, separated
by spaces. If no area name is given, this will CLEAR the area designation. This
can have a profound impact on how subsequent mob or item loading, or room
setting commands work.

SET AREA [OBJECT] - serves the same purpose as the above command of the same
name, but the argument is an object specifier. See Object Specifiers below
this command listing. If the object resolves to a group of objects, a random
one from the group will be chosen.

SET AREAGROUP ([AREA NAME OR NAMES]) - will set the current designated
ROOMGROUP to the areas specified. Although this does nothing in itself, it is
important for the several commands which load mobs and items. The area name ANY
may be given to choose a random area. The area name ALL may be given to choose
all world areas. Several area names may be specified as choices by setting the
first area name as ANY, followed by your other area name choices, separated by
spaces. If no area name is given, this will CLEAR the ROOMGROUP designation.
This can have a profound impact on how subsequent mob or item loading, or room
setting commands work.

SET ROOMGROUP ([ROOM NAME]) - will set the ROOMGROUP to the set specified. If
an area has been previously designated, and not cleared (see SET ROOMGROUP),
then the rooms will be selected from the designated area according to the room
name criteria. Otherwise, rooms from the whole map will be chosen. If a room
name of ANY is given, then the rooms will be chosen randomly from the world, or
the area if designated. The room name of ALL will choose all rooms. Several
room names may be specified as choices by setting the first room name as ANY,
followed by your other room name choices, separated by spaces. If no room name
is given, this will effectly clear the ROOMGROUP designation (but it will not
clear the area designation!). Valid room names include map room IDs such as
MyArea#123, or key words from the titles or descriptions of rooms.

SET ROOMGROUP [OBJECT] - serves the same purpose as the above command of the
same name, but the argument is an object specifier. See Object Specifiers
below this command listing.

SET ROOM ([ROOM NAME]) - will set the current designated room to the set
specified. If a room or area has been previously designated, and not cleared
(see SET AREA), then the room will be selected from the designated area
according to the room name criteria. Otherwise, a room from the whole map will
be chosen. If a room name of ANY is given, then the room will be chosen
randomly from the world, or the area if designated. Several room names may be
specified as choices by setting the first room name as ANY, followed by your
other room name choices, separated by spaces. If no room name is given, this
will effectly clear the room designation (but it will not clear the area
designation!). Valid room names include map room IDs such as MyArea#123, or
key words from the titles or descriptions of rooms.

SET ROOM [OBJECT] - serves the same purpose as the above command of the same
name, but the argument is an object specifier. See Object Specifiers below
this command listing. If the object resolves to a group of objects, a random
one from the group will be chosen.

SET ROOMGROUPAROUND [#RADIUS] ([ROOM NAME])- will set the ROOMGROUP to the set
of rooms up to RADIUS rooms from the previously set ROOM. The rooms will be
selected from the set of rooms which are up to RADIUS rooms away from the
currently set ROOM (see SET ROOM/SET LOCALE). The radius must then be greater
than 0. If the following room name of ANY is given, then all rooms in the
radius are grouped. Several room names may be specified as choices by setting
the first room name as ANY, followed by your other room name choices, separated
by spaces. If no room name is given, this will effectly clear the ROOMGROUP
designation (but it will not clear the area designation!). Valid room names
include map room IDs such as MyArea#123, or key words from the titles or
descriptions of rooms.

SET LOCALEGROUP ([LOCALE]) - will set the ROOMGROUP to the ones with the
specified class name. If an area has been previously designated, and not
cleared (see SET AREA), then the rooms will be selected from the designated
area according to the locale criteria. Otherwise, rooms from the whole map will
be chosen. If a locale name of ANY is given, then the rooms will be chosen
randomly from the world, or the area if designated. Several locale types may
be specified as choices by setting the first locale type as ANY, followed by
your other locale type choices, separated by spaces. If no locale is given,
this will effectly clear the ROOMGROUP designation (but it will not clear the
area designation!). Valid locale names may be Locale class names such as
MountainSurface, StdRoom, etc, or they may be locale types such as stone,
wooden, underwater, mountains, etc.

SET LOCALEGROUP [OBJECT] - serves the same purpose as the above command of the
same name, but the argument is an object specifier. See Object Specifiers
below this command listing.

SET LOCALEGROUPAROUND ([#RADIUS] [LOCALE]) - will set the ROOMGROUP to the ones
with the specified class name. The rooms will be selected from the set of rooms
which areup to RADIUS rooms away from the currently set ROOM (see SET
LOCALE/SET ROOM). The radius must then be greater than 0. If the following
locale name of ANY is given, then all rooms in the radius are grouped. Several
room names may be specified as choices by setting the first locale name as ANY,
followed by your other locale name choices, separated by spaces. If no locale
name is given, this will effectly clear the ROOMGROUP designation (but it will
not clear the area designation!). Valid locale names may be Locale class
names such as MountainSurface, StdRoom, etc, or they may be locale types such
as stone, wooden, underwater, mountains, etc.

SET LOCALE ([LOCALE]) - will set the current designated room to the one with
the specified class name. If a room or area has been previously designated, and
not cleared (see SET AREA), then the room will be selected from the designated
area according to the locale criteria. Otherwise, a room from the whole map
will be chosen. If a locale of ANY is given, then the room will be chosen
randomly from the world, or the area if designated. Several locale types may
be specified as choices by setting the first locale type as ANY, followed by
your other locale type choices, separated by spaces. If no locale is given,
this will effectly clear the room designation (but it will not clear the area
designation!). Valid locale names may be Locale class names such as
MountainSurface, StdRoom, etc, or they may be locale types such as stone,
wooden, underwater, mountains, etc.

SET LOCALE [OBJECT] - serves the same purpose as the above command of the same
name, but the argument is an object specifier. See Object Specifiers below
this command listing. If the object resolves to a group of objects, a random
one from the group will be chosen.

SET MOBGROUP (RESELECT) ([MOB NAME]) - will designate a set of mobs with the
given name. If the name ends with MASK=..., then a mask as described by the
help entry for ZAPPERMASKS will apply in addition to the name mask entered
before the MASK= string. A mob name of ALL will select all appropriate mobs.
The mobs chosen will be selected from those in the designated ROOMGROUP (if one
is designated), AREA (if one is designated) or the world. The mobs must exist
somewhere in the map for this command to work. Normally a mob will not be
placed in the mobgroup if the mob has been previously set with SET MOB, or SET
MOBTYPE. The RESELECT flag is an optional first flag which, if specified,
designates that mobs may be placed in the mobgroup even if previously set, so
long as the RESELECT flag was also used in the previous SET MOB or SET MOBTYPE
command.

SET MOBGROUP [OBJECT] - serves the same purpose as the above command of the
same name, but the argument is an object specifier. See Object Specifiers
below this command listing

SET MOB (RESELECT) ([MOB NAME]) - will set the current mob to one with the
given mob name. If the name ends with MASK=..., then a mask as described by the
help entry for ZAPPERMASKS will apply in addition to the mob name entered
before the MASK= string. Ths mob chosen will be selected from a MOBGROUP if one
has been set. Otherwise, the mob chosen will be selected from those in the
designated ROOMGROUP (if one is designated), or the AREA (if one is designated)
or finally the world. The mob must exist somewhere one of those groups for this
command to work. If a room has been previously designated, then this command
will bring the chosen mob to that room. If a room or area has not been
designated (or was cleared), then this command will designate a new room and
area. Normally a mob will not be chosen by this command if the mob has been
previously set with SET MOB, or SET MOBTYPE. The RESELECT flag is an optional
first flag which, if specified, designates that a mob may be chosen if
previously chosen, so long as the RESELECT flag was also used in the previous
SET MOB or SET MOBTYPE command.

SET MOB [OBJECT] - serves the same purpose as the above command of the same
name, but the argument is an object specifier. See Object Specifiers below
this command listing. If the object resolves to a group of objects, a random
one from the group will be chosen.

SET MOBTYPE (RESELECT) ([CLASS]) - will set the current mob to one with the
given class name. Ths mob chosen will be selected from a MOBGROUP if one has
been set. Otherwise, the mob chosen will be selected from those in the
designated ROOMGROUP (if one is designated), AREA (if one is designated) or the
world. The mob must exist somewhere in the map for this command to work. If a
room has been previously designated, then this command will bring the mob to
that room. If a room or area has not been designated (or was cleared), then
this command will designate a new room and area. Normally a mob will not be
chosen by this command if the mob has been previously set with SET MOB, or SET
MOBTYPE. The RESELECT flag is an optional first flag which, if specified,
designates that a mob may be chosen if previously chosen, so long as the
RESELECT flag was also used in the previous SET MOB or SET MOBTYPE command.

SET MOBTYPE [OBJECT] - serves the same purpose as the above command of the same
name, but the argument is an object specifier. See Object Specifiers below
this command listing. If the object resolves to a group of objects, a random
one from the group will be chosen.

SET ITEMGROUP (RESELECT) ([ITEM NAME]) - will designate a set of items with
the given name. If the name ends with MASK=..., then a mask as described by the
help entry for ZAPPERMASKS will apply in addition to the item name entered
before the MASK= string. A mob name of ALL will select all appropriate mobs.
The items chosen will be selected from those in the designated ROOMGROUP (if
one is designated), the AREA (if one is designated) or the world. The items
must exist somewhere in the map for this command to work. Normally an item
will not be placed in the itemgroup if the item has been previously set with
SET ITEM, or SET ITEMTYPE. The RESELECT flag is an optional first flag which,
if specified, designates that items may be placed in the itemgroup even if
previously set, so long as the RESELECT flag was also used in the previous SET
ITEM or SET ITEMTYPE command.

SET ITEMGROUP [OBJECT] - serves the same purpose as the above command of the
same name, but the argument is an object specifier. See Object Specifiers
below this command listing

SET ITEM (RESELECT) ([ITEM NAME]) - will set the current item to one with the
given name. The item chosen will be selected from those in the designated
ROOMGROUP (if one is designated), AREA (if one is designated) or the world. The
item must exist somewhere in a room on the map for this command to work. If a
room has been previously designated, then this command will bring the item to
that room. If a room or area has not been designated (or was cleared), then
this command will designate a new room and area. Normally an item will not be
chosen by this command if the item has been previously set with SET ITEM, or
SET ITEMTYPE. The RESELECT flag is an optional first flag which, if specified,
designates that an item may be chosen if previously chosen, so long as the
RESELECT flag was also used in the previous SET ITEM or SET ITEMTYPE command.

SET ITEM [OBJECT] - serves the same purpose as the above command of the same
name, but the argument is an object specifier. See Object Specifiers below
this command listing. If the object resolves to a group of objects, a random
one from the group will be chosen.

SET ITEMTYPE (RESELECT) ([CLASS]) - will set the current item to one with the
given class name. The item chosen will be selected from those in the designated
ROOMGROUP (if one is designated), AREA (if one is designated) or the world. The
item must exist somewhere in a room on the map for this command to work. If a
room has been previously designated, then this command will bring the item to
that room. If a room or area has not been designated (or was cleared), then
this command will designate a new room and area. Normally an item will not be
chosen by this command if the item has been previously set with SET ITEM, or
SET ITEMTYPE. The RESELECT flag is an optional first flag which, if specified,
designates that an item may be chosen if previously chosen, so long as the
RESELECT flag was also used in the previous SET ITEM or SET ITEMTYPE command.

LOAD MOBGROUP ([#NUMBER]) [MOB NAME] - will instantiate all (or optionally, the
given number) mobs of the given name from the set of mobs imported using the
IMPORT MOBS command above. If the mob name ends with MASK=..., then a mask as
described by the help entry for ZAPPERMASKS will apply in addition to the mob
name entered before MASK= string. This selected mobs will be set as the current
MOBGROUP. If a room, roomgroup, or area has been previously designated, then
this command will create each mob in that room or random room in the area. If a
room or area has not been designated (or was cleared), then this command will
designate a random room and area. This command will also designate the current
mob to the last one loaded.

LOAD MOB [MOB NAME] - will instantiate a mob of the given name from the list of
mobs imported using the IMPORT MOBS command above. If the name ends with
MASK=..., then a mask as described by the help entry for ZAPPERMASKS will apply
in addition to the name mask entered. This selected mob will be set as the
current mob. If a room, roomgroup, or area has been previously designated, then
this command will create the mob in that room. If a room or area has not been
designated (or was cleared), then this command will designate a random room and
area.

LOAD ITEMGROUP ([#NUMBER]) [ITEM NAME] - will instantiate all (or optionally,
the given number) items of the given name from the list of items imported using
the IMPORT ITEMS command above. This items will be set as the current
ITEMGROUP. If a room, roomgroup, or area has been previously designated, then
this command will create the item in that room. If a room or area has not been
designated (or was cleared), then this command will designate a random room and
area. This command will also designate the current item to the last one
loaded.

LOAD ITEM [ITEM NAME] - will instantiate an item of the given name from the
list of items imported using the IMPORT ITEMS command above. This item will be
set as the current item. If a room, roomgroup, or area has been previously
designated, then this command will create the item in that room. If a room or
area has not been designated (or was cleared), then this command will designate
a random room and area.

GIVE ITEM - will give the currently designated item (designated using the SET
ITEM, or LOAD ITEM command) to the last designated mob or mobs (designated
using the SET MOB, SET MOBGROUP, LOAD MOBGROUP, or LOAD MOB commands).

GIVE ITEMS - will give all currently designated items (designated using the
SET/LOAD ITEM/ITEMGROUP command) to the last designated mob or mobs (designated
using the SET MOB, SET MOBGROUP, LOAD MOBGROUP, or LOAD MOB commands).

GIVE BEHAVIOR [BEHAVIOR ID] ([PARAMETERS]) - The behavior ID must be a valid
behavior class name. The parameters are any parameters you wish to pass to the
behavior. This command will give the most recently designated mob, item, area,
room or mobgroup (designated using the set or load commands), itemgroup, or
roomgroup the above behavior. The parameters above are optional, and include
any text that would be valid for the behavior id specified. The text may also
optionally include embedded references to other quest objects. See below
Object Specifiers in Parameters below for more information on using this
feature.

GIVE ABILITY [ABILITY ID] ([PARAMETERS]) - The ability ID must be a valid
ability class name. The parameters are any parameters you wish to pass to the
ability. This command will give the currently designated mob, or mobgroup
(designated using the set or load commands) the above ability. The parameters
above are optional, and include any text that would be valid for the ability id
specified. The text may also optionally include embedded references to other
quest objects. See below Object Specifiers in Parameters below for more
information on using this feature.

GIVE AFFECT [ABILITY ID] ([PARAMETERS]) - The ability ID must be a valid
ability class name. The parameters are any parameters you wish to pass to the
ability. This command will give the currently designated mob, item, room, area,
or mobgroup (designated using the set or load commands), itemgroup, or
roomgroup the above affect. The parameters above are optional, and include any
text that would be valid for the ability id specified. The text may also
optionally include embedded references to other quest objects. See below
Object Specifiers in Parameters below for more information on using this
feature.

GIVE FOLLOWER [MOB NAME] - The mob name is a mob which will be selected from
the list of previously designated mobs (designated using the LOAD MOB, SET MOB,
or SET MOBTYPE commands). This mob will be made into a follower of the mob most
recently designated using the SET MOB, SET MOBTYPE, or LOAD MOB command. This
command does not change the current mob designation, nor does it change the
location of either mob.

TAKE BEHAVIOR [BEHAVIOR ID] - The behavior ID must be a valid behavior class
name. This command will take from the most recently designated mob, item, area,
room or mobgroup (designated using the set or load commands), itemgroup, or
roomgroup the above behavior.

TAKE ABILITY [ABILITY ID] - The ability ID must be a valid ability class name.
This command will take from the currently designated mob, or mobgroup
(designated using the set or load commands) the above ability. The parameters
above are optional, and include any text that would be valid for the ability id
specified.

TAKE AFFECT [ABILITY ID] - The ability ID must be a valid ability class name.
This command will take from the currently designated mob, item, room, area, or
mobgroup (designated using the set or load commands), itemgroup, or roomgroup
the above affect.

RESET- If a ROOM has been designated using SET ROOM, or by any other previously
described method, this command will cause that room to reset, or re-load from
the database. If a ROOM is not currently set (or has been unset), but a
ROOMGROUP or an AREA has been set, this command will cause all rooms in that
set (respectively) to reload from the database. Doing either can be somewhat
time consuming, and may disrupt any players in the rooms affected, as it will
cause items to vanish from the floor, and make players and mobs unable to move
until the process is completed.

<SCRIPT> - This designates the beginning of embedded Javascript in your quest
script. The end is designated by a corresponding </SCRIPT> tag on its own
line. See the next section for more details.

LOAD= ([QUEST FILE]) ([ARGUMENT] ... [ARGUMENT]) - This command will cause the
specified external quest script file to be loaded and executed as if it were
embedded at the current point in the script. The quest filename is of the
same format mentioned above. When LOAD= is used as a command inside a script,
you can also specify one or more space-delimited arguments which will be
accessible inside the target quest script as Object Specifiers. The first
argument given, whether it is itself an Object Specifier, or a simple string,
will be accessible inside the target quest script as ARG1, the second as ARG2,
and so forth. A special case exists, however, if one of the arguments
evaluates to an Object Specifier which represents a group of objects (such as
MOBGROUP or ITEMGROUP). If that case occurs, the LOAD= command will execute
once for every object inside the group! See the discussion of Object Specifiers
and Object Spcifiers in Parameters for more information.

<OPTION> ([QUEST SCRIPT COMMANDS]) </OPTION> - Putting quest script commands
inside of <OPTION> tags means that, for every execution of the quest script,
only ONE of the <OPTION> tags will be have their script commands executed. The
one chosen will be selected at random. If only one <OPTION> tag exists, it
will be chosen every time, of course.

* Note About #. In a quest script, anywhere the # sign is used above (such as
[#TICKS] or [#PLAYERS], you may enter a normal old every day number (34) or you
may enter a valid arithmetic expression using real or integer numbers and any
of the following operators: + - * () ?

* Object Specifiers. Many of the SET ... commands, such as SET MOBGROUP, SET
MOB, SET ITEMGROUP, SET ROOM, etc, have forms which allow you to designate
their value using an [OBJECT] string. An [OBJECT] string is one of the
following basic quest-script values: "LOADEDMOBS", "LOADEDITEMS", "AREA",
"ROOM", "MOBGROUP", "ITEMGROUP", "ROOMGROUP", "ITEM", "ENVOBJ", "STUFF", "MOB",
or one of the following mystery quest-script values: "FACTION",
"FACTIONGROUP", "AGENT", "AGENTGROUP", "ACTION", "ACTIONGROUP", "TARGET",
"TARGETGROUP", "MOTIVE", "MOTIVEGROUP", "WHEREHAPPENED", "WHEREHAPPENEDGROUP",
"WHEREAT", "WHEREATGROUP", "WHENHAPPENED", "WHENHAPPENEDGROUP", "WHENAT",
"WHENATGROUP", "TOOL", "TOOLGROUP". Using the SET command in this way allows
you to either COPY an objects value, or re-designate it for the purposes of one
of the GIVE ... commands. If the quest script was executed from inside of
another using the LOAD= script command, and arguments were specified from the
above objects, you may also have access to argument object specifiers, such as
ARG1, ARG2, ... ARGN. There will be one such object specifier available for
each argument passed to the script. Please note that some object specifiers
return single objects (such as MOB, ITEM, ROOM) and some return collections of
objects (such as ROOMGROUP, MOBGROUP, ITEMGROUP). Object specifiers can also
be combined using + and - characters. For instance, MOBGROUP-MOB would return
the group of mobs in the MOBGROUP minus the specified MOB while the specifier
MOB+ITEM would refer to an object group containing both the specified MOB and
the specified ITEM.

* Object Specifiers in Parameters. When specifing parameters for the GIVE
BEHAVIOR, GIVE ABILITY, or GIVE AFFECT command, you may embed the names of one
or more of the Object Specifiers by prefixing the Object Specifier code string
with a $ character, and concluding it with a space or other non-alphanumeric
character. For instance, the command: "give script GREET_PROG 100; say I love
$MOB!!!;~;" would embed the name string for the MOB object specifier inside the
in-line script. In addition to this capability, you may also put a special
character after the $ and before the object specifier to manipulate how the
name of the object is generated. Special characters are: '_' (to make the name
in uppercase), '&' to remove any prefixed english article words from the name,
or '|' to replace all spaces in the name with | characters (which is very
useful for QuestChat parameters).

Mystery Objects in Quest scripts:

In addition to the normal quest objects mentioned above, such as MOB, ITEM,
ROOM and so forth, there are also extranous objects and groups intended for use
when building logic problem mysteries. The commands for setting these are as
follows:

SET AGENT [OBJECT] - Sets the AGENT variable to the [OBJECT]. Will also set
the MOB object. See Object Specifiers above this command listing. If the
object resolves to a group of objects, a random one from the group will be
chosen.

SET AGENTGROUP [OBJECT] - Sets the AGENTGROUP variable to the [OBJECT]. Will
also set the MOBGROUP object to the same, as well as designate one random mob
from the group as the AGENT and the MOB. See Object Specifiers above this
command listing.

SET AGENTGROUP [#NUMBER] - Sets the AGENTGROUP variable to the currently set
MOBGROUP, selecting at most NUMBER mobs randomly from that list. Will also set
the MOBGROUP object to the same, as well as designate one random mob from the
group as the AGENT and the MOB. See Object Specifiers above this command
listing.

SET WHEREHAPPENED [OBJECT] - Sets the WHEREHAPPENED variable to the [OBJECT].
Will also set the ROOM object. See Object Specifiers above this command
listing. If the object resolves to a group of objects, a random one from the
group will be chosen.

SET WHEREHAPPENEDGROUP [OBJECT] - Sets the WHEREHAPPENEDGROUP variable to the
[OBJECT]. Will also set the ROOMGROUP object to the same, as well as designate
one random room from the group as the WHEREHAPPENED and the ROOM. See Object
Specifiers above this command listing.

SET WHEREHAPPENEDGROUP [#NUMBER] - Sets the WHEREHAPPENEDGROUP variable to the
currently set ROOMGROUP, selecting at most NUMBER rooms randomly from that
list. Will also set the ROOMGROUP object to the same, as well as designate one
random room from the group as the WHEREHAPPENED and the ROOM. See Object
Specifiers above this command listing.

SET WHEREAT [OBJECT] - Sets the WHEREAT variable to the [OBJECT]. Will also
set the ROOM object. See Object Specifiers above this command listing. If
the object resolves to a group of objects, a random one from the group will be
chosen.

SET WHEREATGROUP [OBJECT] - Sets the WHEREATGROUP variable to the [OBJECT].
Will also set the ROOMGROUP object to the same, as well as designate one random
room from the group as the WHEREAT and the ROOM. See Object Specifiers above
this command listing.

SET WHEREATGROUP [#NUMBER] - Sets the WHEREATGROUP variable to the currently
set ROOMGROUP, selecting at most NUMBER rooms randomly from that list. Will
also set the ROOMGROUP object to the same, as well as designate one random room
from the group as the WHEREAT and the ROOM. See Object Specifiers above this
command listing.

SET WHENHAPPENED [OBJECT] - Sets the WHENHAPPENED variable to the timeclock
[OBJECT]. See Object Specifiers above this command listing. If the object
resolves to a group of objects, a random one from the group will be chosen.

SET WHENHAPPENED [#HOURS-DIFFERENCE] - Sets the WHENHAPPENED variable to the
current time plus or minus the hours difference specified. See Object
Specifiers above this command listing. If the object resolves to a group of
objects, a random one from the group will be chosen.

SET WHENHAPPENEDGROUP [OBJECT] - Sets the WHENHAPPENEDGROUP variable to the
[OBJECT]. Will also designate one random time from the group as the
WHENHAPPENED. See Object Specifiers above this command listing.

SET WHENHAPPENEDGROUP [#HOURS-DIFFERENCE] ... [#HOURS-DIFFERENCE] - Sets the
WHENHAPPENEDGROUP list to the current time plus or minus the list of
hours-differences given. Will also designate one random time from the group as
the WHENHAPPENED. See Object Specifiers above this command listing.

SET WHENAT [OBJECT] - Sets the WHENHAPPENED variable to the timeclock [OBJECT].
See Object Specifiers above this command listing. If the object resolves to
a group of objects, a random one from the group will be chosen.

SET WHENAT [#HOURS-DIFFERENCE] - Sets the WHENAT variable to the current time
plus or minus the hours difference specified. See Object Specifiers above this
command listing. If the object resolves to a group of objects, a random one
from the group will be chosen.

SET WHENATGROUP [OBJECT] - Sets the WHENATGROUP variable to the [OBJECT]. Will
also designate one random time from the group as the WHENAT. See Object
Specifiers above this command listing.

SET WHENATGROUP [#HOURS-DIFFERENCE] ... [#HOURS-DIFFERENCE] - Sets the
WHENATGROUP list to the current time plus or minus the list of
hours-differences given. Will also designate one random time from the group as
the WHENAT. See Object Specifiers above this command listing.

SET FACTION [OBJECT] - Sets the FACTION variable to the faction string
[OBJECT]. See Object Specifiers above this command listing. If the object
resolves to a group of objects, a random one from the group will be chosen.

SET FACTION [FACTION NAME] - Sets the FACTION variable to one of the given name
or ANY to choose a random one.

SET FACTIONGROUP [OBJECT] - Sets the FACTIONGROUP variable to the [OBJECT].
Will also designate one random faction from the group as the FACTION. See
Object Specifiers above this command listing.

SET FACTIONGROUP [#NUMBER] - Sets the FACTIONGROUP variable to NUMBER random
factions, or ALL to set it to all of them. Will also designate one random
faction from the group as the FACTION. See Object Specifiers above this
command listing.

SET FACTIONGROUP [FACTION NAME] ... [FACTION NAME] - Sets the FACTIONGROUP
variable to the set of factions designated by the faction names. Will also
designate one random faction from the group as the FACTION. The faction names
are space delimited, and names grouped with double-quotes.

SET TARGET [OBJECT] - Sets the TARGET variable to the [OBJECT]. Will also set
the MOB or ITEM object depending on what gets designated. See Object
Specifiers above this command listing. If the object resolves to a group of
objects, a random one from the group will be chosen.

SET TARGETGROUP [OBJECT] - Sets the TARGETGROUP variable to the [OBJECT]. Will
also set the MOBGROUP or ITEMGROUP object to the same (depending on what type
of group is designated), as well as designate one random object from the group
as the TARGET, and either the MOB or ITEM. See Object Specifiers above this
command listing.

SET TARGETGROUP [#NUMBER] - Sets the TARGETGROUP variable to the currently set
MOBGROUP (if one is currently set) or ITEMGROUP if not. It will select at most
NUMBER objects randomly from that list. Will also re-set the MOBGROUP or
ITEMGROUP object to the same, as well as designate one random mob or item from
the group as the TARGET and either the MOB or ITEM. See Object Specifiers
above this command listing.

SET TOOL [OBJECT] - Sets the TOOL variable to the [OBJECT]. Will also set the
MOB or ITEM object depending on what gets designated. See Object Specifiers
above this command listing. If the object resolves to a group of objects, a
random one from the group will be chosen.

SET TOOLGROUP [OBJECT] - Sets the TOOLGROUP variable to the [OBJECT]. Will
also set the MOBGROUP or ITEMGROUP object to the same (depending on what type
of group is designated), as well as designate one random object from the group
as the TOOL, and either the MOB or ITEM. See Object Specifiers above this
command listing.

SET TOOLGROUP [#NUMBER] - Sets the TOOLGROUP variable to the currently set
MOBGROUP (if one is currently set) or ITEMGROUP if not. It will select at most
NUMBER objects randomly from that list. Will also re-set the MOBGROUP or
ITEMGROUP object to the same, as well as designate one random mob or item from
the group as the TOOL and either the MOB or ITEM. See Object Specifiers above
this command listing.

SET MOTIVE [OBJECT] - Sets the MOTIVE variable to the string [OBJECT]. See
Object Specifiers above this command listing. If the object resolves to a
group of objects, a random one from the group will be chosen.

SET MOTIVE [STRING] - Sets the MOTIVE variable to the string.

SET MOTIVEGROUP [OBJECT] - Sets the MOTIVEGROUP variable to the [OBJECT]. Will
also designate one random string from the group as the MOTIVE. See Object
Specifiers above this command listing.

SET MOTIVEGROUP [STRING] .. [STRING] - Sets the MOTIVEGROUP to the set of
strings specified. Will also designate one random string from the group as the
MOTIVE. The strings are space delimited, and words grouped with double-quotes.

SET ACTION [OBJECT] - Sets the ACTION variable to the string [OBJECT]. See
Object Specifiers above this command listing. If the object resolves to a
group of objects, a random one from the group will be chosen.

SET ACTION [STRING] - Sets the ACTION variable to the string.

SET ACTIONGROUP [OBJECT] - Sets the ACTIONGROUP variable to the [OBJECT]. Will
also designate one random string from the group as the ACTION. See Object
Specifiers above this command listing.

SET ACTIONGROUP [STRING] .. [STRING] - Sets the ACTIONGROUP to the set of
strings specified. Will also designate one random string from the group as the
ACTION. The strings are space delimited, and words grouped with double-quotes.

Final notes: This stuff may seem complicated, but just make sure you carefully
examine the sample quests found in the CoffeeMud resources directory! Also,
remember that quest script errors are always sent out to your mud.log, so check
their often when starting up a new quest!.

RECORD


Skill : Record
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : RECORD
Usage : RECORD [PLAYER NAME]
Example : record gunther
From anywhere on the map, the player with this skill can begin recording all
activity of the target to a file in the local file system as if they were
snooping them.

RESET

Command  : RESET
Usage : RESET (REJUV) ROOM/AREA (ITEMS/MOBS)
Usage : RESET MOBSTATS ROOM/AREA/WORLD/CATALOG (NOSAVE) ([AREANAME])
Usage : RESET ITEMSTATS ROOM/AREA/WORLD/CATALOG (NOSAVE) ([AREANAME])
Usage : RESET INIFILE
Example : reset room
Example : reset area
Example : reset rejuv area items
Example : reset mobstats world
Example : reset itemstats catalog nosave midgaard
Short(s) :
The reset room or area command will revive any wandered or dead mobs whose
location is the same as the invokers. Any removed items which are resettable
will also return. Any items or mobs which do not belong in the location will
be returned to their proper homes.

The reset rejuv room or area command will revive any dead mobs or resettable
items at the location of the invoker. Mobs that have wandered away will not be
returned. No other mobs or items in the room will be affected.

The reset itemstats and reset mobstats commands serve a similar purpose. Both
will modify the vital statistics of all the mobs or items in the room, area,
world, or catalog specified. The statistics will be "normalizations" of vital
combat scores based on the mob or items level, and the game engine's definition
of nominal ratings for that level. They will allow a "preview" of changes to
be made by specifying the "nosave" parameter on the command line, which
prevents permanent changes. Area names may also be specified on the command
line to cause the command to skip certain areas (for use with WORLD parameter
only).

You can also reload your ini settings, or the lists.ini file using reset
inifile.

RESTRING

Command : RESTRING
Usage : RESTRING [ITEM NAME]
Example : restring longsword
Example : restring "longsword@an orc"
Short(s):
This command is a weak for of MODIFY. It allows you to modify an items name,
display text, and description.

SAVE

Command : SAVE
Usage : SAVE [ROOM, QUESTS, MOBS, ITEMS, USERS]
Example : save room
Short(s):
A command to permanently save the contents of a room, the mobs in the room, the
current quests list, or the users who are logged in. The command will apply to
the room in which your Character is located.

SECURITY

SECURITY in CoffeeMud is on a player by player basis.  
SYSOP status is defined as the ultimate security to do anything, anywhere, at
any time. Access to all commands in all areas will be available. SYSOP status
is defined in the CoffeeMud ini file entry SYSOPMASK which establishes the
player characteristics that designate SYSOPS. All players who meet the
requirements of the mask are automatically SYSOPS.

Players who are not SYSOPS may also be granted specific privileges. Each of
the privileges may be limited to specific areas, or available globally.
Privileges are defined in the Security section of a players settings. Each
security code listed for a player may be either a list of security Groups, or a
specific security code.

Security GROUPS are also defined in the ini file. A Security GROUP consists of
a group name, and a set of strings or codes representing privileges for that
group. Each group is prefixed in the INI file with the "GROUP_". However, you
should not use the "GROUP_" when adding group priviledges to the Security field
of a player. For instance, if you have "GROUP_BUILDER" defined in the INI
file, then you would add "BUILDER" to Security when modifying a player in order
to make that user part of the BUILDER group. The security codes which make up
each group are implicitly global, but can be qualified as area-only using the
keyword "AREA".

The following are the default strings or codes which, when found in a players
security settings or in a group definition, confer the listed privileges. Each
of these settings may be entered as listed below, or prefixed with the word
"AREA" followed by a space, followed by the key. This has the effect of making
that privilege only available in or at areas where the Player is listed in the
areas "Staff" setting. For example, the security code "ANNOUNCE" by itself
confers the global ability to use the ANNOUNCE command. The security code
"AREA ANNOUNCE" means that the ANNOUNCE command can only be used inside areas
where the player is listed as Staff.


ABOVELAW=Immunity to the Arrest behavior.
AFTER=The ability to use the command of the same name.
AHELP=The ability to access administrative help files.
ALLSKILLS=This code gives the player access to ALL skills,songs,prayers,spells
at their next login.
ANNOUNCE=The ability to use the command of the same name.
AS=The ability to use the command of the same name.
AT=The ability to use the command of the same name.
BAN=The ability to use the command of the same name, as well as DESTROY BAN,
LIST BAN, and access the BAN MUDGrinder feature.
BEACON=The ability to use the command of the same name.
BOOT=The ability to use the command of the same name.
CHARGEN=The ability to use the command of the same name.
CLOAK=The ability to use the command of the same name, as well as see those who
are cloaked.
CMDAREAS=The ability to Create, Modify, and Destroy areas. Also gains access
to the MUDGrinder area tool.
CMDCLANS=The ability to Modify or Destroy clans.
CMDCLASSES=The Ability to Create, Modify, Destroy custom classes.
CMDABILITIES=The Ability to Create, Modify, Destroy custom abilities.
CMDEXITS=The Ability to Create, Modify, Link, Unlink, or Destroy exits.
CMDITEMS=The Ability to Create, Modify, Destroy items in rooms.
CMDMOBS=The Ability to Create, Modify, Destroy mobs in rooms. This code also
prevents Mobile mobs from wandering away and confers other similar priviledges.
CMDRECIPES=The Ability to Create, Modify, Destroy Common Skill recipe items.
CMDPLAYERS=The Ability to Modify or Destroy players. Also has the ability to
view Player settings in the MUDGrinder.
CMDQUESTS=The Ability to Create, Modify, Destroy quests. Also has the ability
to access the quests and file editors in the MUDGrinder.
CMDRACES=The Ability to Create, Modify, Destroy custom races.
CMDFACTIONS=The Ability to Create, Modify, and Destroy factions.
CMDROOMS=The ability to Create, Modify, and Destroy rooms. Also gains access
to the MUDGrinder area tool.
CMDSOCIALS=The Ability to Create, Modify, Destroy socials.
COMPONENTS=The Ability to Create, Modify, Destroy spell/skill components.
EXPERTISE=The Ability to Create, Modify, Destroy spell/skill expertises.
TITLES=The Ability to Create, Modify, Destroy player auto-titles.
CARRYALL=Overrides item carrying restrictions.
CATALOG=The ability to use the catalog command of mobs and items.
COPYITEMS=The Ability to copy existing items.
COPYMOBS=The Ability to copy existing items.
COPYROOMS=The ability to copy existing rooms.
DUMPFILE=The ability to use the command of the same name.
EXPORT=The ability to export mobs, items, or rooms.
EXPORTFILE=The ability to export to a file. Requires EXPORT or EXPORTPLAYERS.
EXPORTPLAYERS=The ability to export player data.
FS: <path>=The ability to read/write files in the local path given. No
preceding / chars!
GMODIFY=The ability to use the command of the same name.
GOTO=The ability to use the command of the same name, as well as walk through
doors.
IDLEOK=This code makes the player exempt from any idletimer settings from the
coffeemud.ini file.
I3=The ability to manage the CHANNELS aspect of I3.
IMMORT=Players with this code never ever die.
IMPORTITEMS=The ability to import items into a room.
IMPORTMOBS=The ability to import mobs into a room.
IMPORTPLAYERS=The ability to import players from a file.
IMPORTROOMS=The ability to import rooms or areas from a file.
JOURNALS=The ability to administer all journals.
JSCRIPTS=The ability to approve javascript in Scriptabler behaviors.
KILLASSIST=The ability to LIST and DESTROY entries in the ASSIST list.
KILLBUGS=The ability to LIST and DESTROY entries in the BUG list.
KILLDEAD=The ability to kill anyone by entering 'kill [name] dead'
KILLIDEAS=The ability to LIST and DESTROY entries in the IDEAS list.
KILLTYPOS=The ability to LIST and DESTROY entries in the TYPOS list.
LISTADMIN=The ability to LIST ticks, the log, reports, or threads.
LOADUNLOAD=The ability to load and unload resources. Also gains access to
resource manager in MUDGrinder.
MERGE=The ability to merge mob or item changes from a file or database.
MXPTAGS=The ability to insert MXP tags using the ^< ^> ^& syntax.
NOEXPIRE=This character never expires, but always remains active.
NOPURGE=The ability to add, LIST, or DESTROY entries on the NOPURGE list.
ORDER=The ability to order mobs around. Also grants the ability to GIVE
without failure, and use Take and Dress without failure. The global version of
this code also allows ordering players.
PKILL=The ability to override PKILL flag settings.
POSSESS=The ability to use the command of the same name.
PURGE=The ability to use the command of the same name.
RESET=The ability to use the command of the same name as it applies to rooms or
areas.
RESETUTILS=The ability to use the command of the same name as it applies to the
miscellaneous RESET tools.
RESTRING=The ability to use the command of the same name.
SESSIONS=The ability to use the command of the same name.
SHUTDOWN=The ability to use the command of the same name.
SNOOP=The ability to use the command of the same name.
STAT=The ability to use the command of the same name.
SUPERSKILL=This code makes it impossible for the player to fumble a spell or
skill that they have.
SYSMSGS=The ability to use the command of the same name.
TASKS=The ability to ADD, LIST and DESTROY entries in the TASKS list.
TICKTOCK=The ability to use the command of the same name.
TRAILTO=The ability to use the command of the same name.
TRANSFER=The ability to use the command of the same name.
VFS: <path>=The ability to read/write files in the vfs path given. No preceding
/ chars!
WHERE=The ability to use the command of the same name.
WIZINV=The ability to use the command of the same name, as well as see those
who are WIZINV.

Here is an example Security setting for a player:
Security: BUILDER, AREA GOTO, SNOOP, VFS: RESOURCES/TEXT/
The above would give a player access to the BUILDER group defined by
GROUP_BUILDER in your INI file. It would also give access to the GOTO command,
but only insofar as it relates to areas where the player is listed as Staff.
Lastly, it gives global access to the Snoop command.

SHELL

Command : SHELL
Usage : SHELL [COMMAND] [PARAMETERS]
Example : shell
Example : shell ?
Example : shell directory
Example : shell cd /resources/text
Example : shell copy thisfile.txt ::
Example : shell del ::thisfile.txt
Example : shell edit thisfile.txt
Short(s): .
This command allows the archon, and users with appropriate FS: and/or VFS:
security flags to access the file system and/or the virtual file system. See
help on CMFS or VFS for the difference between the two.

The commands are case-insensitive, except where dealing with the local file
system, where it may be case-sensitive depending upon the host system. As
mentioned in the CMFS docs, filenames and paths may be preceded by a :: string
to denote forced VFS access, or // to denote forced local file-system access.
When neither is specified for a given shell command, the VFS file is always
preferred. The / character is always used to separate directory paths and
folders, such as /resources/text/down.txt would refer to the file down.txt in
the text folder, which in turn is in the resources folder, which in turn is
located in the root directory.

The shell command may be entered with no parameter to see the players current
directory. When viewing directories, a "-" character will precede a file which
exists only in the VFS system. A "+" character will precede a file which
exists in both the local file system and the VFS system. Since folders always
exist in the VFS, they will always be seen with the "+" character preceding
them.

The shell command can be used to create directories, delete files or
directories, copy files, search for files with given names, search inside text
files for a text string, display a text file, or edit a text file. Many
commands support a mask to limit the files displayed. The mask may include "*"
characters anywhere in the string to match 0 or more unknown characters in the
filenames. A "?" character always matches a single unknown character in a
filename.

See HELP CMFS for more information on CoffeeMuds file system.

SHUTDOWN

Command : SHUTDOWN
Usage : SHUTDOWN (IN [NUMBER] [MINS/HOURS..]) (RESTART) (NOPROMPT)
Example : shutdown
Example : shutdown noprompt
Example : shutdown in 10 minutes restart
Short(s):
With no argument, this command will bring down the CoffeeMud server. With the
restart argument, it will "bounce" (restart) the server. You can also specify
how long before the shutdown will begin. This will also cause periodic
warnings to your players.

SNOOP

Command : SNOOP
Usage : SNOOP [TARGET NAME]
Example : snoop player
Short(s):
This command will allow you to watch a player play -- seeing everything they
type in, and everything they read on their screen.

STAT

Command : STAT
Usage : STAT ((SKILL TYPE) [TARGET NAME])/([NUMBER] [DAYS/WEEKS/MONTHS/YEARS]
(/SKILLUSE/QUEST))
Example : stat
Example : stat 2 weeks
Example : stat tom
Example : stat equipment bob
Example : stat combat bob
Example : stat inventory bob
Example : stat questwins bob
Example : stat tattoos bob
Example : stat titles bob
Example : stat scripts bob
Example : stat roomsexplored bob
Example : stat factions bob
Example : stat spell bob
Example : stat skill hassan
Example : stat chant hassan
Example : stat prayer hassan
Short(s):
This command serves two purposes. The first is to allow you to view a usage
statistics report on your mud. Entering STAT alone allows you to see
information gathered since midnight. You may also enter a number and a scale
(days, weeks, months, or years) to view information going farther back.

STAT will also allow you to retreive basic stat information on a player or mob
in the game. Entering STAT and the players name brings up the most basic SCORE
information. Including a skill type before the name will list their abilities
of that type. Valid skill types include: SKILL, SPELL, PRAYER, SONG, TRAP,
PROPERTY, "THIEF SKILL", LANGUAGE, CHANT, "COMMON SKILL", DISEASE, POISON. You
can also get special reports by entering one of the following before the name:
EQUIPMENT, COMBAT, INVENTORY, QUESTWINS, TATTOOS, TITLES, SCRIPTS,
WORLDEXPLORED, AREASEXPLORED, ROOMSEXPLORED, FACTIONS

STINKIFY


Skill : Stinkify
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : STINKIFY
Usage : STINKIFY [PLAYER NAME]
Example : stinkify gunther
From anywhere on the map, the player with this skill can cause the target to
become 1 level stinkier than they were before.

SYSMSGS

Command : SYSMSGS
Usage : SYSMSGS
Example : sysmsgs
Short(s):
A command to toggle debug mode, or extended messages. A mobile NPC will not be
able to enter or leave a room if a player in this mode is present.

TAKE

Command : TAKE
Usage : TAKE (ALL) [ITEM NAME] ([MOB NAME])
Example : take all dagger Horice
Example : take qp Horice
Example : take all Horice
Example : take pie Horice
Short(s):
This is A command that forces the specified mob or character to give item that
is in his or her inventory or equipment to you. If the item is inside a
specified container, it will be retreived from the container. The very special
item name "qp" may be used to take Quest Points from players using this
command.

TASK

Command : TASK
Usage : TASK [MESSAGE]/REVIEW (STARTING MSG)
Example : task nothing is spelled right in this room!
Example : task review
Example : task review 7
Short(s):
This command can be used to submit builder tasks to the system. When the
REVIEW parameter is given, the tasks will be iterated through one at a time to
give the builder a chance to delete, comment on, or email each one. An
optional starting number can be given to REVIEW. The player must be either an
Archon, or a player with the TASKS security string to use this feature.

TATTOO

Tattoo's are intended to act as miscellaneous flags which players may obtain,
not unlike a quest point. These tattoo's can then be checked for as
requirements to enter rooms or exits, or to possess certain items.
An example would be like this: The completion of a specific quest occurs when
Gunther defeats the evil sorcerer Nunder and enters his inner chamber (where
all the treasure is hidden). Entering this inner chamber automatically grants
Gunther a Tatto called "NUNDERKILLER". Now, elsewhere in the realm is the
second quest where Nunder's apprentice has escaped with an ancient artifact and
is up to no good. However, to even ENTER the area where Nunder's apprentice is
operating, the system (via the Prop_ReqTattoo property on this other Area)
requires that Gunther already have the "NUNDERKILLER" Tattoo. If Gunther had
not defeated Nunder and obtained the "NUNDERKILLER" Tattoo, he would not be
allowed into the realm of Nunder's apprentice.

TICKTOCK

Command : TickTock
Usage : [NUM HOURS]/CLANTICK/[THREAD NAME]
Example : ticktock 10
Example : ticktock -4
Example : ticktock CLANTICK
Example : ticktock THPLAYERS0
Advance the time by specified number of hours, or cause one of the specified
maintenance threads to immediately go through a cycle. Use LIST REPORTS to get
a list of maintenance threads.

TRAILTO

Command : TRAILTO
Usage : TRAILTO (CONFIRM) (AREANAMES) (IGNOREROOMS=[ROOMS LIST]) [AREA NAME]
/[ROOM ID] /EVERYROOM /EVERYAREA
Example : trailto MyArea#394
Example : trailto everyarea
Example : trailto confirm areanames "ignorerooms=myarea#10,myarea#20" everyarea
Short(s):
This command shows the directions one must travel to get from their current
position to the destination given.

TRANSFER

Skill    : TRANSFER
Usage : TRANSFER [ALL/[MOB NAME]/"ITEMS X"] [ROOM ID/DESC/MOB/AREA]
Example : transfer all Midgaard#3001
Example : transfer all midgaard
Example : transfer all north
Example : transfer bob #3001
Example : transfer smurf hassan
Example : transfer bobbyjoe temple of mota
Example : transfer "item sword" north
Example : transfer "all item sword" north
Example : transfer "all items" north
Short(s) :
The targets and their followers will be transported, with very little fanfare,
to the destination listed. This ability is not magical in nature, and is thus
not affected by no-teleport areas and rooms. If all or item is used, it will
refer only to those in the same room as the admin. Otherwise, the admins
present area will be checked for all instances of the name and transfers all of
them. If none are found in the same area, the whole world will be checked.

TYPO

Command : TYPO
Usage : TYPO [MESSAGE]/REVIEW (STARTING MSG)
Example : typo nothing is spelled right in this room!
Example : typo review
Example : typo review 7
Short(s):
This command can be used to submit typos to the system. When the REVIEW
parameter is given, the typos will be iterated through one at a time to give
the archon a chance to delete, comment on, or email each one. An optional
starting number can be given to REVIEW.

UNLINK

Command : UNLINK
Usage : UNLINK [DIRECTION]
Example : unlink north
Short(s):
A command for the unlinking of rooms from each other.

UNLOAD

Command  : UNLOAD
Usage : UNLOAD HELP/CLASS/USER/FACTION
Usage : UNLOAD INIFILE/ALL/[RESOURCE NAME]
Example : unload help
Example : unload all
Example : unload armorsmith
Example : unload class Thief_Search
Example : unload user joe
Short(s) :
Unloads most resource text, cached users, class objects, coffeemud.ini,
lists.ini, and help files for easy refreshing.

VFS

VFS Refers specifically to those files in the CMFS (CoffeeMud File System)
which are stored in your database, as opposed to directly in your local file
system (hard drive). VFS files are also mentioned to distinguish between local
files, although VFS files appear to CoffeeMud to be right along side, or even
on top of, your local files in your local directories. VFS can even include
its own directories which are not in your local file system. See HELP CMFS for
more information on this topic.

WHERE

Command : WHERE
Usage : WHERE (AREA) (ROOM/MOB/ITEM/MOBMASK/ITEMMASK) ([MASK])
Example : where
Example : where dog
Example : where area item knife
Example : where area mobmask -race +orc -levels +>=10
Example : where !
Short(s):
Without an argument, this command displays the names and locations of all
players online. With the ROOM, MOB, ITEM, or no argument, it will show all
mobs, rooms, and/or items the match the given key words in the mask, along with
room locations. With the MOBMASK, ITEMMASK arguments, it will show all mobs or
items that match the given Zapper Mask (See ZAPPERMASKS). The arguments may be
qualified with AREA to show only the Archons current area. The argument ! will
show the mundane/player version of the WHERE command.

WIZEMOTE

Command : WIZEMOTE
Usage : WIZEMOTE [ALL/HERE/ROOM NAME/AREA NAME/CLAN NAME/PLAYER NAME] message
Example : wizemote all You are having fun!
Example : wizemote here We are having fun!
Example : wizemote bob You are having more fun though.
Example : wizemote "Death Area" Something bad happened here!
Example : wizemote "Death Area#5320" Something bad happened there!
Example : wizemote "The Artisans" Something bad happened to your clan!
Short(s):
A command to send emote-type messages to everyone in an area, a room, a clan,
or to a specific player, or to everyone everywhere.

WIZINFO

Command : WIZINFO
Short(s):
The automatic information channel available to admins and area admins. Turned
off with NOWIZINFO

WIZINV

Skill    : WIZARD INVISIBILITY
Usage : WIZINV (OFF/NOCLOAK)
Example : wizinv
Example : wizinv nocloak
Short(s) :
Wizard Invisibility makes the invoker completely undetectable by other mobs or
players. In addition, the invoker will not hunger or thirst, may pass through
any terrain unhindered (except doors), and is invulnerable to sleep spells.
Lastly, unless the nocloak parameter is specified, the Archon is completely
cloaked as per the CLOAK command.

WRATH


Skill : Wrath
Domain : Archon
Use Cost : Movement (51)
Quality : Malicious
Targets : Creatures
Range : Touch - Range 1
Commands : WRATH
Usage : WRATH [PLAYER NAME] (!)
Example : wrath gunther
Example : wrath gunther !
From anywhere on the map, the player with this skill can immediately knock
another mob out of their shoes, depriving them of half of their hit points,
mana, and movement in the process. If the "!" flag is added, an announcement of
the wrath will also be made.

XML

Command  : 
Usage : By MUDGrinder only
Example :
Short(s) :
This command exist to fascillitate the transfer of information between
MUDGrinder and CoffeeMud. Do not use this command for any reason.

ZAPPERMASKS

+SYSOP (allow archons to bypass the rules)  
-SYSOP (always disallow archons)
+SUBOP (allow archons or area staff to bypass the rules)
-SUBOP (always disallow archons and area staff)
-PLAYER (disallow all players)
-MOB (disallow all mobs/npcs)
-CLASS (disallow all classes)
-CLASS +thief +mage +ranger (create exceptions)
-BASECLASS (disallow all base classes)
-BASECLASS +thief +mage +ranger (create exceptions)
-thief -mage -ranger (disallow only listed classes)
-RACE (disallow all races)
-RACE +elf +dwarf +human +half +gnome (create exceptions)
-elf -dwarf -human -half -gnome (disallow only listed races)
-RACECAT (disallow all racial categories)
-RACECAT +elf +insect +humanoid +canine +gnome (create exceptions)
+RACECAT (do not disallow all racial categories)
+RACECAT -elf -insect -humanoid -canine -gnome (create exceptions)
-ALIGNMENT (disallow all alignments)
-ALIGNMENT +evil +good +neutral (create exceptions)
-evil -good -neutral (disallow only listed alignments)
-GENDER (disallow all genders)
-GENDER +male +female +neuter (create exceptions)
-male -female -neuter (disallow only listed genders)
-FACTION (disallow all faction and values, even a lack of faction)
-FACTION +myfactionrange +faction.rangename (create exceptions)
-rangename -faction.rangename (disallow only faction range named)
-TATTOOS (disallow all tattoos, even a lack of a tattoo)
-TATTOOS +mytatto +thistattoo +anytattoo etc.. (create exceptions)
+TATTOOS (do not disallow any or no tattoos)
+TATTOOS -mytattoo -anytatto, etc.. (create exceptions)
-EXPERTISES (disallow all expertises, even a lack of a edus)
-EXPERTISES +myedu +thisedu +anyedu etc.. (create exceptions)
+EXPERTISES (do not disallow any or no expertises)
+EXPERTISES -myedu -anyedu, etc.. (create exceptions)
-SECURITY (disallow all security flags, even a lack of a security)
-SECURITY +cmdrooms +area cmditems etc.. (create exceptions)
+SECURITY (do not disallow any or no expertises)
+SECURITY -cmdrooms +area cmditems, etc.. (create exceptions)
-MOOD +grumpy +normal (disallow all except those with given moods)
+MOOD -grumpy -normal (disallow only those with subtracted moods)
-LEVEL (disallow all levels)
-LEVEL +=1 +>5 +>=7 +<13 +<=20 (create exceptions)
-=1 ->5 ->=7 -<13 -<=20 (disallow only listed levels range)
-NAMES (disallow everyone)
-NAMES +bob "+my name" etc.. (create name exceptions)
+NAMES (do not disallow anyone who has a name)
+NAMES -bob "-my name" etc.. (create name exceptions)
-CLAN (disallow anyone, even no clan)
-CLAN +Killers "+Holy Avengers" etc.. (create clan exceptions)
+CLAN (do not disallow anyone, even non clan people)
+CLAN -Killers "-Holy Avengers" etc.. (create clan exceptions)
-DEITY (disallow anyone, even no deity)
-DEITY +Apollo "+Grothon The Great" etc.. (create deity exceptions)
+DEITY (do not disallow anyone, even non deity worshipping people)
+DEITY -Apollo "-rothon The Great" etc.. (create deity exceptions)
-ANYCLASS (disallow all multi-class combinations)
-ANYCLASS +thief +mage +ranger (exceptions, allow any class)
+ANYCLASS (do not disallow all multi-class combinations)
+ANYCLASS -thief -mage -ranger (exceptions, disallow any class)
-STR X (disallow those with strength greater than X)
+STR X (disallow those with strength less than X)
-INT X (disallow those with intelligence greater than X)
+INT X (disallow those with intelligence less than X)
-WIS X (disallow those with wisdom greater than X)
+WIS X (disallow those with wisdom less than X)
-CON X (disallow those with constitution greater than X)
+CON X (disallow those with constitution less than X)
-CHA X (disallow those with charisma greater than X)
+CHA X (disallow those with charisma less than X)
-DEX X (disallow those with dexterity greater than X)
+DEX X (disallow those with dexterity less than X)
+-ADJSTR...ADJCON (Same as above, but uses current values)
-GROUPSIZE X (disallow those in groups larger than X)
+GROUPSIZE X (disallow those in groups smaller than X)
-AREA (disallow in all areas)
-AREA "+my areaname" etc.. (create exceptions)
+AREA (do not disallow any areas)
+AREA "-my areaname" etc.. (create exceptions)
-HOME (disallow in all home/beacon areas)
-HOME "+my home/beacon areaname" etc.. (create exceptions)
+HOME (do not disallow any home/beacon areas)
+HOME "-my home/beacon areaname" etc.. (create exceptions)
-ITEM "+item name" etc... (disallow only those with an item name)
-WORN "+item name" etc... (disallow only those wearing item name)
-EFFECTS (disallow anyone, even no effects)
-EFFECTS +Sleep "+Wood Chopping" etc.. (create name exceptions)
+EFFECTS (do not disallow anyone, even non effected people)
+EFFECTS -Sleep "-Wood Chopping" etc.. (create name exceptions)
-SKILLS (disallow anyone, even those with no skill)
-SKILLS +Spell_Sleep(75) etc.. (create exceptions with proficiency)
+SKILLS (do not disallow anyone, even non skilled people)
+SKILLS -Spell_Sleep(75) etc.. (create exceptions with proficiency)
-MATERIAL "+WOODEN" etc.. (disallow only items of added materials)
+MATERIAL "-WOODEN" etc.. (Do not disallow items of -materials)
-RESOURCES "+OAK" etc.. (disallow only items of added resources)
+RESOURCES "-OAK" etc.. (Do not disallow items of -resources)
-JAVACLASS "+GENMOB" etc.. (disallow only objects of +java class)
+JAVACLASS "-GENITEM" etc.. (Do not disallow objs of -classes)
-ABILITY X (disallow those with magical ability less than X)
+ABILITY X (disallow those with magical ability greater than X)
-IF <CONDITION> (disallow, unless they meet Scriptable conditions)
+IF <CONDITION> (never disallow anyone who meets Scriptable cond)
-VALUE X (disallow those with value or money less than X)
+VALUE X (disallow those with value or money greater than X)
-WEIGHT X (disallow those weighing less than X)
+WEIGHT X (disallow those weighing more than X)
-ARMOR X (disallow those with armor bonus less than X)
+ARMOR X (disallow those with armor bonus more than X)
-DAMAGE X (disallow those with damage bonus less than X)
+DAMAGE X (disallow those with damage bonus more than X)
-ATTACK X (disallow those with attack bonus less than X)
+ATTACK X (disallow those with attack bonus more than X)
-WORNON "+TORSO" etc.. (disallow only items wearable on +locations)
+WORNON "-NECK" etc.. (Do not disallow items wearable on -locations)
-DISPOSITION "+ISHIDDEN" etc.. (disallow only with +dispositions)
+DISPOSITION "-ISHIDDEN" etc.. (Do not disallow only with sub disp)
-SENSES "+CANSEEDARK" etc.. (disallow only those with +senses)
+SENSES "-CANSEEDARK" etc.. (Do not disallow those with -senses)
-HOUR +X (disallow always, unless the hour is X)
+HOUR -X (disallow those only when the hour is X)
-SEASON +FALL (disallow those only when season is FALL)
+SEASON -SPRING (disallow those whenever the season is SPRING)
-MONTH +X (disallow those only when month number is X)
+MONTH -X (disallow those whenever the month number is X)
-DAY +X (disallow those only when day number is X)
+DAY -X (disallow those whenever the day number is X)
-WEATHER +DROUGHT (disallow those only when weather is DROUGHT)
+WEATHER -BLIZZARD (disallow those whenever the weather is BLIZZARD)
-QUESTWIN "+MY QUEST" (disallow those who have not my MY QUEST)
+QUESTWIN "-MY QUEST" (disallow those who have won MY QUEST)
-SKILLFLAG (disallow anyone, even those with no skills)
-SKILLFLAG +ENCHANTMENT etc.. (create exceptions to -skillflag)
+SKILLFLAG (do not disallow anyone, even non skilled people)
+SKILLFLAG -ENCHANTMENT etc.. (create exceptions to +skillflag)
-CHANCE 50 (disallow the given % of the time)