Module:HeroData/doc: Difference between revisions

From The Deadlock Wiki
Jump to navigation Jump to search
Browse history interactively
← Older edit

Vergir (talk | contribs)

2 user groups
1,631 edits
undo
VisualWikitext
Sur (talk | contribs)
Moderators
2,147 edits
m sig_figs example; spacing
Vergir (talk | contribs)
Contributors, Interface administrators
1,631 edits
Document resolve_key, has_tags and the shared Lua helpers; drop removed get_similar_items; mark get_hero_scaling_data deprecated (with help from vergir-bot LLM)
 
(31 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Also see:
* [[Module:HeroData/nav]] - For nav box purposes
* [[Module:HeroData/release]] - For determining the release status of a hero
* [[Module:HeroDataArrays]] - For tables in stat pages
== Overview ==
== Overview ==


Line 11: Line 16:
== Functions ==
== Functions ==


=== write_infobox ===
=== get_hero_var ===
Writes a [[Template:Infobox_hero]] template call for a given hero
Retrieve a hero variable's value, such as Abram's MaxHealth


====Parameters====
====Parameters====
* '''hero_name''' – Name of the hero, in english
* '''hero_name''' - Name of the hero in english, or key of the hero. Preferred and recommended to use hero key, as its much more efficient. Search for the key in [[Data:HeroData.json]]
 
* '''hero_var''' - Key of the hero's variable, see [[Data:HeroData.json]]
====Example====
* '''sig_figs_or_localize''' - OPTIONAL, # of sig figs to round to if retrieving a float, or "true" if its a string that should be localized. See Localizable values section.
From wikitext:<br>
<pre>{{#invoke:HeroData|write_infobox|HERO_NAME}}</pre>


Which outputs
Note: Recommended to use hero key where possible, i.e. hero_atlas as its O(1) time complexity instead of hero name (Abrams) which is O(N).
{{#invoke:HeroData|write_infobox|Abrams}}


=== write_stat_infoboxes ===
====Examples====
Writes all 3 [[Template:StatBox]] template calls (Weapon, Vitality, Spirit) for a given hero
 
====Parameters====
* '''hero_name''' – Name of the hero, in english
 
====Example====
From wikitext:<br>
From wikitext:<br>
<pre>{{#invoke:HeroData|write_stat_infoboxes|HERO_NAME}}</pre>
Using hero name in english


Which outputs
<pre>{{#invoke:HeroData|get_hero_var|Abrams|MaxHealth}}</pre>
{{#invoke:HeroData|write_stat_infoboxes|Abrams}}
{{#invoke:HeroData|get_hero_var|Abrams|MaxHealth}}


=== get_hero_var ===
Retrieve a hero variable's value, such as Abram's MaxHealth


====Parameters====
Using hero key
* '''hero_name''' - Name of the hero, in english
* '''hero_var''' - Key of the hero's variable, see [[Data:HeroData.json]]
* '''sig_figs''' - OPTIONAL, # of sig figs to round to if retrieving a float


====Examples====
<pre>{{#invoke:HeroData|get_hero_var|hero_atlas|MaxHealth}}</pre>
From wikitext<br>:
{{#invoke:HeroData|get_hero_var|hero_atlas|MaxHealth}}
<pre>{{#invoke:HeroData|get_hero_var|Abrams|MaxHealth}}</pre>
{{#invoke:HeroData|get_hero_var|Abrams|MaxHealth}}




Line 54: Line 43:
{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange}}
{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange}}


Round to 2 sig figs


<pre>{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange|2}}</pre>
<pre>{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange|2}}</pre>
{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange|2}}
{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange|2}}


<pre>{{#invoke:HeroData|get_hero_var|Abrams|WeaponName}}</pre>
{{#invoke:HeroData|get_hero_var|Abrams|WeaponName}}
Localize
<pre>{{#invoke:HeroData|get_hero_var|Abrams|WeaponName|true}}</pre>
{{#invoke:HeroData|get_hero_var|Abrams|WeaponName|true}}


====Notes====
====Notes====
Line 64: Line 64:
If using sig_figs parameter, ensure the value is a float.
If using sig_figs parameter, ensure the value is a float.


=== get_localized_var ===
If using localize parameter, ensure the value is a string. See [[Data:HeroData.json]], you will notice that hero_astro's "Lore" variable has the value "hero_astro_lore". This key is then sent to [[Module:Lang]] which checks for it in [[Data:Lang_en.json]] (or a different language).
Get a hero's stat, then localize it


====Parameters====
This function will automatically search for the variable in the hero's top-level data, then the 'Weapon' block, then the 'AltFire' block.
* '''hero_name''' - Name of the hero, in english
 
=== get_alt_fire_var ===
Retrieve a hero's variable's value from "AltFire" table. Works the same as get_hero_var
 
====Examples====
 
<pre>{{#invoke:HeroData|get_alt_fire_var|Viscous|BulletDamage}}</pre>
{{#invoke:HeroData|get_alt_fire_var|Viscous|BulletDamage}}
 
=== get_list_elem ===
Retrieve a specified element from a list
 
==== Parameters ====
* '''hero_name''' - Name of the hero in english, or hero key. Preferred and recommended to use hero key, as its much more efficient. Search for the key in [[Data:HeroData.json]]
* '''hero_var''' - Key of the hero's variable, see [[Data:HeroData.json]]
* '''hero_var''' - Key of the hero's variable, see [[Data:HeroData.json]]
* '''number''' - Index to retrieve from the list. 1 for 1st element, 2 for 2nd element, etc.
* '''localize''' - OPTIONAL - "true" if its a string that should be localized. See Localizable values section.


====Examples====
==== Example ====
From wikitext:<br>
From wikitext:<br>
<pre>{{#invoke:HeroData|get_localized_var|Abrams|WeaponName}}</pre>
Using hero name in english
{{#invoke:HeroData|get_localized_var|Abrams|WeaponName}}
<pre>{{#invoke:HeroData|get_list_elem|Abrams|WeaponTypes|2}}</pre>
{{#invoke:HeroData|get_list_elem|Abrams|WeaponTypes|2}}
 
 
Using hero key
<pre>{{#invoke:HeroData|get_list_elem|hero_atlas|WeaponTypes|2}}</pre>
{{#invoke:HeroData|get_list_elem|hero_atlas|WeaponTypes|2}}
 


<pre>{{#invoke:HeroData|get_list_elem|Abrams|WeaponTypes|2|true}}</pre>
{{#invoke:HeroData|get_list_elem|Abrams|WeaponTypes|2|true}}


<pre>{{#invoke:HeroData|get_localized_var|Abrams|Role}}</pre>
{{#invoke:HeroData|get_localized_var|Abrams|Role}}


=== get_hero_scalar ===
Retrieve a hero variable's scalar value that is inside either "Spirit Scaling" or "Level Scaling", such as Abram's BulletDamage (scaling).
====Parameters====
* '''hero_key''' - Key of the hero. Search for the key of a given hero in [[Data:HeroData.json]]
* '''scaling_type''' - "Spirit" or "Level"
* '''hero_var''' - Key of the hero's variable that is inside either "Spirit Scaling" or "Level Scaling", see [[Data:HeroData.json]]
* '''sig_figs_or_localize''' - OPTIONAL, # of sig figs to round to.
* '''no_template''' - OPTIONAL, return numerical value instead of scaling template. Has to be defined as "true"
====Examples====
<pre>{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage}}</pre>
{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage}}
Round to 2 sig figs
<pre>{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage|2}}</pre>
{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage|2}}
No template
<pre>{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage|2|no_template=true}}</pre>
{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage|2|no_template=true}}


====Notes====
====Notes====
Only usable on variables that can be localized. See [[Data:HeroData.json]], you will notice that hero_astro's "Lore" variable has the value "hero_astro_lore". This key is then sent to [[Module:Lang]] which checks for it in [[Data:Lang_en.json]] (or a different language).
If the scaling type or the stat key is not found in the hero's data, this function returns an empty string instead of an error message.


As of writing this (not exhaustive), localizable variables include:
=== hero_has_stat ===
Checks if a hero possesses a specific stat in their Base data, Level Scaling (Boons), or Spirit Scaling. Used primarily for conditionally hiding rows in infoboxes.
 
The base value is looked up in the hero's top-level data, then the 'Weapon' block, then the 'AltFire' block, the same as get_hero_var. A stat counts as present when its base value is non-zero, or when it has any non-zero scaling.
 
====Parameters====
* '''hero_key''' - Key of the hero.
* '''stat_key''' - Key of the stat to check (e.g., BulletResist, TechResist).
 
====Example====
<pre>{{#invoke:HeroData|hero_has_stat|hero_kelvin|TechResist}}</pre>
{{#invoke:HeroData|hero_has_stat|hero_kelvin|TechResist}}
 
=== get_hero_key ===
Returns the key of the specified hero's english name. A hero key may also be passed, in which case it is returned unchanged. Matching is case-insensitive. Returns "Hero not found." when the input matches no hero.
 
====Parameters====
* '''hero_name''' - Name of the hero in english, or a hero key
 
====Example====
<pre>{{#invoke:HeroData|get_hero_key|Abrams}}</pre>
 
=== resolve_key ===
The same lookup as get_hero_key, but returns an empty string instead of "Hero not found." when the input matches no hero. Intended for templates that need to branch on whether the input names a hero at all.
 
====Parameters====
* '''hero_name_or_key''' - Name of the hero in english, or a hero key
 
====Example====
<pre>{{#invoke:HeroData|resolve_key|Abrams}}</pre>
{{#invoke:HeroData|resolve_key|Abrams}}
 
=== get_ability_key ===
Gets the ability key from a hero's bound ability slot
 
====Parameters====
* '''hero_key''' - Key of the hero
* '''slot_number''' - Slot number (1-based index)
 
====Example====
<pre>{{#invoke:HeroData|get_ability_key|hero_atlas|1}}</pre>
 
=== get_hero_tag ===
Retrieve a hero's description tags with [[Module:Lang]], to be used in [[Template:HeroRosterCard]] and [[Template:Infobox hero]]
 
====Parameters====
* '''name''' - Name of the hero in english. This is normally referenced from the template parameters
* '''number''' - Which tag to call (1, 2 or 3)
 
====Example====
<pre>{{#invoke:HeroData|get_hero_tag|Abrams|1}}</pre>
 
=== has_tags ===
Returns "true" when the hero has description tags, or an empty string otherwise. Intended for templates that need to hide a tag block entirely for heroes without tags.
 
====Parameters====
* '''name''' - Name of the hero in english
 
====Example====
<pre>{{#invoke:HeroData|has_tags|Abrams}}</pre>
{{#invoke:HeroData|has_tags|Abrams}}
 
=== write_role_playstyle_quote ===
Writes a formatted role and playstyle quotation for a hero
 
====Parameters====
* '''hero_key''' - Key of the hero
 
====Example====
<pre>{{#invoke:HeroData|write_role_playstyle_quote|hero_atlas}}</pre>
 
=== write_default_items ===
Writes the recommended items list for a hero
 
====Parameters====
* '''hero_key''' - Key of the hero (unlocalized)
 
====Example====
<pre>{{#invoke:HeroData|write_default_items|hero_atlas}}</pre>
 
=== write_ground_dash_buckets ===
Outputs a wikitable of heroes grouped by their GroundDashDuration using [[Template:HeroIcon]]
 
====Example====
 
<pre>{{#invoke:HeroData|write_ground_dash_buckets}}</pre>
 
{{#invoke:HeroData|write_ground_dash_buckets}}
 
== Localizable values ==
Localizable values as of writing this:
* Hero names (via hero keys)
* Lore
* Lore
* Playstyle
* Playstyle
Line 90: Line 223:
* WeaponDescription
* WeaponDescription
* WeaponName
* WeaponName
* TODO each value in WeaponTypes
* elements in WeaponTypes
* elements in RecommendedItems
* All stat labels and postfixes
* Ability descriptions and names
* Hero tags (1, 2, 3)
 
== Internal Utility Functions ==
The following functions are called directly from Lua by other modules, not from wikitext:
 
=== get_json_item ===
Returns the table of a specific hero by name
 
====Parameters====
* '''name''' - Name of the hero in english
 
=== get_stat ===
Returns the value of a stat, checking the hero's top-level data, then the 'Weapon' block, then the 'AltFire' block. Returns nil when the hero has no such stat. This is the shared lookup behind get_hero_var, get_list_elem and hero_has_stat.
 
====Parameters====
* '''hero_data''' - Hero table, such as the one returned by get_json_item
* '''stat''' - Key of the stat
 
=== get_scalings ===
Returns an ordered list of a hero's scalings for a stat, Level first then Spirit:
 
<pre>{ { type = "Level", value = 1.5 }, { type = "Spirit", value = 0.04 } }</pre>
 
Absent and zero scalings are omitted, so an empty list means the stat does not scale.
 
====Parameters====
* '''hero_data''' - Hero table
* '''stat''' - Key of the stat
* '''include_zero''' - OPTIONAL, keep scalings whose value is 0. Only get_hero_scaling_data needs this.
 
=== has_stat ===
Returns true when a hero has a non-zero base value for a stat, or any scaling for it. Backs hero_has_stat.
 
====Parameters====
* '''hero_data''' - Hero table
* '''stat''' - Key of the stat
 
=== find_hero_key ===
Resolves a hero key or an english hero name to a hero key, case-insensitively. Returns nil when the input matches no hero. Backs get_hero_key and resolve_key.
 
====Parameters====
* '''input''' - Hero key or english hero name
 
=== hero_tag ===
Returns a hero's Nth description tag, or an empty string when there is no such tag. Backs get_hero_tag and has_tags.
 
====Parameters====
* '''hero_en''' - Name of the hero in english
* '''index''' - Which tag to return (1, 2 or 3)
 
=== write_scalar_str ===
Returns the expanded <code>Ss</code> or <code>PI</code> template for a scaling value, or an empty string when the value is 0.
 
====Parameters====
* '''scaling_value''' - The scaling amount
* '''scaling_type''' - "Spirit" or "Level"
* '''compact''' - OPTIONAL, render the compact form with the value shown
 
=== get_hero_scaling_data ===
'''Deprecated''', use get_scalings instead. Returns a table keyed by scaling value, so an entry is silently dropped when Level and Spirit scale by the same amount, and zero scalings are kept. Retained only for [[Module:HeroComparisonTable]].
 
====Parameters====
* '''hero_data''' - Hero table
* '''stat''' - Key of the stat
 
== Scaling System ==
The module supports two types of scaling:
* '''Spirit Scaling''' - Affects stats based on Spirit Power
* '''Level Scaling''' - Affects stats based on Power Increases/Levels/Boons

Latest revision as of 13:36, 11 August 2026

Also see:

Overview

[edit source]

This module provides functions to create hero infoboxes, statboxes, or retrieve hero information using the data uploaded to Data:HeroData.json.

Both will automatically be translated depending on the language selected. If called on

  • Page - translates to english
  • Page/en - translates to english
  • Page/es - translates to spanish

See Template:Lang for more

Functions

[edit source]

get_hero_var

[edit source]

Retrieve a hero variable's value, such as Abram's MaxHealth

Parameters

[edit source]
  • hero_name - Name of the hero in english, or key of the hero. Preferred and recommended to use hero key, as its much more efficient. Search for the key in Data:HeroData.json
  • hero_var - Key of the hero's variable, see Data:HeroData.json
  • sig_figs_or_localize - OPTIONAL, # of sig figs to round to if retrieving a float, or "true" if its a string that should be localized. See Localizable values section.

Note: Recommended to use hero key where possible, i.e. hero_atlas as its O(1) time complexity instead of hero name (Abrams) which is O(N).

Examples

[edit source]

From wikitext:
Using hero name in english 

{{#invoke:HeroData|get_hero_var|Abrams|MaxHealth}}

800


Using hero key 

{{#invoke:HeroData|get_hero_var|hero_atlas|MaxHealth}}

800 


{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange}}

17


Round to 2 sig figs 

{{#invoke:HeroData|get_hero_var|Abrams|FalloffStartRange|2}}

17 


{{#invoke:HeroData|get_hero_var|Abrams|WeaponName}}

0


Localize 

{{#invoke:HeroData|get_hero_var|Abrams|WeaponName|true}}

0

Notes

[edit source]

Only usable on variables that are integers, strings, or floats (meaning not dictionaries/hashes or arrays/lists).

If using sig_figs parameter, ensure the value is a float.

If using localize parameter, ensure the value is a string. See Data:HeroData.json, you will notice that hero_astro's "Lore" variable has the value "hero_astro_lore". This key is then sent to Module:Lang which checks for it in Data:Lang_en.json (or a different language).

This function will automatically search for the variable in the hero's top-level data, then the 'Weapon' block, then the 'AltFire' block.

get_alt_fire_var

[edit source]

Retrieve a hero's variable's value from "AltFire" table. Works the same as get_hero_var

Examples

[edit source]
{{#invoke:HeroData|get_alt_fire_var|Viscous|BulletDamage}}

42

get_list_elem

[edit source]

Retrieve a specified element from a list

Parameters

[edit source]
  • hero_name - Name of the hero in english, or hero key. Preferred and recommended to use hero key, as its much more efficient. Search for the key in Data:HeroData.json
  • hero_var - Key of the hero's variable, see Data:HeroData.json
  • number - Index to retrieve from the list. 1 for 1st element, 2 for 2nd element, etc.
  • localize - OPTIONAL - "true" if its a string that should be localized. See Localizable values section.

Example

[edit source]

From wikitext:
Using hero name in english 

{{#invoke:HeroData|get_list_elem|Abrams|WeaponTypes|2}}

Attribute_EWeaponAttribute_CloseRange


Using hero key 

{{#invoke:HeroData|get_list_elem|hero_atlas|WeaponTypes|2}}

Attribute_EWeaponAttribute_CloseRange 


{{#invoke:HeroData|get_list_elem|Abrams|WeaponTypes|2|true}}

Close Range


get_hero_scalar

[edit source]

Retrieve a hero variable's scalar value that is inside either "Spirit Scaling" or "Level Scaling", such as Abram's BulletDamage (scaling).

Parameters

[edit source]
  • hero_key - Key of the hero. Search for the key of a given hero in Data:HeroData.json
  • scaling_type - "Spirit" or "Level"
  • hero_var - Key of the hero's variable that is inside either "Spirit Scaling" or "Level Scaling", see Data:HeroData.json
  • sig_figs_or_localize - OPTIONAL, # of sig figs to round to.
  • no_template - OPTIONAL, return numerical value instead of scaling template. Has to be defined as "true"

Examples

[edit source]
{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage}}

+0.1

Round to 2 sig figs 

{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage|2}}

+0.1

No template 

{{#invoke:HeroData|get_hero_scalar|hero_atlas|Level|BulletDamage|2|no_template=true}}

0.1

Notes

[edit source]

If the scaling type or the stat key is not found in the hero's data, this function returns an empty string instead of an error message.

hero_has_stat

[edit source]

Checks if a hero possesses a specific stat in their Base data, Level Scaling (Boons), or Spirit Scaling. Used primarily for conditionally hiding rows in infoboxes.

The base value is looked up in the hero's top-level data, then the 'Weapon' block, then the 'AltFire' block, the same as get_hero_var. A stat counts as present when its base value is non-zero, or when it has any non-zero scaling.

Parameters

[edit source]
  • hero_key - Key of the hero.
  • stat_key - Key of the stat to check (e.g., BulletResist, TechResist).

Example

[edit source]
{{#invoke:HeroData|hero_has_stat|hero_kelvin|TechResist}}

true

get_hero_key

[edit source]

Returns the key of the specified hero's english name. A hero key may also be passed, in which case it is returned unchanged. Matching is case-insensitive. Returns "Hero not found." when the input matches no hero.

Parameters

[edit source]
  • hero_name - Name of the hero in english, or a hero key

Example

[edit source]
{{#invoke:HeroData|get_hero_key|Abrams}}

resolve_key

[edit source]

The same lookup as get_hero_key, but returns an empty string instead of "Hero not found." when the input matches no hero. Intended for templates that need to branch on whether the input names a hero at all.

Parameters

[edit source]
  • hero_name_or_key - Name of the hero in english, or a hero key

Example

[edit source]
{{#invoke:HeroData|resolve_key|Abrams}}

hero_atlas

get_ability_key

[edit source]

Gets the ability key from a hero's bound ability slot

Parameters

[edit source]
  • hero_key - Key of the hero
  • slot_number - Slot number (1-based index)

Example

[edit source]
{{#invoke:HeroData|get_ability_key|hero_atlas|1}}

get_hero_tag

[edit source]

Retrieve a hero's description tags with Module:Lang, to be used in Template:HeroRosterCard and Template:Infobox hero

Parameters

[edit source]
  • name - Name of the hero in english. This is normally referenced from the template parameters
  • number - Which tag to call (1, 2 or 3)

Example

[edit source]
{{#invoke:HeroData|get_hero_tag|Abrams|1}}

has_tags

[edit source]

Returns "true" when the hero has description tags, or an empty string otherwise. Intended for templates that need to hide a tag block entirely for heroes without tags.

Parameters

[edit source]
  • name - Name of the hero in english

Example

[edit source]
{{#invoke:HeroData|has_tags|Abrams}}

true

write_role_playstyle_quote

[edit source]

Writes a formatted role and playstyle quotation for a hero

Parameters

[edit source]
  • hero_key - Key of the hero

Example

[edit source]
{{#invoke:HeroData|write_role_playstyle_quote|hero_atlas}}

write_default_items

[edit source]

Writes the recommended items list for a hero

Parameters

[edit source]
  • hero_key - Key of the hero (unlocalized)

Example

[edit source]
{{#invoke:HeroData|write_default_items|hero_atlas}}

write_ground_dash_buckets

[edit source]

Outputs a wikitable of heroes grouped by their GroundDashDuration using Template:HeroIcon

Example

[edit source]
{{#invoke:HeroData|write_ground_dash_buckets}}
Hero Dash Buckets
Bucket 1 Bucket 2 Bucket 3
Calico Apollo Abrams
Celeste Billy Bebop
Grey Talon Drifter Dynamo
Haze Graves Kelvin
Holliday Infernus Lady Geist
Ivy Lash Mo & Krill
Mina McGinnis Paige
Paradox Mirage Rem
The Doorman Pocket Shiv
Seven Venator
Silver Victor
Silver (Transformed)
Sinclair
Vindicta
Viscous
Vyper
Warden
Wraith
Yamato

Localizable values

[edit source]

Localizable values as of writing this:

  • Hero names (via hero keys)
  • Lore
  • Playstyle
  • Role
  • WeaponDescription
  • WeaponName
  • elements in WeaponTypes
  • elements in RecommendedItems
  • All stat labels and postfixes
  • Ability descriptions and names
  • Hero tags (1, 2, 3)

Internal Utility Functions

[edit source]

The following functions are called directly from Lua by other modules, not from wikitext:

get_json_item

[edit source]

Returns the table of a specific hero by name

Parameters

[edit source]
  • name - Name of the hero in english

get_stat

[edit source]

Returns the value of a stat, checking the hero's top-level data, then the 'Weapon' block, then the 'AltFire' block. Returns nil when the hero has no such stat. This is the shared lookup behind get_hero_var, get_list_elem and hero_has_stat.

Parameters

[edit source]
  • hero_data - Hero table, such as the one returned by get_json_item
  • stat - Key of the stat

get_scalings

[edit source]

Returns an ordered list of a hero's scalings for a stat, Level first then Spirit: 

{ { type = "Level", value = 1.5 }, { type = "Spirit", value = 0.04 } }

Absent and zero scalings are omitted, so an empty list means the stat does not scale.

Parameters

[edit source]
  • hero_data - Hero table
  • stat - Key of the stat
  • include_zero - OPTIONAL, keep scalings whose value is 0. Only get_hero_scaling_data needs this.

has_stat

[edit source]

Returns true when a hero has a non-zero base value for a stat, or any scaling for it. Backs hero_has_stat.

Parameters

[edit source]
  • hero_data - Hero table
  • stat - Key of the stat

find_hero_key

[edit source]

Resolves a hero key or an english hero name to a hero key, case-insensitively. Returns nil when the input matches no hero. Backs get_hero_key and resolve_key.

Parameters

[edit source]
  • input - Hero key or english hero name

hero_tag

[edit source]

Returns a hero's Nth description tag, or an empty string when there is no such tag. Backs get_hero_tag and has_tags.

Parameters

[edit source]
  • hero_en - Name of the hero in english
  • index - Which tag to return (1, 2 or 3)

write_scalar_str

[edit source]

Returns the expanded Ss or PI template for a scaling value, or an empty string when the value is 0.

Parameters

[edit source]
  • scaling_value - The scaling amount
  • scaling_type - "Spirit" or "Level"
  • compact - OPTIONAL, render the compact form with the value shown

get_hero_scaling_data

[edit source]

Deprecated, use get_scalings instead. Returns a table keyed by scaling value, so an entry is silently dropped when Level and Spirit scale by the same amount, and zero scalings are kept. Retained only for Module:HeroComparisonTable.

Parameters

[edit source]
  • hero_data - Hero table
  • stat - Key of the stat

Scaling System

[edit source]

The module supports two types of scaling:

  • Spirit Scaling - Affects stats based on Spirit Power
  • Level Scaling - Affects stats based on Power Increases/Levels/Boons
Retrieved from "https://deadlock.wiki/Module:HeroData/doc?oldid=108399"