Update README.md

MiniMage_TWOW.lua

@@ -1,3 +1,5 @@
+local MM_Initialized = false
+
 --
 -- Global variable for storage of settings/options
 --
@@ -16,6 +18,8 @@ function class_OnLoad()
 end
 
 function MM_Initialize()
+    if MM_Initialized then return end
+    MM_Initialized = true
     MM_fac = UnitFactionGroup('player');
     M_class = UnitClass("player");
     if (M_class == "Mage") then
@@ -34,6 +38,9 @@ function MM_Button_Initialize()
         if (MiniMageOptions.MMButtonPosition == nil) then
             MiniMageOptions.MMButtonPosition = 0;
         end
+        if (MiniMageOptions.HidePortals == nil) then
+            MiniMageOptions.HidePortals = false;
+        end
     end
 end
 
@@ -53,9 +60,8 @@ end
 
 --
 -- Minimap button drag/drop functions
---
-
 -- Thanks to Atlas for the button dragging code
+--
 
 function MM_Button_BeingDragged()
     local xpos,ypos = GetCursorPosition();
@@ -95,6 +101,18 @@ function MM_Button_UpdatePosition()
     );
 end
 
+--
+-- ADDED: REQUIRED LEVEL CHECKS
+--
+
+function MM_CanCastTeleport()
+    return UnitLevel("player") >= 20;
+end
+
+function MM_CanCastPortal()
+    return UnitLevel("player") >= 40;
+end
+
 --
 -- Drop down menu functions
 --
@@ -111,6 +129,11 @@ function MM_DropDown_InitButtons()
     info.isTitle = 1;
     info.justifyH = "CENTER";
     info.notCheckable = 1;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Click to cast"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
     local fact = UnitFactionGroup('player');
@@ -124,121 +147,438 @@ end
 function MM_DropDown_ForTheHorde()
     local appender = ': ';
 
+    if not MiniMageOptions.HidePortals then
         local info = { };
         info.text = MINIMAGE_LABEL_PORTAL;
         info.isTitle = 1;
         info.notCheckable = 1;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal spells"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- ORG PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_ORG;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_ORG); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_ORG);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Orgrimmar"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- STONARD PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_STONARD;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_STONARD); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_STONARD);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Stonard"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- TB PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_TB;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_TB); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_TB);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Thunder Bluff"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- UC PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_UC;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_UC); end;
-	UIDropDownMenu_AddButton(info);
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_UC);
+            end
+        end;
 
-	info = { };
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Undercity"
+        info.tooltipOnButton = true
+
+        UIDropDownMenu_AddButton(info);
+    end
+
+    -- TELEPORT SECTION
+    local info = { };
     info.text = MINIMAGE_LABEL_TELEPORT;
     info.isTitle = 1;
     info.notCheckable = 1;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport spells"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- ORG TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_ORG;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_ORG); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_ORG);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Orgrimmar"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- STONARD TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_STONARD;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_STONARD); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_STONARD);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Stonard"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- TB TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_TB;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_TB); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_TB);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Thunder Bluff"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- UC TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_UC;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_UC); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_UC);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Undercity"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 end
 
 function MM_DropDown_ForTheAlliance()
     local appender = ': ';
 
+    if not MiniMageOptions.HidePortals then
         local info = { };
         info.text = MINIMAGE_LABEL_PORTAL;
         info.isTitle = 1;
         info.notCheckable = 1;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal spells"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- ALAH PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_ALAH;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_ALAH); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_ALAH);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Aerie Peak"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- DARNASSUS PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_DARNASSUS;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_DARNASSUS); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_DARNASSUS);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Darnassus"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- IF PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_IF;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_IF); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_IF);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Ironforge"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- SW PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_SW;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_SW); end;
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_SW);
+            end
+        end;
+
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Stormwind"
+        info.tooltipOnButton = true
+
         UIDropDownMenu_AddButton(info);
 
+        -- THERAMORE PORTAL
         info = { };
         info.text = MINIMAGE_LABEL_THERAMORE;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_THERAMORE); end;
-	UIDropDownMenu_AddButton(info);
+        info.disabled = not MM_CanCastPortal();
+        info.func = function(msg)
+            if MM_CanCastPortal() then
+                MM_TryCast(MINIMAGE_LABEL_PORTAL..appender..MINIMAGE_LABEL_THERAMORE);
+            end
+        end;
 
-	info = { };
+        info.tooltipTitle = info.text
+        info.tooltipText = "Portal to Theramore"
+        info.tooltipOnButton = true
+
+        UIDropDownMenu_AddButton(info);
+    end
+
+    -- TELEPORT TITLE
+    local info = { };
     info.text = MINIMAGE_LABEL_TELEPORT;
     info.isTitle = 1;
     info.notCheckable = 1;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport spells"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- ALAH TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_ALAH;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_ALAH); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_ALAH);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Aerie Peak"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- DARN TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_DARNASSUS;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_DARNASSUS); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_DARNASSUS);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Darnassus"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- IF TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_IF;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_IF); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_IF);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Ironforge"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- SW TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_SW;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_SW); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_SW);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Stormwind"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 
+    -- THERAMORE TELEPORT
     info = { };
     info.text = MINIMAGE_LABEL_THERAMORE;
-	info.func = function(msg) CastSpellByName(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_THERAMORE); end;
+    info.disabled = not MM_CanCastTeleport();
+    info.func = function(msg)
+        if MM_CanCastTeleport() then
+            MM_TryCast(MINIMAGE_LABEL_TELEPORT..appender..MINIMAGE_LABEL_THERAMORE);
+        end
+    end;
+
+    info.tooltipTitle = info.text
+    info.tooltipText = "Teleport to Theramore"
+    info.tooltipOnButton = true
+
     UIDropDownMenu_AddButton(info);
 end
+
+--
+-- Slash Commands
+--
+
+SLASH_MINIMAGE1 = "/mmage"
+
+SlashCmdList["MINIMAGE"] = function(msg)
+    msg = string.lower(msg or "")
+
+    if msg == "reset" then
+        MiniMageOptions = {}
+        DEFAULT_CHAT_FRAME:AddMessage("|cffffff00MiniMage: options reset.|r")
+
+    elseif msg == "icon" then
+        if MM_ButtonFrame:IsShown() then
+            MM_ButtonFrame:Hide()
+            DEFAULT_CHAT_FRAME:AddMessage("|cffffff00MiniMage: minimap button hidden.|r")
+        else
+            MM_ButtonFrame:Show()
+            DEFAULT_CHAT_FRAME:AddMessage("|cffffff00MiniMage: minimap button shown.|r")
+        end
+
+    elseif msg == "portals" then
+        MiniMageOptions.HidePortals = not MiniMageOptions.HidePortals
+
+        if MiniMageOptions.HidePortals then
+            DEFAULT_CHAT_FRAME:AddMessage("|cffffff00MiniMage: Portal hidden.|r")
+        else
+            DEFAULT_CHAT_FRAME:AddMessage("|cffffff00MiniMage: Portal shown.|r")
+        end
+
+    elseif msg == "help" or msg == "" then
+        DEFAULT_CHAT_FRAME:AddMessage("|cffffff00MiniMage commands:|r")
+        DEFAULT_CHAT_FRAME:AddMessage("/mmage help        - Show this help")
+        DEFAULT_CHAT_FRAME:AddMessage("/mmage icon        - Show/Hide minimap button")
+        DEFAULT_CHAT_FRAME:AddMessage("/mmage reset       - Reset addon saved options")
+        DEFAULT_CHAT_FRAME:AddMessage("/mmage portals     - Show/Hide portal in dropdown")
+
+    else
+        DEFAULT_CHAT_FRAME:AddMessage("|cffff0000MiniMage: unknown command.|r")
+        DEFAULT_CHAT_FRAME:AddMessage("Type /mmage help for options.")
+    end
+end
+
+-- ===== ADDED: Minimal cast tracking + wrapper + error listener + spell check =====
+
+-- Track last attempted spell cast
+local MM_LastAttemptedSpell = nil
+local MM_LastAttemptTime = 0
+
+-- Check if player knows the spell
+function MM_HasSpell(spellName)
+    for i=1, GetNumSpellTabs() do
+        local _, _, offset, numSpells = GetSpellTabInfo(i)
+        for j=1, numSpells do
+            local name = GetSpellName(j + offset, BOOKTYPE_SPELL)
+            if name == spellName then
+                return true
+            end
+        end
+    end
+    return false
+end
+
+-- Wrapper to track attempts and check if learned
+function MM_TryCast(spellName)
+    if not MM_HasSpell(spellName) then
+        DEFAULT_CHAT_FRAME:AddMessage("|cffff0000You Have Not Learned " .. spellName .. ".|r")
+        return
+    end
+    MM_LastAttemptedSpell = spellName
+    MM_LastAttemptTime = GetTime()
+    CastSpellByName(spellName)
+end
+
+-- Event frame to listen for UI error messages and show custom text
+local MM_EventFrame = CreateFrame("Frame")
+MM_EventFrame:RegisterEvent("UI_ERROR_MESSAGE")
+
+MM_EventFrame:SetScript("OnEvent", function(self, event, message)
+    local now = GetTime()
+
+    -- Only react if the error happens within 1 second of our own click
+    if MM_LastAttemptedSpell and (now - MM_LastAttemptTime) < 1.0 then
+        -- Any standard "failed" message triggers custom output
+        if message then
+            DEFAULT_CHAT_FRAME:AddMessage("|cffff0000You Have Not Learned " .. MM_LastAttemptedSpell .. ".|r")
+        end
+        MM_LastAttemptedSpell = nil
+        MM_LastAttemptTime = 0
+    end
+end)

MiniMage_TWOW.toc

@@ -1,7 +1,8 @@
 ## Interface: 11200
 ## Title: MiniMage_TWOW
-## Version: 1.0
+## Version: 1.2
 ## Notes: Forked version of MiniMage 1.2b. No original GitHub Repo found, only found in Wow1.12.1_Addons_Collection
 ## SavedVariables: MiniMageOptions
-MiniMage_TWOW.xml
 localization.lua
+MiniMage_TWOW.lua
+MiniMage_TWOW.xml

MiniMage_TWOW.xml

@@ -1,6 +1,6 @@
 <Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/ C:\Projects\WoW\Bin\Interface\FrameXML\UI.xsd">
-	<Script file="MiniMage_TWOW.lua"/>
 		<Script file="localization.lua"/>
+		<Script file="MiniMage_TWOW.lua"/>
 	
 	<!-- Empty core frame used for initialization and such -->
 	

README.md

@@ -7,7 +7,7 @@ MiniMage_TWOW is a lightweight World of Warcraft addon designed for Mages, provi
 * I do not take credit for creating this addon, only modifying it to include TurtleWoW specific features
 
 
-
+# Version 1.3
 ## TurtleWoW Specific Features
  * Includes Alah'Thalas and Theramore for Alliance characters.
  * Includes Stonard for Horde characters.
@@ -17,6 +17,12 @@ MiniMage_TWOW is a lightweight World of Warcraft addon designed for Mages, provi
 * **Minimap Button**: Drag and position a minimap button for easy access.
 * **Dropdown Menu**: Quick-cast portals and teleports, organized by faction.
 * **Faction Support**: Automatically shows relevant portal and teleport spells for Horde or Alliance Mages.
+* "Haven't Learned Spell" Message when trying to cast a Teleport/Portal you don't have trained.
+  
+* **Show/Hide Based on Level**: 
+* Portals Section Greyed out Until Level 40
+* Specific Portals/Teleports Greyed out until required level is reached
+
 
 
 ## Installation
@@ -31,13 +37,18 @@ The launcher will automatically download and install the addon and keep it updat
 ### Manual Install
 
 1. Download the repository into your `Interface/AddOns/` folder.
-2. Ensure the folder structure is `MiniMage_TWOW/MiniMage.lua`.
+2. Ensure the folder structure is `MiniMage_TWOW/MiniMage_TWOW.lua`.
 3. Reload the UI or restart WoW.
 
-## Usage
+## Usage & Options
 
 * Click the minimap button to open the dropdown menu.
 * Select the desired portal or teleport.
+### /mmage Commands
+* /mmage help  -  Show Commands
+* /mmage icon  -  Show/Hide Minimap Icon
+* /mmage portals  -  Show/Hide Portals from Menu
+* /mmage reset  -  Reset Addon Settings
 
 ## Contributing
 
@@ -45,5 +56,4 @@ Let me know if you have any issues, I'll fix it if I am able to.
 
 ## Screenshots
 
-![MiniMage_TWOWa](https://github.com/user-attachments/assets/ed95ae31-580e-49ae-b469-eca9d63a2328)
-
+<img width="800" height="600" alt="ss1" src="https://github.com/user-attachments/assets/e1344159-2bd9-43a1-8edb-9b16e123d022" />

localization.lua

@@ -1,6 +1,6 @@
 
 --the only place MINIMAGE_VERSION should be set
-MINIMAGE_VERSION = "1.0";
+MINIMAGE_VERSION = "1.2";
 
 
 --[[