= Game Items =
**Important**: Visit [wiki:olivine/dsl/types/core core types] for information on primitive and core types such as `integer` and visit [wiki:olivine/dsl/qualref qualified references] for how to express item identification ''before'' you continue here.

An `item` expresses a named game item using a qualified reference.  The syntax takes the form `item reference`.

== Examples ==

{{{
   item &foo:potion\`awesome sauce`
}}}

== Attributes ==
You can also tack-on attributes to your item definition, the syntax is either `item &group:name with attributes` or `item &name with attributes` where ''attributes'' is described as a dictionary in the table below:

||= Name =||= Type =||= Description =||
||name||text||Custom name of the item||
||description||text||The ''lore'' of the item (that's just a fancy name for a custom description of the item)||
||enchantments||list of [wiki:olivine/dsl/attribs/enchantment enchantment]||The list of enchantments the item should have||
||color||[wiki:olivine/dsl/types/color color]||Color of the item, only applies to leather armor right now||
||modifiers||[#=itemmodifiers item modifiers]||Item-specific modifiers, click the ''item modifiers'' link for more information||
||wear||integer||How worn the item is, this isn't how damaged it is but how much it costs to repair it when it becomes damaged||

=== Item Modifiers ===
All these are [wiki:olivine/dsl/attribs/modifier modifier] definitions, click on the link for information on how to define one.  These modifiers affect the mob or player holding this item in their hand.
 * `health` - 'nuff said
 * `stability` - Knockback resistance
 * `agility` - Movement / run speed
 * `strength` - Attack damage dealt

== Examples ==
Here's an item with attributes including enchantments and a modifier:
{{{
item &mmm:darksteel_leggings with {
    name -> "Me pants!"
    description -> "Git yer own pants! these be mine!"
    enchantments -> [
        { type -> fire_protection; level -> 3 }
        { type -> unbreaking; level -> 3 }
    ]
    modifiers -> {
        health -> { amount -> 2; operator -> boost }
    }
}
}}}