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

= Drop =

||||<rowstyle="background-color: #CCCCCC;">'''Command Information'''||
||''Keyword'' ||<:>{{{ drop }}}||
||''Type'' ||<:>{{{ BuiltIn }}}||
||<(|1>''Arguments'' ||<:>{{{ <object> }}}||
||''Aliases''||<:>None||
||<(|1>''Usage''||<:>{{{ drop <object> }}}||

=== Purpose ===

Enables players to drop objects in their inventory.

=== Syntax ===

To drop an object from one's inventory:

 . ''{{{ drop <object> }}}''

=== Parameters ===

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

 . The name or database reference identifier for an object to be dropped from the player's inventory. 

=== Examples ===

__Example 1__

If Lepus wanted to drop a Seismic Activity Recorder from his inventory onto the ground, they would type:

 . {{{ drop Seismic Activity Recorder }}}

Lepus would see:

 . {{{ "Dropped" }}}

Everyone else in the room would see:

 . {{{ "Lepus drops Seismic Activity Recorder." }}}

=== Caveats ===

Depending on whether the room or object has particular flags or properties set will determine what happens when an object is dropped. 

If the dropped object has the [[Concepts/Flags#Sticky|Sticky]] flag set, it will return to the object's assigned [[Concepts/Rooms#Home|home]] location.

If the object is dropped into a room with the [[Concepts/Rooms#Drop-To|Drop-To]] property set, the dropped object will be sent to the location specified in the drop-to.

If the object has the [[Concepts/Flags#Sticky|Sticky]] flag set and the room has the [[Concepts/Rooms#Drop-To|Drop-To]] property set, the object will remain in the room so long it remains occupied. Once the last player leaves, the object will be sent to its assigned home.

If a MUCK is using the built-in [[Commands/BuiltIn/put|put]] command, it may be used instead of drop. The SpinDizzy MUCK does not utilize the built-in put command.

=== Related ===

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

[[Commands/BuiltIn/get|Get]] - Get an object from the environment or a container

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

[[Concepts/Flags|Flags]] - Information on Object Flags

[[Concepts/Properties|Properties]] - Information on Object Properties

[[Concepts/Rooms|Rooms]] - Information on working with Room objects

=== Parent Topic ===

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

-----
CategoryBuiltincmd CategoryBasiccmd