WoW Addon Entwicklung - Komplette Referenz

World of Warcraft\_classic_\Interface\AddOns\DeinAddonName\

## Interface: 11508
## Title: Hallo Welt
## Notes: Mein erstes Addon!
## Author: DeinName
## Version: 1.0.0
HalloWelt.lua

local frame = CreateFrame("Frame")
frame:RegisterEvent("PLAYER_LOGIN")
frame:SetScript("OnEvent", function(self, event)
    print("Hallo, Welt!")
end)

MeinAddon/
├── MeinAddon.toc        # Pflicht: Addon-Manifest
├── MeinAddon.lua        # Haupt-Code-Datei
├── Config.lua           # Einstellungen
├── embeds.xml           # Bibliotheks-Includes
├── libs/                # Externe Bibliotheken
└── Locales/             # Lokalisierung

## Interface: 11508
## Title: Mein Addon
## Notes: Beschreibung des Addons
## Author: Dein Name
## Version: 1.0.0
## SavedVariables: MeinAddonDB
## SavedVariablesPerCharacter: MeinAddonCharDB
## OptionalDeps: Ace3
embeds.xml
Core.lua
Config.lua

-- Lokale Variable (bevorzugt)
local meinWert = "Hallo"
-- Globale Variable (vermeiden wenn möglich)
MeineGlobaleVar = "Welt"
-- Datentypen
local text = "String"           -- Text
local zahl = 100                -- Zahl
local dezimal = 0.75            -- Dezimalzahl
local aktiv = true              -- Boolean
local nichts = nil              -- Nil (kein Wert)
local tabelle = {1, 2, 3}       -- Array
local dict = {name = "Held"}    -- Dictionary

-- Arithmetik
local a = 10 + 5    -- 15
local b = 10 - 5    -- 5
local c = 10 * 5    -- 50
local d = 10 / 5    -- 2
local e = 10 % 3    -- 1 (Modulo)
-- Vergleich
a == b              -- gleich
a ~= b              -- ungleich (NICHT !=)
a < b               -- kleiner
a > b               -- größer
-- Logisch
true and false      -- false
true or false       -- true
not true            -- false
-- String-Verkettung
"Hallo" .. " " .. "Welt"  -- "Hallo Welt"

-- If/Else
local leben = UnitHealth("player")
if leben > 50 then
    print("Alles gut")
elseif leben > 25 then
    print("Vorsicht!")
else
    print("Kritisch!")
end
-- Ternärer Stil (Lua-Idiom)
local status = (leben > 50) and "Gut" or "Schlecht"

-- For-Schleife (numerisch)
for i = 1, 10 do
    print(i)
end
-- For-Schleife (Array)
local items = {"Schwert", "Schild", "Trank"}
for index, item in ipairs(items) do
    print(index, item)
end
-- For-Schleife (Dictionary)
local stats = {staerke = 100, beweglichkeit = 50}
for key, value in pairs(stats) do
    print(key, value)
end
-- While-Schleife
local count = 0
while count < 5 do
    print(count)
    count = count + 1
end

-- Einfache Funktion
local function gruessen(name)
    print("Hallo, " .. name)
end
gruessen("Spieler")
-- Funktion mit Rückgabe
local function addieren(a, b)
    return a + b
end
local summe = addieren(5, 3)  -- 8
-- Mehrere Rückgabewerte
local function getSpielerInfo()
    return "Spielername", 60, "Krieger"
end
local name, level, klasse = getSpielerInfo()
-- Anonyme Funktion
frame:SetScript("OnClick", function(self, button)
    print("Geklickt mit:", button)
end)

-- Array (1-indiziert!)
local items = {"Schwert", "Schild"}
print(items[1])      -- "Schwert"
print(#items)        -- 2 (Länge)
table.insert(items, "Trank")
table.remove(items, 1)
-- Dictionary
local spieler = {
    name = "Held",
    level = 60,
    klasse = "Krieger"
}
print(spieler.name)       -- "Held"
print(spieler["level"])   -- 60
-- Tabelle als Objekt
local MeinAddon = {}
function MeinAddon:Initialisieren()
    self.aktiv = true
end
MeinAddon:Initialisieren()

-- 1. Frame erstellen
local frame = CreateFrame("Frame")
-- 2. Events registrieren
frame:RegisterEvent("PLAYER_LOGIN")
frame:RegisterEvent("PLAYER_LOGOUT")
-- 3. Event-Handler setzen
frame:SetScript("OnEvent", function(self, event, ...)
    if event == "PLAYER_LOGIN" then
        print("Spieler eingeloggt!")
    elseif event == "PLAYER_LOGOUT" then
        print("Spieler loggt aus!")
    end
end)

frame:RegisterEvent("UNIT_HEALTH")
frame:UnregisterEvent("UNIT_HEALTH")
frame:UnregisterAllEvents()
-- Unit-spezifisches Event
frame:RegisterUnitEvent("UNIT_HEALTH", "player", "target")

local frame = CreateFrame("Frame")
local events = {}
function events:PLAYER_LOGIN()
    print("Eingeloggt!")
end
function events:UNIT_HEALTH(unit)
    if unit == "player" then
        print("Leben:", UnitHealth("player"))
    end
end
frame:SetScript("OnEvent", function(self, event, ...)
    if events[event] then
        events[event](self, ...)
    end
end)
for event in pairs(events) do
    frame:RegisterEvent(event)
end

-- CreateFrame(frameType, name, parent, template)
local frame = CreateFrame("Frame", "MeinFrame", UIParent)
frame:SetSize(200, 100)
frame:SetPoint("CENTER")

frame:SetSize(200, 100)
frame:SetWidth(200)
frame:SetHeight(100)
-- Ankerpunkte: TOPLEFT, TOP, TOPRIGHT, LEFT, CENTER, RIGHT, BOTTOMLEFT, BOTTOM, BOTTOMRIGHT
frame:SetPoint("CENTER", UIParent, "CENTER", 0, 0)
frame:SetPoint("TOPLEFT", parentFrame, "BOTTOMLEFT", 10, -5)
frame:ClearAllPoints()

frame:Show()
frame:Hide()
frame:SetShown(true)
local isShown = frame:IsShown()
local isVisible = frame:IsVisible()

-- Einfarbige Textur
local texture = frame:CreateTexture(nil, "BACKGROUND")
texture:SetAllPoints(frame)
texture:SetColorTexture(0, 0, 0, 0.8)  -- RGBA
-- Bild-Textur
local icon = frame:CreateTexture(nil, "ARTWORK")
icon:SetSize(32, 32)
icon:SetPoint("LEFT", 5, 0)
icon:SetTexture("Interface\\Icons\\INV_Misc_QuestionMark")

local text = frame:CreateFontString(nil, "OVERLAY", "GameFontNormal")
text:SetPoint("CENTER")
text:SetText("Hallo Welt")
text:SetTextColor(1, 1, 0)  -- Gelb

local button = CreateFrame("Button", "MeinButton", UIParent, "UIPanelButtonTemplate")
button:SetSize(100, 25)
button:SetPoint("CENTER")
button:SetText("Klick mich")
button:SetScript("OnClick", function(self, mouseButton, down)
    print("Button geklickt mit:", mouseButton)
end)

local bar = CreateFrame("StatusBar", nil, UIParent)
bar:SetSize(200, 20)
bar:SetPoint("CENTER")
bar:SetMinMaxValues(0, 100)
bar:SetValue(75)
bar:SetStatusBarTexture("Interface\\TargetingFrame\\UI-StatusBar")
bar:SetStatusBarColor(0, 1, 0)  -- Grün

frame:SetScript("OnLoad", function(self) end)
frame:SetScript("OnShow", function(self) end)
frame:SetScript("OnHide", function(self) end)
frame:SetScript("OnUpdate", function(self, elapsed) end)
frame:SetScript("OnEvent", function(self, event, ...) end)
frame:SetScript("OnEnter", function(self) end)
frame:SetScript("OnLeave", function(self) end)
frame:SetScript("OnMouseDown", function(self, button) end)
frame:SetScript("OnMouseUp", function(self, button) end)

-- Grundinfos
local name = UnitName("target")
local level = UnitLevel("target")
local class, classFile = UnitClass("target")  -- "Krieger", "WARRIOR"
local race = UnitRace("target")
local guid = UnitGUID("target")
-- Klassifikation
local classification = UnitClassification("target")
-- "normal", "elite", "rareelite", "rare", "worldboss"
-- Fraktion
local faction = UnitFactionGroup("target")  -- "Horde", "Alliance"
local isEnemy = UnitIsEnemy("player", "target")
local isFriend = UnitIsFriend("player", "target")
-- Existenz prüfen
local exists = UnitExists("target")
local isPlayer = UnitIsPlayer("target")
local isSameUnit = UnitIsUnit("player", "target")

-- Leben
local health = UnitHealth("player")
local maxHealth = UnitHealthMax("player")
local healthPercent = (health / maxHealth) * 100
-- Kraft (Mana, Wut, Energie)
local power = UnitPower("player")
local maxPower = UnitPowerMax("player")
local powerType = UnitPowerType("player")
-- 0=Mana, 1=Wut, 2=Fokus, 3=Energie
-- Tot?
local isDead = UnitIsDead("target")
local isGhost = UnitIsGhost("player")

-- Buff nach Name
local name, icon, count, debuffType, duration, expirationTime =
    UnitAura("player", "Segen der Macht", "HELPFUL")
-- Alle Buffs durchlaufen
for i = 1, 40 do
    local name, _, _, _, _, _, source, _, _, spellId =
        UnitAura("player", i, "HELPFUL")
    if not name then break end
    print(i, name, spellId)
end
-- Alle Debuffs durchlaufen
for i = 1, 40 do
    local name = UnitAura("player", i, "HARMFUL")
    if not name then break end
    print(i, name)
end

local name, rank, icon, castTime, minRange, maxRange = GetSpellInfo(spellId)
local start, duration, enabled = GetSpellCooldown(spellId)
local remaining = (start + duration) - GetTime()
local isKnown = IsSpellKnown(spellId)

local name, link, quality, ilvl, reqLevel, class, subclass,
      maxStack, equipSlot, texture, vendorPrice = GetItemInfo(itemId)
local count = GetItemCount(itemId)
local countMitBank = GetItemCount(itemId, true)

SendChatMessage("Hallo!", "SAY")
SendChatMessage("Gruppennachricht", "PARTY")
SendChatMessage("Schlachtzugnachricht", "RAID")
SendChatMessage("Flüstern", "WHISPER", nil, "Spielername")
SendChatMessage("Gildennachricht", "GUILD")
print("Nachricht")
DEFAULT_CHAT_FRAME:AddMessage("Rote Nachricht", 1, 0, 0)

local time = GetTime()  -- Sekunden, hohe Präzision
local hours, minutes = GetGameTime()  -- Serverzeit
local formatted = date("%Y-%m-%d %H:%M:%S")

local numMembers = GetNumGroupMembers()
local inRaid = IsInRaid()
local inGroup = IsInGroup()
local name, rank, subgroup, level, class, fileName, zone,
      online, isDead, role, isML = GetRaidRosterInfo(i)

SLASH_MEINADDON1 = "/meinaddon"
SLASH_MEINADDON2 = "/ma"
SlashCmdList["MEINADDON"] = function(msg, editBox)
    print("Befehl empfangen:", msg)
end

SLASH_MEINADDON1 = "/meinaddon"
SlashCmdList["MEINADDON"] = function(msg)
    msg = msg:lower()
    if msg == "" or msg == "hilfe" then
        print("Nutzung: /meinaddon [an|aus|config|status]")
    elseif msg == "an" then
        MeinAddon.aktiv = true
        print("MeinAddon aktiviert")
    elseif msg == "aus" then
        MeinAddon.aktiv = false
        print("MeinAddon deaktiviert")
    elseif msg == "config" then
        MeinAddon:OpenConfig()
    else
        print("Unbekannter Befehl:", msg)
    end
end

SlashCmdList["MEINADDON"] = function(msg)
    local befehl, arg1, arg2 = strsplit(" ", msg, 3)
    befehl = (befehl or ""):lower()
    if befehl == "setze" and arg1 == "lautstaerke" and arg2 then
        local wert = tonumber(arg2)
        if wert and wert >= 0 and wert <= 100 then
            MeinAddon.lautstaerke = wert
            print("Lautstärke auf", wert, "gesetzt")
        end
    end
end

## SavedVariables: MeinAddonDB
## SavedVariablesPerCharacter: MeinAddonCharDB

local frame = CreateFrame("Frame")
frame:RegisterEvent("ADDON_LOADED")
frame:SetScript("OnEvent", function(self, event, addonName)
    if addonName == "MeinAddon" then
        MeinAddonDB = MeinAddonDB or {}
        MeinAddonDB.aktiv = MeinAddonDB.aktiv ~= false
        MeinAddonDB.lautstaerke = MeinAddonDB.lautstaerke or 50
        self:UnregisterEvent("ADDON_LOADED")
    end
end)

local defaults = {
    aktiv = true,
    lautstaerke = 50,
    position = {x = 0, y = 0}
}
local function InitializeDB()
    MeinAddonDB = MeinAddonDB or {}
    for key, value in pairs(defaults) do
        if MeinAddonDB[key] == nil then
            if type(value) == "table" then
                MeinAddonDB[key] = CopyTable(value)
            else
                MeinAddonDB[key] = value
            end
        end
    end
end

local MeinAddon = LibStub("AceAddon-3.0"):NewAddon("MeinAddon", "AceConsole-3.0")
local defaults = {
    profile = {
        aktiv = true,
        lautstaerke = 50,
    },
    char = {
        position = {x = 0, y = 0}
    }
}
function MeinAddon:OnInitialize()
    self.db = LibStub("AceDB-3.0"):New("MeinAddonDB", defaults, true)
    print(self.db.profile.aktiv)
    print(self.db.char.position.x)
end

<Ui xmlns="http://www.blizzard.com/wow/ui/">
    <Script file="Core.lua"/>
    <Include file="Frames.xml"/>
</Ui>

<Frame name="MeinFrame" parent="UIParent" enableMouse="true" movable="true">
    <Size x="200" y="100"/>
    <Anchors>
        <Anchor point="CENTER"/>
    </Anchors>
    <Layers>
        <Layer level="BACKGROUND">
            <Texture setAllPoints="true">
                <Color r="0" g="0" b="0" a="0.8"/>
            </Texture>
        </Layer>
        <Layer level="OVERLAY">
            <FontString name="$parentTitle" inherits="GameFontNormal">
                <Anchors><Anchor point="CENTER"/></Anchors>
            </FontString>
        </Layer>
    </Layers>
    <Scripts>
        <OnLoad>self:RegisterForDrag("LeftButton")</OnLoad>
        <OnDragStart>self:StartMoving()</OnDragStart>
        <OnDragStop>self:StopMovingOrSizing()</OnDragStop>
    </Scripts>
</Frame>

<Button name="MeinButton" inherits="UIPanelButtonTemplate" text="Klick">
    <Size x="100" y="25"/>
    <Anchors><Anchor point="CENTER"/></Anchors>
    <Scripts>
        <OnClick>print("Geklickt!")</OnClick>
    </Scripts>
</Button>

if InCombatLockdown() then
    print("Im Kampf - geschützte Operationen blockiert")
    return
end
mySecureButton:SetAttribute("spell", "Heilende Berührung")

local button = CreateFrame("Button", "MeinSecureButton", UIParent,
    "SecureActionButtonTemplate")
button:SetSize(50, 50)
button:SetPoint("CENTER")
-- AUSSERHALB des Kampfes konfigurieren!
button:SetAttribute("type", "spell")
button:SetAttribute("spell", "Heilende Berührung")

button:SetAttribute("type", "spell")
button:SetAttribute("spell", "Blitzheilung")
button:SetAttribute("shift-type", "spell")
button:SetAttribute("shift-spell", "Große Heilung")
button:SetAttribute("ctrl-type", "spell")
button:SetAttribute("ctrl-spell", "Erneuerung")

-- Sicheres Hooking ohne Taint
hooksecurefunc("SecureFunction", function(...)
    print("Funktion wurde aufgerufen mit:", ...)
end)

local name, rank = GetSpellInfo(spellId)
print(name, rank)  -- "Heilende Berührung", "Rang 11"
CastSpellByName("Heilende Berührung(Rang 7)")

local powerType = UnitPowerType("player")
-- 0 = Mana
-- 1 = Wut
-- 2 = Fokus (Jäger-Begleiter)
-- 3 = Energie

local happiness, damageModifier, loyaltyRate = GetPetHappiness()
-- 1=Unglücklich, 2=Zufrieden, 3=Glücklich

local haveTotem, totemName, startTime, duration = GetTotemInfo(slot)
-- slot: 1=Feuer, 2=Erde, 3=Wasser, 4=Luft
DestroyTotem(slot)

frame:RegisterEvent("COMBAT_LOG_EVENT_UNFILTERED")
frame:SetScript("OnEvent", function(self, event)
    local timestamp, subevent, _, sourceGUID, sourceName, sourceFlags,
          sourceRaidFlags, destGUID, destName, destFlags, destRaidFlags,
          arg12, arg13, arg14, arg15 = CombatLogGetCurrentEventInfo()
    if subevent == "SPELL_DAMAGE" then
        local spellId, spellName, spellSchool = arg12, arg13, arg14
        local amount = arg15
        print(sourceName, "trifft", destName, "für", amount)
    end
end)

/reload              -- UI neu laden
/dump ausdruck       -- Lua auswerten
/etrace              -- Event-Debugger
/fstack              -- Frames unter Mauszeiger
/console taintLog 1  -- Taint-Logging