Template:Abundance

From HorizonXI Wiki
Revision as of 15:54, 30 October 2023 by Aramachus (talk | contribs) (added comments to the code to describe what each part does)

Usage

This section describes how the Abundance template works. If you are looking for rules and guidelines on use, see HorizonXIwiki:Drop Rate Policy.

{{Abundance|total items obtained|total attempts to obtain}}
  • This template is used to collect and present rarity/abundance data. It is intended to collect data from multiple users and keep a running total (new results are added to the existing totals rather than replacing them), thus becoming more accurate over time.
  • The template automatically displays the general rarity of the item using the following ranges:
Abundance Range
Extremely Rare 0 - 1%
Very Rare 1 - 5%
Rare 5 - 10%
Uncommon 10 - 15%
Common 15 - 20%
Very Common 20 - 50%
Extremely Common 50 - 100%
  • The abundance is also displayed as a percent value after the text (in superscript) and the exact number of items obtained and attempts to obtain the item are displayed in the hovertext, as well as a message describing the data's current reliablity.
  • If the data is too low to be considered reliable (less than 50 attempts), the abundance percent will be colored gray and More data needed will be displayed in place of the usual text.
  • If the data is low, but not completely unreliable (less than 500 attempts), the abundance percent will simply be colored gray.
  • "Map" (case-insensitive) can be used as the "number of items" value to display "Received if not previously obtained".
  • "Quest" (case-insensitive) can be used as the "number of items" value to display "Received with quest active".
  • optional parameter CI has been added to display a 95% confidence interval. Setting it to true, e.g. {{Abundance|98|232|CI=true}} will display the confidence interval in the output.

Examples

Code Result Result with CI
{{Abundance|map}}
101%Received if not previously obtained 101%Received if not previously obtained
{{Abundance|quested}}
101%Received with quest active 101%Received with quest active
{{Abundance||}}
0%Unknown(0%) 0%Unknown(0%)
{{Abundance|0|0}}
0%Unknown(0%) 0%Unknown(0%)
{{Abundance|0|5}}
0%More data needed.(0%) 0%More data needed.(0+/-60%)
{{Abundance|1|10}}
10%More data needed.(10%) 10%More data needed.(10+/-30%)
{{Abundance|2|1503}}
0.1%Extremely Rare(0.1%) 0.1%Extremely Rare(0.1+/-0.2%)
{{Abundance|24|153}}
15.7%Common(15.7%) 15.7%Common(15.7+/-5.8%)
{{Abundance|100|344}}
29.1%Very Common(29.1%) 29.1%Very Common(29.1+/-4.8%)
{{Abundance|443|562}}
78.8%Extremely Common(78.8%) 78.8%Extremely Common(78.8+/-3.4%)
{{Abundance|11|625}}
1.8%Very Rare(1.8%) 1.8%Very Rare(1.8+/-1%)
{{Abundance|108|110}}
98.2%Extremely Common(98.2%) 98.2%Extremely Common(98.2+/-2.7%)