##master-page:CommandTemplate
##master-date:2017-08-17
##master-revision:3
#format wiki
#language en

= Get =

||||<rowstyle="background-color: #CCCCCC;">'''Command Information'''||
||''Keyword'' ||<:>{{{ get }}}||
||''Type'' ||<:>{{{ BuiltIn }}}||
||<(|2>''Arguments'' ||<:>{{{ <object> }}}||
||||<:>{{{ <container> }}}||
||''Aliases''||<:>{{{ take }}}||
||<(|2>''Usage''||<:>{{{ get <object>  }}}||
||||<:>{{{ get <container>=<object> }}}||

=== Purpose ===

Retrieves an object from the surrounding area or from within a designated container.

=== Syntax ===

To retrieve an object from the current room:

 . ''{{{ get <object> }}}''

To retrieve an object from within a container on your person or within the current room:

 . ''{{{ get <container>=<object> }}}''

=== Parameters ===

''<object>'' 

 . The thing that a player wishes to get. 

''<container>'' 

 . An object which can contain things. Can either be a specialized container object or a player.

=== Examples ===

__Example 1__

If Morticon wanted to pick up an Apple from the ground, they would type the following:

 . {{{ get Apple }}}

Morticon would see the following:

 . {{{ Taken. }}}

__Example 2__

If Lepus wanted to pull a Scanner from his container called Backpack, he would type the following:

 . {{{ get Backpack=Scanner }}}

Lepus would see the following:

 . {{{ Taken. }}}

__Example 3__

If Jaxen wanted to get a Tennis Ball using the alternate syntax, he would type the following:

 . {{{ take Tennis Ball }}}

Jaxen would see the following:

 . {{{ Taken. }}}

__Example 4__

If Alkani wanted to pull a Fuel Rod from a Reactor Housing, he would type the following:

 . {{{ take Reactor Housing=Fuel Rod }}}

Alkani would see the following:

 . {{{ Taken. }}}


=== Caveats ===

Players may only retrieve objects if they have permission to access the object or container as determined by the appropriate [[Concepts/Locks|lock]] settings. Object owners may always retrieve objects they own. Wizards may always retrieve anyone's objects.

If an object has [[Programming/messages]] set on it, they will not be displayed if the object is being retrieved from a container.

=== Related ===

[[Commands/BuiltIn/drop|Drop]] - Drop an object on the ground

[[Commands/BuiltIn/put|Put]] - Put an object into a container

[[Programming/Messages|Messages]] - Working With Messages

[[Concepts/Locks|Locks]] - Information about Object Locks

=== Parent Topic ===

[[Commands/BuiltIn|List of SpinDizzy MUCK System Built-In and Local Commands]]
-----
CategoryBuiltincmd CategoryBasiccmd