Skip to main content
MPStorysMAPLESTORY SERIES HUB

Template:Infobox NPC

From the MapleStory Classic Wiki, mirrored inside MPStorys

Template:Infobox NPC displays the structured stat block for an NPC entity, stores all fields in the Cargo npcs table, and categorises the page.

Usage

{{Infobox NPC
| id           = 1052001
| name_en      = Grendel the Really Old
| name_ko      = 그렌델
| location     = Ellinia
| map          = Magic Library
| region       = Victoria Island
| role         = Magician job instructor
| image        = Grendel_the_Really_Old.webp
| game_version = pre-launch
}}

Parameters

Parameter Type Required Description
id Integer Recommended Game's internal NPC ID.
name_en String Recommended English display name. Falls back to Infobox NPC.
name_ko String No Korean display name.
name_zh String No Chinese display name.
name_ja String No Japanese display name.
title_icon File No Small icon (24 px) shown inline before the NPC name in the infobox title bar. Do not include the File: prefix.
location Page Recommended Broader town or region where this NPC is found (e.g. Ellinia). Rendered as a link via {{map|...}}.
map Page No Specific in-game map the NPC stands in (e.g. Magic Library). Optional: omit when the NPC stands in the town's overworld map and location alone is sufficient.
region String No Region this NPC is located in. One of: Maple Island, Victoria Island, Ossyria. Rendered as a link to the region page, immediately below the Map row. Used for the "Browse NPCs by region" facet on the NPCs landing. Row suppressed if empty.
role String Recommended Free-text descriptor of what this NPC does, e.g. Magician job instructor, Storage keeper, Cab driver, Quest giver. Not a constrained enum: use whatever is clearest to readers.
summary Text Recommended One-sentence description of what this NPC offers a passing player (e.g. Sells basic potions and arrows, Grants 1st job advancement to qualifying Beginners). Stored in the npcs Cargo table and surfaced in two places: as an italic description line beneath the portrait on the NPC's own page, and as the "Summary" column of the auto-generated Template:Notable NPCs table on the NPC's town/map page. The map page does not duplicate this text; it queries from Cargo, so editing the summary here updates every map that lists this NPC.
shop_type String For a shopkeeper The kind of shop this NPC runs: Potion, Weapon, Armor, Use, Setup, General, Quest or Cash. Setting it makes the article the shop's home: it stores the shop in the shops Cargo table (with map, location as its town, and region), shows a Shop line linking the article's Shop section, and adds Category:Shops. The stock goes in that section; see MapleWiki:Shop page model.
currency String No For a shopkeeper charging something other than mesos: the currency's name. Defaults to Mesos.
image File No Sprite or portrait of the NPC. Do not include the File: prefix.
game_version String Recommended Patch version this data was last verified against. Use pre-launch or a version string such as 1.0.0.
stub Boolean No Set yes to add Category:Stubs.

Cargo table: npcs

This template declares and stores data in the npcs Cargo table. See Special:CargoTables/npcs to inspect the live schema.

Post-save ritual

After any change to the #cargo_declare block:

  1. Save the template
  2. Visit Template:Infobox NPC in a browser once: the page must render to register the declaration
  3. Run Cargo's cargoRecreateData.php --table=npcs maintenance script

Categories auto-added by this template


Source:MapleStory Classic Wiki