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

= Put =

~-''This page describes the functionality for the Built-In {{{ put }}} command. For more information on how the extended page functionality works, look at the global [[Commands/Globals/PutPlusPlus|put]] command.''-~

||||<rowstyle="background-color: #CCCCCC;">'''Command Information'''||
||''Keyword'' ||<:>{{{ put }}}||
||''Type'' ||<:>{{{ BuiltIn }}}||
||<(|3>''Arguments'' ||<:>{{{ put }}}||
||||<:>{{{ <thing> }}}||
||||<:>{{{ <container> }}}||
||''Aliases''||<:>{{{throw}}}||
||<(|1>''Usage''||<:>{{{ put <thing>=<container> }}}||

=== Purpose ===

Places an object into a designated container.

=== Syntax ===

To put an object into a container:

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


=== Parameters ===

''{{{<object>}}}'' 

 . An object that you wish to put into a container. 

''{{{<container>}}}'' 

 . A container into which you would like to put an object. This is generally a player, room, or another object.

=== Examples ===

__Example 1__

If Morticon wanted to put a Strawberry-flavored Licorice Straw into a Candy Bag, they would type the following:

 . {{{ put Strawberry-flavored Licorice Straw=Candy Bag }}}

Morticon would see:

 . {{{ "Put away." }}}


__Example 2__

If Jaxen wanted to put a Vinyl Recording into Alkani's hands, Jaxen would type the following:

 . {{{ put Vinyl Recording=Alkani }}}

Jaxen would see:

 . {{{ "You hand Vinyl Recording to Alkani." }}}

Alkani would see:

 . {{{ "Jaxen hands you Vinyl Recording." }}}

=== Caveats ===

Players may only place objects into containers if they have permission to access the object and container as determined by the appropriate lock settings. Wizards may put objects wherever they please.

If an object has [[Programming/messages|messages]] set on it, they will not be displayed; this is because the {{{put}}} command always puts objects into containers.

=== Related ===

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

[[Commands/BuiltIn/get|Get]] - Get an object from the environment or 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