http:// www.metamage.com / mush / croaker / chapter2.html

Croaker's TinyMUSH Manual

Last update: December 8, 2004

Author: Croaker

Editor: Josh Juran <wanderer@metamage.com>

URL: <http://www.metamage.com/mush/croaker/>


2. Attribute Lists

Attribute lists are what makes MUSH go. Simply stated, they are a place in an object where information can be stored. MUD had attribute lists of a sort, like the description (@desc) or success message (@succ.) There are many more attribute lists in MUSH, and they are much more powerful. Here, they not only store messages, but also commands and numbers.

The attributes are set in the same method as they are in mud, namely:

@attribute object=string

like:

@desc me = A toad.

2.1. New Attributes

In addition to the traditional DESC, FAIL, OFAIL, SUCC, and OSUCC, there are many new attributes in MUSH. In this section we'll only introduce a few new ones, since the others are used for more complex purposes.

There are four new attributes, KILL, OKILL, DROP, and ODROP, which work exactly like the SUCC and OSUCC attributes. The KILL attribute holds a message that will be sent to the killer of an object, while OKILL is displayed to everyone else in the room. DROP holds a message to be sent to the dropper of an object, while everyone else in a room see the ODROP message.

Example: Kill and Okill

My assistant, Mocker...

look me
Mocker(#3506Pc)
You see nothing special.
Last:Mon Jul 23 21:23:03 1990
Carrying:
glass of beer

@kill me = Ow! Hey! What did I ever do to you?
Set.

@okill me = has killed me! That Jerk!
Set.

Now, from my perspective...

Mocker says "Hey Croaker, yer a wimp!"

kill mocker=100
Ow! Hey! What did I ever do to you?
Mocker has left.

From Mocker's...

"Hey Croaker, yer a wimp!
You say "Hey Croaker, yer a wimp!"
Croaker has killed me! That Jerk!
Croaker killed you!
Your insurance policy pays 50 pennies.
Mocker's room(#3505R)

There are also two other player attributes which are visible to all, LAST and SEX. LAST indicates when the player was last logged in. The player cannot set this attribute, it is set for her by MUSH. SEX usually indicates whether the player is (virtually) male or female, but since it (like all attributes) is a string, it can be set to silly things like "No, thank you."

Example: player Shiva

look shiva
The god of @destruction.
Sex:male
Last:Fri Jul 20 08:05:03 1990
Carrying:
Tan for Shiva
Shiva's *SUNBURN*

note the LAST and SEX attributes

2.2. New Flags

Several new flags have also been added, and old ones changed. Below is a brief list of them and their purposes. The commands that are effected by them will explain them in full. The letter that symbolizes the flag (which is usually displayed after the object's number when you look at it) appears after the flag's name in parentheses.

Abode (A)
Allows a player to set their home in a room, and also allows them to teleport to it as well.
Chown_ok (C)
Indicates that the ownership of the object can be changed. This allows players to "adopt" an object and make it their own. See the command chown for more.
Dark (D)
If dark is set on an exit, the exit's name will not be displayed in the "obvious exits" list of the room. This can also be set on objects to keep them out of sight and on rooms to make all of its contents invisible.
Destroy_ok (d)
when set on an object, allows anyone to use the @destroy command on it to eliminate it. Particularly useful for such things as notes and such. To destroy an object with destroy_ok set, you must be carrying it (this prevents random people destroying an object meant for a specific person, like a note.)
Enter_ok (e)
Setting this flag on a player or object allows objects that don't belong to them to be given to them, and allows objects or players to enter them.
Floating (F)
(TinyTIM only) The floating flag can be set on a room to indicate that it is all right for it not to be linked to anything. Usually, MUSH will complain to you every ten minutes or so if you have a disconnected room. If this flag is set on a room, then you will not be nagged about that room not being connected to anything. Do not use this flag unless you are one of those who Know What They Are Doing.
Going (G)
This flag is set on a room that is about to be destroyed. It can be reset to save the room from destruction.
Key (K)
When set, this flag prevents puppets from picking up an object. Also, an object with the key flag set will go home if the player carrying it @teleports someplace.
Puppet (p)
When set on an object, the object beings to relay everything it hears to its owner. See the section on puppets for more.


Last updated December 8, 2004 by Josh Juran
Metamage Labs