Template:Infobox Item/doc
Standard infobox parameters
This infobox uses Module:Infobox, which provides a number of standard parameters.
Versioning
This infobox supports switching between multiple versions. Each version needs to have a name defined in a parameter called version#, numbered sequentially starting from 1. For all parameters that have different values, a number can be appended to the end of each parameter name to define the value for each version. Parameters without a version number will be shared between all versions.
For example, if the name of version 2 is called "Bob", you should define |name2 = Bob.
Linking
You can link to a page and have an alternative infobox appear by using a hash value, as if you were linking to a section. The hash value is the version name, as defined by the relevant version# parameter. For example, to link to the variant of a switch infobox with |version3 = Quest, you can use [[Example#Quest]].
Alternative versions are not visible or accessible when Javascript is disabled.
defver
If defver is defined, the infobox will switch to the specified version when the page is loaded. For example, |defver = 4 will automatically select the 4th infobox version.
smwname
This overrides the name of the Semantic MediaWiki subobject that the infobox will set the parameters into. By default, an infobox with multiple versions will save properties into subobjects with the same name as the version name. This parameter only needs to be set if the version name is different from the desired subobject name, or if an unversioned infobox needs to set properties of a specific subobject (for example, when versioned and unversioned infoboxes of different types, like Item and Bonuses, are used on the same page).
This is necessary when a version name would otherwise be an invalid SMW subobject name. The value of smwname is also not permitted to be an invalid subobject name. A subobject name must not violate the following rules:
- The first 5 characters of the name must not contain a period (
.). - The name must not be the number zero (
0). - The name must not be the empty string.
If the infobox does not have multiple versions, SMW properties would normally be set on the page itself. Setting smwname overrides this default behaviour and the properties will be only be set to the specified subobjects and not the page itself.
Multiple subobjects can be specified by separating the subobject names with the broken bar character (¦). The properties will be set in all of the subobjects specified.
For example, if the infobox has |version2 = H.A.M. member, this would cause an invalid subobject name due to having a period within the first 5 characters. The infobox should therefore override the smwname using |smwname2 = HAM member or something similar.
Suppressing SMW
Setting |smw = No will suppress all SMW output for the infobox.
Setting |smwX = No will suppress all SMW output for version number X.
__dump__
This parameter is used only for debugging an infobox. If __dump__ is present with any value then a string version of the infobox object is dumped to the page, rather than displaying the infobox as normal. This should only be used when previewing the page and must never be saved in a mainspace page. Setting this adds Category:Dumping infoboxes to the page.
Specifically, this shows the result at the time the infobox is converted to a string. This will always occur when the module finally returns, but may instead occur earlier in the code. The object is dumped using mw.dumpObject(box). Dumping will not prevent a script error occurring.
Parameters
name
The name of the item exactly as it appears in game (identical case and spacing).
image
The inventory image of the item, formatted as [[File:Image.png]]. Ideally in PNG format (or GIF format if the image is animated).
release
Release date of the item. Should follow the format [[DD Month]] [[YYYY]].
id
The item's game ID. Meta item IDs should be prefixed by "m:".
Example values for this field:
- 1234
- m:1234
description
The description of the item that appears in the game.
members
Whether or not the item is a members only item. Must be the string "Yes" or "No".
donator
Whether or not the item is a donator only item. Must be the string "Yes" or "No".
level
The level of the item.
cost
The price of the item, or Not Buyable if not buyable.
Example values for this field:
sell
The sell price of the item, or Not Sellable if not sellable.
Example values for this field:
tradeable
Whether the item is tradeable between players.
Examples:
- Yes
- No
craftable
Whether the item is craftable.
Examples:
- Yes
- No
brewable
Whether the item is brewable.
Examples:
- Yes
- No
quest
See Category:Quest items for guidelines. Also applicable for miniquests.
The possible values for this field are:
- [[''Quest name'']]
- No
market_sp_limit
Sell price limits on the global market, as they appear in game.
Examples:
- 0 - 0
- 12 - 21
market_bp_limit
Buy price limits on the global market, as they appear in game.
Examples:
- 0 - 0
- 12 - 21
type
The type of the item
The possible values for this field are:
- [[''Item Type'']]
potion_type
The potion type, if the item is a potion.
The possible values for this field are:
- [[''Health Potion'']]
- [[''Effect Potion'']]
potion_effect
If the item is a potion effect, specify the effect here.
book_author
If the item is a book, specify the author here.
damage_blocked
If the item blocks damage, specify it here.
rune_tp
If the item is a rune, specify the location it teleports to.
The possible values for this field are:
- [[''Location name'']]
damage
If the item deals damage, specify it here.
Examples:
- 0 - 0
- 12 - 21
tool_type
If the item is a tool, specify the type of tool here.
The possible values for this field are:
- Fishing Rod
- Axe
- Pickaxe
- Shears
tool_skill_level
The level required in the skill required to use the tool.
tool_effect
If the tool has any effects, put them here.
forage_level
If the item can be gotten from foraging, add the minimum forage level needed to get it here.
mine_level
If the item can be gotten from mining, add the minimum mining level needed to get it here.
fish_level
If the item can be gotten from fishing, add the minimum fishing level needed to get it here.
chop_level
If the item can be gotten from chopping, add the minimum chop level needed to get it here.
ring_effect
If the item is a ring, provide the rings effect here.
necklace_effect
If the item is a necklace, provide the necklaces effect here.
Quick copy
{{Infobox Item
|name =
|image =
|release =
|id =
|description =
|members =
|level =
|cost =
|sell =
|tradeable =
|craftable =
|brewable =
|quest =
|market_sp_limit = (Optional)
|market_bp_limit = (Optional)
|type =
|potion_type = (Optional)
|potion_effect = (Optional)
|book_author = (Optional)
|damage_blocked = (Optional)
|rune_tp = (Optional)
|damage = (Optional)
|tool_type = (Optional)
|skill_level = (Optional)
|tool_effect = (Optional)
}}