trans

trans <creature|object> <room>

Move a creature or object to a room.

The entity is taken from wherever it is and placed in the destination room. A creature is moved only if it is allowed to enter that room; a worn, carried, or contained object is first removed from its holder.

Arguments

• <creature|object> — the entity to move. A creature is teleported to the room (subject to the room's entry permission); an object is relocated there.
• <room> — the destination room. Get one with room, e.g. [room 1] for a room vnum or [room $self] for the owner's room.

Returns

null. Like the other action commands, a successful trans in the handle phase suppresses the event's default action. Moving a creature that is not authorized to enter the destination does not take effect, and so does not suppress.

Examples

after command (say) {
  trans $actor [room 1]
}

The actor is moved to room 1. The script compiles and runs to completion.

handle command (order) {
  trans $actor [room 1]
  do "say Begone!"
}

The actor is whisked to room 1 and the owner pronounces the banishment.

See also

• room — resolve a room from a vnum or an entity.
• oload, mload — create new objects and mobiles in a room.
• Handlers, events, and phases · Types