Template:Infobox item

The Infobox item template displays a structured summary for any item in a player's inventory. It stores the item's data row in the items Cargo table and auto-adds and a category-specific sub-category (e.g. ). Contents 1 Usage 1.1 Minimal example (use item) 1.2 Full equip example 1.3 Etc / setup / cash examples 2 Parameters 3 Conditional rendering by category 4 Auto-categories 5 Cargo table Usage Place the infobox as the very first block on the page, before any prose. Parameters that do not apply to an item may be omitted entirely. Minimal example (use item) {{Infobox item | id = 2000000 | name_en = Red Potion | category = use | subcategory = Potion | sell_price = 5 | stackable = yes | max_stack = 200 | image = red-potion.png | game_version = pre-launch }} Full equip example {{Infobox item | id = 1002000 | name_en = Blue Bandana | name_ko = 파란 두건 | description_en = A simple blue bandana worn around the head. | category = equip | subcategory = Hat | sell_price = 200 | required_level = 10 | required_str = 0 | required_dex = 0 | required_int = 0 | required_luk = 0 | stat_str = 0 | stat_dex = 0 | stat_int = 0 | stat_luk = 1 | stat_hp = 0 | stat_mp = 0 | stat_weapon_attack = 0 | stat_magic_attack = 0 | slots = 5 | image = blue-bandana.png | game_version = pre-launch }} Etc / setup / cash examples {{Infobox item | id = 4000001 | name_en = Snail Shell | category = etc | sell_price = 2 | image = snail-shell.png | game_version = pre-launch }} {{Infobox item | id = 3010000 | name_en = Wooden Chair | category = setup | sell_price = 0 | image = wooden-chair.png | game_version = pre-launch }} {{Infobox item | id = 5000000 | name_en = Pet: White Rabbit | category = cash | image = pet-white-rabbit.png | game_version = pre-launch }} Parameters Parameter Type Required? Notes id Integer Yes Game's internal item ID. Source of truth for matching with import data. name_en String Yes English display name. name_ko String No Korean name. Shown automatically when reader's UI language is Korean. name_zh String No Chinese name. name_ja String No Japanese name. title_icon File No Optional small icon (24 px) shown left of the name in the title bar. Not stored in Cargo. description_en Text No In-game item description. Rendered in italics below the image. description_ko Text No description_zh Text No description_ja Text No category String Yes One of: equip, use, etc, setup, cash. Controls which conditional sections appear (see below). subcategory String No Free-text subcategory, e.g. Hat, Weapon, Potion, Quest item. Shown in the "Type" row. job String No For job-restricted equipment: a single job (Warrior, Magician, Bowman, Thief, Beginner) or slash-separated combinations like Warrior/Thief when more than one job can wear the item. Blank or unset means any job can use the item; the infobox shows "All jobs" in that case. Renders as a "Usable by" row in the infobox on every equip item, with each job rendered as a separate wikilink. sell_price Integer No NPC sell value in mesos. Omit if the item cannot be sold. required_level Integer No Equip only. Minimum character level to equip. required_str Integer No Equip only. Minimum STR to equip. required_dex Integer No Equip only. Minimum DEX to equip. required_int Integer No Equip only. Minimum INT to equip. required_luk Integer No Equip only. Minimum LUK to equip. stat_str Integer No Equip only. STR bonus provided by this item. stat_dex Integer No Equip only. DEX bonus. stat_int Integer No Equip only. INT bonus. stat_luk Integer No Equip only. LUK bonus. stat_hp Integer No Equip only. Max HP bonus. stat_mp Integer No Equip only. Max MP bonus. stat_weapon_attack Integer No Equip only. Weapon attack bonus. stat_magic_attack Integer No Equip only. Magic attack bonus. recovery_hp Integer No HP restored on consumption (use-category items). Renders a "Recovery" section in the infobox when set. recovery_mp Integer No MP restored on consumption (use-category items). slots Integer No Equip only. Number of upgrade slots available on the item. stackable Boolean No yes or no. When yes (and category is not equip), a "Max stack" row is shown. max_stack Integer No Maximum stack size. Shown whenever set, regardless of stackable, as long as category is not equip. image File No Item sprite or icon filename, e.g. red-potion.png. game_version String No Patch or version string this data was last verified against, e.g. pre-launch or 1.0.0. stub String No Set to yes to show a stub callout banner and add . Conditional rendering by category The infobox shows different rows depending on category: Section Shown when Notes Title, image, description Always Title falls back to Infobox item if no name is set. Category row Always Displays the raw category value. Type (subcategory) row When subcategory is set Any category. Sell price row When sell_price is set Any category. Recovery section When recovery_hp or recovery_mp is set Shows HP and MP rows individually based on which fields are populated. Requirements section category=equip only Shows individual requirement rows only when each param is set. Stats section category=equip only Attack row shown only if at least one of stat_weapon_attack / stat_magic_attack is set. Base-stat row (STR/DEX/INT/LUK) shown only if at least one is set. HP/MP row shown only if at least one is set. Slots row category=equip only Shown when slots is set. Max stack row Non-equip categories Shown when stackable=yes OR max_stack is set. Game version footer When game_version is set Any category. Auto-categories The template automatically adds: — always. , , , , or — based on the category value (first letter uppercased). — when stub=yes. Do not add manually once this infobox is in use. Further subcategories (e.g. , ) should still be added in the page body. Cargo table This template declares and populates the items Cargo table. After any change to the #cargo_declare block: View the template page in a browser once (registers the declaration). Run Cargo's cargoRecreateData.php --table=items maintenance script. See the Cargo tables for the full schema.