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

= Give =

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

=== Purpose ===

To give [[Concepts/Currency|currency objects]] to a player or to change the value of an object.

=== Syntax ===

To give currency to another player:

 . ''{{{ give <player>=<amount> }}}''

To change the value of an object:

 . ''{{{ give <object>=<amount> }}}''

=== Parameters ===

''{{{<player>}}}'' 

 . The player to give currency from your balance to. 

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

 . An object whose value you wish to increase.

''{{{<amount>}}}'' 

 . A specified amount of currency, in whole units.

=== Examples ===

__Example 1__

If Alkani wanted to give Jaxen ten shiny coins to "purchase" something from Morticon's Marshmallow Madness vending machine, he would type:

 . {{{ give Jaxen=10 }}}

Alkani would see:

 . {{{ "You give 10 shiny coins to Jaxen." }}}

Jaxen would see:

 . {{{ "Alkani gives you 10 shiny coins." }}}

If Alkani doesn't have the shiny coins to give, he would see:

 . {{{ "You don't have that many shiny coins to give!" }}}


__Example 2__

If Morticon wanted to increase the value of an object named Gold Ingot to one thousand unobtanium, they would type the following:

 . {{{ give Gold Ingot=1000 }}}

Morticon would see:

 . {{{ "You change the value of Gold Ingot to 1000 unobtanium." }}}

Because Morticon is a Wizard, he may give currency freely regardless of whether or not he has it.


=== Caveats ===

An object's intrinsic value can be set on [[Commands/BuiltIn/at-create|creation]]. This is the only way players can assign a value to an object.

Players may only give currency to other players.

Wizards may decrease or increase the value of an object as well as giving or taking currency from players. Giving currency does not impact a Wizards currency total.

=== Related ===

[[Commands/BuiltIn/at-create|@create]] - Create an object

[[Concepts/Currency|Currency]] - Information about Currency

[[Concepts/Characters#Belongings|Belongings]] - Information about Character Belongings

[[Concepts/Staff#Wizards|Wizards]] - Information about Wizards

=== Parent Topic ===

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


-----

CategoryBuiltincmd CategoryBasiccmd