Module:Droprate

Overview

Functions for making loot table. Data comes from Loot:Monster.json, Loot:Prop.json, Loot:Loose Loot.json, and the Loot: namespace.

Functions

loot_tables

Creates a table of drops

• name - Name of the object
• category - Monster, Prop, Loose Loot

{{#invoke:Droprate|loot_tables|name=Lich|category=Monster}}

Loot Tables

Common

Elite

Default

PvE

LR

Default

Monsters_Bosses

Key_High

Key_Med

QuestItemDefaultCommon

QuestItemDefaultCommon

EventCurrency

Rolls: 3

Drop rates 

Luck grade	Probability	Probability per item	Item count
4	20%	0.5%	40
5	80%	2%	40

Loot Table 

Name	Luck Grade	Rarity	Item Count
Stitched Turnshoe	4	Rare	1
	5	Epic	1
Heavy Gauntlets	4	Rare	1
	5	Epic	1
Darkleaf Boots	4	Rare	1
	5	Epic	1
Cuffed Boots	4	Rare	1
	5	Epic	1
Mystic Gloves	4	Rare	1
	5	Epic	1
Rugged Boots	4	Rare	1
	5	Epic	1
Reinforced Gloves	4	Rare	1
	5	Epic	1
Buttoned Boots	4	Rare	1
	5	Epic	1
Low Boots	4	Rare	1
	5	Epic	1
Plate Boots	4	Rare	1
	5	Epic	1
Buckled Boots	4	Rare	1
	5	Epic	1
Pigache	4	Rare	1
	5	Epic	1
Dashing Boots	4	Rare	1
	5	Epic	1
Adventurer Boots	4	Rare	1
	5	Epic	1
Jester Poulaines	4	Rare	1
	5	Epic	1
Bloodwoven Gloves	4	Rare	1
	5	Epic	1
Onyx Gloves	4	Rare	1
	5	Epic	1
Arcane Gloves	4	Rare	1
	5	Epic	1
Gloves of Utility	4	Rare	1
	5	Epic	1
Prowler Gloves	4	Rare	1
	5	Epic	1
Forest Boots	4	Rare	1
	5	Epic	1
Turnshoe	4	Rare	1
	5	Epic	1
Sturdy Boots	4	Rare	1
	5	Epic	1
Runestone Gloves	4	Rare	1
	5	Epic	1
Crystal Ball	4	Rare	1
	5	Epic	1
Rawhide Gloves	4	Rare	1
	5	Epic	1
Light Gauntlets	4	Rare	1
	5	Epic	1
Ceremonial Staff	4	Rare	1
	5	Epic	1
Crystal Sword	4	Rare	1
	5	Epic	1
Lightfoot Boots	4	Rare	1
	5	Epic	1
Wizard Shoes	4	Rare	1
	5	Epic	1
Laced Turnshoe	4	Rare	1
	5	Epic	1
Old Shoes	4	Rare	1
	5	Epic	1
Heavy Boots	4	Rare	1
	5	Epic	1
Leather Gloves	4	Rare	1
	5	Epic	1
Magic Staff	4	Rare	1
	5	Epic	1
Spellbook	4	Rare	1
	5	Epic	1
Riveted Gloves	4	Rare	1
	5	Epic	1
Occultist Boots	4	Rare	1
	5	Epic	1
Elkwood Gloves	4	Rare	1
	5	Epic	1

Rolls: 0

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	100%	100%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Cursed Bell	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	50%	50%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Golden Key	5	Unique	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	5%	5%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Dark Matter	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
2	15%	7.5%	2
3	20%	20%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Maggots	2	Common	1
Old Cloth	2	Common	1
Grave Essence	3	Uncommon	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
1	99.2%	24.8%	4
2	0.4%	0.05%	8
3	0.2%	0.05%	4
4	0.2%	0.04%	5

Loot Table 

Name	Luck Grade	Rarity	Item Count
Gold Coin	1	Unique	3
	2	Unique	4
	2	Unique	5
	2	Unique	6
	3	Unique	7
	3	Unique	8
	3	Unique	9
	4	Unique	10
	4	Unique	12
	4	Unique	15
	4	Unique	18
Silver Coin	1	Common	3
	1	Common	4
	1	Common	5
	2	Common	6
	2	Common	7
	2	Common	8
	2	Common	9
	2	Common	10
	3	Common	15
	4	Common	25

Crypts

Monsters_Bosses

Key_High

Key_Med

QuestItemDefaultCommon

QuestItemDefaultCommon

EventCurrency

Rolls: 3

Drop rates 

Luck grade	Probability	Probability per item	Item count
4	10%	0.25%	40
5	90%	2.25%	40

Loot Table 

Name	Luck Grade	Rarity	Item Count
Stitched Turnshoe	4	Rare	1
	5	Epic	1
Heavy Gauntlets	4	Rare	1
	5	Epic	1
Darkleaf Boots	4	Rare	1
	5	Epic	1
Cuffed Boots	4	Rare	1
	5	Epic	1
Mystic Gloves	4	Rare	1
	5	Epic	1
Rugged Boots	4	Rare	1
	5	Epic	1
Reinforced Gloves	4	Rare	1
	5	Epic	1
Buttoned Boots	4	Rare	1
	5	Epic	1
Low Boots	4	Rare	1
	5	Epic	1
Plate Boots	4	Rare	1
	5	Epic	1
Buckled Boots	4	Rare	1
	5	Epic	1
Pigache	4	Rare	1
	5	Epic	1
Dashing Boots	4	Rare	1
	5	Epic	1
Adventurer Boots	4	Rare	1
	5	Epic	1
Jester Poulaines	4	Rare	1
	5	Epic	1
Bloodwoven Gloves	4	Rare	1
	5	Epic	1
Onyx Gloves	4	Rare	1
	5	Epic	1
Arcane Gloves	4	Rare	1
	5	Epic	1
Gloves of Utility	4	Rare	1
	5	Epic	1
Prowler Gloves	4	Rare	1
	5	Epic	1
Forest Boots	4	Rare	1
	5	Epic	1
Turnshoe	4	Rare	1
	5	Epic	1
Sturdy Boots	4	Rare	1
	5	Epic	1
Runestone Gloves	4	Rare	1
	5	Epic	1
Crystal Ball	4	Rare	1
	5	Epic	1
Rawhide Gloves	4	Rare	1
	5	Epic	1
Light Gauntlets	4	Rare	1
	5	Epic	1
Ceremonial Staff	4	Rare	1
	5	Epic	1
Crystal Sword	4	Rare	1
	5	Epic	1
Lightfoot Boots	4	Rare	1
	5	Epic	1
Wizard Shoes	4	Rare	1
	5	Epic	1
Laced Turnshoe	4	Rare	1
	5	Epic	1
Old Shoes	4	Rare	1
	5	Epic	1
Heavy Boots	4	Rare	1
	5	Epic	1
Leather Gloves	4	Rare	1
	5	Epic	1
Magic Staff	4	Rare	1
	5	Epic	1
Spellbook	4	Rare	1
	5	Epic	1
Riveted Gloves	4	Rare	1
	5	Epic	1
Occultist Boots	4	Rare	1
	5	Epic	1
Elkwood Gloves	4	Rare	1
	5	Epic	1

Rolls: 0

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	100%	100%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Cursed Bell	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	50%	50%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Golden Key	5	Unique	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	5%	5%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Dark Matter	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
2	15%	7.5%	2
3	20%	20%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Maggots	2	Common	1
Old Cloth	2	Common	1
Grave Essence	3	Uncommon	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
1	99.2%	24.8%	4
2	0.4%	0.05%	8
3	0.2%	0.05%	4
4	0.2%	0.04%	5

Loot Table 

Name	Luck Grade	Rarity	Item Count
Gold Coin	1	Unique	3
	2	Unique	4
	2	Unique	5
	2	Unique	6
	3	Unique	7
	3	Unique	8
	3	Unique	9
	4	Unique	10
	4	Unique	12
	4	Unique	15
	4	Unique	18
Silver Coin	1	Common	3
	1	Common	4
	1	Common	5
	2	Common	6
	2	Common	7
	2	Common	8
	2	Common	9
	2	Common	10
	3	Common	15
	4	Common	25

Crypts

Monsters_Bosses

Key_High

Key_Med

QuestItemDefaultCommon

QuestItemDefaultCommon

EventCurrency

Rolls: 3

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	40%	1%	40
6	60%	1.5%	40

Loot Table 

Name	Luck Grade	Rarity	Item Count
Stitched Turnshoe	5	Epic	1
	6	Legend	1
Heavy Gauntlets	5	Epic	1
	6	Legend	1
Darkleaf Boots	5	Epic	1
	6	Legend	1
Cuffed Boots	5	Epic	1
	6	Legend	1
Mystic Gloves	5	Epic	1
	6	Legend	1
Rugged Boots	5	Epic	1
	6	Legend	1
Reinforced Gloves	5	Epic	1
	6	Legend	1
Buttoned Boots	5	Epic	1
	6	Legend	1
Low Boots	5	Epic	1
	6	Legend	1
Plate Boots	5	Epic	1
	6	Legend	1
Buckled Boots	5	Epic	1
	6	Legend	1
Pigache	5	Epic	1
	6	Legend	1
Dashing Boots	5	Epic	1
	6	Legend	1
Adventurer Boots	5	Epic	1
	6	Legend	1
Jester Poulaines	5	Epic	1
	6	Legend	1
Bloodwoven Gloves	5	Epic	1
	6	Legend	1
Onyx Gloves	5	Epic	1
	6	Legend	1
Arcane Gloves	5	Epic	1
	6	Legend	1
Gloves of Utility	5	Epic	1
	6	Legend	1
Prowler Gloves	5	Epic	1
	6	Legend	1
Forest Boots	5	Epic	1
	6	Legend	1
Turnshoe	5	Epic	1
	6	Legend	1
Sturdy Boots	5	Epic	1
	6	Legend	1
Runestone Gloves	5	Epic	1
	6	Legend	1
Crystal Ball	5	Epic	1
	6	Legend	1
Rawhide Gloves	5	Epic	1
	6	Legend	1
Light Gauntlets	5	Epic	1
	6	Legend	1
Ceremonial Staff	5	Epic	1
	6	Legend	1
Crystal Sword	5	Epic	1
	6	Legend	1
Lightfoot Boots	5	Epic	1
	6	Legend	1
Wizard Shoes	5	Epic	1
	6	Legend	1
Laced Turnshoe	5	Epic	1
	6	Legend	1
Old Shoes	5	Epic	1
	6	Legend	1
Heavy Boots	5	Epic	1
	6	Legend	1
Leather Gloves	5	Epic	1
	6	Legend	1
Magic Staff	5	Epic	1
	6	Legend	1
Spellbook	5	Epic	1
	6	Legend	1
Riveted Gloves	5	Epic	1
	6	Legend	1
Occultist Boots	5	Epic	1
	6	Legend	1
Elkwood Gloves	5	Epic	1
	6	Legend	1

Rolls: 0

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	100%	100%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Cursed Bell	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	50%	50%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Golden Key	5	Unique	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	20%	20%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Dark Matter	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
2	10%	5%	2
3	20%	20%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Maggots	2	Common	1
Old Cloth	2	Common	1
Grave Essence	3	Uncommon	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
1	98%	24.5%	4
2	1%	0.125%	8
3	0.5%	0.125%	4
4	0.5%	0.1%	5

Loot Table 

Name	Luck Grade	Rarity	Item Count
Gold Coin	1	Unique	3
	2	Unique	4
	2	Unique	5
	2	Unique	6
	3	Unique	7
	3	Unique	8
	3	Unique	9
	4	Unique	10
	4	Unique	12
	4	Unique	15
	4	Unique	18
Silver Coin	1	Common	3
	1	Common	4
	1	Common	5
	2	Common	6
	2	Common	7
	2	Common	8
	2	Common	9
	2	Common	10
	3	Common	15
	4	Common	25

HR

Crypts

Monsters_Bosses

Key_High

Key_Med

QuestItemDefaultCommon

QuestItemDefaultCommon

EventCurrency

Rolls: 3

Drop rates 

Luck grade	Probability	Probability per item	Item count
6	59%	1.475%	40
7	40%	1%	40
8	1%	0.25%	4

Loot Table 

Name	Luck Grade	Rarity	Item Count
Stitched Turnshoe	6	Legend	1
	7	Unique	1
Heavy Gauntlets	6	Legend	1
	7	Unique	1
Darkleaf Boots	6	Legend	1
	7	Unique	1
Zirkzi's Eye	8	Artifact	1
Cuffed Boots	6	Legend	1
	7	Unique	1
Mystic Gloves	6	Legend	1
	7	Unique	1
Rugged Boots	6	Legend	1
	7	Unique	1
Reinforced Gloves	6	Legend	1
	7	Unique	1
Buttoned Boots	6	Legend	1
	7	Unique	1
Low Boots	6	Legend	1
	7	Unique	1
Plate Boots	6	Legend	1
	7	Unique	1
Buckled Boots	6	Legend	1
	7	Unique	1
Pigache	6	Legend	1
	7	Unique	1
Dashing Boots	6	Legend	1
	7	Unique	1
Adventurer Boots	6	Legend	1
	7	Unique	1
Jester Poulaines	6	Legend	1
	7	Unique	1
Bloodwoven Gloves	6	Legend	1
	7	Unique	1
Onyx Gloves	6	Legend	1
	7	Unique	1
Arcane Gloves	6	Legend	1
	7	Unique	1
Gloves of Utility	6	Legend	1
	7	Unique	1
Prowler Gloves	6	Legend	1
	7	Unique	1
Forest Boots	6	Legend	1
	7	Unique	1
Turnshoe	6	Legend	1
	7	Unique	1
Sturdy Boots	6	Legend	1
	7	Unique	1
Runestone Gloves	6	Legend	1
	7	Unique	1
Crystal Ball	6	Legend	1
	7	Unique	1
Rawhide Gloves	6	Legend	1
	7	Unique	1
Light Gauntlets	6	Legend	1
	7	Unique	1
Ceremonial Staff	6	Legend	1
	7	Unique	1
Illusory	8	Artifact	1
Spellweaver	8	Artifact	1
Crystal Sword	6	Legend	1
	7	Unique	1
Lightfoot Boots	6	Legend	1
	7	Unique	1
Wizard Shoes	6	Legend	1
	7	Unique	1
Laced Turnshoe	6	Legend	1
	7	Unique	1
Old Shoes	6	Legend	1
	7	Unique	1
Heavy Boots	6	Legend	1
	7	Unique	1
Leather Gloves	6	Legend	1
	7	Unique	1
Magic Staff	6	Legend	1
	7	Unique	1
Spellbook	6	Legend	1
	7	Unique	1
Riveted Gloves	6	Legend	1
	7	Unique	1
Occultist Boots	6	Legend	1
	7	Unique	1
Elkwood Gloves	6	Legend	1
	7	Unique	1
Catice	8	Artifact	1

Rolls: 0

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	100%	100%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Cursed Bell	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	50%	50%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Golden Key	5	Unique	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
5	30%	30%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Dark Matter	5	Epic	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
2	5%	2.5%	2
3	15%	15%	1

Loot Table 

Name	Luck Grade	Rarity	Item Count
Maggots	2	Common	1
Old Cloth	2	Common	1
Grave Essence	3	Uncommon	1

Rolls: 1

Drop rates 

Luck grade	Probability	Probability per item	Item count
1	96%	24%	4
2	2%	0.25%	8
3	1%	0.25%	4
4	1%	0.2%	5

Loot Table 

Name	Luck Grade	Rarity	Item Count
Gold Coin	1	Unique	3
	2	Unique	4
	2	Unique	5
	2	Unique	6
	3	Unique	7
	3	Unique	8
	3	Unique	9
	4	Unique	10
	4	Unique	12
	4	Unique	15
	4	Unique	18
Silver Coin	1	Common	3
	1	Common	4
	1	Common	5
	2	Common	6
	2	Common	7
	2	Common	8
	2	Common	9
	2	Common	10
	3	Common	15
	4	Common	25

---

--[[
Terminology:
- Dungeon: A specific area in the game where players can explore and fight monsters.  Synonymous with "queue".
- Dungeon grade: A numeric code representing a specific dungeon mode and map combination.
	- Mode: The type of dungeon, such as PvE or LR or HR.
	- Map: The specific area within the dungeon, such as Goblin Caves or Ice Cavern.
- Loot table: A combination of loot drop and drop rate data and roll count
	- Loot drop table: A collection of items and the rarity therein that can be rolled for a loot table.
	- Drop rate table: Contains the rates at which certain luck grades are rolled.
		- Luck grade: A property which determines which items are rolled from within the loot drop table.
	- Roll count: The number of times the loot table is rolled.
- Loot drop group: table of all the loot tables for each specific dungeon grade. It also contains loot drop tables and drop rate tables.

For an easier time following the code, the functions each have a docstring.
Use Lua by Sumneko on VSCode to view workspace function signatures and type hints.

#TODO
	Change code to handle props and loose loot as well.
]]--


local p = {}
local utils = require("Module:Utilities")


local MODES = {
	["Default"] = "0",
	["PvE"] = "10",
	["LR"] = "20",
	["HR"] = "30",
	["Squire to Riches"] = "40",
	["???"] = "50"
}
local MAPS = {
	["Default"] =		"0",
	["Goblin Caves"] =	"01",
	["Firedeep"] =		"02",
	["Ice Cavern"] =	"11",
	["Ice Abyss"] =		"12",
	["Ruins"] =			"21",
	["Crypts"] =		"22",
	["Inferno"] =		"23",
	["Ship Graveyard"] ="31"
}
-- Convert one two strings to a numeric code. Note that the returned strings are concatenated, so the order matters.
-- - @param a: string (optional) - associated with either a mode or a map string
-- - @param b: string (optional) - associated with either a mode or a map string
-- - @return: string - number representing the dungeon mode or map or both
-- - - e.g. ("") -> ""
-- - - e.g. ("Gibberish") -> ""
-- - - e.g. ("PvE") -> "10"
-- - - e.g. ("Goblin Caves") -> "01"
-- - - e.g. ("PvE","Goblin Caves") -> "1001"
local function interpret_dungeon_strings(a,b)
	-- Convert the input strings to their corresponding numeric codes, if they exist
	a = MODES[tostring(a)] or MAPS[tostring(a)]
	b = MODES[tostring(b)] or MAPS[tostring(b)]

	-- If strings weren't matched, default to empty strings instead of nil
	if a == nil then a = '' end
	if b == nil then b = '' end

	-- Default cases cannot be paired with other modes or maps, so return "0" if either is "Default"
	if a == "Default" or b == "Default" then
		return "0"
	else
		return a..b
	end
end


local DUNGEON_GRADES = {
	["0"]    = {mode = "Default",	map = "Default"},

	["1001"] = {mode = "PvE",		map = "Goblin Caves"},
	["1002"] = {mode = "PvE",		map = "Firedeep"},
	["1011"] = {mode = "PvE",		map = "Ice Cavern"},
	["1012"] = {mode = "PvE",		map = "Ice Abyss"},
	["1021"] = {mode = "PvE",		map = "Ruins"},
	["1022"] = {mode = "PvE",		map = "Crypts"},
	["1023"] = {mode = "PvE",		map = "Inferno"},
	["1031"] = {mode = "PvE",		map = "Ship Graveyard"},

	["2001"] = {mode = "LR",		map = "Goblin Caves"},
	["2002"] = {mode = "LR",		map = "Firedeep"},
	["2011"] = {mode = "LR",		map = "Ice Cavern"},
	["2012"] = {mode = "LR",		map = "Ice Abyss"},
	["2021"] = {mode = "LR",		map = "Ruins"},
	["2022"] = {mode = "LR",		map = "Crypts"},
	["2023"] = {mode = "LR",		map = "Inferno"},
	["2031"] = {mode = "LR",		map = "Ship Graveyard"},

	["3001"] = {mode = "HR",		map = "Goblin Caves"},
	["3002"] = {mode = "HR",		map = "Firedeep"},
	["3011"] = {mode = "HR",		map = "Ice Cavern"},
	["3012"] = {mode = "HR",		map = "Ice Abyss"},
	["3021"] = {mode = "HR",		map = "Ruins"},
	["3022"] = {mode = "HR",		map = "Crypts"},
	["3023"] = {mode = "HR",		map = "Inferno"},
	["3031"] = {mode = "HR",		map = "Ship Graveyard"},

	["4001"] = {mode = "StR",		map = "Goblin Caves"},
	["4002"] = {mode = "StR",		map = "Firedeep"},
	["4011"] = {mode = "StR",		map = "Ice Cavern"},
	["4012"] = {mode = "StR",		map = "Ice Abyss"},
	["4021"] = {mode = "StR",		map = "Ruins"},
	["4022"] = {mode = "StR",		map = "Crypts"},
	["4023"] = {mode = "StR",		map = "Inferno"},
	["4031"] = {mode = "StR",		map = "Ship Graveyard"},

	-- ["5001"] = {mode = "???",		map = "Goblin Caves"},
	-- ["5002"] = {mode = "???",		map = "Firedeep"},
	-- ["5011"] = {mode = "???",		map = "Ice Cavern"},
	-- ["5012"] = {mode = "???",		map = "Ice Abyss"},
	-- ["5021"] = {mode = "???",		map = "Ruins"},
	-- ["5022"] = {mode = "???",		map = "Crypts"},
	-- ["5023"] = {mode = "???",		map = "Inferno"},
	-- ["5031"] = {mode = "???",		map = "Ship Graveyardo"}
}
-- Convert a numeric dungeon grade to its corresponding mode and map strings
-- - @param grade: string - integer corresponding to a specific mode and map
-- - @return: string, string - pair of strings corresponding to the mode and map
-- - - e.g. (0) -> "Default", "Default"; (4023) -> "HR 225+", "Inferno"
-- - - e.g. (5318008) -> "Default", "Default"; ("test") -> "Default", "Default"
local function interpret_dungeon_grade(dungeon_grade)
	if dungeon_grade == nil or DUNGEON_GRADES[dungeon_grade] == nil then
		return "Improper dungeon grade code",""
	end

	return DUNGEON_GRADES[dungeon_grade].mode, DUNGEON_GRADES[dungeon_grade].map
end

-- Interpret a list of dungeon grades and return the corresponding tree
-- - @param dungeon_grades: table - ideally the dungeon grades are numericall ordered
-- - - Example: {1001, 2001, 4023}
-- - @return: table - a 2-level tree structure with order lists
-- - - Example: {["mode_order"] = {"PvE", "HR 225+""},
--				["PvE"] = {["map_order"] = {"Goblin Caves", "Ice Cavern"}, ["Goblin Caves"] = true, ["Ice Cavern"] = true},
--				["HR 225+"] = {["map_order"] = {"Ice Cavern", "Ice Abyss"}, ["Ice Cavern"] = true, ["Ice Abyss"] = true}}
local function get_dungeon_tree(ordered_dungeon_grades)
	if ordered_dungeon_grades == nil then return {} end

	local tree = {}
	tree.order = {}

	for _,dungeon_grade in ipairs(ordered_dungeon_grades) do
		local mode,map = interpret_dungeon_grade(tostring(dungeon_grade))
		-- if dungeon grade cannot be matched, skip it
		if map ~= "" then
			if tree[mode] == nil then
				tree[mode] = {}
				tree[mode].order = {}
				table.insert(tree.order,mode)
			end
			if tree[mode][map] == nil then
				tree[mode][map] = true
				table.insert(tree[mode].order,map)
			end
		end
	end

	return tree
end


-- Create a div header with a class based on the id and an optional display argument
-- - @param id: string - represents the id of the div
-- - @param is_displayed: boolean - indicates whether the div should be displayed or hidden
-- - @return: string - the HTML div header
-- - - e.g. '\<div class="0-data" style="display:none;">'
-- - - e.g. '\<div class="0-data">
local function create_div_header(id_prefix, id, is_displayed, disambiguation)
	local interpretation = interpret_dungeon_strings(id)
	if interpretation == ''  then interpretation = id end

	local wt = '<div class="'..id_prefix..interpretation

	if disambiguation then
		wt = wt..disambiguation
	end

	if is_displayed then
		wt = wt..'-data">'
	else
		wt = wt..'-data" style="display:none;">'
	end

	return wt
end


-- Create a tab toggle element with a specific id, number, and content
-- - @param data_tabid: string - determines which class to toggle when the toggle is clicked
-- - @param data_tab: string - determines the toggle group, among which only one can be selected at a time
-- - @param content: string - the content of the tab toggle
-- - @param selected_tab: boolean - if true, the tab will be displayed as selected
-- - @return: string - the HTML tab toggle element
-- - - Example: \<div class="selected-tab tab-toggle tab" data-tabid="0" data-tab="PvE">PvE\</div>
local function create_tab_toggle(data_tab_id, data_tab, content, selected_tab)
	if selected_tab then
		return '<div class="selected-tab tab-toggle tab" data-tabid="'..data_tab_id..'" data-tab="'..data_tab..'">'..content..'</div>'
	else
		return '<div class="tab-toggle tab" data-tabid="'..data_tab_id..'" data-tab="'..data_tab..'">'..content..'</div>'
	end
end


-- Create tab toggles from a list of tabs.
-- - @param tab_list: table - list of content to be displayed for tab toggles.
-- - - e.g. {"PvE", "LR 0-124", "LR 125+", "HR 0-224", "HR 225+"}.
-- - @param tab_id: string - the id of the tab toggle group. Must be unique per tab toggle group.
-- - - e.g. "0" for the first level of tabs, or 11 for second level in the first group.
local function create_tab_toggles_from_list(tab_list, tab_id, is_differentiated)
	if tab_list == nil then return '' end

	local wikitext = ''
	for i,tab in ipairs(tab_list) do
		local interpretation = interpret_dungeon_strings(tab)
		if interpretation == ''  then interpretation = tab end

		if is_differentiated then
			wikitext = wikitext..create_tab_toggle(tab_id, tab_id..interpretation..tostring(i), tab, i==1)
		else
			wikitext = wikitext..create_tab_toggle(tab_id, tab_id..interpretation, tab, i==1)
		end
	end

	return wikitext
end


-- Round a number to a specified decimal place value
local function round(number, decimal_places)
	return tonumber(("%."..(decimal_places or 0).."f"):format(number))
end


-- Create a drop rate table from drop rate data and loot drop item counts
-- - @param drop_rate_data: table - contains drop rate data keyed by luck grade
-- - @param loot_drop_item_counts: table - contains item counts keyed by luck grade
-- - @return: string - the HTML drop rate table
local function create_drop_rate_wikitext(drop_rate_data, loot_drop_item_counts)
	local droprate_table = '<table cellspacing="0" class="loottable stripedtable sortable jquery-tablesorter mw-collapsible" style="min-width:30%"><caption>Drop rates&nbsp;</caption>'
		..'<tr><th>Luck grade</th><th>Probability</th><th>Probability per item</th><th>Item count</th></tr>'

	for luckgrade = 1,8 do
		local probability = drop_rate_data[luckgrade]
		local item_count = loot_drop_item_counts[luckgrade]
		if probability ~= nil and item_count ~= nil then
			droprate_table = droprate_table
				.."<tr class='cr"..luckgrade.."'>"
					.."<td><b>"..luckgrade.."</b></td>"
					.."<td><b>".. 100*probability.."%</b></td>"
					.."<td><b>"..round(100*probability/item_count,4).."%</b></td>"
					.."<td><b>"..item_count.."</b></td>"
				.."</tr>"
		end
	end

	return droprate_table..'</table><br>'
end


-- Clean an ID string by removing the "I[dD]_..._" prefix and any trailing numbers
local function clean_loot_table_id(loot_table_id)
	local cleaned_id = loot_table_id:gsub("I[dD]_%a*_","")
	cleaned_id = cleaned_id:gsub("_%d+$", "")
	return cleaned_id
end


-- Get the loot table ids for a specific dungeon grade
-- - @param loot_tables: table - contains array of severl loot drop, drop rate, roll count pairs.
-- - @return: table - array of loot drop rate ids
local function get_loot_table_ids(loot_tables)
	local drop_rate_ids = {}
	for _, loot_table in ipairs(loot_tables) do
		table.insert(drop_rate_ids, clean_loot_table_id(loot_table.drop_rate_id))
	end
	return drop_rate_ids
end


-- Get the luck grades for a specific drop rate table
-- - @param drop_rate_table: table - contains drop rate data keyed by luck grade
-- - @return: table - contains luck grades keyed by their numeric value
local function get_luck_grades(drop_rate_table)
	local luck_grades = {}
	for i = 1,8 do
		if drop_rate_table[i] then luck_grades[i]=true end
	end
	return luck_grades
end


-- Create a loot table from loot drop and drop rate data
-- - @param items: table - contains item data keyed by item name
-- - - e.g. {["Unobtainium Ore"] = {{luck_grade = 9, rarity = 9, count = 2}, {luck_grade = 9, rarity = 9, count = 10}}, 
--           ["Mithril Ore"] = {{luck_grade = 8, rarity = 8, count = 1}, {luck_grade = 8, rarity = 8, count = 8}}}
-- - @param luck_grades: table - contains luck grades keyed by their numeric value
-- - - e.g. {3=true, 5=true, 7=true, 8=true}
-- - @return: string - the HTML loot table
local function create_loot_drop_wikitext(items,luck_grades)
	local wikitext = '<table cellspacing="0" class="loottable stripedtable sortable jquery-tablesorter mw-collapsible" style="min-width:30%"><caption>Loot Table&nbsp;</caption>'
		..'<tr><th>Name</th><th>Luck Grade</th><th>Rarity</th><th>Item Count</th></tr>'

	for item_name, item_data in pairs(items) do
		local rowspan = 0
		for _,item_record in ipairs(item_data) do
			if luck_grades[item_record.luck_grade] then rowspan = rowspan + 1 end
		end

		-- Track how many rows have been created for this item; this is typically a subset of the entire record array
		local record_row_index = 1 -- this is incremented at the end of the loop's if block
		for _, item_record in ipairs(item_data) do
			if luck_grades[item_record.luck_grade] then
				local luck_grade = item_record.luck_grade
				local rarity_num = item_record.rarity
				local item_count = item_record.count

				local rarity_name = utils.rarity_num_to_name(rarity_num)
				if rarity_name == nil then return "rarity_num of '" .. rarity_num .. "' was converted to a nil rarity_name." end

				local rowspan_td_cell = ""
				-- if first, record's td must span all records rows and have an appropriate iconbox
				if record_row_index == 1 then
					if rowspan > 1 then
						rowspan_td_cell = "<td rowspan='" .. rowspan .. "'>"
					else
						rowspan_td_cell = "<td>" -- no rowspan needed for items with only one record
					end
					-- create the td element containing the iconbox
					rowspan_td_cell = rowspan_td_cell
							.."<div class='iconbox'>"
								.."<div class='rarity"..rarity_num.." rounded relative'>"
									.."[[File:"..item_name..".png|x80px|link="..item_name.."]]"
								.."</div>"
								.."[["..item_name.."|<b class=cr"..rarity_num..">"..item_name.."</b>]]"
							.."</div>"
						.."</td>"
				end

				-- Add the row to the resulting table
				wikitext = wikitext
					.."<tr>"
						..rowspan_td_cell
						.."<td class='cr"..luck_grade.."'><b>"..luck_grade.."</b></td>"
						.."<td class='cr"..rarity_num.."'><b>"..rarity_name.."</b></td>"
						.."<td>"..item_count.."</td>"
					.."</tr>"

				record_row_index = record_row_index + 1
			end
		end
	end

	return wikitext..'</table><br>'
end

-- Create the wikitext containing loot tables specific to a monster/prop/loose loot
local function create_wikitext(LDG,dungeon_tree,grade)
	local wikitext = create_tab_toggles_from_list(dungeon_tree.order,grade.."0") -- mode toggles
	for i,mode in ipairs(dungeon_tree.order) do -- modes - 4 nodes
		wikitext = wikitext
			..create_div_header(grade.."0", mode, i == 1)
			..create_tab_toggles_from_list(dungeon_tree[mode].order,grade.."1"..i) -- map toggles

		for j,map in ipairs(dungeon_tree[mode].order) do -- maps - 1 to 6 nodes
			if not LDG.loot_drop_groups.data[0] and not LDG.loot_drop_groups.data[1] then return "No items drop from this source." end

			local dungeon_grade = tonumber(interpret_dungeon_strings(mode, map)) -- e.g. "1001" for "PvE", "Goblin Caves"
			-- json decoder forces 0 -> 1 for arrays, so we must rely on a manual fix
			if dungeon_grade == 0 and LDG.loot_drop_groups.data[dungeon_grade] == nil then dungeon_grade = 1 end

			wikitext = wikitext
				..create_div_header(grade.."1"..i, map, j == 1) -- prefix "1", the tab toggle's depth, to create a unique identifier
				..create_tab_toggles_from_list(get_loot_table_ids(LDG.loot_drop_groups.data[dungeon_grade]),grade.."2"..i..j,true) -- loot table toggles

			for k,loot_table in ipairs(LDG.loot_drop_groups.data[dungeon_grade]) do -- 1 to 6 nodes
				wikitext = wikitext
					..create_div_header(grade.."2"..i..j, clean_loot_table_id(loot_table.drop_rate_id), k == 1,k) -- prefix "2", the tab toggle's depth, to create a unique identifier
						..'<span style="margin:20px 0px 20px 30px; font-size:24px">Rolls: '..loot_table.roll_count..'</span>'
						..create_drop_rate_wikitext(
							LDG.drop_rates[loot_table.drop_rate_id],
							LDG.loot_drops[loot_table.loot_drop_id].items_per_luck_grade)
						..create_loot_drop_wikitext(
							LDG.loot_drops[loot_table.loot_drop_id].items_data,
							get_luck_grades(LDG.drop_rates[loot_table.drop_rate_id]))

					..'</div>' -- close the content div
			end
			wikitext = wikitext..'</div>' -- close the map div
		end
		wikitext = wikitext..'</div>' -- close the mode div
	end

	return wikitext
end


local GRADE_ORDER = {"Common","Elite","Nightmare"}


-- Some monsters don't have all three grades, so we filter them here
local function get_grades(ML,page_name)
	local grades = {}

	for _,grade in ipairs(GRADE_ORDER) do
		if ML.localized_name[page_name][grade] ~= nil then
			grades[#grades+1] = grade
		end
	end

	return grades
end


-- Create a loot table for a specific monster, prop, or loose loot
-- - @param frame: table
-- - - frame.args[1]: string - {{PAGENAME}} or localized string + grade
-- - - frame.args[2]: string - type of the object, either "Monster", "Prop", or "Loose_loot"
function p.loot_tables(frame)
	local wt = {}
	local ML = mw.loadJsonData("Loot:Monster.json")
	local pagename = frame.args.name
	local LDG_id = ""
	local LDG = {}

	wt[#wt+1] = "<h2 style='width:100%'>Loot Tables</h2>"

	local grades = get_grades(ML,pagename)
	wt[#wt+1] = create_tab_toggles_from_list(grades,"Grade")
	for i, grade in ipairs(grades) do
		local id = ML.localized_name[pagename][grade]

		if LDG_id ~= "Loot:"..ML.id[id].loot..".json" then -- only load as needed
			LDG_id = "Loot:"..ML.id[id].loot..".json"
			LDG = mw.loadJsonData(LDG_id)
		end
		if LDG == nil then return "LootDropGroup file not found." end

		wt[#wt+1] = create_div_header("Grade", grade, i == 1)
		wt[#wt+1] = create_wikitext(LDG,get_dungeon_tree(ML.id[id].dungeon_grade_order),grade)
		wt[#wt+1] = "</div>"
	end

	return table.concat(wt)
end

return p



--[=[
mw.log(p.loot_tables({args={name="Mermaid",category="Monster"}}))
mw.log(p.loot_tables({args={name="Ghost King",category="Monster"}}))
]=]