/
umud/DOC/
umud/DOC/examples/
umud/DOC/internals/
umud/DOC/wizard/
umud/MISC/
umud/MISC/dbchk/
umud/RWHO/rwhod/
Teleport Rules
--------------

  Teleporting in UnterMUD is slightly different than in any other mud. It is
not intended as the main mode of moving around the mud; in fact, when a player
teleports or is teleported, everything they are carrying will get sent home,
unless the player that does the teleporting or the player that is teleported
is a wizard. This insures that people won't run off with puzzle keys and so
forth. This rule actually sounds worse than it is, because things in UnterMUD
can have a player as their home (they even default to it.) To be able to hold
on to your stuff when you teleport, simply set its home to you.
  
  Generally speaking, you can teleport to any place that is linkok. The 
reasoning behind this is: if you can build an exit there, and go through the
exit to that room, why not save yourself some time and trouble and simply
teleport there directly? You can always teleport to a room you own. In
order to find other linkok rooms, you'll just have to ask around.

  The only objects that can be teleported are player and things. In UnterMUD,
every object (player, room, thing, and exit) can use the teleport command.
Macros on a room, exit, or thing, run *as* that object, not as the owner or as
the player who used them. Rooms and exits do not move; only players and
things do.

  The syntax for the teleport command is "teleport what where". To teleport
yourself "home", for instance, you just type "teleport me home". There is
a system macro called "home" that does that teleport command, so you needn't
type it all out. 

  Success, osuccess, fail, ofail, drop and odrop messages can all be macros 
(instead of ordinary strings). Thus, teleport commands can be in a macro,
and therefore done by the exit, thing, or room. (Players don't have success,
fail, drop, etc messages.) Exits may have macros on them, but those macros
can only be triggered via other macros in the success/fail/drop/etc fields
on the exit.

Specific Rules:

In all cases, "them", "themselves" refer to Player, Object, or Room as given.

Players can teleport:

	players
	  themselves OR other players they own OR are linkok
	    FROM anywhere
	    TO a room they own OR is linkok OR home
	  other players
	    FROM a room they own AND are standing in
	    TO home
	teleported player will drop all their inventory (it goes home)

	things
	  things they own OR are linkok
	    FROM anywhere
	    TO themselves OR a room/player they own OR is linkok OR home
	  things that are in a room they own or in their inventory
	    FROM there
	    TO home

Players or things that are in a room the player owns can ONLY be teleported
to "home", NOT to a room the player owns, a linkok room or to themselves. In
other words, no fair hiding other people's stuff where they can't find it.

Things can teleport:

	players that call macros that are attached to them
	  FROM anywhere
	  TO a room they own OR is linkok OR home
	 teleported player will drop all inventory (it goes home)

	themselves OR other things they own OR are linkok
	  FROM anywhere
	  TO the actor OR a room/player they own OR is linkok OR home

Rooms can teleport:

	players that are in the room OR they own OR are linkok
	  FROM themself
	  TO a room they own OR is linkok OR home
	 teleported player will drop all inventory (it goes home)

Note that rooms can normally only teleport players home. If the player is
owned by the room or is linkok, then room can then teleport that player to
another room the room owns, or to one that is linkok.

	things they own OR are linkok
	  FROM anywhere
	  TO the actor OR themselves OR a room/player they own OR is linkok
             OR home

Also note that droptos do exist ("set here dropto dest").

Exits can teleport:

	players that use them
	  NOT AT ALL (if you want to move a player, use an exit, with the
	  macro in the success, and the player will go to the destination
	  of the exit, normally.)
	
	things they own OR are linkok
	  FROM anywhere
	  TO a room/player they own OR is linkok OR home


Some generalities can be derived from the above.  Any object can teleport a
thing it controls to a room or player that it controls, or to the things
home.  Players can always teleport a thing that is in their possesion to its
home, even if they don't control it.  Things can also be teleported into a
players inventory when the player triggers a command attached to a room or
thing.

Player teleporting is much more limited.  Players can teleport a player they
control to a room they control, or send a player on their property home. 
Things can also move a player who uses them to a room they control.

Control means that the controlled object is self, linkok, or owned for
the controlling object.  Possesion means that the thing is in a players
inventory or a room they own.