Lib's - Addon Tools

A shared toolkit that gives you a modern error handler, a profile manager, a macro editor, a Lua console, and more all in one place.

What Does This Addon Do?

Lib's - Addon Tools adds a handful of useful tools to your game. You don't need to be a developer to use them! Here's the short version:

Error Handler

Ever get random Lua errors popping up while you play? This addon replaces WoW's default error popup with a cleaner, more detailed error viewer. Errors are captured quietly in the background and you can browse them whenever you want.

• Show All formats every error into one clean, copyable block perfect for pasting into Discord or a GitHub issue.
• Minimap button shows how many errors happened this session. Click it to open the error window.
• Ignore errors hide the ones you don't care about.
• Auto-popup optionally have the window open automatically when a new error happens.
• Errors are color-coded and easy to read.

Profile Manager

Import and export your addon settings so you can share them with friends or move them between characters.

• Works with most popular AceDB-based addons automatically.
• Built-in support for addons like Bartender4, Masque, and more.
• Export creates a shareable text string copy it, paste it in Discord, done.
• Import lets you paste a string and load it into your current profile or a new one.

Open it with /profiles.

Macro Editor

This addon gives you a full-size macro editor with more room to work than WoW's default.

• Lists all your Account and Character macros.
• Big text area so you can actually see what you're writing.
• Icon picker built in.
• Drag-to-action-bar support.
• Character count so you know when you're near the 255 limit.

Open it with /macros.

Lua Console (CLI)

A mini code editor inside WoW. Type Lua code, hit execute, and see the output. You can save scripts for later too.

Open it with /lua.

Setup Wizard

Some addons that use this library can register setup pages. If any are available, you'll get a one-time prompt on login to walk through first-time configuration.

Open it anytime with /setup.

Quick Commands

For Developers

Everything below is aimed at addon developers who want to integrate with or build on top of Lib's - Addon Tools.

Getting Started

Lib's - Addon Tools is an AceAddon-based framework. It registers itself globally as LibAT (_G.LibAT). All systems are accessible through this namespace.

Logger System

A structured logging framework with 5 severity levels: Debug, Info, Warning, Error, and Critical.

Logs are organized in a three-level hierarchy: Category → SubCategory → SubSubCategory (auto-detected from dotted source names). Each module can override the global log level or inherit from it.

Registering a Logger

-- Simple registration (single category)
local log = LibAT.Logger.RegisterAddon("MyAddon")
log.info("Addon loaded")
log.debug("Initializing systems...")
log.warning("Something looks off")
log.error("Something went wrong")

-- Advanced registration (multiple categories)
local log = LibAT.Logger.RegisterAddon("MyAddon", { "Combat", "UI", "Data" })
log.Categories["Combat"].info("Combat module loaded")
log.Categories["UI"].debug("Building frames...")

-- Register sub-categories dynamically
local subLog = log:RegisterCategory("Networking")
subLog.info("Connected to server")

Logger Methods

Logs are viewable in-game via /logs or the DevUI Logs tab. See Logger-TechDoc.md for the full technical reference.

Profile Manager API

Register your addon so users can import/export its settings through the profile manager UI.

local addonId = LibAT.ProfileManager:RegisterAddon({
    name = "My Addon",       -- Display name
    db = myAceDB,            -- Your AceDB instance
    namespaces = {           -- Optional: named AceDB namespaces
        { name = "Our Bars", db = myAceDB:GetNamespace("Bars") },
    },
    icon = 12345,            -- Optional: icon texture ID
})

Profile Manager Methods

Auto-Discovery Adapters

You can register a discovery adapter so your addon is automatically available in the profile manager even without explicit registration:

LibAT.ProfileManager.RegisterDiscoveryAdapter("MyAddon", {
    name = "My Addon",
    savedVariables = "MyAddonDB",
    wrapType = "acedb",  -- or "raw"
})

Setup Wizard API (WIP)

Register setup pages so your addon can guide users through first-time configuration.

LibAT.SetupWizard:RegisterAddon("myaddon", {
    name = "My Addon",
    icon = 12345,  -- Optional
    pages = {
        {
            id = "welcome",
            name = "Welcome",
            builder = function(contentFrame)
                -- Build your setup UI into contentFrame
            end,
            isComplete = function()
                return MyAddonDB.setupDone == true
            end,
        },
    },
   
        -- Called when user clicks Finish on the last page
    end,
})

Setup Wizard Methods

UI Component Library (WIP)

A shared UI toolkit styled after Blizzard's AuctionHouse frames. Used internally by all systems but available for other addons.

Window Creation

local window = LibAT.UI.CreateWindow({
    name = "MyWindow",
    title = "My Addon",
    width = 800,
    height = 600,
    portrait = texturePath,  -- Optional
    resizable = true,        -- Optional
})

local controlFrame = LibAT.UI.CreateControlFrame(window)
local contentFrame = LibAT.UI.CreateContentFrame(window, controlFrame)
local leftPanel = LibAT.UI.CreateLeftPanel(contentFrame)
local rightPanel = LibAT.UI.CreateRightPanel(contentFrame, leftPanel)

Widget Builder

Declarative widget creation from definition tables (similar to AceConfig):

LibAT.UI.BuildWidgets(container, {
    enabled = {
        type = "checkbox",
        name = "Enable Feature",
        order = 1,
        get = function() return db.enabled end,
        set = function(val) db.enabled = val end,
    },
    scale = {
        type = "slider",
        name = "UI Scale",
        order = 2,
        min = 0.5, max = 2.0, step = 0.1,
        get = function() return db.scale end,
        set = function(val) db.scale = val end,
    },
    apply = {
        type = "button",
        name = "Apply",
        order = 3,
        func = function() ApplySettings() end,
    },
})

Supported widget types: button, slider, checkbox, dropdown, header, description, divider.

Available UI Components

Developer Tools Commands

Extra slash commands for frame inspection and debugging:

Enhanced /tinspect & Frame Stack

The addon hooks into Blizzard's TableAttributeDisplay (used by /tinspect and the Ctrl-click frame stack) to add extra mouse actions on any value row:

Utility Functions