Skip to content

Xurkon/MinimapButtonFrame

Repository files navigation

๐Ÿ”˜ Minimap Button Frame

Documentation

WoW 3.3.5a Version 3.2.1 Project Ascension Total Downloads Latest Release

Patreon PayPal

Collects minimap addon buttons and organizes them into a movable, customizable frame


Localization

โœจ Features

๐Ÿ“ฆ Button Collection

  • Automatically gathers minimap buttons
  • Manual add/remove with /mbf add and /mbf remove
  • Alphabetical or custom sorting
  • Supports up to 50 buttons per row/column

๐ŸŽจ Customization

  • Movable and resizable frame
  • Customizable background color
  • Modular button skins
  • Multiple anchor positions
  • Grow buttons up/down option

๐Ÿ”Œ Addon Integration

  • ElvUI - Seamless integration toggle
  • LDB - LibDataBroker support
  • Profile system for settings
  • Protected icon exclusions

๐ŸŒ Localization

  • English, German, French
  • Spanish (ES/MX), Korean
  • Russian, Chinese (CN/TW)

๐Ÿ“ฆ Installation

  1. Download the latest release
  2. Extract to Interface/AddOns/MinimapButtonFrame
  3. Restart WoW or /reload

๐ŸŽฎ Usage

Slash Commands

Command Description
/mbf Display command options
/mbf add [button] Add button under cursor (or named)
/mbf remove [button] Remove button from frame
/mbf show Show the MBF frame
/mbf hide Hide the MBF frame
/mbf config Open configuration
/mbf info Show info about object under cursor

Minimap Button

Action Result
Left-click Show/hide the frame
Shift-click Open config screen
Right-click + drag Move the minimap button

๐Ÿ”ง ElvUI Integration

MBF includes seamless ElvUI integration:

  • MBF Controls Buttons: Default mode - MBF manages all minimap buttons
  • ElvUI Controls Buttons: Toggle in MBF settings โ†’ Plugins to let ElvUI's Button Grabber take over
  • Both addons offer reload prompts when switching control

๐Ÿ“œ Changelog

v3.1.x - Project Ascension Updates

v3.2.0

  • ๐Ÿ”ง Fixed stack overflow with FarmHud addon
  • โž• Added recursion guard to prevent infinite loop when iterating minimap children
  • ๐Ÿ›ก๏ธ Wrapped GetChildren iteration in pcall for additional safety

v3.1.9

  • ๐Ÿ”ง Fixed ElvUI Button Grabber auto-enable now uses correct path
  • ๐Ÿ”„ Improved "Let ElvUI Control" popup - now requires disabling MBF to take effect
  • โœจ Cancel button properly reverts to MBF control
  • ๐Ÿ”ง All MBF options now correctly disabled when ElvUI controls buttons

v3.1.7

  • โœจ ElvUI's Button Grabber now auto-enabled when switching to ElvUI control
  • ๐Ÿ”„ Updated popup message to confirm auto-enable

v3.1.6

  • ๐Ÿ”ง SkinPack addon now auto-disabled when switching to ElvUI button control

v3.1.5

  • ๐Ÿ”ง Fixed quest icon pins (pfQuest etc.) no longer collected into MBF
  • โž• Added pfQuest minimap pin frames to icon exclusion list
  • ๐Ÿ”„ Improved detection of non-button minimap elements

v3.1.4

  • โž• MBF options grey out when ElvUI's Button Grabber is in control
  • โž• Warning message in MBF settings when ElvUI controls buttons
  • โž• ElvUI popup to disable MBF when enabling Button Grabber

v3.1.3

  • โž• Added "Plugins" submenu in MBF options for addon integrations
  • โž• ElvUI Integration toggle: "Let ElvUI Control Buttons"
  • โž• Popup when toggling to ElvUI offers to disable MBF addon

v3.1.2

  • ๐Ÿ”ง Fixed ElvUI minimap panels no longer hide when MBF is hidden
  • ๐Ÿ”„ Added all 8 ElvUI MiniPanel frames to protection list

v3.1.1

  • ๐Ÿ”ง Fixed ElvUI drag conflict - MBF drags independently
  • ๐Ÿ”ง Fixed anchor chain issues with MMHolder and ElvUI
  • โž• New ElvUI integration toggle in Maps โ†’ Minimap โ†’ Buttons
  • ๐Ÿ”„ Removed debug print statements
v3.0.x - v3.1.0

v3.1.0

  • ๐Ÿ”ง Fixed initial profile set to default
  • ๐Ÿ”ง Fixed MinimapButtonFrame.lua:1332 error
  • โž• Added grow buttons up option
  • โž• Added MBF anchor position selection

v3.0.x

  • โœจ Redesigned config screens using Ace3
  • โž• New title bar drag system
  • โž• Profile support
  • โž• Custom button sorting
Earlier Versions

See Readme.txt for full version history from v0.9 to v2.4


โš ๏ธ Known Issues

  • MetaMap: Incompatible due to continual position resetting
  • SexyMap: Disable all minimap icon control for best results
  • Enchantrix / onRaid: Cannot grab buttons without names

๐Ÿ‘ฅ Credits

Bachlott
Original Author
Xurkon
Project Ascension Updates

Made for Project Ascension

This addon is open source and provided as-is. Not affiliated with Blizzard Entertainment.

Documentation

About

Collects minimap addon buttons and organizes them into a movable, customizable frame.

Resources

License

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages