HushUI

Hush — A clean, distraction-free UI overhaul for World of Warcraft focused on removing noise, hiding clutter, and keeping your attention on gameplay.

Open the settings panel in-game with: /hush or /hui

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ABOUT THE AUTHOR
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Hush was developed as a personal tool — a UI built to my own specifications and workflow, with no original intention of public distribution. It is being shared at the request of others who expressed interest in using it, and is made available as-is in its current alpha state.

This addon operates under a clear and deliberate design philosophy: minimal intervention on the base Blizzard UI. The objective is to reduce visual noise, suppress unnecessary interface elements, and lightly reshape the default UI — not to replace it. Feature scope is intentionally narrow. The absence of extensive customization options is not an oversight; it is a design decision.

Hush is engineered to remain resilient across WoW patch cycles. Rather than rebuilding or replacing core Blizzard systems — an approach that guarantees breakage on every major update — Hush works with Blizzard's existing frame infrastructure, leveraging native APIs wherever possible. This keeps the addon lightweight, taint-safe, and maintainable without requiring significant remediation after each patch.

Hush is not designed for everyone. Users seeking deep UI customization, extensive theming controls will find the scope deliberately insufficient. A lightweight per-character profile system is included — named profiles can be created and assigned per character from within the settings panel.

Feature requests are welcome and considered, provided they align with the core design philosophy. Requests that introduce significant complexity, heavy frame manipulation, or diverge from the minimalist intent are unlikely to be incorporated.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PROFILES & SHARING
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Named profiles let each character use independent settings. All profiles are stored account-wide — any character can access any profile. Switching profiles applies instantly and persists across sessions.

• Save / Create — Save your current settings under any name
• Switch — Click a profile in the list to activate it on the current character
• Rename / Delete — Manage existing profiles with inline confirmation

Settings Sharing:
• Export — Copy your full settings to a string to share with others
• Import — Paste a received string and click Apply to load it
• Author Settings — The author's personal settings export is provided as a ready-to-use starting point
• Edit Mode Layout — The author's Edit Mode frame positions, ready to paste directly into WoW's Edit Mode import dialog

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INTERFACE TWEAKS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Square Minimap — Replaces the round minimap with a clean square shape
• Hide Talking Head — Suppresses the NPC talking head popup that interrupts your view
• Hide UI Errors — Removes "Not enough mana" and similar error spam from your screen
• Hide Chat Buttons — Cleans up the extra buttons cluttering the chat frame
• Large Tooltip Text — Bumps tooltip text to 18pt for easier reading
• Skip Cinematics — Automatically skips in-game cinematics and movies
• Hide Talent Alerts — Suppresses the unspent talent point glow on the micro menu
• Show Spell / Item IDs — Appends Spell ID or Item ID to the bottom of tooltips
• Class Color Accent — Colors the Hush panel accents using your class color

Chat:
• Chat Timestamps — Adds a dim 12-hour timestamp to every chat message
• Chat Arrow Keys — Use Up/Down arrows in the chat box to navigate history (no Alt required)
• Hide Learn/Unlearn Messages — Filters "You have learned..." and skill-up messages from chat
• Hide Combat Log Tab — Makes the Combat Log tab invisible and unclickable

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ZONE & MAP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Hide Zone Text — Suppresses the large zone name popup when entering a new area
• Hide Difficulty Icon — Hides the instance difficulty badge on the minimap
• Difficulty Text Mode — Replaces the difficulty icon with a compact text label (e.g. M+15, H, N20)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GAMEPLAY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Cast on Key Down — Trigger spells on key press rather than release for lower perceived latency
• FCT: Damage — Toggle floating combat text for outgoing damage
• FCT: Healing — Toggle floating combat text for outgoing healing

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PARTY & RAID FRAMES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Hide Party/Raid Names — Removes name labels from compact party and raid frames
• Tank/Healer Icons Only — Hides DPS role icons, keeping only tank and healer indicators
• Show Raid Frames While Solo — Keeps the compact party frame visible when playing alone

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AUTOMATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Fast Loot — Auto-loots all items the moment a loot window opens
• Auto Sell & Repair — Automatically sells grey junk and repairs gear at any vendor
• Show Repair Cost in Chat — Prints your repair bill to chat each visit
• Show Sell Profit in Chat — Prints total junk gold earned each vendor visit
• Auto Quest & Gossip — Auto-accepts and auto-turns-in quests (skips multi-reward quests)
• Auto Sort Bags — Sorts your bags automatically whenever they are opened
• Auto Insert Keystone — Inserts your Mythic+ keystone when you interact with the dungeon font
• Easy Item Destroy — Skip typing "DELETE" when destroying an item
• Auto-Open Containers — Automatically uses box, crate, and satchel items found in your bags
• Auto-Unwrap Collectibles — Automatically uses bag items that teach mounts, pets, or toys you don't already own
• Auto Battle Rez — Automatically accepts battle resurrections from party or raid members while in combat
• Extended Merchant — Expands vendor windows to show up to 20 items per page instead of the default 10
• Dim Collected Battle Pets — Desaturates and dims battle pet items at vendors that you already own

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ACTION BARS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

All action bar settings live in one dedicated page.

Labels:
• Hide Hotkey Text — Hide the keybind labels on action bar buttons
• Hide Stack Text — Hide charge and stack counts on action bar buttons
• Hide Macro Text — Hide macro name labels at the bottom of buttons
• Hide Action Cues — Remove Blizzard's Assisted Combat arrow overlays
• Hide Extra Action Art — Remove the decorative artwork rings around Extra Action and Zone Ability buttons
• Short Hotkey Text — Abbreviate keybind labels (e.g. SHIFT- → S-, CTRL- → C-)

Label Sizes (apply even without Font Override enabled):
• Hotkey Font Size — 6–20pt
• Stack / Charge Size — 6–20pt
• Macro Name Size — 6–20pt

Button Spacing:
• Button Padding — Pixel gap between buttons (-6 to +20px)

Icon Shapes — Clip button icons into custom shapes per bar:
  None | Circle | Rounded Square | Diamond | Hexagon | Oval | Shield | Square
  Applies to: Main Bar, Bottom Left, Bottom Right, Right Bar, Left Bar, Extra Bars 5 / 6 / 7

Visibility — Per-bar show/hide mode (Always | Combat | No Combat | Fade | Never):
  Main Bar, Bottom Left, Bottom Right, Right Bar, Left Bar, Stance Bar

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VISIBILITY CONTROL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Every element below supports five modes: Always | Combat Only | Out of Combat | Fade (mouseover) | Never

UI Elements:
• Chat Tabs
• Buff / Debuff frames
• Micro Menu
• Bags Bar
• Objective Tracker
• Unit Frames
• Boss Frames
• Raid Tools
• Pet Action Bar
• XP / Status Bars

Minimap:
• Zone Text, Calendar, Time, Tracking button
• Hide Micro Menu Alerts — Suppresses the orange badge and flash notifications on Micro Menu buttons
• Landing Page Right-Click Menu — Adds a right-click context menu to the expansion minimap button to access older content (Garrison, Order Hall, etc.)

Objective Tracker:
• Collapsible Tracker — Add a collapse/expand toggle to the objective tracker
• Collapse Style — Choose between a free-floating button or the tracker's own header
• Button Visibility — Control when the collapse button appears (Always/Combat/No Combat/Fade)

Dungeon Finder Eye:
• Detach from MicroMenu — Drag the queue status eye anywhere on screen; position is saved across sessions
• Eye Visibility — Independent alpha/fade control for the eye while queued or inside an instance, separate from the MicroMenu visibility setting
  The eye only appears when Blizzard shows it (while queued or inside an instance/raid/delve)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMBAT BEHAVIOR
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Auto-Hide Boss Banner — Instantly dismisses the boss kill banner at the top of the screen
• Auto-Dismount (Ground) — Automatically dismounts when using spells or abilities while mounted
• Auto-Dismount (Flying) — Automatically dismounts from flying mounts when using abilities
• Block Duel Requests — Automatically declines all incoming PvP duel requests
• Block Pet Battle Requests — Automatically declines all incoming PvP pet battle requests

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ALERTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

On-screen badge warnings for critical situations. The alert container is draggable.

• Low Health Warning — Pulses a red vignette border when your HP drops below a configurable threshold (5–75%)
• Pet on Passive — Badge warning when your pet is set to Passive stance (Hunter / Warlock / DK)
• Pet Not Summoned — Badge warning when you have no active pet (Hunter / Warlock / DK)
• Missing Healthstone — Badge warning when you have no Healthstone in your bags (Warlock only)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DARK UI THEME
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Recolors Blizzard's default UI to a dark theme using the game's own color API. Toggle per-category independently:

• Action Bars • Chat Frame • Bags • Minimap • Player Frame • Target Frame
• Tooltips • Nameplates • Objective Tracker • Damage Meter • Spellbook & Talents
• Character Frame • Quest & NPC Dialogs • Friends Frame • Professions & Trade
• Group Finder (LFG) • Journals & Collections • Guild & Communities • PvP / Honor
• World Map • Auction House • Mail • Bank • Calendar
• Barbershop, Trade Window & Dressing Room

Also brightens quest text and spellbook text for improved readability when the dark theme is active.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
NAMEPLATES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Always Show Enemy Names — Display enemy names on all nameplates without needing to hover
• Center Enemy Name Text — Center-justify nameplate name text instead of left-align
• Threat-Based Health Bar Colors — Colors enemy health bars green/yellow/orange/red by your threat level (inverted for tanks)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CURSOR EFFECTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Cursor Trail — A fading dot trail that follows your mouse cursor
• GCD Ring — A class-colored ring at your cursor that tracks the Global Cooldown
• Cast Ring — A class-colored ring that appears while casting or channeling a spell
• Spell Icon — Optionally display the spell's icon at the center of the cast ring

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DATATEXT PANEL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

A slim info bar at the bottom of your screen. Fully drag-to-reposition and drag-to-reorder.

• Loot Spec — Left-click to change loot spec, right-click to change active specialization
• Durability — Average gear durability percentage
• Gold — Current gold on your character
• Time — Local clock
• Volume — Master volume; scroll to adjust, left-click to mute/unmute
• FPS / MS — Live framerate and latency with addon memory breakdown on hover
• Hush — Left-click to open/close the settings panel; right-click to reload UI

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FONTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

•  Font Override — Replace WoW's default font with one of 15 bundled fonts (Expressway, Poppins, Fira Sans, Ubuntu, Barlow Condensed, Russo One, and more)
• UI Element Size — Font size for cast bar text, nameplate names, and DataText panel cells
• Tooltip Text Size — Independent font size for GameTooltip text

Action bar label sizes (hotkey, stack/charge, macro) are configured separately on the Action Bars page and apply regardless of whether Font Override is enabled.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AFK SCREEN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

A full-screen overlay shown while AFK — keeps your session active and your screen looking sharp.

• 3D character model with optional slow rotation
• Faction icon, local clock, and current zone
• Live scrolling log of chat messages received while away
• Camera Rotation — Spins the world camera independently of the model
• AFK Emote — Set a looping emote: None, Dance, Sit, Sleep, Kneel, Bow
• Rotation Speed — 1 (slow) to 10 (fast)
• Screen Dimming — 40% (semi-transparent) to 97% (near solid black)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FISHING HELPER
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Cast and Interact keybind — Bind one key to cast fishing and interact with the bobber
• Double-Click Cast — Right double-click to cast or interact with the bobber
• Recast on Double-Click — Automatically recast when double-clicking
• Enhance Sounds While Fishing — Mutes music/ambience and boosts SFX so you hear the splash
• Override Lunker Buff — Cast while the "Looking for Lunkers" channel is active
• Disable Bobber Icon — Hides the soft-target icon above the bobber
• Hide Cast Bar Icon — Hides the fishing spell icon on the cast bar while bobbing

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FRAME MOVER
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Hold a modifier key (Shift, Ctrl, or Alt — your choice) and drag any major Blizzard frame to reposition it. Panel-type frames also receive a teal resize grip in the bottom-right corner. Positions and sizes are saved and restored every session, including across zone transitions.

Supported frames include: Player/Target/Focus frames, Minimap, Objective Tracker, Boss frames, all action bars, and all major panels (Character, Spellbook, Talents, Quest Log, Friends, Guild, Auction House, Bank, Merchant, Mail, Trade, LFG, Encounter Journal, Collections, Achievements, World Map, Bags, and more).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TELEPORT PANEL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

A dedicated tab inside the World Map quest panel listing every teleport available to your character — hearthstones, class teleports, racial abilities, engineering gadgets, toys, and teleport items — organized by category.

• Greys out teleports you don't own or haven't learned
• Cooldown overlays show remaining cooldown on each entry
• Shift+right-click any entry to toggle it as a favorite
• "Hide Missing Items" option to show only what you currently have
• Left-click to use; works with spells, toys, and items

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SOUND MUTING
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Mute individual in-game sounds without affecting anything else. Changes take effect immediately — no reload needed. Mute All / Unmute All buttons are available for quick toggling. Sounds are organized by category.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
QUALITY OF LIFE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Train All Button — Adds a "Train All" button next to Train in the Class Trainer window
• Disable Tutorials — Sets the showTutorials CVar to 0, disabling Blizzard tutorial popups
• /editmode (/em, /edit) — Slash command to toggle the Edit Mode UI panel
• /cdm — Slash command to open the Cooldown Viewer frame

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MISCELLANEOUS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Item Level Overlays — Shows item level on equipped gear in the Character panel and in your bags
• /hush — Opens the settings panel from anywhere
• /rl — Shortcut alias for ReloadUI
• Settings Search — Search bar in the settings panel to find any option instantly
• Resizable Panel — Drag the settings panel corner to resize; size is saved per character
• FStack Button — Toggle Frame Stack from the options panel title bar for quick frame debugging
• Reload UI Button — One-click UI reload from the options panel title bar

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DISCLAIMER & CREDITS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Hush was built by drawing inspiration and referencing code patterns from several
existing community addons. Credit and thanks to the authors of:

• AzortharionUI — UI layout and action bar structure reference
• DarkMode — Dark skin recoloring approach and frame targeting
• EllesmereUI — Action bar architecture and button management patterns
• MinimalDark — Minimalist styling and dark theme inspiration
• QUI — QoL feature patterns including talent alert suppression, micro menu tweaks, and datatext design
• BetterFishing — Fishing helper features including cast-and-interact keybind and sound enhancements
• EnhanceQoL — Teleport panel data structure and sound muting patterns, QOL functions
• rnxmUI — Nameplate and unit frame glass texture artwork (hpglass0, 9slice2)

This addon was developed with the assistance of Warp (warp.dev), an AI-powered
agentic development environment. Code architecture, feature implementation, and
bug fixes were produced collaboratively between the author and Warp's AI agent.