Template:Item/doc

From Path of Exile 2 Wiki
Revision as of 13:15, 8 April 2016 by >OmegaK2 (→‎Gems)
Jump to navigation Jump to search

This subpage provides documentation for Template:Item.

Lua logo

This template uses the following modules:

Template:Ambox

Semantic Mediawiki version of the item template.

Overview

This template should be used for all items on the wiki and it will take of setting semantic properties, creating an infobox as well as setting categories.

It is meant for usage on permanent pages, do not use it on user pages.

Currently the template is safe to use for the following item classes:

  • Active Skill Gems
  • Support Skill Gems

Parameters

Base

Parameter Value Required Description
class str Yes A valid item class
rarity str Yes rarity of the item, one of:
  • Normal
  • Magic
  • Rare
  • Unique
name str Yes Name of the item
size_x int No x-size in inventory units, i.e. the width
size_y int No y-size in inventory units, i.e. the width
drop_enabled bool No Whether the item is drop enabled; this defaults to true.

Specify false for legacy items that do not drop anymore.

drop_level int No At which level the item starts dropping at (may differ from required_level)
required_level int No Which level is required to use the item (may differ from drop_level)
required_dexterity int No The dexterity requirement of the item if any
required_intelligence int No The intelligence requirement of the item if any
required_strength int No The strength requirement of the item if any
flavour_text str No Flavour text if any (i.e. for unique items, vaal fragments, divination cards, etc)
help_text str No Help text if any

For some item classes such as gems a default string is inserted if this value is missing.

tags list[str] No List of internal tags
metadata_id str No Internal metadata id of the item

Class groups

Parameters that apply to various groups of item classes.

Flasks

Eligible item classes:

Life Flasks, Mana Flasks, Hybrid Flasks, Utility Flasks, Critical Utility Flasks

Parameter Value Required Description
flask_duration int No How long the flask lasts
charges_max int No Maximum number of charges the flask holds
charges_per_use int No Charges consumed when the flask is used

Weapons

Eligible item classes:

'Claws', 'Daggers', 'Wands', 'One Hand Swords', 'Thrusting One Hand Swords', 'One Hand Axes', 'One Hand Maces', 'Bows', 'Staves', 'Two Hand Swords', 'Two Hand Axes', 'Two Hand Maces', 'Sceptres'

Parameter Value Required Description
critical_strike_chance int No Base critical strike chance of the weapon
attack_speed int No Base attack speed of the weapon
damage_min int No Minimum base physical damage of the weapon
damage_max int No Maximum base physical damage of the weapon
range int No Range in game units of the weapon

Armour

Eligible item classes:

'Gloves', 'Boots', 'Body Armours', 'Helmets', 'Shields'

Parameter Value Required Description
armour int No Armour of the armour
energy_shield int No Energy Shield of the armour
evasion int No Evasion Rating of the armour

Gems

Eligible item classes:

'Active Skill Gems', 'Support Skill Gems'

They also inherit all parameters from the Skill template.

Parameter Value Required Description
gem_tags list[str] No List of gem tags.

The gem tags will be matched against a list of verified tags.

dexterity_percent int No Dexterity portion of the gem stat distribution.

For pure gems, this is usually 100 for the primary attribute and 0 for the other attribute. For hybrid gems, this is usually 60 for the primary attribute, 40 for the secondary attribute, and 0 for the remaining attribute.

strength_percent int No Strength portion of the gem stat distribution.
intelligence_percent int No Intelligence portion of the gem stat distribution.

Stackables

Eligible item classes:

'Currency', 'Stackable Currency', 'Hideout Doodads', 'Microtransactions', 'Divination Card'

Parameter Value Required Description
stack_size int No Maximum stack size of the item

Item class

Parameters specific to item classes

Class Parameter Value Required Description
Life Flasks

Hybrid Flasks

flask_life int No How much Life the flask recovers
Mana Flasks

Hybrid Flasks

flask_mana int No How much Mana the flask recovers
Shields block int No The base chance to block on shields