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.