💾 Archived View for spam.works › mirrors › textfiles › computers › muck.txt captured on 2023-06-14 at 16:04:08.
View Raw
More Information
-=-=-=-=-=-=-
COMMANDS
--------
Terminology:
+ MUCK additon
# Restricted with GOD_PRIV
B Builder command -- may be restricted
P Programmer command -- restricted unless MUCKER_ALL
~ Optional
% Special
@ACTION [+B]
@action <name>=<source>. Creates a new action and attaches it to the
thing, room, or player specified. You may only attach actions you
control to things you control. Creating an action costs 1 penny. The
action can then be linked with the command @LINK.
@ATTACH [+B]
@attach <action>=<new source>. Removes the action from where it was
and attaches it to the new source. You must control the action in
question.
@BOOT [*]
@boot <player>. Disconnects a player from the game. If a player is
connected more than once it affects the most recent connection.
@CHOWN [%]
@chown <object> [=<player>]. Changes the ownership of <object> to
<player>, or if no player is given, to yourself. If the MUCK is
compiled with PLAYER_CHOWN, all players are allowed to take possession
of objects, rooms, and actions, provided the CHOWN_OK flag is set.
Mortals cannot take ownership of a room unless they are standing in
it, and may not take ownership of an object unless they are holding
it. Wizards have absolute power over all ownership.
@CREATE [B]
@create <object> [=<cost>]. Creates a new object and places it in
your inventory. This costs at least ten pennies. If <cost> is
specified, you are charged that many pennies, and in return, the
object is endowed with a value according to the formula ((cost / 5) -
1). Usually the maximum value of an object is 100 pennies, which
would cost 505 pennies to create.
@DESCRIBE
@describe <object> [=<text>]. Sets the description field of <object>
to <text>. If <text> is not specified, the description field is
cleared.
@DIG [B]
@dig <room> [=<parent>]. Creates a new room and sets its parent. If
no parent is given it defaults to the global environment which is
typically room #0. Digging a room costs 10 pennies, and you must be
able to link to the parent room if specified.
@DROP [+]
@drop <object> [=<text>]. Sets the drop field of <object> to <text>.
If <text> is not specified, the drop field is cleared. The drop
message on an object is displayed when you drop it. On an exit, it is
displayed upon entering the destination room. On a player it is
displayed to whoever kills them. On a room, it is displayed when an
object is dropped there.
@DUMP [*]
@dump. Saves the database to disk. This is done automatically every
hour or so, and after an @shutdown.
@EDIT [+P]
@edit <program>. Searches for a program and if a match is found, puts
the player into edit mode. Programs must be created with @PROG.
@FAIL
@fail <object> [=<text>]. Sets the fail field of <object> to <text>.
If <text> is not specified, the fail field is cleared.
@FIND
@find [<string>]. Searches through the entire database for rooms,
things, players, and programs you control, optionally matching their
names to <string> if given. This usually costs at least a penny due
to the computing power involved.
@FORCE [*#]
@force <player>=<command>. Causes the game to process <command> as if
typed by <player>. With the compile option GOD_PRIV, God cannot be
forced by his/her sub-wizards.
@LINK
@link <object1>=<object2> [; <object3>; ... <objectn> ]. Links
<object1> to <object2>, provided you control <object1>, and <object2>
is either controlled by you or linkable. Actions may be linked to
more than one thing, specified in a list separated by semi-colons.
@LIST
@list <program> [=[line1] [-] [line2]]. Lists lines in a program,
provided you control it or it is LINK_OK. Zero, one, or two line
numbers may be specified, denoting the range of lines to list. If no
lines are given, the entire program is listed.
@LOCK
@lock <object>=<key>. Sets the key for <object> to that specified by
<key>. <key> is a full boolean expression, which may contain any of
the characters: ! | & ( ).
@NAME
@name <object>=<name> [<password>]. Sets the name field of <object>
to <name>. <name> cannot be empty; a null name is illegal.
<password> must be supplied to rename a player. Wizards can rename
any player but still must include the password.
@NEWPASSWORD [*#]
@newpassword <player> [=<password>]. Sets the password field of
<player> to <password>. If <password> is not specified, the password
field is cleared. A player with no password cannot rename
him/herself. If GOD_PRIV was defined, nobody can change God's
password.
@ODROP [+]
@odrop <object> [=<text>]. Sets the odrop field of <object> to
<text>. If <text> is not specified, the odrop field is cleared.
Odrop on an object is displayed prefixed by the player's name when
s/he drops that object. On an exit, it is displayed upon a player's
arrival to the destination room (or the location of the destination
player). On a player, it is displayed after the `name killed victim!'
message. On a room, it is displayed when an object is dropped there,
prefixed by the object's name.
@OFAIL
@ofail <object> [=<text>]. Sets the ofail field of <object> to
<text>. If <text> is not specified, the ofail field is cleared.
@OPEN [B]
@open <exit> [=<object> [; <object2>; ... <objectn> ]]. Opens an exit
in the current room, optionally attempting to link it simultaneously.
Opening an exit costs a penny, and an extra penny to link it, and you
must control the room where it is being opened.
@OSUCCESS
@osucc <object> [=<text>]. Sets the osuccess field of <object> to
<text>. If <text> is not specified, the osuccess field is cleared.
@OWNED
@owned [<player>]. Lists everything you own, or Wizards may specify a
player argument. This list includes exits, unlike @FIND.
@PASSWORD
@password <old>=<new>. Change your password.
@PCREATE [*#~]
@pcreate <player>=<password>. This command is only used under the
compile option REGISTRATION. Create a new player named <player> with
<password>.
@PROG [+P]
@prog <program>. Create a new program, or enter edit mode on an
existing one. See @EDIT and Programmer's Reference.
@RECYCLE [+~]
@recycle <object>. Destroy an object and remove all references to it
within the database. The object is then added to a free list, and
newly created objects are assigned from the pool of recycled objects
first. You *must* own the object being recycled, even wizards must
use the @chown command to recycle someone else's belongings.
@SET
@set <object> = [!] <flag> -or-
@set <object> = <property> : [ <string> ] -or-
@set <object> = :
@set does one of three things on TinyMUCK, it can modify flags, add
properties to an object, or remove properties from an object.
Using the first format, you may set flags, which are: WIZARD,
LINK_OK, DARK [DEBUG], FILTER, STICKY [SETUID], or JUMP_OK.
Optional flags which may or may not be on a given site are:
BUILDER, CHOWN_OK, HAVEN, ABODE, or MUCKER.
The second format sets <property> on <object> to <string>, or if <string>
is not given, removes <property>.
The third format removes all properties from an object.
@SHUTDOWN [*]
@shutdown. Dumps the database and shuts the game down.
@STATS
@stats [<player>]. For mortal players, returns the highest number in
the database, which includes garbage that has been generated with
@recycle. For Wizards, gives this number as well as a breakdown of
each type of object: rooms, exits, things, programs, players, and
garbage. Wizards may also specify <player> which returns a similar
display limited to the possessions of <player>.
@SUCCESS
@succ <object> [=<text>]. Sets the success field of <object> to
<text>. If <text> is not specified, the success field is cleared.
@TELEPORT
@teleport <arg1> [=<destination>]. Moves <arg1> to <destination>, if
<destination> is not given, moves you to <arg1>. Wizards may teleport
anything to anywhere, provided it makes sense, and mortals are allowed
to do two things: teleport rooms to change their parent fields, and
the may teleport things to a room they can link to, provided they
control either the thing or its location.
@TOAD [*]
@toad <player>. Turns <player> into a slimy toad, destroying his/her
character and disconnecting him/her from the game.
@TRACE [+]
@trace <object> [=<depth>]. Starts with <object> and traces all
location fields, until the global-environment room is reached or the
optional <depth> is specified. This is generally useful for finding
which rooms are parents in your heirarchy. If you cannot link to a
particular location its name is replaced by stars ***.
@UNLINK [B]
@unlink <action>. Removes any and all destination fields of the
specified <action>.
@UNLOCK
@unlock <object>. Removes any and all locks on the specified
<object>.
@WALL [*]
@wall <message>. Shouts a message to every player in the game.
DROP
drop <object>. Drops the <object> if you are holding it. It moves
the object to the room you are in, unless its STICKY flag is set, or
the room has a drop-to. Programs are much like objects but are not
affected by room droptos or STICKY flags.
EXAMINE examine <object>. If you control <object>, a complete
breakdown of all fields, flags, properties, etc. associated with the
object is displayed. Program-executing fields are displayed as their
true text, rather than executing the program in question. If you do
not control <object>, however, it prints the owner of the object in
question, and, again, displays the true text of the description.
GET
get <object>. Attempts to pick up <object>. The lock on <object> is
checked for a success (true), and the normal path of success/fail is
then taken. On success the object is placed in your inventory.
GIVE
give <player|object>=<amount>. Gives <amount> pennies from your
supply to <player>. Mortals may only give positive amounts and may
not cause a player to have more than 10000 pennies. Wizards do not
affect their penny supplies by giving to others, and may also give
pennies to objects, changing that object's value.
GOTO
goto <direction>. Attempts to find an exit by that name. Goto is
unnecessary and much like LET in Basic (read: silly).
GRIPE
gripe <message>. Sends <message> to the system maintainer.
HELP
help. Displays the help file.
INVENTORY
inventory. Lists the objects you are carrying, as well as how many
pennies you have.
KILL
kill <player> [=<cost>]. A successful kill sends the player home,
sends all objects in the player's inventory to their respective homes.
The probability of killing the player is <cost> percent. Spending 100
pennies always works except against Wizards who cannot be killed.
Players cannot be killed in rooms which have the HAVEN flag set.
LOOK
look <object>. Looks around at the current room, or at <object> if
specified. For players, displays their description and inventory, for
things, their description, and for rooms, their name, description,
succ/fail message, and contents. Also triggers osucc/ofail messages
on rooms. Programs are triggered accordingly on desc/succ/fail
fields.
MOVE
move <direction>. See GOTO.
MAN [+]
man. Displays the programmer's manual or a quick reference.
NEWS
news. Displays the game's news file.
OUTPUTPREFIX
OUTPUTPREFIX [string]. Must be in all capitals, and must be typed in
full. This prints the given string before the output of every
command.
OUTPUTSUFFIX [string]. Must be in all capitals, and must be typed in
full. This prints the given string after the output of every command.
PAGE
page <player> [=<message>]. Costs a penny, and sends your name and
location to <player>, optionally passing them <message> as well. A
player who is set HAVEN cannot be paged, and will not be notified that
you tried.
POSE or :
:<text>. Displays your name, followed by <text>.
PUT
put <object>. See DROP.
QUIT
QUIT. Logs you off the game. Must be typed all capitals.
READ
read [<object>]. Synonym for LOOK.
ROB
rob <player>. Attempts to steal a penny from <player>. The lock on
<player> is checked, and you succeed or fail appropriately. If you
succeed, the message `You stole a penny.' is always displayed.
SAY or "
"<text>. Displays the message, <player> says, "<text>".
SCORE
score. Displays how many pennies you have.
TAKE
take <object>. Synonym for GET.
THROW
throw <object>. Synonym for DROP.
WHISPER
whisper <player>=<message>. Gives <player> a private message,
undetectable by others in the same room.
WHO
WHO [<match>]. List names of the players logged in, and their idle
times. If <match> is specified, only names that start with <match>
are displayed. Must be typed in all capitals.