### AtlasLoot Item Database API - Add/Get Module

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Manage item databases for addon modules using the ItemDB. Use Add to register a new database and Get to retrieve an existing one.

```lua
-- Add a new item database for an addon module
-- Parameters: addonName (string), tierID (number - Encounter Journal tier)
local data = AtlasLoot.ItemDB:Add("AtlasLoot_TheWarWithin", 11)
```

```lua
-- Get an existing item database by addon name
local moduleData = AtlasLoot.ItemDB:Get("AtlasLoot_TheWarWithin")
```

--------------------------------

### AtlasLoot Item Database API - Get Module List

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Retrieve a list of all content (instances) available within a specific addon module from the ItemDB.

```lua
-- Get list of all content in a module
local contentList = AtlasLoot.ItemDB:GetModuleList("AtlasLoot_TheWarWithin")
for i = 1, #contentList do
    print("Instance:", contentList[i])
end
```

--------------------------------

### AtlasLoot Item Database API - Get Item Table

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Retrieve the complete loot table for a specific boss and difficulty within an instance. The returned itemTable can be iterated to access individual item details.

```lua
-- Get complete loot table for a specific boss/difficulty
-- Returns: itemTable, tableType, difficultyData
local items, tableType, diffData = AtlasLoot.ItemDB:GetItemTable(
    "AtlasLoot_TheWarWithin",  -- addonName
    "The Stonevault",           -- contentName (instance name)
    1,                          -- boss index
    2                           -- difficulty index
)
```

```lua
-- Iterate through items in the loot table
for i, item in ipairs(items) do
    local position = item[1]  -- Display position
    local itemID = item[2]    -- Item ID or item string
    print("Position:", position, "ItemID:", itemID)
end
```

--------------------------------

### Register Module Initialization Hooks

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Execute code when AtlasLoot finishes loading or when a specific module is initialized.

```lua
-- Add a function to run when AtlasLoot initializes
AtlasLoot:AddInitFunc(function()
    print("AtlasLoot has finished initializing!")

    -- Access database after initialization
    local db = AtlasLoot.db
    local guiSettings = db.GUI

    -- Check addon settings
    if guiSettings.autoselect then
        print("Auto-select is enabled")
    end
end)

-- Add initialization function for a specific module
AtlasLoot:AddInitFunc(function()
    print("My custom module initialized!")
end, "MyCustomModule")  -- Only runs when MyCustomModule loads
```

--------------------------------

### Registering a World Map Button

Source: https://github.com/nanderson11/atlaslootenhanced/blob/master/AtlasLoot/Libs/Krowi_WorldMapButtons/README.md

Initializes the button object and registers it with the library using LibStub.

```lua
local _, addon = ...;
addon.Gui.WorldMapButton = {};
local worldMapButton = gui.WorldMapButton;

addon.WorldMapButtons = LibStub("Krowi_WorldMapButtons-1.4"); -- Global world map buttons object

function worldMapButton.Load()
    worldMapButton = addon.WorldMapButtons:Add("KrowiAF_WorldMapButton_Template", "BUTTON");
    addon.Gui.WorldMapButton = worldMapButton;
end
```

--------------------------------

### AtlasLoot GUI Window Management

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Programmatically control the main AtlasLoot interface using the GUI module. This allows for dynamic showing, hiding, and resetting of addon windows.

```lua
-- Toggle the main AtlasLoot window (show if hidden, hide if shown)
AtlasLoot.GUI:Toggle()
```

```lua
-- Access the main frame directly
local mainFrame = AtlasLoot.GUI.frame
```

```lua
-- Check if the frame is currently visible
if AtlasLoot.GUI.frame:IsShown() then
    print("AtlasLoot is currently open")
end
```

```lua
-- Reset all frame positions to center of screen
AtlasLoot.GUI.ResetFrames()
```

--------------------------------

### Configure Item Button Click Handlers

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Define custom interactions for item buttons in the loot browser using the ClickHandler system.

```lua
-- Item click actions (configurable in options)
-- Default bindings:
-- Shift + Left Click:  Add item link to chat
-- Ctrl + Left Click:   Open item in Dressing Room
-- Alt + Left Click:    Add/Remove item from Favourites
-- Shift + Right Click: Open Azerite powers (for Azerite items)

-- The ClickHandler system manages all button interactions
local ItemClickHandler = AtlasLoot.ClickHandler:Add(
    "Item",  -- Handler name
    {
        ChatLink = { "LeftButton", "Shift" },
        DressUp = { "LeftButton", "Ctrl" },
        SetFavourite = { "LeftButton", "Alt" },
        types = {
            ChatLink = true,
            DressUp = true,
            SetFavourite = true,
        },
    },
    db.ClickHandler,  -- Saved settings
    {
        { "ChatLink", "Chat Link", "Add item into chat" },
        { "DressUp", "Dress up", "Shows the item in the Dressing room" },
        { "SetFavourite", "Set Favourite", "Set/Remove the item as favourite" },
    }
)

-- Check what action a mouse button should perform
local action = ItemClickHandler:Get("LeftButton")  -- Returns action based on modifiers
```

--------------------------------

### Creating a Button Template

Source: https://github.com/nanderson11/atlaslootenhanced/blob/master/AtlasLoot/Libs/Krowi_WorldMapButtons/README.md

Defines the XML structure for the button, including layers, textures, and script bindings.

```xml
<Ui>
    <Script file="WorldMapButton.lua"/>
    <Script file="WorldMapButtonMixin.lua"/>

	<Button name="KrowiAF_WorldMapButton_Template" frameStrata="HIGH" mixin="KrowiAF_WorldMapButtonMixin" motionScriptsWhileDisabled="true" virtual="true">
		<Size x="32" y="32"/>
		<Layers>
			<Layer level="BACKGROUND" textureSubLevel="-1">
				<Texture atlas="MapCornerShadow-Right" useAtlasSize="true" hidden="true">
					<Anchors>
						<Anchor point="TOPRIGHT" x="4" y="1"/>
					</Anchors>
					<TexCoords left="0" right="1" top="1" bottom="0"/>
				</Texture>
			</Layer>
			<Layer level="BACKGROUND">
				<Texture parentKey="Background" file="Interface\Minimap\UI-Minimap-Background">
					<Size x="25" y="25"/>
					<Anchors>
						<Anchor point="TOPLEFT" x="2" y="-4"/>
					</Anchors>
				</Texture>
			</Layer>
			<Layer level="ARTWORK">
				<Texture parentKey="Icon" file="Interface\AchievementFrame\UI-Achievement-Progressive-Shield-NoPoints">
					<Size x="20" y="20"/>
					<Anchors>
						<Anchor point="TOPLEFT" x="6" y="-6"/>
					</Anchors>
					<TexCoords left="0.0625" right="0.59375" top="0.09375" bottom="0.625"/>
				</Texture>
			</Layer>
			<Layer level="OVERLAY">
				<Texture parentKey="IconOverlay" hidden="true">
					<Anchors>
						<Anchor point="TOPLEFT" relativeKey="$parent.Icon"/>
						<Anchor point="BOTTOMRIGHT" relativeKey="$parent.Icon"/>
					</Anchors>
					<Color r="0.0" g="0.0" b="0.0" a="0.5"/>
				</Texture>
			</Layer>
			<Layer level="OVERLAY" textureSubLevel="1">
				<Texture parentKey="Border" file="Interface\Minimap\MiniMap-TrackingBorder">
					<Size x="54" y="54"/>
					<Anchors>
						<Anchor point="TOPLEFT"/>
					</Anchors>
				</Texture>
			</Layer>
			<Layer level="OVERLAY" textureSubLevel="2">
				<Texture parentKey="ActiveTexture" file="Interface\Minimap\UI-Minimap-ZoomButton-Toggle" alphaMode="ADD" hidden="true" setAllPoints="true"/>
			</Layer>			
		</Layers>
		<Frames>
			<Frame parentKey="DropDown" inherits="UIDropDownMenuTemplate" clampedToScreen="true" hidden="true"/>
		</Frames>
		<HighlightTexture alphaMode="ADD" file="Interface\Minimap\UI-Minimap-ZoomButton-Highlight"/>
		<Scripts>
			<OnLoad method="OnLoad"/>
			<OnMouseDown method="OnMouseDown"/>
			<OnMouseUp method="OnMouseUp"/>
			<OnClick method="OnClick"/>
			<OnEnter method="OnEnter"/>
			<OnLeave function="GameTooltip_Hide"/>
			<OnHide method="OnHide"/>
		</Scripts>
	</Button>
</Ui>
```

--------------------------------

### Access and Modify Settings

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Interact with the AceDB-backed database to read or update AtlasLoot configuration settings.

```lua
-- Access the main database after initialization
local db = AtlasLoot.db           -- Profile settings
local dbGlobal = AtlasLoot.dbGlobal  -- Global settings

-- Common GUI settings
local guiSettings = db.GUI
guiSettings.autoselect = true        -- Auto-select instance when entering
guiSettings.classFilter = true       -- Enable class filter
guiSettings.transMogHighlighter = true  -- Highlight transmog items

-- Default frame position
guiSettings.point = { "CENTER" }     -- Reset to center

-- Content appearance settings
guiSettings.mainFrame.scale = 1.0    -- Window scale
guiSettings.contentTopBar.bgColor = { 0.1, 0.1, 0.1, 1 }  -- RGBA

-- Favourites settings
local favDb = AtlasLoot.db.Addons.Favourites
favDb.enabled = true
favDb.showIconInTT = true    -- Show favourite icon in tooltips
favDb.showListInTT = true    -- Show list names in tooltips
```

--------------------------------

### AtlasLoot Enhanced GUI Toggle and Window Management

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Programmatic control over the main AtlasLoot interface using the GUI module.

```APIDOC
## GUI Toggle and Window Management

The main AtlasLoot interface can be toggled programmatically through the GUI module.

### Toggle Main Window
```lua
-- Toggle the main AtlasLoot window (show if hidden, hide if shown)
AtlasLoot.GUI:Toggle()
```

### Access Main Frame
```lua
-- Access the main frame directly
local mainFrame = AtlasLoot.GUI.frame
```

### Check Frame Visibility
```lua
-- Check if the frame is currently visible
if AtlasLoot.GUI.frame:IsShown() then
    print("AtlasLoot is currently open")
end
```

### Reset Frame Positions
```lua
-- Reset all frame positions to center of screen
AtlasLoot.GUI.ResetFrames()
```
```

--------------------------------

### Registering Loot Data Modules

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Defines difficulty levels, content types, and instance loot tables for new loot modules.

```lua
local addonname = ...
local AtlasLoot = _G.AtlasLoot
local data = AtlasLoot.ItemDB:Add(addonname, 11)  -- 11 = The War Within tier ID

-- Register the module with AtlasLoot
AtlasLoot:RegisterModules(addonname)

-- Define difficulty levels with scaling presets
local NORMAL_DIFF = data:AddDifficulty("Normal", "DungeonWithPreset", {
    Item = { addDifficultyBonus = true }
}, 1)  -- difficultyID = 1

local HEROIC_DIFF = data:AddDifficulty("Heroic", "HeroicDungeonWithPreset", {
    Item = { addDifficultyBonus = true }
}, 2)  -- difficultyID = 2

local MYTHIC_DIFF = data:AddDifficulty("Mythic", "MythicDungeonWithPreset", {
    Item = { addDifficultyBonus = true }
}, 23) -- difficultyID = 23

-- Define content types with colors
local DUNGEON_CONTENT = data:AddContentType("Dungeons", ATLASLOOT_DUNGEON_COLOR)
local RAID_CONTENT = data:AddContentType("Raids", ATLASLOOT_RAID_COLOR)

-- Define item table type (how items are displayed)
local RAID_ITTYPE = data:AddItemTableType("Item", "Item")

-- Create instance loot data
data["The Stonevault"] = {
    EncounterJournalID = 1269,   -- Blizzard Encounter Journal ID
    MapID = 2341,                -- Map ID for world map integration
    AtlasMapID = "TheStonevault", -- Atlas addon map reference
    ContentType = DUNGEON_CONTENT,
    items = {
        { -- First boss: E.D.N.A.
            EncounterJournalID = 2572,
            [NORMAL_DIFF] = {
                { 1, 221077 },  -- Position 1, Item ID 221077
                { 2, 221076 },  -- Position 2, Item ID 221076
                { 3, 221075 },  -- Position 3, Item ID 221075
            },
            [HEROIC_DIFF] = {
                GetItemsFromDiff = NORMAL_DIFF,  -- Inherit from Normal
            },
            [MYTHIC_DIFF] = {
                GetItemsFromDiff = NORMAL_DIFF,
                { 16, 226683, "mount" },  -- Mythic-only mount
            },
        },
    }
}
```

--------------------------------

### Managing Favourites and Wishlists

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Interacts with the Favourites addon to add, remove, export, and import items, as well as manage custom lists.

```lua
-- Get the Favourites addon instance
local Favourites
AtlasLoot.Addons:GetAddon("Favourites", function(addon, enabled)
    Favourites = enabled and addon or nil
end)

-- Add an item to the active favourites list
local itemID = 221077
if Favourites:AddItemID(itemID) then
    print("Item added to favourites!")
end

-- Remove an item from favourites
if Favourites:RemoveItemID(itemID) then
    print("Item removed from favourites!")
end

-- Check if an item is in any favourites list
local isFavourite = Favourites:IsFavouriteItemID(itemID)
local isInActiveListOnly = Favourites:IsFavouriteItemID(itemID, true)

-- Get the active favourites list
local activeList = Favourites:GetActiveList()
for itemID, value in pairs(activeList) do
    if type(itemID) == "number" then
        local itemName = C_Item.GetItemInfo(itemID)
        print("Favourite item:", itemName or itemID)
    end
end

-- Create a new favourites list
local newListID = Favourites:AddNewList(false)  -- false = profile list, true = global
Favourites:SetActiveListName("My BiS List")

-- Set a custom icon for the list
Favourites:SetIcon("Interface\\Icons\\inv_misc_questionmark")

-- Add a note to a favourited item
Favourites:SetItemNote(itemID, "BiS for Mythic raiding")
local note = Favourites:GetItemNote(itemID)

-- Export favourites list to string (for sharing)
local exportString = Favourites:ExportItemList("ProfileBase", false)
print("Export string:", exportString)

-- Import items from string
local numImported = Favourites:ImportItemList(
    "ProfileBase",  -- listID
    false,          -- isGlobalList
    "i:221077,i:221076,i:221075",  -- comma-separated item list
    false           -- replace existing (false = append)
)
print("Imported", numImported, "items")

-- Clear all items from the active list
Favourites:ClearList()

-- Get number of items in current list
local count = Favourites:GetNumItemsInList()

-- Count favourites by content
local counts = Favourites:CountFavouritesByList(
    "AtlasLoot_TheWarWithin",  -- addonName
    "The Stonevault",          -- contentName
    nil,                       -- boss (nil = all)
    nil                        -- difficulty (nil = all)
)
for listName, itemCount in pairs(counts) do
    print(listName .. ": " .. itemCount .. " items")
end
```

--------------------------------

### Defining a Button Mixin

Source: https://github.com/nanderson11/atlaslootenhanced/blob/master/AtlasLoot/Libs/Krowi_WorldMapButtons/README.md

Implements the required event handlers and lifecycle methods for the button's behavior.

```lua
KrowiAF_WorldMapButtonMixin = {};

function KrowiAF_WorldMapButtonMixin:OnLoad()

end

function KrowiAF_WorldMapButtonMixin:OnMouseDown(button)

end

function KrowiAF_WorldMapButtonMixin:OnMouseUp()

end

function KrowiAF_WorldMapButtonMixin:OnClick()

end

function KrowiAF_WorldMapButtonMixin:OnEnter()

end

function KrowiAF_WorldMapButtonMixin:OnHide()

end

function KrowiAF_WorldMapButtonMixin:Refresh()
  -- Below functions should be called here
  -- self:Enable(), self:Disable(), self:Show(), self:Hide()
  -- Refresh is called by the system if you open the world map or change maps
end
```

--------------------------------

### AtlasLoot Enhanced Slash Commands

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Use these slash commands in WoW chat to quickly access AtlasLoot features. Some commands have aliases for brevity.

```lua
-- Open the main AtlasLoot loot browser window
/atlasloot
/al
```

```lua
-- Open the Favourites/Wishlist window
/atlasloot fav
/al fav
```

```lua
-- Open the options/settings menu
/atlasloot options
/al options
```

```lua
-- Reset frames and clear cached data (useful for fixing disconnects)
/atlasloot reset
/al reset
```

```lua
-- Toggle the minimap button visibility
/atlasloot mmb
/al mmb
```

```lua
-- Print a list of all available slash commands
/atlasloot slash
/al slash
```

--------------------------------

### AtlasLoot Enhanced Slash Commands

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

A list of available slash commands to interact with AtlasLoot Enhanced directly from the World of Warcraft chat interface.

```APIDOC
## AtlasLoot Enhanced Slash Commands

AtlasLoot provides several slash commands for quick access to addon features via chat.

### Open Main Window
- `/atlasloot`
- `/al`

### Open Favorites/Wishlist
- `/atlasloot fav`
- `/al fav`

### Open Options Menu
- `/atlasloot options`
- `/al options`

### Reset Frames and Clear Cache
- `/atlasloot reset`
- `/al reset`

### Toggle Minimap Button
- `/atlasloot mmb`
- `/al mmb`

### List All Slash Commands
- `/atlasloot slash`
- `/al slash`
```

--------------------------------

### Register Custom Slash Commands

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Use the SlashCommands API to add custom commands and reset functions to the AtlasLoot command structure.

```lua
-- Add a custom slash command
AtlasLoot.SlashCommands:Add(
    "mycommand",                           -- Command name (usage: /al mycommand)
    function(arg1, arg2)                   -- Handler function
        print("My command executed with:", arg1, arg2)
    end,
    "/al mycommand - Description of my custom command"  -- Help text
)

-- Add a reset function that runs with /al reset
AtlasLoot.SlashCommands:AddResetFunction(
    function()
        print("Custom reset function executed!")
        -- Reset your addon's state here
    end,
    "frames",   -- Category: runs with /al reset frames
    "myAddon"   -- Category: runs with /al reset myAddon
)

-- Run a slash command programmatically
AtlasLoot.SlashCommands:Run("options")
```

--------------------------------

### AtlasLoot Enhanced Item Database API

Source: https://context7.com/nanderson11/atlaslootenhanced/llms.txt

Functions for managing and retrieving loot data from the ItemDB module.

```APIDOC
## Item Database API

The ItemDB module manages all loot data storage, retrieval, and difficulty management for instances.

### Add New Item Database
```lua
-- Add a new item database for an addon module
-- Parameters: addonName (string), tierID (number - Encounter Journal tier)
local data = AtlasLoot.ItemDB:Add("AtlasLoot_TheWarWithin", 11)
```

### Get Existing Item Database
```lua
-- Get an existing item database by addon name
local moduleData = AtlasLoot.ItemDB:Get("AtlasLoot_TheWarWithin")
```

### Get Item Table for Boss/Difficulty
```lua
-- Get complete loot table for a specific boss/difficulty
-- Returns: itemTable, tableType, difficultyData
local items, tableType, diffData = AtlasLoot.ItemDB:GetItemTable(
    "AtlasLoot_TheWarWithin",  -- addonName
    "The Stonevault",           -- contentName (instance name)
    1,                          -- boss index
    2                           -- difficulty index
)

-- Iterate through items in the loot table
for i, item in ipairs(items) do
    local position = item[1]  -- Display position
    local itemID = item[2]    -- Item ID or item string
    print("Position:", position, "ItemID:", itemID)
end
```

### Get Module Content List
```lua
-- Get list of all content in a module
local contentList = AtlasLoot.ItemDB:GetModuleList("AtlasLoot_TheWarWithin")
for i = 1, #contentList do
    print("Instance:", contentList[i])
end
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.