first commit

2025-12-08 13:45:59 +01:00
commit bd66424c2a
14 changed files with 1324 additions and 0 deletions
@@ -0,0 +1,195 @@
+# Wiki.js Formatting Guide for AI/LLM
+
+This document provides formatting guidelines for creating and editing Wiki.js articles in this repository.
+
+## Project Overview
+
+This is the ExilesWiki project for an Ascension WoW private server. Articles are written in Markdown format with Wiki.js-specific features enabled.
+
+## Markdown Features
+
+### Standard Markdown
+- Headers: `#`, `##`, `###`, etc.
+- **Bold**: `**text**`
+- *Italic*: `*text*`
+- Lists: `-` or `1.`
+- Links: `[text](url)`
+- Code blocks: triple backticks
+
+### Wiki.js Specific
+
+#### Icons
+Icons are stored in `/icons/` directory and referenced as:
+```markdown
+![Icon Alt Text](/icons/path/to/icon.png)
+```
+
+Examples:
+- Class icons: `![Paladin](/icons/classes/classicon_paladin.png)`
+- Item icons: `![Item Name](/icons/items/itemicon_name.png)`
+
+#### Tables
+MultiMarkdown Table format is enabled:
+```markdown
+| Column 1 | Column 2 | Column 3 |
+|----------|----------|----------|
+| Data     | Data     | Data     |
+```
+
+- Use `<br>` for line breaks within cells
+- Tables support standard markdown formatting inside cells
+
+#### PlantUML Diagrams
+PlantUML code blocks are rendered as diagrams:
+
+````markdown
+```plantuml
+@startuml
+title Diagram Title
+' Your PlantUML code here
+@enduml
+```
+````
+
+**C4 PlantUML for Rotations:**
+For ability rotations/priority systems, use C4 PlantUML format:
+
+````markdown
+```plantuml
+@startuml
+!define C4 true
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+
+title Ability Priority System
+
+rectangle "Priority System" {
+  (1) Ability Name : Description
+  (2) Another Ability : Description
+
+  (1) -down-> (2)
+}
+@enduml
+```
+````
+
+#### External Links
+
+**Ascension Database Links:**
+Link items/spells to the Ascension database:
+```markdown
+[Item Name](https://db.ascension.gg/?item=ITEMID)
+[Spell Name](https://db.ascension.gg/?spell=SPELLID)
+```
+
+Example:
+```markdown
+[Lionheart Helm](https://db.ascension.gg/?item=12640)
+[Deranged Druid](https://db.ascension.gg/?spell=84531)
+```
+
+## Content Structure
+
+### Class Guides
+
+Typical structure for class guides:
+
+1. **Title & Icon**: Class name with class icon
+2. **Introduction**: Brief overview and author credit
+3. **Pre-Raid BiS Gear**: Table format with slot/item options
+4. **Enchants**: Table with slot/enchant/stats
+5. **Talents**: Key talent descriptions
+6. **Mystic Enchants**: Organized by rarity (Artifact, Legendary, Epic, Rare)
+7. **Macros**: Code blocks with macro examples
+8. **Rotation**: PlantUML priority diagram + text breakdown
+
+### Formatting Best Practices
+
+- Use tables for gear lists, enchants, and stat comparisons
+- Use code blocks for macros, commands, and configuration
+- Include icons for visual appeal (class icons, item icons)
+- Link items to db.ascension.gg when possible
+- Use PlantUML for visual representations of rotations/priorities
+- Break long lists with headers and categories
+- Use bold for important terms or item/ability names
+- Use italic for quest/flavor text
+
+## File Organization
+
+```
+exileswiki/
+├── .ai/                           # AI/LLM documentation
+│   └── wiki-formatting-guide.md
+├── scripts/                       # Utility scripts
+│   ├── add_item_links.py         # Auto-link items to db
+│   └── item_links_found.json     # Cache of found item IDs
+├── icons/                         # Icon assets
+│   ├── classes/
+│   └── items/
+└── *.md                          # Wiki articles
+```
+
+## Scripts
+
+### add_item_links.py
+Automatically searches db.ascension.gg for items in guides and adds proper links.
+
+Usage:
+```bash
+python3 scripts/add_item_links.py
+```
+
+The script:
+1. Extracts item names from markdown files
+2. Searches db.ascension.gg for each item
+3. Saves results to `item_links_found.json`
+4. Reports items that need manual lookup
+
+## Tips for AI/LLM
+
+When creating or editing wiki articles:
+
+1. **Always check existing articles** for formatting consistency
+2. **Use the icon path format** `/icons/category/name.png` (absolute path from root)
+3. **MultiMarkdown tables** support `<br>` for multi-line cells
+4. **PlantUML C4 diagrams** work well for ability priority systems
+5. **Item links** should use format `[Name](https://db.ascension.gg/?item=ID)`
+6. **Code blocks** for macros should specify language (e.g., ````lua` or just ``` for plain)
+7. **Test PlantUML** syntax before committing (validate it renders)
+8. **Keep tables readable** in source - align columns when possible
+
+## Example Article Structure
+
+```markdown
+# Class Name Guide
+
+![Class Icon](/icons/classes/classicon_name.png)
+
+*By Author*
+
+Brief introduction...
+
+## Section Header
+
+Content with [linked items](https://db.ascension.gg/?item=12640)...
+
+| Header 1 | Header 2 |
+|----------|----------|
+| Data     | Data     |
+
+```plantuml
+@startuml
+title Diagram
+@enduml
+```
+
+## Another Section
+
+More content...
+```
+
+## Resources
+
+- [Wiki.js Documentation](https://docs.requarks.io/)
+- [PlantUML Documentation](https://plantuml.com/)
+- [Ascension Database](https://db.ascension.gg/)
+- [MultiMarkdown Table Syntax](https://fletcher.github.io/MultiMarkdown-6/syntax/tables.html)
@@ -0,0 +1,11 @@
+# Ignore project files
+.idea/
+*.iml
+
+# Ignore all .java files except the ones from the 'src/main' folder
+venv/
+
+# Ignore logs and temporary files
+logs/
+*.log
+*.tmp
@@ -0,0 +1,45 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Python files
+[*.py]
+indent_style = space
+indent_size = 4
+max_line_length = 120
+multi_line_output = 3
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+# Requirements files
+[requirements*.txt]
+insert_final_newline = false
+
+# Shell scripts
+[*.sh]
+end_of_line = lf
+
+# Windows scripts
+[*.{cmd,bat}]
+end_of_line = crlf
@@ -0,0 +1,36 @@
+# Basic .gitattributes for a python repo.
+
+# py source files
+*.pxd text
+*.py  text
+*.py3 text
+*.pyw text
+*.pyx text
+
+# py binary files
+*.db  binary
+*.p   binary
+*.pkl binary
+*.pyc binary
+*.pyd binary
+*.pyo binary
+
+# Note: .db, .p, and .pkl files are associated
+# with the python modules ``pickle``, ``dbm.*``,
+# ``shelve``, ``marshal``, ``anydbm``, & ``bsddb``
+# (among others).
+
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto
+
+# Explicitly declare text files you want to always be normalized and converted
+# to native line endings on checkout.
+*.c text
+*.h text
+
+# Declare files that will always have CRLF line endings on checkout.
+*.sln text eol=crlf
+
+# Denote all files that are truly binary and should not be modified.
+*.png binary
+*.jpg binary
@@ -0,0 +1,87 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+env/
+ENV/
+*.egg-info/
+dist/
+build/
+
+# Icon files (downloaded and converted)
+icons/ICONS/
+icons/*.zip
+icons_converted/
+
+# IDE
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Temporary files
+*.tmp
+*.bak
+.cache/
+
+# ---> Ansible
+*.retry
+
+# Temporary files
+temp/
+temp/*
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+env/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+
+# Logs
+*.log
+
+# Environment variables
+.env
+.env.local
@@ -0,0 +1,13 @@
+## Interface: 30300
+## Title: Ascension Exporter
+## Notes: Export active talents, worn items, and active Mystic Enchants to JSON
+## Author: Subd from Exiles EU
+## Version: 0.1.0
+## SavedVariables: AscensionExporterSaved, AscensionExporterConfig
+
+Core.lua
+Util/Json.lua
+UI/ExportFrame.lua
+Collectors/Talents.lua
+Collectors/Gear.lua
+Collectors/Enchants.lua
@@ -0,0 +1,58 @@
+-- AscensionExporter - Mystic Enchants collector (from equipped item tooltips)
+
+local AE = AscensionExporter
+
+local SLOT_NAMES = {
+    [1] = "HEAD", [2] = "NECK", [3] = "SHOULDER", [4] = "SHIRT", [5] = "CHEST",
+    [6] = "WAIST", [7] = "LEGS", [8] = "FEET", [9] = "WRIST", [10] = "HANDS",
+    [11] = "FINGER1", [12] = "FINGER2", [13] = "TRINKET1", [14] = "TRINKET2",
+    [15] = "BACK", [16] = "MAINHAND", [17] = "OFFHAND", [18] = "RANGED", [19] = "TABARD",
+}
+
+local function extract_mystic_from_tooltip(slot)
+    GameTooltip:SetOwner(UIParent, "ANCHOR_NONE")
+    GameTooltip:SetInventoryItem("player", slot)
+    local found = nil
+    for i = 1, GameTooltip:NumLines() do
+        local line = _G["GameTooltipTextLeft" .. i]
+        if line then
+            local txt = tostring(line:GetText() or "")
+            if txt and txt ~= "" then
+                local l = txt:lower()
+                if (l:find("mystic") or l:find("mythic")) and (l:find("enchant") or l:find("rune")) then
+                    -- Try to pull the enchant name after a colon, else use the whole line
+                    local name = txt
+                    local after = txt:match("[:：]%s*(.+)$")
+                    if after and after ~= "" then name = after end
+                    -- Trim color codes if any
+                    name = name:gsub("|c%x%x%x%x%x%x%x%x", ""):gsub("|r", "")
+                    found = name
+                    break
+                end
+            end
+        end
+    end
+    GameTooltip:Hide()
+    return found
+end
+
+function AE.CollectMysticEnchants()
+    local perSlot = {}
+    local activeSet = {}
+    for slot = 1, 19 do
+        local link = GetInventoryItemLink("player", slot)
+        if link then
+            local name = extract_mystic_from_tooltip(slot)
+            if name and name ~= "" then
+                table.insert(perSlot, { slot = slot, slotName = SLOT_NAMES[slot] or tostring(slot), name = name })
+                activeSet[name] = true
+            end
+        end
+    end
+    local active = {}
+    for n, _ in pairs(activeSet) do
+        table.insert(active, { name = n })
+    end
+    table.sort(active, function(a,b) return a.name < b.name end)
+    return { perSlot = perSlot, active = active }
+end
@@ -0,0 +1,109 @@
+-- AscensionExporter - Gear collector (equipped items only)
+
+local AE = AscensionExporter
+
+local SLOT_NAMES = {
+    [1] = "HEAD", [2] = "NECK", [3] = "SHOULDER", [4] = "SHIRT", [5] = "CHEST",
+    [6] = "WAIST", [7] = "LEGS", [8] = "FEET", [9] = "WRIST", [10] = "HANDS",
+    [11] = "FINGER1", [12] = "FINGER2", [13] = "TRINKET1", [14] = "TRINKET2",
+    [15] = "BACK", [16] = "MAINHAND", [17] = "OFFHAND", [18] = "RANGED", [19] = "TABARD",
+}
+
+local function parse_item_link(itemLink)
+    if not itemLink then return nil end
+    local itemString = itemLink:match("Hitem:([%d:]+)")
+    if not itemString then return nil end
+    local parts = {}
+    for v in string.gmatch(itemString, "([^:]+)") do
+        parts[#parts+1] = tonumber(v) or 0
+    end
+    local itemId = parts[1] or 0
+    local enchantId = parts[2] or 0
+    local gems = { parts[3] or 0, parts[4] or 0, parts[5] or 0, parts[6] or 0 }
+    local suffixId = parts[7] or 0
+    return {
+        itemId = itemId,
+        enchantId = enchantId,
+        gems = gems,
+        suffixId = suffixId,
+    }
+end
+
+local function resolve_gems(itemLink, gemIds)
+    local arr = {}
+    for i = 1, 4 do
+        local gid = gemIds[i] or 0
+        if gid and gid > 0 then
+            -- GetItemGem gives name & link by index
+            local name, gemLink = GetItemGem(itemLink, i)
+            table.insert(arr, { itemId = gid, name = name or "", link = gemLink or "" })
+        end
+    end
+    return arr
+end
+
+local function read_enchant_from_tooltip(slot)
+    -- Try to extract human-readable base enchant (not mystic) if present
+    GameTooltip:SetOwner(UIParent, "ANCHOR_NONE")
+    GameTooltip:SetInventoryItem("player", slot)
+    local name = nil
+    for i = 1, GameTooltip:NumLines() do
+        local line = _G["GameTooltipTextLeft" .. i]
+        if line then
+            local txt = tostring(line:GetText() or "")
+            if txt and txt ~= "" then
+                local l = txt:lower()
+                -- Skip mystic/mythic lines; those are handled separately
+                if not ((l:find("mystic") or l:find("mythic")) and (l:find("enchant") or l:find("rune"))) then
+                    -- Heuristic: lines starting with "Enchanted" or containing "Enchantment" often denote base enchants
+                    if l:find("^enchanted") or l:find("enchant") then
+                        name = txt
+                    end
+                end
+            end
+        end
+    end
+    GameTooltip:Hide()
+    return name
+end
+
+function AE.CollectGear()
+    local out = { slots = {} }
+    for slot = 1, 19 do
+        local itemLink = GetInventoryItemLink("player", slot)
+        if itemLink then
+            local parsed = parse_item_link(itemLink) or {}
+            local itemId = parsed.itemId or 0
+            local itemName, _, itemQuality, itemLevel, _, itemType, itemSubType, _, equipSlot, texture = GetItemInfo(itemLink)
+
+            local enchantName = read_enchant_from_tooltip(slot)
+            local enchant = nil
+            if parsed.enchantId and parsed.enchantId > 0 then
+                enchant = { id = parsed.enchantId, name = enchantName or "" }
+            elseif enchantName then
+                enchant = { id = 0, name = enchantName }
+            end
+
+            local gems = resolve_gems(itemLink, parsed.gems or {})
+
+            table.insert(out.slots, {
+                slot = slot,
+                slotName = SLOT_NAMES[slot] or tostring(slot),
+                itemId = itemId,
+                name = itemName or "",
+                quality = itemQuality or 0,
+                itemLevel = itemLevel or 0,
+                type = itemType or "",
+                subType = itemSubType or "",
+                equipSlot = equipSlot or "",
+                texture = texture or "",
+                link = itemLink,
+                enchant = enchant,
+                gems = gems,
+            })
+        else
+            -- Empty slot omitted intentionally
+        end
+    end
+    return out
+end
@@ -0,0 +1,56 @@
+-- AscensionExporter - Talents collector (active spec only)
+
+local AE = AscensionExporter
+
+local function get_active_group()
+    if GetActiveTalentGroup then
+        local g = GetActiveTalentGroup()
+        if g == 0 then g = 1 end
+        return g or 1
+    end
+    return 1
+end
+
+local function collect_selected_for_tab(tabIndex, talentGroup)
+    local arr = {}
+    local numTalents = GetNumTalents(tabIndex)
+    for talentIndex = 1, numTalents do
+        local name, _, _, _, rank, maxRank = GetTalentInfo(tabIndex, talentIndex, false, false, talentGroup)
+        if rank and rank > 0 then
+            local link = GetTalentLink(tabIndex, talentIndex)
+            local spellId = 0
+            if link then
+                spellId = tonumber(string.match(link, "talent:(%d+)")) or 0
+            end
+            table.insert(arr, {
+                tabIndex = tabIndex,
+                talentIndex = talentIndex,
+                name = name or "",
+                rank = rank or 0,
+                maxRank = maxRank or 0,
+                spellId = spellId,
+            })
+        end
+    end
+    return arr
+end
+
+function AE.CollectTalents()
+    local active = get_active_group()
+    local out = {
+        activeTalentGroup = active,
+        selected = {},
+    }
+
+    local numTabs = GetNumTalentTabs()
+    for tabIndex = 1, numTabs do
+        local tabName, _, pointsSpent = GetTalentTabInfo(tabIndex, false, false, active)
+        -- Only export selected ranks for the active group
+        local selected = collect_selected_for_tab(tabIndex, active)
+        for _, v in ipairs(selected) do
+            table.insert(out.selected, v)
+        end
+    end
+
+    return out
+end
@@ -0,0 +1,250 @@
+-- AscensionExporter - Core
+local ADDON_NAME = ...
+local AE = {}
+AscensionExporter = AE
+
+-- SavedVariables defaults
+AscensionExporterConfig = AscensionExporterConfig or {}
+AscensionExporterConfig.enableSavedVariables = AscensionExporterConfig.enableSavedVariables == true and true or false
+AscensionExporterSaved = AscensionExporterSaved or {}
+
+-- Utils
+local function IsArray(t)
+    if type(t) ~= "table" then return false end
+    local n = 0
+    for k, _ in pairs(t) do
+        if type(k) ~= "number" then return false end
+        n = n + 1
+    end
+    for i = 1, n do
+        if t[i] == nil then return false end
+    end
+    return true
+end
+
+-- Shims for safety
+local function SafeCall(fn, ...)
+    local ok, r = pcall(fn, ...)
+    if ok then return r end
+    return nil
+end
+
+-- Export assembly
+function AE:AssembleExport(which)
+    local nowIso = date("!%Y-%m-%dT%H:%M:%SZ")
+    local version, build, buildDate, toc = GetBuildInfo()
+
+    local name = UnitName("player") or ""
+    local level = UnitLevel("player") or 0
+    local _, class = UnitClass("player")
+    local _, race = UnitRace("player")
+    local faction = UnitFactionGroup("player") or ""
+    local realm = GetRealmName and GetRealmName() or (GetCVar and GetCVar("realmName")) or ""
+
+    local out = {
+        schemaVersion = 1,
+        exportedAt = nowIso,
+        client = { interface = toc or 30300, version = version, build = build, buildDate = buildDate },
+        character = { name = name or "", realm = realm or "", level = level or 0, class = class or "", race = race or "", faction = faction or "" },
+    }
+
+    local wantAll = (which == nil) or (which == "all")
+
+    if wantAll or which == "talents" then
+        if AE.CollectTalents then
+            out.talents = SafeCall(AE.CollectTalents) or {}
+        end
+    end
+
+    if wantAll or which == "gear" then
+        if AE.CollectGear then
+            out.gear = SafeCall(AE.CollectGear) or {}
+        end
+    end
+
+    if wantAll or which == "enchants" then
+        if AE.CollectMysticEnchants then
+            out.mysticEnchants = SafeCall(AE.CollectMysticEnchants) or {}
+        end
+    end
+
+    return out
+end
+
+function AE:Export(which)
+    local data = self:AssembleExport(which)
+    -- Prefer global encoder from Util/Json.lua; fallback to a tiny local encoder if missing
+    local function tiny_json_encode(v)
+        local tv = type(v)
+        if tv == 'nil' then return 'null' end
+        if tv == 'boolean' then return v and 'true' or 'false' end
+        if tv == 'number' then return tostring(v) end
+        if tv == 'string' then
+            local s = v:gsub('\\', '\\\\'):gsub('"', '\\"'):gsub('\n', '\\n'):gsub('\r', '\\r'):gsub('\t', '\\t')
+            return '"' .. s .. '"'
+        end
+        if tv == 'table' then
+            -- detect array-like
+            local n = 0
+            for k,_ in pairs(v) do if type(k) ~= 'number' then n = -1 break else n = math.max(n, k) end end
+            if n >= 1 then
+                local parts = {}
+                for i=1,n do parts[#parts+1] = tiny_json_encode(v[i]) end
+                return '[' .. table.concat(parts, ',') .. ']'
+            else
+                local parts = {}
+                for k,val in pairs(v) do parts[#parts+1] = tiny_json_encode(tostring(k)) .. ':' .. tiny_json_encode(val) end
+                return '{' .. table.concat(parts, ',') .. '}'
+            end
+        end
+        return 'null'
+    end
+    local encoder = _G.AscensionExporter_Json_Encode or tiny_json_encode
+    local json = encoder(data)
+
+    local title = "Ascension Export"
+    if which and which ~= "all" then title = title .. " - " .. which end
+    AscensionExporter_ShowExportFrame(json, title .. " - Copy All (Ctrl+C)")
+
+    if AscensionExporterConfig.enableSavedVariables then
+        local key = (data.character.realm or "") .. ":" .. (data.character.name or "")
+        AscensionExporterSaved[key] = data
+        DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter: export saved to SavedVariables for " .. key)
+    end
+end
+
+-- Markdown gear table generator (for guide tables like mage-guide.md)
+function AE:GenerateMarkdownGear()
+    local gear = self.CollectGear and self.CollectGear() or { slots = {} }
+    local ench = self.CollectMysticEnchants and self.CollectMysticEnchants() or { perSlot = {}, active = {} }
+
+    -- Map gear by slot and mystic enchant per slot
+    local bySlot = {}
+    for _, s in ipairs(gear.slots or {}) do
+        bySlot[s.slot] = s
+    end
+    local mystPer = {}
+    for _, e in ipairs(ench.perSlot or {}) do
+        mystPer[e.slot] = e.name
+    end
+
+    -- Desired order and pretty slot names matching the mage guide
+    local ORDER = {
+        {1,  "Head"},
+        {2,  "Neck"},
+        {3,  "Shoulders"},
+        {15, "Back"},
+        {5,  "Chest"},
+        {9,  "Wrist"},
+        {16, "Mainhand"},
+        {17, "Offhand"},
+        {18, "Wand"},
+        {10, "Gloves"},
+        {6,  "Belt"},
+        {7,  "Legs"},
+        {8,  "Boots"},
+        {11, "Ring 1"},
+        {12, "Ring 2"},
+        {13, "Trinket 1"},
+        {14, "Trinket 2"},
+    }
+
+    local function md_link(name, itemId)
+        if (itemId or 0) > 0 and name and name ~= "" then
+            return string.format("[%s](https://db.ascension.gg/?item=%d)", name, itemId)
+        elseif name and name ~= "" then
+            return name
+        else
+            return "-"
+        end
+    end
+
+    local lines = {}
+    table.insert(lines, "| Slot | Item | Location | Enchant | Alternative |")
+    table.insert(lines, "|------|------|----------|---------|-------------|")
+
+    for _, ent in ipairs(ORDER) do
+        local slotId, label = ent[1], ent[2]
+        local s = bySlot[slotId]
+        local itemCell = "-"
+        local enchantCell = "-"
+
+        if s then
+            itemCell = md_link(s.name, s.itemId)
+            local base = s.enchant and s.enchant.name or nil
+            local myst = mystPer[slotId]
+            if base and base ~= "" then
+                enchantCell = base
+            end
+            if myst and myst ~= "" then
+                enchantCell = (enchantCell ~= "-" and enchantCell ~= nil and enchantCell ~= "")
+                    and (enchantCell .. " / Mystic: " .. myst)
+                    or ("Mystic: " .. myst)
+            end
+            if not enchantCell or enchantCell == "" then enchantCell = "-" end
+        end
+
+        local row = string.format("| **%s** | %s | - | %s | - |", label, itemCell, enchantCell)
+        table.insert(lines, row)
+    end
+
+    return table.concat(lines, "\n") .. "\n"
+end
+
+-- Slash command handling
+SLASH_ASCX1 = "/ascx"
+SLASH_ASCX2 = "/asxc" -- alias: both map to the same handler key "ASCX"
+SlashCmdList["ASCX"] = function(msg)
+    msg = msg or ""
+    msg = msg:lower()
+    if msg == "" or msg == "help" then
+        -- Open the export window with helpful text and let buttons drive actions
+        if AscensionExporter_ShowExportFrame then
+            local help = "Use the buttons above or type:\n/ascx export all|talents|gear|enchants|mdgear\n/ascx sv on|off (SavedVariables is currently " .. (AscensionExporterConfig.enableSavedVariables and "ON" or "OFF") .. ")\n"
+            AscensionExporter_ShowExportFrame(help, "Ascension Export - Tools & Help")
+            return
+        else
+            DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter usage:")
+            DEFAULT_CHAT_FRAME:AddMessage("  /ascx export all|talents|gear|enchants|mdgear")
+            DEFAULT_CHAT_FRAME:AddMessage("  /ascx sv on|off  - toggle SavedVariables export (currently " .. (AscensionExporterConfig.enableSavedVariables and "ON" or "OFF") .. ")")
+            return
+        end
+    end
+
+    local cmd, rest = msg:match("^(%S+)%s*(.*)$")
+    if cmd == "export" then
+        rest = rest ~= "" and rest or "all"
+        if rest == "mdgear" or rest == "md" then
+            local md = AE:GenerateMarkdownGear()
+            AscensionExporter_ShowExportFrame(md, "Ascension Export - Markdown Gear - Copy All (Ctrl+C)")
+        elseif rest == "all" or rest == "talents" or rest == "gear" or rest == "enchants" then
+            AE:Export(rest)
+        else
+            DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter: unknown export target '" .. tostring(rest) .. "'")
+        end
+        return
+    elseif cmd == "sv" then
+        if rest == "on" then
+            AscensionExporterConfig.enableSavedVariables = true
+            DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter: SavedVariables export ENABLED")
+        elseif rest == "off" then
+            AscensionExporterConfig.enableSavedVariables = false
+            DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter: SavedVariables export DISABLED")
+        else
+            DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter: sv on|off")
+        end
+        return
+    else
+        DEFAULT_CHAT_FRAME:AddMessage("AscensionExporter: unknown command. Type /ascx help")
+    end
+end
+
+-- Basic event binding (not strictly necessary for slash-only usage)
+local f = CreateFrame("Frame")
+f:RegisterEvent("ADDON_LOADED")
+f:SetScript("OnEvent", function(_, event, addon)
+    if event == "ADDON_LOADED" and addon == ADDON_NAME then
+        -- init defaults if needed
+        AscensionExporterConfig.enableSavedVariables = AscensionExporterConfig.enableSavedVariables and true or false
+    end
+end)
@@ -0,0 +1,54 @@
+AscensionExporter
+=================
+
+Export the following from your Ascension (WotLK 3.3.5) client:
+- Active talents (current spec only)
+- Worn items (equipped gear only), including base enchant text and gems
+- Active Mystic/Mythic Enchants (derived from equipped item tooltips)
+
+Installation (Linux path provided by you)
+- Copy the `AscensionExporter` folder to:
+  `/srv/add01/wow-ascension/Interface/AddOns/AscensionExporter`
+- Ensure the structure is:
+  `/srv/add01/wow-ascension/Interface/AddOns/AscensionExporter/AscensionExporter.toc`
+
+Usage
+- In-game, type:
+  - `/ascx export all` — talents + gear + mystic enchants
+  - `/ascx export talents` — only active spec selected talents
+  - `/ascx export gear` — only equipped gear
+  - `/ascx export enchants` — only mystic enchants
+  - `/ascx export mdgear` — equipped gear as a Markdown table (for guides)
+- A copyable JSON window will open. Press Ctrl+C to copy.
+
+Export window button
+- The export window now has a "MD Gear" button. Click it to populate the window with a Markdown gear table matching the guide format:
+  - Columns: `Slot | Item | Location | Enchant | Alternative`
+  - `Item` links to db.ascension.gg when the itemId is known.
+  - `Enchant` includes base enchant text and any active Mystic/Mythic enchant (e.g., `... / Mystic: Rune of Power`).
+  - `Location` and `Alternative` are placeholders (`-`) since those are guide-specific.
+
+SavedVariables (optional)
+- Disabled by default. Toggle with:
+  - `/ascx sv on`  — enable saving last export to SavedVariables
+  - `/ascx sv off` — disable
+- Saved in: `AscensionExporterSaved` table (path depends on your client setup).
+
+JSON schema (v1)
+- Top-level fields:
+  - `schemaVersion` (number)
+  - `exportedAt` (ISO UTC string)
+  - `client` (interface/build info)
+  - `character` (name, realm, level, class, race, faction)
+  - `talents` → `{ activeTalentGroup, selected[] }` for current spec only
+  - `gear` → `{ slots[] }` equipped items with parsed IDs, names, enchant text, gems
+  - `mysticEnchants` → `{ perSlot[], active[] }` from equipped item tooltips
+
+Notes & limits
+- Mystic vs Mythic wording varies; detection is case-insensitive for lines containing both `mystic|mythic` and `enchant|rune`.
+- Profession-only enchants (e.g., Enchanting ring enchants) are not included in `mysticEnchants`; base enchant text is placed under `gear.slots[].enchant`.
+- Some item info may be `nil` if not cached; reopen the character pane or shift-hover items to cache if needed.
+
+Troubleshooting
+- If `/ascx` doesn’t respond, verify the addon is enabled on the character select screen.
+- If the export window is empty, try `/reload` and re-run the command out of combat.
@@ -0,0 +1,104 @@
+-- AscensionExporter - Export UI
+
+local function CreateOrGetFrame()
+    if AscensionExporterFrame then return AscensionExporterFrame end
+
+    local frame = CreateFrame("Frame", "AscensionExporterFrame", UIParent, "DialogBoxFrame")
+    frame:SetSize(700, 500)
+    frame:SetPoint("CENTER")
+    frame:SetMovable(true)
+    frame:EnableMouse(true)
+    frame:RegisterForDrag("LeftButton")
+    frame:SetScript("OnDragStart", frame.StartMoving)
+    frame:SetScript("OnDragStop", frame.StopMovingOrSizing)
+
+    -- Title text
+    local title = frame:CreateFontString(nil, "OVERLAY", "GameFontHighlightLarge")
+    title:SetPoint("TOP", 0, -8)
+    frame.title = title
+
+    -- Action buttons row
+    local function makeBtn(label, x, click)
+        local btn = CreateFrame("Button", nil, frame, "UIPanelButtonTemplate")
+        btn:SetSize(90, 22)
+        btn:SetPoint("TOPLEFT", 16 + x, -36)
+        btn:SetText(label)
+        btn:SetScript("OnClick", click)
+        return btn
+    end
+
+    local x = 0
+    makeBtn("All", x, function()
+        if AscensionExporter and AscensionExporter.Export then
+            local data = AscensionExporter:AssembleExport("all")
+            local encoder = _G.AscensionExporter_Json_Encode
+            local json
+            if encoder then json = encoder(data) else
+                -- very small fallback mirroring Core's behavior
+                local function E(v)
+                    local t=type(v)
+                    if t=='nil' then return 'null' end
+                    if t=='boolean' then return v and 'true' or 'false' end
+                    if t=='number' then return tostring(v) end
+                    if t=='string' then v=v:gsub('\\','\\\\'):gsub('"','\\"'):gsub('\n','\\n'):gsub('\r','\\r'):gsub('\t','\\t'); return '"'..v..'"' end
+                    if t=='table' then local n=0 for k,_ in pairs(v) do if type(k)~='number' then n=-1 break else if k>n then n=k end end end if n>=1 then local p={} for i=1,n do p[#p+1]=E(v[i]) end return '['..table.concat(p,',')..']' else local p={} for k,val in pairs(v) do p[#p+1]=E(tostring(k))..':'..E(val) end return '{'..table.concat(p,',')..'}' end end
+                    return 'null'
+                end
+                json = E(data)
+            end
+            AscensionExporter_ShowExportFrame(json, "Ascension Export - all - Copy All (Ctrl+C)")
+        end
+    end)
+    x = x + 95
+    makeBtn("Talents", x, function()
+        if AscensionExporter then AscensionExporter:Export("talents") end
+    end)
+    x = x + 95
+    makeBtn("Gear", x, function()
+        if AscensionExporter then AscensionExporter:Export("gear") end
+    end)
+    x = x + 95
+    makeBtn("Enchants", x, function()
+        if AscensionExporter then AscensionExporter:Export("enchants") end
+    end)
+    x = x + 95
+    makeBtn("MD Gear", x, function()
+        if AscensionExporter and AscensionExporter.GenerateMarkdownGear then
+            local md = AscensionExporter:GenerateMarkdownGear() or ""
+            AscensionExporter_ShowExportFrame(md, "Ascension Export - Markdown Gear - Copy All (Ctrl+C)")
+        end
+    end)
+
+    -- ScrollFrame + EditBox
+    local scrollFrame = CreateFrame("ScrollFrame", "AscensionExporterScrollFrame", frame, "UIPanelScrollFrameTemplate")
+    scrollFrame:SetPoint("TOPLEFT", 16, -64)
+    scrollFrame:SetPoint("BOTTOMRIGHT", -32, 16)
+
+    local editBox = CreateFrame("EditBox", "AscensionExporterEditBox", scrollFrame)
+    editBox:SetMultiLine(true)
+    editBox:SetAutoFocus(true)
+    editBox:SetFontObject(ChatFontNormal)
+    editBox:SetWidth(640)
+    editBox:SetScript("OnEscapePressed", function(self) self:ClearFocus() end)
+    editBox:SetScript("OnEditFocusGained", function(self) self:HighlightText() end)
+    scrollFrame:SetScrollChild(editBox)
+
+    frame.scrollFrame = scrollFrame
+    frame.editBox = editBox
+
+    -- Close button
+    local close = CreateFrame("Button", nil, frame, "UIPanelCloseButton")
+    close:SetPoint("TOPRIGHT", -4, -4)
+
+    AscensionExporterFrame = frame
+    return frame
+end
+
+function AscensionExporter_ShowExportFrame(text, titleText)
+    local f = CreateOrGetFrame()
+    f:Show()
+    f.editBox:SetText(text or "")
+    f.title:SetText(titleText or "Ascension Export - Copy All (Ctrl+C)")
+    f.editBox:HighlightText()
+    f.editBox:SetFocus()
+end
@@ -0,0 +1,58 @@
+-- Minimal JSON encoder for AscensionExporter
+
+local function escape_str(s)
+    s = tostring(s)
+    s = s:gsub('\\', '\\\\')
+    s = s:gsub('"', '\\"')
+    s = s:gsub('\n', '\\n')
+    s = s:gsub('\r', '\\r')
+    s = s:gsub('\t', '\\t')
+    return '"' .. s .. '"'
+end
+
+local function is_array(t)
+    if type(t) ~= 'table' then return false end
+    local n = 0
+    for k, _ in pairs(t) do
+        if type(k) ~= 'number' then return false end
+        n = n + 1
+    end
+    for i = 1, n do
+        if t[i] == nil then return false end
+    end
+    return true
+end
+
+local function encode_value(v)
+    local tv = type(v)
+    if tv == 'nil' then
+        return 'null'
+    elseif tv == 'boolean' then
+        return v and 'true' or 'false'
+    elseif tv == 'number' then
+        return tostring(v)
+    elseif tv == 'string' then
+        return escape_str(v)
+    elseif tv == 'table' then
+        if is_array(v) then
+            local parts = {}
+            for i = 1, #v do
+                parts[#parts+1] = encode_value(v[i])
+            end
+            return '[' .. table.concat(parts, ',') .. ']'
+        else
+            local parts = {}
+            for k, val in pairs(v) do
+                local key = escape_str(k)
+                parts[#parts+1] = key .. ':' .. encode_value(val)
+            end
+            return '{' .. table.concat(parts, ',') .. '}'
+        end
+    else
+        return 'null'
+    end
+end
+
+function AscensionExporter_Json_Encode(obj)
+    return encode_value(obj)
+end
@@ -0,0 +1,248 @@
+![Mage](/icons/classes/classicon_mage.png)
+
+This guide covers pre-raid best-in-slot gear, enchants, talents, mystic enchants, macros, and rotation to help you master this powerful spellcasting class.
+
+98% stolen from Author - Mikeyjackson (Minimike)- https://docs.google.com/document/d/e/2PACX-1vRlCRWmOhDHk8_iWEv71tw989BnT7WIjGLgE_T6MNu6SNRKNhItay_QLbJepH065mRPeiqCAj5EoYg0/pub
+
+
+
+> **Note:** Some items marked with `ITEMID` or `SPELLID` are custom Ascension items (Heroic Dungeon drops, Worldforged items, custom mystic enchants). These IDs will be updated when they become available in db.ascension.gg. All standard WoW Classic and ZG items have been linked.
+>
+{.is-info}
+> TODO: Work in progress
+>
+{.is-danger}
+
+
+## Pre-Raid Best-in-Slot Gear
+
+**Note:** Only included alternatives if they are really close in value. For crafted items, SP/INT is ideal but SP + anything or INT + anything is fine. With ZG out, worldforged items can be upgraded one more time.
+
+| Slot | Item | Location | Enchant | Alternative |
+|------|------|----------|---------|-------------|
+| **Head** | [The Hexxer's Cover](https://db.ascension.gg/?item=19886) | ZG - Jin'do the Hexxer | ZG Enchant - Shaman (+13 SP / 15 INT) | [Sylvan Crown of Prophecy](https://db.ascension.gg/?item=ITEMID) |
+| **Neck** | [Jeklik's Opaline Talisman](https://db.ascension.gg/?item=19923) | ZG - High Priestess Jeklik | - | [Necklace of the Sunken Empire](https://db.ascension.gg/?item=1379171) |
+| **Shoulders** | [Zandalar Illusionist's Mantle](https://db.ascension.gg/?item=19845) (Mage Set) | ZG - Multiple Bosses | Zandalar Signet (+18 SP) | [Ironweave Mantle](https://db.ascension.gg/?item=260562) (Heroic Dungeon) |
+| **Back** | [Hide of the Wild](https://db.ascension.gg/?item=1154794) | Crafted - Tailoring | Sustaining Cloak Lining (+6 SP / 6 STAM) | [Hide of the Wild of the Conjurer](https://db.ascension.gg/?item=ITEMID) |
+| **Chest** | [Bloodvine Vest](https://db.ascension.gg/?item=1156333) | Crafted - Tailoring | Flamescale Gambeson (+6 HASTE) | [Robe of the Archmage of the Arcane](https://db.ascension.gg/?item=ITEMID) |
+| **Wrist** | [Zandalar Illusionist's Wraps](https://db.ascension.gg/?item=19846) (Mage Set) | ZG - Multiple Bosses | Enchant Bracer - Healing Power (+15 SP) | [Crystalline Cuffs](https://db.ascension.gg/?item=14148) (Heroic Dungeon) |
+| **Mainhand** | [Bloodcaller](https://db.ascension.gg/?item=19864) | ZG - Hakkar | Arcane Artillery (+80 SP Proc) | - |
+| **Offhand** | [Jin'do's Bag of Whammies](https://db.ascension.gg/?item=319891) | ZG - Jin'do the Hexxer | - | [Tome of Knowledge](https://db.ascension.gg/?item=13385) |
+| **Wand** | [Cold Snap](https://db.ascension.gg/?item=19130) | Azuregos World Boss (BoE) | Reflex Scope (+6 HASTE) | [Touch of Chaos](https://db.ascension.gg/?item=19861) (Hakkar Drop) |
+| **Gloves** | [Combed Furline Handwraps](https://db.ascension.gg/?item=856011) | Timbermaw Hold Rep - Exalted | Enchant Glove - Minor Haste (+10 HASTE) | - |
+| **Belt** | [Belt of Untapped Power](https://db.ascension.gg/?item=222716) | ZG - Multiple Bosses | Magus Belt Buckle (+10 INT) | [Whipvine Cord](https://db.ascension.gg/?item=246873) |
+| **Legs** | [Bloodvine Leggings](https://db.ascension.gg/?item=1156336) | Crafted - Tailoring | ZG Enchant - Shaman (+13 SP / 15 INT) | - |
+| **Boots** | [Bloodvine Boots](https://db.ascension.gg/?item=1156339) | Crafted - Tailoring | Enchant Boots - Lesser Accuracy (+5 HIT) | [Dragonrider Boots](https://db.ascension.gg/?item=102373) (Heroic Dungeon) |
+| **Ring 1** | [Arcane Loop](https://db.ascension.gg/?item=1544934) | Ring Vendor (in ORG or SW, 600g) | - | - |
+| **Ring 2** | [Band of Servitude](https://db.ascension.gg/?item=19898) | ZG - Multiple Bosses | - | [Band of the Titans](https://db.ascension.gg/?item=1414517) |
+| **Trinket 1** | [Hazza'rah's Charm of Magic (Mage Set)](https://db.ascension.gg/?item=19897) | ZG - Summoned Bosses | - | [Rune Band of Wizardry](https://db.ascension.gg/?item=260814) (Heroic Dungeon) |
+| **Trinket 2** | [Zandalarian Hero Charm](https://db.ascension.gg/?item=219950) | ZG - Hakkar | - | [Burst of Knowledge](https://db.ascension.gg/?item=11832) (Heroic Dungeon)<br>[Draconic Infused Emblem](https://db.ascension.gg/?item=102339) (Heroic Dungeon) |
+
+## Enchants
+
+Enchants are listed in the gear table above. Key enchants include:
+
+### ZG Enchants
+
+The ZG enchants are incredibly important as they grant significant spell power and stats. Each enchant requires:
+- 1x Primal Hakkari Idol (drops from ZG bosses/trash)
+- 1x Voodoo Doll (looted from Hoodoo Pile nodes in ZG)
+  - Shaman: Blue Punctured Voodoo Doll (+13 SP / +15 INT)
+
+Turn in these items to Zanza the Restless in a cleared ZG. Check with Sub and the guild bank before purchasing from the AH.
+
+### Zandalar Shoulder Enchant
+
+The Zandalar Signet enchant (+18 SP) requires farming reputation with the Zandalar Tribe through ZG runs and turning in bijous and coins.
+
+## Talents
+
+The Arcane talent tree focuses on maximizing single-target burst damage with mana efficiency. Below is the recommended pre-raid build:
+
+<iframe src="/static/talents/?build=mage...02_13_25_63_93_b1_e3_f3_h1_j5_l3_m2_o3_p1_t2_u3_y3_113_122&embed=true" width="100%" height="840" style="border: 0px solid #333; border-radius: 8px;"></iframe>
+
+### Defensive/Utility Options
+
+Consider these based on encounter needs:
+- <img src="/icons/spells/spell_holy_dispelmagic.png" width="20" height="20" style="vertical-align: middle;" /> **Arcane Subtlety** (3/3) - 20% threat reduction, 12% reduced Arcane spell mana cost
+- <img src="/icons/spells/spell_arcane_arcaneresilience.png" width="20" height="20" style="vertical-align: middle;" /> **Arcane Fortitude** (3/3) - Increases armor by 150% of Intellect while Mana-forged Barrier is active
+- <img src="/icons/spells/spell_arcane_blink.png" width="20" height="20" style="vertical-align: middle;" /> **Improved Blink** (3/3) - Reduces Blink cooldown by 12 seconds, 20% damage reduction for 3 sec after Blink
+
+## Mystic Enchants
+
+### <span class="legendary">Artifact</span>
+{.legendary}
+
+**[Rune of Power](https://db.ascension.gg/?spell=116011)** - *"Place a rune of power on the ground for 1 minute. While standing in your rune, your mana regeneration is increased by 100% and your spell power is increased by 15%."*
+
+Best choice for single-target encounters. Stand still and maximize damage output.
+
+### <span class="legendary">Legendary</span>
+{.legendary}
+
+**[Barrage Overload](https://db.ascension.gg/?spell=SPELLID)** - *"Your Arcane Barrage has a chance to cast an additional Arcane Barrage at your target at 50% effectiveness."*
+
+Excellent for movement-heavy fights where Rune of Power is difficult to utilize effectively.
+
+**[Touch of the Magi](https://db.ascension.gg/?spell=210824)** - *"Your Arcane Blast has a chance to apply Touch of the Magi, which stores 25% of all damage dealt to the target and releases it as Arcane damage after 6 seconds."*
+
+Situational option that can be strong on longer encounters with burst windows.
+
+### <span class="epic">Epic Enchants</span>
+{.epic}
+
+**Essential:**
+- **[Esoteric Power](https://db.ascension.gg/?spell=SPELLID)** - "If you are consistently reaching 5 stacks of Arcane Blast, this enchant significantly boosts your damage output". This is your top priority epic enchant if you can maintain 5 stacks
+
+**Core:**
+- **[Arcane Surge](https://db.ascension.gg/?spell=SPELLID)** - "After casting 4 Arcane Blasts in a row, your next Arcane Missiles deals 30% increased damage". Synergizes perfectly with the rotation
+- **[Improved Arcane Missiles](https://db.ascension.gg/?spell=SPELLID)** - "Reduces the mana cost of Arcane Missiles by 20% and increases its damage by 10%". Essential for mana management
+
+**Recommended:**
+- **[Arcane Tempo](https://db.ascension.gg/?spell=SPELLID)** - "Your Arcane Blast increases your haste by 1% per stack, up to 4%". More haste means more casts
+- **[Mana Adept](https://db.ascension.gg/?spell=SPELLID)** - "Your spell damage is increased by up to 15% of your current mana percentage". Rewards intelligent mana management
+
+**Situational:**
+- **[Arcane Familiar](https://db.ascension.gg/?spell=205022)** - "Summon a familiar that periodically casts Arcane Blast at your target". Passive damage increase
+- **[Nether Tempest](https://db.ascension.gg/?spell=114923)** - "Places a periodic damage effect on the target that damages nearby enemies". Good for multi-target situations
+
+### <span class="rare">Rare Enchants</span>
+{.rare}
+
+**Essential:**
+- **[Glyph of Arcane Blast](https://db.ascension.gg/?spell=56360)** - "Increases damage done by Arcane Blast by 10%". Absolutely essential
+- **[Arcane Intellect](https://db.ascension.gg/?spell=1459)** - "Increases your total Intellect by 15%". Absolutely essential
+
+**Highly Recommended:**
+- **[Glyph of Arcane Missiles](https://db.ascension.gg/?spell=56363)** - "Increases the damage of Arcane Missiles by 15%". Core part of your rotation
+- **[Glyph of Mana Gem](https://db.ascension.gg/?spell=56383)** - "Increases the mana restored by your Mana Gem by 40%". Critical for mana management on longer fights
+- **[Glyph of Evocation](https://db.ascension.gg/?spell=56380)** - "Your Evocation ability also regenerates 15% of your health over its duration". Adds survivability
+
+**Situational:**
+- **[Glyph of Ice Block](https://db.ascension.gg/?spell=56372)** - "Your Frost Nova cooldown is reduced by 30%". Good for movement/kiting situations
+- **[Glyph of Arcane Power](https://db.ascension.gg/?spell=56357)** - "Increases the duration of Arcane Power by 3 seconds". Extends your burst window
+
+## Consumables
+
+Proper consumables are essential for maximizing your damage output:
+
+**Flasks:**
+- Flask of the Kirin Tor (preferred)
+- Flask of Pure Mojo (budget option)
+
+**Oils:**
+- Brilliant Wizard Oil
+
+**Potions:**
+- Major Mana Potion (use throughout fight)
+- Potion of Lesser Haste (pre-pot and during burn phases)
+- Dark Rune / Demonic Rune (emergency mana)
+
+**Food:**
+- Wizard Wontons (best buff food)
+
+**Scrolls:**
+- Scroll of Intellect
+
+**Elixirs (if not using flask):**
+- Greater Arcane Elixir
+- Elixir of Wisdom
+
+## Macros
+
+These macros help streamline your rotation and improve responsiveness:
+
+**Rune of Power at Feet:**
+```
+#showtooltip Rune of Power
+/cast [target=player] Rune of Power
+```
+
+**Arcane Blast with Target Switching:**
+```
+#showtooltip Arcane Blast
+/cast Arcane Blast
+```
+
+**Cooldown Macro (Icy Veins + Trinket + Arcane Power):**
+```
+#showtooltip Icy Veins
+/use [trinket slot 13 or 14]
+/cast Icy Veins
+/cast Arcane Power
+```
+
+**Emergency Mana:**
+```
+#showtooltip Major Mana Potion
+/use Major Mana Potion
+/use Dark Rune
+```
+
+## Rotation
+
+```kroki
+graphviz
+digraph G {
+  bgcolor="transparent";
+  rankdir=LR;
+  node [shape=box, style="rounded,filled", fillcolor="#1a1a1a", color="#cccccc", fontcolor="#ffffff", fontname="Arial", fontsize=11, margin=0.25, penwidth=1.5];
+  edge [color="#999999", penwidth=2, arrowsize=0.8];
+
+  PRE [label="Pre-pot\nHaste"];
+  PRECAST [label="Pre-cast\nArcane Blast"];
+  STACK [label="Stack\nArcane Blasts - 3 or 4"];
+  ROP [label="Rune of\nPower"];
+  CDS [label="Pop All\nCooldowns"];
+  BURN [label="Burn Phase\n(Max Stacks)"];
+  SUSTAIN [label="Sustain Phase\n(4-5 Stacks)"];
+  MISSILES [label="Arcane\nMissiles"];
+
+  PRE -> PRECAST -> STACK -> ROP -> CDS -> BURN -> SUSTAIN -> MISSILES -> SUSTAIN;
+}
+```
+
+### Rotation Breakdown
+
+**Pre-Pull:**
+1. Pre-pot Potion of Lesser Haste 2-3 seconds before pull
+2. Begin casting Arcane Blast to land as tank pulls
+
+**Opening Burst:**
+1. Cast Arcane Blast to 4 stacks
+2. Drop Rune of Power at your feet
+3. Pop all cooldowns (Icy Veins, Arcane Power, Trinkets)
+4. Continue casting Arcane Blast at max stacks while cooldowns are active
+
+**Sustain Phase:**
+1. Let Arcane Blast stacks drop to 4-5
+2. Cast 4-5 Arcane Blasts
+3. Cast Arcane Missiles to dump mana and maintain stacks
+4. Repeat this cycle
+
+**Mana Management:**
+- Goal is to end the fight nearly out of mana (OOM)
+- Use Evocation when you drop below 20-30% mana (fight dependent)
+- Use Mana Gem on cooldown during sustain phases
+- Don't be afraid to use Dark Runes and Major Mana Potions
+- Adjust your burn/sustain ratio based on fight length
+
+**Movement:**
+- If using Rune of Power, minimize movement and plan positioning carefully
+- If using Barrage Overload, movement is less punishing
+- Use Arcane Barrage while moving if necessary
+- Never stop casting if you can avoid it
+
+## Stat Weights (Pre-Raid)
+
+Priority for stat weights:
+
+1. **Spell Power:** 1.0 (scales all damage)
+2. **Haste:** 0.9 (more casts = more damage)
+3. **Spell Penetration:** 0.8 (crucial for PvE)
+4. **Hit:** 0.75 (cap at 16% for raid bosses)
+5. **Intellect:** 0.65 (mana pool and spell crit)
+6. **Spell Crit:** 0.5 (valuable but not as strong as above)
+
+**Note:** Spell Hit is crucial. Aim for the 16% hit cap through gear and talents. After hit cap, prioritize Spell Power > Haste > Spell Penetration.
+