Template:Item infobox
This template is very complex. Please, sandbox any changes before making them. If you have questions about this template, feel free to ask on the IRC. |
This template uses translation switching. The correct language will be displayed automatically. Localized versions of this template (e.g. Template:Item infobox/ru) are not necessary. Add your translations directly to this template by editing it. Supported languages for this template: en, de, es, fr, hu, ja, ko, pl, pt, pt-br, ru, sv, tr, zh-hans (add) |
This template must not be used on user pages. Please use Template:User item infobox instead. |
This infobox template can be used to display images and basic information pertaining to items. For infoboxes for other uses, see Category:Infobox templates.
Contents
Supersession
{{Item infobox}}
deprecates the following templates:
{{Weapon infobox}}
{{Hat infobox}}
{{Tool infobox}}
Errors
This template places pages with incorrect use into tracking categories.
- Pages using
{{Item infobox}}
: 40,139 pages - Pages with errors: 926 pages
Usage
Please remove the parameters that are left blank. See Parameters section below for documentation of all parameters.
{{Item infobox | name = | game = (Only use this if the game is TFC) | type = | image = | team-colors = | team-colors-width = | two-models = | 3d-alt = | 3d-team-alt = | number-of-3d-images = | number-of-3d-team-images = | number-of-3d-alt-images = | view1name = ... | view6name = | displayed-price = | kill-icon-1 = ... | kill-icon-6 = | kill-tooltip-2 = ... | kill-tooltip-6 = | used-by = | slot = | contributed-by = | released = | released-major = | availability = | medieval = | taunt-kill = | trade = | marketable = | craft = | numbered = | paint = | rename = | ammo-loaded = | ammo-carried = | ammo-type = | reload-type = | loadout = | custom-icon = | level = | no-level = | att-1-positive = ... | att-6-negative = | item-description = }}
Parameters
Setup parameters
- name
- The displayed title of the infobox. Not necessary for most English pages as the title is collected from the page's name itself. This is also the name displayed in the loadout stats if enabled (overridden by
loadout-name
). It also overwrites the displaytitle template and changes the article name into the displayed title of the infobox. The following parameters are also aliases forname
, and function in the exact same way:NAME, title, name-override, item-name-override
- type[1]
- Changes the display of information and the categorization of the page based on type.
weapon, cosmetic, taunt, special taunt, action, tool, ingredient
- unused
- Set to anything to mark the item as "unused". This will hide the "Trading", "Crafting", etc, fields that appear by default, and also removes slot categorization. Also sets slot to "Unknown" if one is not defined.
- game[1]
- Not necessary for the majority of items. Team Fortress Classic weapon pages need to set this parameter to "
tfc
".
Image parameters
- image
- The main infobox image to be displayed directly underneath the title.
- Example:
File name.png
- Example:
- imagewidth
- The width of the image, defaults to
250px
. Use this only if the image does not display well at the default size.- Example:
96px
- Example:
- team-colors
- Set to "
yes
" if the item has team-based color variations. The images will be displayed using the syntax "File:RED <Item Name>.png
" (where <Item Name> is collected from the page's actual name). This can be overridden with different filenames usingskin-image-blu
andskin-image-red
(see below).
- team-colors-width
- Sets custom width for the team-based color variation images. Default is 95px.
- team-colors-class1, team-colors-class2 and team-colors-class3
- If item has class specific team colours, specify those classes here. Set to other for "Other classes".
- skin-image-blu and skin-image-red
- The filenames for team-color images. Overrides defaults (see above).
3d model parameters
For a more complete explanation with examples, see Module:3D viewer advanced.
- 3d-team
- If the weapon has >2 team coloured models set to
yes
.
- 3d-alt
- If the weapon has alternate models set to
yes
.
- 3d-team-alt
- If the weapon has both team coloured and non team coloured alt models set to
yes
.
- number-of-3d-team-images
- If 3d-team-alt is true set to the number of team coloured models.
- number-of-3d-alt-images
- If 3d-team-alt is true set to the number of non-team coloured alternate models.
- viewnname
- The name to display for the nth 3D image.
- viewn
- Optional overide for model image filename.
- Example:
Scattergun 3D temp.jpg
- Example:
Buy now button parameters
- displayed-price
- The name of the item to display the price of from the price dictionary, if not the same as the page name.
Kill icon parameters
Main templates:
{{Icon killicon}}
and {{Kill notice}}
The following parameters can only be used if type
has been set to weapon
or taunt
(see above). Up to 6 of each are allowed.
- hide-kill-icon
- Setting to
off
orhide
will hide the kill icon section from the infobox, even iftype
is set toweapon
ortaunt
. Common usage: weapons that do not have a kill icon (e.g. Medi Gun).
- kill-icon-n
- The weapon's kill icons. See
{{Icon killicon}}
for exact naming. By default,kill-icon-1
will be displayed using the page's name; thus in most circumstances, definingkill-icon
parameters is not necessary unless the weapon has additional kill icons (e.g.backstab
orflaming arrow
).
- kill-tooltip-n
- The weapons kill icons with an added tooltip (e.g.
Flaregun
hadouken would have the tooltip "Taunting") . Not a required parameter.
- kill-text-n
- The kill text displayed within the kill notice. If it does not display properly (i.e. the text is too big), wrap the text in
tags.
- Example:
FISH KILL!
- Example:
Information parameters
- used-by
- The class or classes that can use the item. Basic text parameter. Please use
{{Used by}}
instead of plain text.
- slot[1] [
primary, secondary, melee, pda1, pda2
] - Can only be defined when
type
is set toweapon
ortaunt
(see above). Other variations:- primary:
slot1, slot 1, 1
- secondary:
slot2, slot 2, 2
- melee:
slot3, slot 3, 3
- pda1:
pda1, pda 1, disguise kit
- pda2:
pda2, pda 2, watch, cloak
- primary:
- This template will also categorize based on these values.
- The default text displayed by these values can also be overridden by setting
slot
to any other specified value. - Note: this behaviour will disable the automatic categorization based on slot types. Categories will need to be applied to the bottom of the article manually.
- The custom-slot parameter can also be used when the slot type is non-standard (e.g. if the weapon has both Primary and Secondary slots).
- slot[1] [
- crafting-slot [
primary, secondary
] - For weapons that have a different crafting slot to their loadout slot.
- primary:
slot1, slot 1, 1
- secondary:
slot2, slot 3, 3
- primary:
- crafting-slot [
- equip-region and equip-region-2 [
whole head, hat, face, glasses, ears, beard, shirt, medal, arms, back, feet, heavy pocket, engineer belt, engineer pocket, scout necklace, sniper necklace, scout backpack, demoman bombs, medic backpack, medic necklace
] - The item's equip region according to items_game.txt
- equip-region and equip-region-2 [
- contributed-by
- The person(s) who contributed the item to the game. Basic text parameter. Not displayed unless defined specifically. Categorizes the pages into Category:Community-contributed items.
- released
- When the item was released. Basic text parameter. Not displayed unless defined specifically. Please use
{{Patch name}}
instead of plain text.
- released-major
- The named patch the item was released in. Basic text parameter. Not displayed unless defined specifically. Check Template:Dictionary/common_strings#major_update_titles for a list of parameters.
- availability
- The means of obtaining the item. Basic text parameter. Not displayed unless defined specifically. Please use
{{avail}}
instead of plain text.
- show-price
- Used to disable the display of the price if in error. Prices themselves are stored inside
{{Item price/core}}
.- Example:
off
- Example:
- trade[1] [
yes, no
] - If the item can obtained through Trading. Items are marked as tradable by default. Pages with
trade
set tono
are categorized into Category:Untradeable items.
- trade[1] [
gift- Deprecated: Since the February 29, 2016 Patch, only tradable items can be wrapped using the Gift Wrap or Giftapult. The only tradable unwrappable items are the aforementioned tools and the Description Tag. The template handles everything automatically. Not displayed if item is untradable.
- marketable[1] [
yes, no
] - If the item can be sold on the Steam Community Market.
- marketable[1] [
- rename[1] [
yes, no
] - If the item can be used with the Name Tag or Description Tag.
- rename[1] [
- medieval[1] [
yes, no
] - If the item can be used in Medieval Mode. All melee weapons default to yes.
- medieval[1] [
- taunt-kill[1] [
yes, no
] - If the item can Taunt Kill. All weapons default to no.
- taunt-kill[1] [
Ammo parameters
These parameters are only available if type
is set to weapon
or taunt
(see above).
- ammo-loaded
- The amount of ammo available in the clip (or magazine?). Basic text parameter. Hidden if set to "
N/A
" or "∞
".
- ammo-carried
- The amount of additional ammo carried by the player. Basic text parameter. Hidden if set to "
N/A
" or "∞
".
- ammo-type
- The ammo's type. Optional basic text parameter.
- reload-type
- The reloading type. Basic text parameter.
- Common uses: Single, No Reload
- show-ammo
- Set to
off
to disable the display of ammunition stats. Some example uses would be the Razorback, Darwin's Danger Shield, or the Electro Sapper.
Loadout parameters
Main template:
{{Backpack item}}
- loadout
- Set to
yes
to display loadout information as it is displayed in the backpack. Is not displayed by default.
- quality[1] [
normal, unique, community, unusual, self-made, valve
] - Item quality. Defaults to "unique" yellow. (See Rarity#Colors and documentation of
{{Backpack item}}
for full list of parameters).
- quality[1] [
- loadout-name
- The name displayed. Defaults to either the page's name itself or the displayed name (set by
name
, see above). Use this parameter when the infobox name differs to the loadout name (for example, adding the rarity prefix on non-English pages):- Example:
Необычный Призрачный металлолом
(Unusual Haunted Metal Scrap)
- Example:
- loadout-prefix
- English pages will have their loadout name preceded by "The" unless this parameter is set to "none". This will be overridden if 'loadout-name' above is defined.
- custom-icon
- Custom backpack icon for users' own purposes. Usage: entering usual file link without File: prefix.
- level
- The level and type of the item. Basic text parameter. Defaults to "Level 1-100".
- att-n-positive
- Positive attributes. Up to 6 basic text parameters.
- att-n-negative
- Negative attributes. Up to 6 basic text parameters.
- att-n-neutral
- Neutral attributes. Up to 6 basic text parameters. Use
item-description
for weapon or cosmetic descriptions instead.
- item-description
- The item's description. Basic text parameter. Displays the description with a smaller font size and lower line height so it fits neatly and stands out from the item's other attributes. Please use
{{item description}}
instead of plain text.
- item-uses
- The amount of uses the item has. Basic text parameter.
- item-flags
- The flags attached to the item. Basic text parameter.
- prefix
- suffix
- Set to "none" to hide the "Vintage" or "Community", etc, prefix/suffix but keeping the colour. Can also use a custom value, e.g. "prefix/suffix = The Best" will generate "The Best Flare Gun" or "Flare Gun The Best".
Non-article maintenance parameters
These parameters should only be used in certain circumstances.
- cat
- Disables all automatic categorization (i.e. slot categorization, etc). Does not disable maintenance tracking categories.
- override
- Overrides Polycount Pack categorization. Will not be around for much longer.