--------------------------------------------------
SIMPLELUATWEAKER
--------------------------------------------------
SimpleLuaTweaker is a lightweight, Blizzard-friendly addon that improves
World of Warcraft's default Lua error window without replacing it.
The goal is simple:
- Make the error window more usable.
- Keep the default Blizzard UI intact.
- Avoid fragile hooks or invasive modifications.
- Minimize the risk of breakage across patches.
If Blizzard didn't already do it this way, this addon does it *carefully*.
--------------------------------------------------
FEATURES
--------------------------------------------------
• Resizable Lua error window
- Adds a small external resize tab instead of modifying the frame itself.
• Adjustable font size
- Fine-grained slider.
- Updates live while the error window is open.
- Includes a reset button to restore the default font size.
• Combat-safe error handling
- Optionally suppresses Lua errors during combat.
- Errors reappear automatically once combat ends.
- Optional one-time chat notice per combat (no spam).
- If /slt lua is used in combat, the window opens once combat ends.
• Complete error suppression (optional)
- Suppress all Lua error popups entirely.
- Errors still occur in the background.
- Optional one-time chat notice per session.
- While enabled, combat-only suppression is disabled and inactive.
- Enabling this option also enables the unread notification system,
so hidden background errors are not forgotten completely.
• Unread Lua error notification system
- Adds a small horn notification tab to the Lua error window.
- Grey horn means there are no unread Lua errors.
- Red horn means new unread Lua errors are available.
- The horn tooltip shows the current unread Lua error count.
- Repeat counts of the same acknowledged error do not trigger new alerts.
- Mark current Lua errors as read with a simple Yes/No popup.
- Lua errors can be marked as read automatically when viewed.
- Previous/Next navigation can mark viewed Lua errors as read.
- Optional reminder messages can warn you about unread Lua errors.
- Reminder interval is configurable from 1 to 30 minutes.
- Includes a reset button to restore the default reminder interval.
• Bottom unread status bar
- Adds a small Blizzard-style status bar to the bottom of the Lua error
window.
- Shows the current unread Lua error count while viewing errors.
- Updates together with the horn notification system.
• Blizzard "many errors" popup management
- Helps manage Blizzard's "AddOns are experiencing a large number of
errors" warning popup.
- Adds SLT-managed top and bottom bars to the popup.
- Lets you move the popup by dragging SLT's top bar.
- Remembers the popup position.
- Includes an option to reset the popup position.
- Adds a "Remind me in 30 minutes" button.
- During the 30-minute reminder window, SLT keeps the popup and repeated
warning sound quiet while still printing reminder messages in chat.
- Chat reminder messages are printed every 5 minutes while postponed.
- If the popup is left open, SLT can automatically postpone it after
5 minutes.
- Pressing ESC on the managed popup gives one emergency 10-minute
postpone per UI session/reload.
• Disable AddOns protection
- Adds an SLT confirmation before Blizzard's "Disable AddOns" button can
disable all addons and reload the UI.
- Pressing Yes still allows Blizzard's disable-all behavior to happen.
- Pressing No cancels safely.
- If the SLT confirmation is left open, it automatically cancels after
1 minute.
- This protection is focused only on Blizzard's many-errors popup.
• Focused Blizzard-popup handling
- SLT only manages Blizzard's large-error warning popup.
- Other Blizzard confirmation popups are left alone.
- Item upgrades, limited-resource purchases, item deletion confirmations,
and other important Blizzard popups should continue to behave normally.
• Timestamp-aware chat messages
- SLT chat messages follow your Blizzard chat timestamp setting.
- If timestamps are disabled, SLT prints normally.
- Warning messages use red text.
- Informational messages use normal white text.
• Persistent window state
- Remember size (optional).
- Remember position (optional).
- Uses Blizzard's true default size when disabled.
• Easy way to close Lua errors
- ESC will now close the normal Lua error window.
• Quick access settings
- Cogwheel tab directly on the Lua error window.
- Toggle settings open/close with a single click.
• Organized options
- Options are grouped into clear sections:
Suppression, Large-error management, Notifications, and Other settings.
- Large-error management has separate controls for:
"Disable AddOns" protection and large-error popup protection.
- Reset buttons are protected by confirmation popups where appropriate.
• Simple-AddOns Discord link
- The About tab includes a clickable Discord link.
- Opens a small popup with a copyable invite URL.
• Slash commands
/slt - Shows this list of commands.
/slt help - Same as /slt.
/slt lua - Opens the Lua error window.
/slt error - Same as /slt lua.
/slt options - Opens the options-window.
/slt settings - Same as /slt options.
/slt reset - Resets the position of the options-window.
--------------------------------------------------
DESIGN PHILOSOPHY
--------------------------------------------------
SimpleLuaTweaker is intentionally conservative.
• No frame replacements.
• No heavy rewrites.
• No insecure hooks.
• No combat-taint risks.
• No visual restyling of Blizzard frames.
All additions (resize tab, settings cog, notification horn, status bar,
and large-error popup controls) are external and layered on top of the
default UI in a reversible, non-invasive way.
The large-error popup management is deliberately narrow:
- It targets Blizzard's "many errors" warning popup.
- It does not globally replace Blizzard popup handling.
- It does not try to disable culprit addons.
- It does not depend on BugSack, BugGrabber, or any other addon.
- It avoids interfering with unrelated protected Blizzard actions.
This approach dramatically reduces the chance of:
- Patch breakage.
- UI taint.
- Combat lockdown issues.
- Conflicts with other addons.
--------------------------------------------------
COMPATIBILITY
--------------------------------------------------
• Built using modern Blizzard APIs.
• Designed with Midnight (12.0) restrictions in mind.
• Compatible with other error-handling addons
(BugSack, Swatter, etc.).
SimpleLuaTweaker does not require BugSack, BugGrabber, or any other
third-party addon.
If Blizzard changes the Lua error system, this addon is designed
to fail gracefully rather than catastrophically.
--------------------------------------------------
WHY THIS ADDON EXISTS
--------------------------------------------------
Because:
- Lua errors shouldn't break immersion mid-combat.
- Copying error text shouldn't be painful.
- Important hidden errors should not be easy to miss.
- Repeated error-warning popups should not cover boss mechanics forever.
- Accidentally disabling every addon should require confirmation.
- The default UI is good — it just needs a few careful tweaks.
SimpleLuaTweaker stays out of Blizzard's way and fixes only what's necessary.
--------------------------------------------------
INSTALLATION
--------------------------------------------------
1. Extract the SimpleLuaTweaker folder into:
World of Warcraft/_retail_/Interface/AddOns/
2. Enable the addon in the character selection screen.
That's it.
--------------------------------------------------
SUPPORT / FEEDBACK
--------------------------------------------------
If you encounter issues or have suggestions:
- Report them on the addon's CurseForge page.
- Join the Simple-AddOns Discord from the About tab.
- Include the WoW version and a brief description.
Minimal addons deserve minimal bugs.
--------------------------------------------------
THANK YOU
--------------------------------------------------
Thanks for using SimpleLuaTweaker.
Sometimes the best addon is the one you barely notice.
--------------------------------------------------
Author
--------------------------------------------------
Created and maintained by:
Zaryx-Aszune (EU)
