Difference between revisions of "Template:Itembox"

Revision as of 13:20, 23 November 2009

This entire page and template is currently in the process of being refactored. (11/23/09)

Template:Itembox is designed for use on item pages to display an item's picture and properties. It is designed to simulate the item being in a character's backpack with the standard in-game cursor hovering over it and displaying the item's tooltip, all in the format found in the the Ultima Online Classic Client.

Note: If the Classic Client is ever dropped in favor of the Enhanced Client, the look and feel of this template will be changed accordingly.

All of the properties that are displayed in the tooltip portion of the template are displayed as centered and using white text except for the name of the item, which is displayed in yellow text. Specific item property names also serve as links to their corresponding pages.

Notes on Usage

Since it is highly unlikely, if not impossible, that an item will ever be encountered that uses absolutely every item property that is available in this template, Template:Item Infobox has been designed with conditional parameters. This means that when using this template on an item's page it is intended that only the parameters which correspond to that specific item's properties should be included. Unlike many other templates that show in their entirety no matter what, if one of the parameters from this template is not included or left blank, its associated property will simply not display at all. It is recommended that blank parameters be left out entirely when using this template, in order not to waste space.

Template

{{Item Infobox
|image=
|imageheight=
|name=
|usesremaining=
|blessed=
|weight=
|elvesonly=
|ammo=
|damagemodifier=
|requirementmondainslegacy=
|armorset=
|jewelryset=
|weaponarmorset=
|durabilityincrease=
|spellchanneling=
|velocity=
|hitstaminaleech=
|swingspeedincrease=
|damageincrease=
|physicalresist=
|fireresist=
|coldresist=
|poisonresist=
|energyresist=
|physicaldamage=
|firedamage=
|colddamage=
|poisondamage=
|energydamage=
|mindamage=
|maxdamage=
|weaponspeed=
|range=
|strengthrequirement=
|handedweapon=
|skillrequired=
|durability=
}}

Parameters

[[Category:{{{category}}} Templates|Itembox]]

image

• Usage: Optional
• Description: The image parameter takes a string denoting the name of a valid image of the item on UOGuide. This is used to generate the item's image in the containing area of the backpack. If this parameter is left blank or omitted, a default value of "Image_Needed.png" is used. Although this parameter is marked as "Optional," if this parameter is not supplied a value an image will be displayed that says "IMAGE NEEDED" and the page will be flagged and put into a category of item pages lacking images so that it may be given a valid image in the future.
• Valid Value(s): Any string that is the name of a valid image on UOGuide.

imageheight

• Usage: Optional
• Description: The imageheight parameter takes a whole number denoting the height of the item image. This is used to generate the layout code necessary to vertically center the image in the containing area of the backpack.
• Valid Value(s): Any whole number.

name

• Usage: Optional
• Description: The name parameter takes a string denoting the name of the item. This is used to generate the first line of the tooltip section. If this parameter is left blank or omitted, a default value of "{{PAGENAME}}" is used. It is recommended that this field be left blank unless the item's page name has a parenthetical differentiation in it; I.e. "Item Name (Item)."
• Valid Value(s): Any string.

usesremaining

• Usage: Optional
• Description: The usesremaining parameter takes a whole number denoting the number of uses remaining on an item. This is used to generate the "Uses Remaining" item property in the tooltip section. Any whole number may be supplied for this parameter, as it is designed merely to display the "Uses Remaining" property with a realistic number. The ability to supply a specific value as opposed to having a default number is retained due to the possibility that some pages may exist for unique, one-of-a-kind rare items that have a specific number of uses remaining.
• Valid Value(s): Any whole number.

blessed

• Usage: Optional
• Description: The blessed parameter takes a string denoting whether the item is Blessed or Cursed. This is used to generate the "Blessed" or "Cursed" item property in the tooltip section.
• Valid Value(s): "Cursed," "CURSED," or "cursed" to display "Cursed," and any other value to display "Blessed."

weight

• Usage: Optional
• Description: The weight parameter takes a whole number denoting the weight of the item. This is used to generate the "Weight" item property in the tooltip section.
• Valid Value(s): Any whole number greater than or equal to one (1).

swingspeedincrease

• Usage: Optional
• Description: The swingspeedincrease parameter takes a whole number denoting the amount of Swing Speed Increase on the item. This is used to generate the "Swing Speed Increase" item property in the tooltip section.
• Valid Value(s): Any whole number greater than or equal to one (1).

Resist parameters

|physicalresist=
|fireresist=
|coldresist=
|poisonresist=
|energyresist=

The resist parameters display their corresponding resist property (physical, fire, cold, poison, or energy) on an item in the format "Y Resist X%", where X is the inputted value and Y is the resist type. Resist parameters do not accept any value less than 1.

The resist parameters display as follows:

• physicalresist: Template:ColoredLink 10%
• fireresist: Template:ColoredLink 10%
• coldresist: Template:ColoredLink 10%
• poisonresist: Template:ColoredLink 10%
• energyresist: Template:ColoredLink 25%

Damage Type parameters

|physicaldamage=
|firedamage=
|colddamage=
|poisondamage=
|energydamage=

The damage type parameters display their corresponding damage type property (physical, fire, cold, poison, or energy) on an item in the format "Y Damage X%", where X is the inputted value and Y is the damage type. Damage types do not accept any value of less than 1. If the combined value of the damage types you use for an item does not equal 100, none of the damage types will display, as any other combined value would be impossible within the limitations of the game.

The damage type parameters display as follows:

• physicaldamage: Template:ColoredLink 20%
• firedamage: Template:ColoredLink 20%
• colddamage: Template:ColoredLink 20%
• poisondamage: Template:ColoredLink 20%
• energydamage: Template:ColoredLink 20%

handedweapon

• Usage: Optional
• Description: The handedweapon parameter takes a whole number denoting whether the item is wielded with one (1) or two (2) hands. This is used to generate the "One-Handed Weapon" or "Two-Handed Weapon" item property in the tooltip section.
• Valid Value(s): "1" to display "One-Handed Weapon," or "2" to display "Two-Handed Weapon."

durability

• Usage: Optional
• Description: The durability parameter takes a whole number denoting the minimum and maximum durability of the item. This is used to generate the "Durability" item property in the tooltip section.
• Valid Value(s): Any whole number greater than or equal to one (1).