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

{{{#!wiki caution
'''Page Under Construction'''

This page is under construction and using the CommandTemplate. This should be removed once the page is finished.
}}}

= @create =

||||<rowstyle="background-color: #CCCCCC;">'''Command Information'''||
||''Keyword'' ||<:>{{{ @create }}}||
||''Type'' ||<:>{{{ BuiltIn }}}||
||<(|3>''Arguments'' ||<:>{{{ <object-name> }}}||
||||<:>{{{ <cost> }}}||
||||<:>{{{ <registry-name> }}}||
||''Aliases''||<:>None||
||<(>''Usage''||<:>{{{ @create <object-name> }}}||

=== Purpose ===

Create a new object.

=== Syntax ===

To create a new object:

 . ''{{{ @create <object-name> }}}''

To create a new object and specify the object's cost:

 . ''{{{ @create <object-name>=<cost> }}}''

To create a new object and specify the object's registry name:

 . ''{{{ @create <object-name>=<registry-name> }}}''

=== Parameters ===

''{{{<object-name>}}}'' 

 . The name for the new object 

''{{{<cost>}}}'' 

 . The object's cost.

''{{{<registry-name>}}}'' 

 . The object's registry name


=== Examples ===

__Example 1__

If Alkani wanted to create an object named "Jar of Ocelot Treats," he would type the following:

 . {{{ @create Jar of Ocelot Treats }}}

Alkani would see:

 . {{{ Jar of Ocelot Treats created with number 8609. }}}


__Example 2__

If Morticon wanted to create an object named Leather Bandolier, paying one-hundred (100) currency units, they would type the following:

 . {{{ @create Leather Bandolier=100 }}}

Morticon would see:

 . {{{ Leather Bandolier created with number7530. }}}


__Example 3__

If Jaxen wanted to create an object named Technical Reference Manual and assign it to the alias "trm," they would type the following:

 . {{{ @create Technical Reference Manual=trm }}}

Jaxen would see:

 . {{{ Technical Reference Manual created with number 8675. }}}


__Example 4__

If Lepus wanted to create an object named Vial of Pure Mithril, paying five hundred (500) currency units and assigning it to an alias of "pm" they would type the following:

 . {{{ @create Vial of Pure Mithril=500=pm }}}

Lepus would see:

 . {{{ Vial of Pure Mithril created with number 5309. }}}


=== Caveats ===

By default, the cost of creating an object is ten (10) currency units. As a result, the default value of any created object is one (1) currency unit.

Players may specify the value of an object by specifying the cost. Based on the code, the formula for determine the value based on the cost is:

TBD

=== Related ===
[[Concepts/Objects|Objects]] - Information about Objects

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

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

[[BuiltIn/give|Give]] - Give currency to a player or value to an object

=== Parent Topic ===

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

-----

CategoryBuiltincmd CategoryBuildingcmd