Template:NpcData/doc: Difference between revisionsGive feedback
Created page with "This template is a shortcut for Module:NpcData to make it easier to display NPC stats on a page. It can be used to get a single stat (like `MaxHealth`) or an item from a list of stats (like the 4th value in a list of resistances). == How to Use == === Getting a Single Stat === This is the most common use. Provide the information in the following order. '''Syntax''' <code><nowiki>{{NpcData|NPC Name|Stat Name|Rounding}}</nowiki></code> '''Parameters''' * '''First..." |
Added templatedata |
||
| Line 41: | Line 41: | ||
** '''Code:''' <code><nowiki>{{NpcData|npc_boss_tier2|NearbyEnemyResistanceValues|index=4}}</nowiki></code> | ** '''Code:''' <code><nowiki>{{NpcData|npc_boss_tier2|NearbyEnemyResistanceValues|index=4}}</nowiki></code> | ||
** '''Result:''' {{NpcData|npc_boss_tier2|NearbyEnemyResistanceValues|index=4}} | ** '''Result:''' {{NpcData|npc_boss_tier2|NearbyEnemyResistanceValues|index=4}} | ||
<templatedata> | |||
{ | |||
"description": "A shortcut for Module:NpcData to display stats for NPCs, either a single value or an item from a list.", | |||
"params": { | |||
"1": { | |||
"label": "NPC Name", | |||
"description": "The internal key for the NPC (e.g., npc_boss_tier2).", | |||
"type": "string", | |||
"required": true, | |||
"example": "trooper_medic", | |||
"aliases": [ "npc" ] | |||
}, | |||
"2": { | |||
"label": "Stat or List Name", | |||
"description": "The name of the stat (e.g., MaxHealth) or the list (e.g., NearbyEnemyResistanceValues).", | |||
"type": "string", | |||
"required": true, | |||
"example": "MaxHealth", | |||
"aliases": [ "stat" ] | |||
}, | |||
"3": { | |||
"label": "Rounding", | |||
"description": "(Optional) A number to round a stat to that many significant figures. Does not apply when getting an item from a list.", | |||
"type": "number", | |||
"required": false, | |||
"aliases": [ "round" ] | |||
}, | |||
"index": { | |||
"label": "Index", | |||
"description": "The position of the item to get from a list (e.g., 4 for the 4th item). Using this parameter changes the template's behavior to get an item from a list.", | |||
"type": "number", | |||
"required": false, | |||
"example": "4" | |||
} | |||
}, | |||
"format": "inline" | |||
} | |||
</templatedata> | |||
<includeonly> | |||
[[Category:Templates]] | |||
</includeonly><noinclude> | |||
[[Category:Template documentation]] | |||
</noinclude> | |||
Revision as of 16:13, 1 October 2025
This template is a shortcut for Module:NpcData to make it easier to display NPC stats on a page.
It can be used to get a single stat (like `MaxHealth`) or an item from a list of stats (like the 4th value in a list of resistances).
How to Use
Getting a Single Stat
This is the most common use. Provide the information in the following order.
Syntax
{{NpcData|NPC Name|Stat Name|Rounding}}
Parameters
- First parameter (NPC Name): The internal key for the NPC (e.g., `npc_boss_tier2`).
- Second parameter (Stat Name): The name of the stat you want to look up (e.g., `MaxHealth`).
- Third parameter (Rounding): (Optional) A number to round the result to that many significant figures.
Examples
- To get the max health of a Medic Trooper:
- Code:
{{NpcData|trooper_medic|MaxHealth}} - Result: 350
- Code:
- If you misspell a stat, you will see an error:
- Code:
{{NpcData|trooper_medic|MaxHeath}} - Result: Error: Key "MaxHeath" not found in path "trooper_medic".
- Code:
Getting an Item from a List
To get a single value from a list, you must use the named `index=` parameter.
Syntax
{{NpcData|NPC Name|List Name|index=Position Number}}
Parameters
- First parameter (NPC Name): The internal key for the NPC.
- Second parameter (List Name): The name of the list property (e.g., `NearbyEnemyResistanceValues`).
- index= The position in the list. The first item is `1`, the second is `2`, and so on.
Example
- The Tier 2 Boss has a list of resistance values. To get the 4th value in that list:
- Code:
{{NpcData|npc_boss_tier2|NearbyEnemyResistanceValues|index=4}} - Result: Error: Key "NearbyEnemyResistanceValues" not found in path "npc_boss_tier2".
- Code:
A shortcut for Module:NpcData to display stats for NPCs, either a single value or an item from a list.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| NPC Name | 1 npc | The internal key for the NPC (e.g., npc_boss_tier2).
| String | required |
| Stat or List Name | 2 stat | The name of the stat (e.g., MaxHealth) or the list (e.g., NearbyEnemyResistanceValues).
| String | required |
| Rounding | 3 round | (Optional) A number to round a stat to that many significant figures. Does not apply when getting an item from a list. | Number | optional |
| Index | index | The position of the item to get from a list (e.g., 4 for the 4th item). Using this parameter changes the template's behavior to get an item from a list.
| Number | optional |