Template:Npc infobox
- 此模板定义表格“NPCs”。 查看表格.
- 此模板添加行到模板Item infobox声明的表格“Items”。 查看表格.
This template is used for displaying the infobox for an NPC (including enemies, bosses, critters, etc.). Together with {{item infobox}}, it is one of the most important and most powerful infobox templates.
Usage
The template's main functionality is to display the standard infobox.
The data which is to be displayed can be manually entered when calling the template, but thanks to {{npcinfo}}, the vast majority of data is generated automatically. To enable automatic data, use the parameter autoauto=yes and either id=<NPC ID>, name=<NPC name>, or nothing else – the latter two methods will cause the template to automatically generate the ID using {{npcNameFromId}}, with the last method using the page title for name reference). This way, all relevant NPC parameters are set automatically. See the table below for affected parameters. However, they can still be overridden, and manually entered parameters always take precedence over the automatic ones.
Basic parameters
- Notes:
- The dollar sign (
$ - All parameters which have a default value listed can usually be omitted. Note that this does not mean that parameters which do not have a default value listed should always be filled in.
| Parameter | Description | Auto | Example | Default value （if omitted） |
Note |
|---|---|---|---|---|---|
{{npc infobox
| |||||
Box-related parameters | |||||
| boxwidth |
Width of the infobox | 27em |
Number with unit. The box is adjusting to the width of the images by default. | ||
| float |
Position of the infobox | left |
right |
||
| cssor | style |
CSS style affecting the entire infobox | Any | |||
| tabor | tabs |
Toggle difficulty tabs | |
The Classic/Expert/Master tabs will not be used for town NPCs, critters, furniture, exclusive variants, and in the Legacy namespace, and will be used for all other NPCs. This parameter overrides this default configuration. | ||
| auto |
Enables automatic data | 201 |
Can also be | ||
| id |
ID of the NPC | ✔️ | 201 |
Cosmetic ID to be displayed, overrides the display of | |
| name |
Name of the NPC | ✔️ | Skeleton |
<page name> |
Will be displayed as the heading of the infobox. |
| lname |
Localized name of the NPC | ✔️ | Scheletro（Italian for "Skeleton"） |
{{tr|$name}} |
Will be displayed as heading of the infobox; only to be used if {{tr}} database of the specific language.
|
| showenglishname |
Display of English name of the NPC | yesno |
The default value for this parameter can be configured in the localization subtemplate (key: showenglishname_default). The default value should be set to no for languages that have an in-game translation[1] and yes for all other languages (as the translated terms in those other languages are not official). Feel free to change it to the best fit for your language's community, though.
| ||
| name2 |
Cosmetic addition to the name |   / {{expert|Lunatic Cultist}} |
Will be directly appended to | ||
| namesub |
Name sub-heading | ✔️ | Additional information directly underneath the title of the infobox. Mainly internal NPC variant names, like | ||
| namesub2 |
Name sub-heading | First Form |
Additional information directly underneath the title of the infobox or underneath | ||
| namenote |
Name sub-sub-heading | ✔️ | Will be displayed underneath | ||
| variant |
Platform-exclusivity note | yes |
Displays a note at the top of the infobox informing about the  前代主机版和任天堂 版-exclusivity of the NPC.
| ||
| expertonly |
Expert-exclusivity of the NPC | yes |
Removes the "Classic" tab and displays the following line underneath title / | ||
| masteronly |
Master-exclusivity of the NPC | yes |
Removes the "Classic" and "Expert" tabs and displays the following line underneath title / | ||
Image-related parameters | |||||
| imagealt |
Complete custom control over the display of the first image | [[File:Skeleton.png]] |
Overrides the | ||
| image |
Main image of the NPC | Skeleton.png |
$namesub.png or $name.png |
This is the image that is stored to cargo by default. | |
| imagesize |
Size of the main image | 40x20px*0.75 |
*1 |
Corresponds to the <width>x<height>*<scale>
| |
| imageexpert |
Image of the Expert variant | Skeleton.png |
|||
| image2 |
Additional image | Skeleton.png |
Default value: <$image without ".png">_(old).png / .gif. Leave it empty to disable this automatic old image discovering. On mainspace pages with a corresponding Legacy page, this automatic old image discovering is always disabled.
| ||
| imagemode |
Controls image display | full |
Setting it to anything other than | ||
| image3 |
Additional image | Skeleton.png |
|||
| imageversion2 |
Exclusive versions of |
desktop-console |
old-gen-3ds |
Versions that will be displayed when hovering over | |
| imageversion3 |
Exclusive versions of |
desktop-console |
Versions that will be displayed when hovering over | ||
| imageother |
Additional, visually separated image | Map Icon Skeletron.png |
Will be displayed underneath all other images, above the statistics, separated by a horizontal line at the bottom of the infobox. Usually used for map icons or sprites of NPCs' temporary states (e.g. the "rolling" state of the Sroller). Can be a slash-separated ( | ||
| imageothercaption |
Caption of |
Rolling state |
Will be displayed underneath | ||
Statistics-related parameters | |||||
| type(deprecated: | type2,| type3) |
Classification and categorization | Boss |
Enemy |
Broad classifications like "Flying Enemy", "Critter", etc. Separate multiple values with a slash ( | |
| environment(deprecated: | environment2,| environment3) |
Native environment of the NPC | DesertForest+RainDesert / ForestDesert / Forest+Rain |
Biome in which or event during which the NPC naturally spawns. All environments will be linked if the respective page exists. A plus (The | ||
| ai |
AI style of the NPC | ✔️ | Fighter AI |
||
| damage |
Damage | ✔️ | |||
| damage2 |
Addition to the damage | Will be directly appended to | |||
| life |
Maximum health of the NPC | ✔️ | |||
| life2 |
Addition to the maximum health | Will be directly appended to | |||
| defense |
Defense of the NPC | ✔️ | |||
| defense2 |
Addition to the defense | Will be directly appended to | |||
| knockback |
Resistance to knockback of the NPC | ✔️ | |||
| knockback2 |
Addition to the knockback resistance | Will be directly appended to | |||
| banner |
Banner of the NPC | ✔️ | yes |
Setting it to Note that, if using | |
| immune(deprecated: | immune1| immune2... | immune<n>) |
Debuffs to which the NPC is immune | ✔️ | Poisoned / Frostburn |
The All immunity-related information will only be displayed if | |
| immuneall |
Immunity to all debuffs | ✔️ | yes |
All immunity-related information will only be displayed if | |
| immuneallnotwhips |
Immunity to all debuffs except whip debuffs | ✔️ | yes |
||
| immuneallnoteor | immunenote |
Addition to |
Will be directly appended to the text that is displayed if Example: All immunity-related information will only be displayed if | |||
Buff- & Debuff-related parameters | |||||
| buff |
Buff that the NPC causes | ❌ | Dryad's Blessing |
Name of the buff. As a shortcut for | buff = <name> / <duration> / <chance> <mode>. Chance and mode may also be omitted, and only the standard mode values[2] are allowed.
Examples:
| |
| idbuff |
Buff ID | ✔️ | |||
| bufflink |
Buff link target | ✔️ | |||
| bufftip |
Buff tooltip | ✔️ | |||
| buffchance |
Buff chance | ❌ | |||
| buffduration |
Buff duration | ❌ | Enter the value using the {{duration}} template. | ||
| buffmode |
Mode-exclusivity of the buff | ❌ | Can be one of the standard mode options[2] or | ||
| idbuffshow |
Vanity buff ID | ||||
| buff<n> |
Additional buff that the NPC causes | Can be continued nearly infinitely, e.g. buff2, buff3, etc.
| |||
| idbuff<n> |
Buff ID | ||||
| bufflink<n> |
Buff link target | ||||
| bufftip<n> |
Buff tooltip | ||||
| buffchance<n> |
Buff chance | ||||
| buffduration<n> |
Buff duration | ||||
| buffmode<n> |
Mode-exclusivity | ||||
| idbuffshow<n> |
Vanity buff ID | ||||
| debuff |
Debuff that the NPC inflicts | ❌ | See above. Debuffs and buffs are handled identically. | ||
| iddebuff |
Debuff ID | ✔️ | |||
| debufflink |
Debuff link target | ||||
| debufftip |
Debuff tooltip | ✔️ | |||
| debuffchance |
Debuff chance | ❌ | |||
| debuffduration |
Debuff duration | ❌ | |||
| debuffmode |
Mode-exclusivity of the debuff | ❌ | |||
| iddebuffshow |
Vanity debuff ID | ||||
| debuff<n> |
Additional debuff that the NPC causes | Can be continued nearly infinitely, e.g. debuff2, debuff3, etc.
| |||
| iddebuff<n> |
Debuff ID | ||||
| debufflink<n> |
Debuff link target | ||||
| debufftip<n> |
Debuff tooltip | ||||
| debuffchance<n> |
Debuff chance | ||||
| debuffduration<n> |
Debuff duration | ||||
| debuffmode<n> |
Mode-exclusivity | ||||
| iddebuffshow<n> |
Vanity debuff ID | ||||
Drop-related parameters | |||||
| money |
Base amount of money that the NPC drops | ✔️ | {{coin|3gc 80sc}} |
Use the {{钱币}} template. | |
| money2 |
Addition to dropped money | Will be directly appended to | |||
| <item name 1>
...
|
Dropped item | ❌ | |Gel|2–5|{{modes|75%|100%}}
|
Note that these are unnamed parameters, i.e., they are not used with an equals sign (=) like the other parameters.
| |
|:note:before |
Text above a dropped item | |:note:before|Drop rate depends on wave|#expert |
Note that these are unnamed parameters, i.e., they are not used with an equals sign (=) like the other parameters.
Adds some supplementary text above/below a dropped item, in the same row. Use {{note}} for appropriate styling. Use {{modes}} to display different texts for different modes. This note text is not stored to cargo and will therefore not appear in {{drop infobox}}. | ||
|:note:after |
Text below a dropped item | |:note:after|Drop rate depends on wave|#expert |
|||
|:note: |
Row with supplementary text | |:note:|Higher drop rates in later waves| |
Note that these are unnamed parameters, i.e., they are not used with an equals sign (=) like the other parameters.
Adds a row with some supplementary text, such as an explanation for the items below it. The text will be surrounded by a dashed border. Use {{note}} for appropriate styling. Use {{modes}} to display different texts for different modes. | ||
|:group:start
...
|
Group of dropped items | |:group:start|Only one of the following 4 will drop|@normal
...
|
Note that these are unnamed parameters, i.e., they are not used with an equals sign (=) like the other parameters.
| ||
|:loot:start
...
|
Subgroup of a dropped item | Note that these are unnamed parameters, i.e., they are not used with an equals sign (=) like the other parameters.
All items inside the section will be stored to cargo with the name of the item directly above the section, instead of the name of the NPC as usual. For example, preceding a loot section on Wall of Flesh that contains the Demon Heart with Treasure Bag (Wall of Flesh) will store the dropping entity of the Demon Heart as "Treasure Bag (Wall of Flesh)" instead of "Wall of Flesh", as would be the case with all items outside the loot section. | |||
| custom:<raw item name(s)> |
Custom dropped item | Note that these are unnamed parameters, i.e., they are not used with an equals sign (=) like the other parameters.
| |||
Projectile-related parameters | |||||
| idprojectile |
Projectile that the NPC creates | ❌ | 427
|
The ID of the projectile. Can be a comma-separated list for multiple projectiles. Each projectile ID can be a shortcut for ID, mode, and note, in the format <ID><mode>//<note> (the mode and note parts are optional). The mode part can only be one of the standard mode values[2]. To use a literal comma within a note, use the HTML entity , or ,.
| |
| projectileblock |
Projectile images arrangement | ❌ | yes |
no |
If yes, causes all projectile images to each take up a separate row. If no (the default), the images will be displayed in the same row (if there is enough space; this is seen with small projectile images and/or short projectile names).
|
Sound-related parameters | |||||
| soundhurt |
Hurt sound effect | ✔️ | NPC_Hit_1.wav |
Can be a comma-separated list for multiple sounds. Caption is "受伤害". Set to an empty value (|soundhurt=) to hide the automatically generated sounds.
| |
| soundkilled |
Killed sound effect | ✔️ | NPC_Killed_1.wav |
Can be a comma-separated list for multiple sounds. Caption is "被击杀". Set to an empty value (|soundkilled=) to hide the automatically generated sounds.
| |
| sound1 |
Custom additional sound effect | Can be a comma-separated list for multiple sounds. | |||
| soundcaption1 |
Caption for the sound effect | ||||
| soundmode1 |
Mode-exclusivity of the sound effect | |
Can be | ||
| sound2 |
Custom additional sound effect | See above. These parameters behave in the exact same manner. | |||
| soundcaption2 |
Caption for the sound effect | ||||
| soundmode2 |
Mode-exclusivity of the sound effect | ||||
| sound<n> |
Custom additional sound effect | Can be continued nearly infinitely. Sounds will only be displayed if there is a sound<n> parameter with a corresponding soundcaption<n> parameter.
| |||
| soundcaption<n> |
Caption for the sound effect | ||||
| soundmode<n> |
Mode-exclusivity of the sound effect | ||||
Back-end-related parameters | |||||
| cate |
Toggles all categorization | ❌ | no |
Set to | |
| listcat(deprecated: | listcat2) |
Categorization | ❌ | Supplemental category names (Category:<$listcat> NPCs). Separate multiple with a slash (Note: The template mainly categorizes the page based on the | ||
| allversions |
Platform version availability | ✔️ | |
Set to {{exclusive}} banner is on the page. If omitted, it will be detected automatically based on the result of {{eversions|<NPC name>}} (even though | |
| hardmode |
Hardmode-exclusivity | ❌ | yes |
Set to | |
| cargo |
Toggles cargo data storage | ❌ | no |
Set to | |
| cargodrops |
Toggles drops cargo data storage | ❌ | no |
By default, dropped item data will be stored to cargo if A frequently used example is in cases where an enemy with multiple parts, e.g. a worm, does not store its main infobox data to cargo (since only the individual parts should be stored), but contains the drop information in the main infobox, which should be stored to cargo. | |
| cargobanner |
Prevents banner cargo data storage | ❌ | no |
If using | |
| idcargo |
NPC ID to store to cargo | ❌ | 201 |
Can be a comma-separated list. Can also be left empty to prevent cargo storage as well. | |
| imagecargo |
NPC image to store to cargo | ❌ | [[File:Skeleton.png]] |
Define an image to store to cargo, completely overriding the image parameters. | |
Subpages
There are numerous supplemental subpages which are mainly used for formatting certain data:
- Template:Npc infobox/AI
- Template:Npc infobox/customView
- Template:Npc infobox/drop
- Template:Npc infobox/environment
- Template:Npc infobox/infoboxView
- Template:Npc infobox/initOptions
- Template:Npc infobox/itemView
- Template:Npc infobox/knockback
- Template:Npc infobox/l10n
- Template:Npc infobox/modestat
- Template:Npc infobox/namedb-en
- Template:Npc infobox/namedb-zh
- Template:Npc infobox/npcToBannerItemId
- Template:Npc infobox/options
- Template:Npc infobox/stat
- Template:Npc infobox/strip
- Template:Npc infobox/tableView
- Template:Npc infobox/tableView/damage
- Template:Npc infobox/tableView/damageBlock
- Template:Npc infobox/tableView/defense
- Template:Npc infobox/tableView/defenseBlock
- Template:Npc infobox/tableView/drops
- Template:Npc infobox/tableView/health
- Template:Npc infobox/tableView/healthBlock
- Template:Npc infobox/tableView/item
- Template:Npc infobox/tableView/kbresist
- Template:Npc infobox/tableView/kbresistBlock
- Template:Npc infobox/tableView/money
- Template:Npc infobox/tableView/moneyBlock
- Template:Npc infobox/tableView/npcid
- Template:Npc infobox/tableView/variant
- Template:Npc infobox/tableend
- Template:Npc infobox/tablestart
- Template:Npc infobox/voidView
See also
- {{item infobox}}
Footnotes
- ↑
de(German),es(Spanish),fr(French),it(Italian),pl(Polish),pt(Portuguese),ru(Russian),zh(Chinese) - ↑ 2.0 2.1 2.2 2.3 2.4 2.5 2.6
The following values are available:
@normal@expert@master#normal#expert#master
- ↑ A root page is a page that is not a subpage. This prevents language subpages from storing duplicates by default.