{"id":49033896,"url":"https://github.com/mikarregui/minimapbuttoncollector","last_synced_at":"2026-04-24T09:02:07.127Z","repository":{"id":352374294,"uuid":"1214929178","full_name":"mikarregui/MinimapButtonCollector","owner":"mikarregui","description":"Groups your WoW minimap addon buttons behind a single trigger. TBC Classic Anniversary.","archived":false,"fork":false,"pushed_at":"2026-04-19T10:02:35.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T10:07:14.281Z","etag":null,"topics":["addon","classic-anniversary","lua","tbc-classic","world-of-warcraft","wow","wow-addon"],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mikarregui.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-19T08:40:21.000Z","updated_at":"2026-04-19T10:02:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mikarregui/MinimapButtonCollector","commit_stats":null,"previous_names":["mikarregui/minimapbuttoncollector"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/mikarregui/MinimapButtonCollector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikarregui%2FMinimapButtonCollector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikarregui%2FMinimapButtonCollector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikarregui%2FMinimapButtonCollector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikarregui%2FMinimapButtonCollector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mikarregui","download_url":"https://codeload.github.com/mikarregui/MinimapButtonCollector/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikarregui%2FMinimapButtonCollector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32216347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T08:24:32.376Z","status":"ssl_error","status_checked_at":"2026-04-24T08:24:26.731Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["addon","classic-anniversary","lua","tbc-classic","world-of-warcraft","wow","wow-addon"],"created_at":"2026-04-19T10:04:43.678Z","updated_at":"2026-04-24T09:02:07.121Z","avatar_url":"https://github.com/mikarregui.png","language":"Lua","funding_links":["https://ko-fi.com/mikarregui"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/mikarregui/MinimapButtonCollector/main/assets/logo.png\" alt=\"Minimap Button Collector logo\" width=\"160\"\u003e\n\u003c/p\u003e\n\n# MinimapButtonCollector\n\n\u003e One trigger on your minimap. Click it, your addon buttons appear in a clean side panel. Click one, it closes. Done.\n\n[![Release](https://img.shields.io/github/v/release/mikarregui/MinimapButtonCollector?sort=semver\u0026display_name=tag)](https://github.com/mikarregui/MinimapButtonCollector/releases)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![GitHub downloads](https://img.shields.io/github/downloads/mikarregui/MinimapButtonCollector/total.svg?label=GitHub\u0026color=24292f)](https://github.com/mikarregui/MinimapButtonCollector/releases)\n[![CurseForge downloads](https://img.shields.io/curseforge/dt/1518595?label=CurseForge\u0026color=f16436)](https://www.curseforge.com/wow/addons/minimap-button-collector)\n[![Issues](https://img.shields.io/github/issues/mikarregui/MinimapButtonCollector.svg)](https://github.com/mikarregui/MinimapButtonCollector/issues)\n[![Stars](https://img.shields.io/github/stars/mikarregui/MinimapButtonCollector.svg?style=social)](https://github.com/mikarregui/MinimapButtonCollector/stargazers)\n\n\u003e Target client: **World of Warcraft — The Burning Crusade Classic Anniversary Edition** (2.5.5, Interface `20505`).\n\u003e Available on **[GitHub Releases](https://github.com/mikarregui/MinimapButtonCollector/releases)**, **[CurseForge](https://www.curseforge.com/wow/addons/minimap-button-collector)**, and **[Wago](https://addons.wago.io/addons/minimapbuttoncollector)**.\n\n\u003c!-- TODO: add demo GIF here after first release --\u003e\n\n## Why\n\nInstall a handful of addons and your minimap edge turns into a ring of overlapping little buttons. Finding the one you want becomes a game in itself. MinimapButtonCollector reclaims that space: a single trigger sits on the minimap, and when you click it, all the collected addon buttons appear in a clean side panel anchored to the minimap.\n\n## Features\n\n- **Hybrid detection** — catches modern LibDBIcon buttons (including those registered after login, captured live) and legacy minimap buttons\n- **Side panel layout** — buttons appear in a floating panel anchored to a configurable corner of the minimap. Never covers the map itself, so raid / BG / quest navigation stays readable\n- **Per-button exclusion** — keep individual buttons on the minimap instead of collecting them, ideal for icons whose look communicates state at a glance\n- **Reorder inside the panel** — arrange collected buttons in the order that makes sense for you, per character\n- **Smooth fade transition** — 200 ms panel fade, no jarring pop-in\n- **Auto-close** — click any addon button and the panel closes on its own\n- **Draggable trigger** — move it anywhere around the minimap edge; position persists per-character\n- **Non-modal** — the panel coexists with world interactions (loot, NPCs, spells) and can be opened or kept open during combat\n- **Native settings** — `/mbc config` or right-click the trigger opens a Blizzard-style settings panel\n\n## Installation\n\n### Via addon manager (recommended)\n\nAvailable on [CurseForge](https://www.curseforge.com/wow/addons/minimap-button-collector) and [Wago](https://addons.wago.io/addons/minimapbuttoncollector). Install via the CurseForge app, the Wago app, or [WowUp](https://wowup.io) (multi-source).\n\n### Manual\n\n1. Download the latest `MinimapButtonCollector-vX.Y.Z.zip` from the [Releases page](https://github.com/mikarregui/MinimapButtonCollector/releases).\n2. Extract the `MinimapButtonCollector/` folder into your AddOns directory:\n   ```\n   \u003cWoW install\u003e\\_anniversary_\\Interface\\AddOns\\\n   ```\n3. Launch WoW. Enable the addon in the AddOns menu if needed. `/reload` in-game.\n\n## Usage\n\n- **Click** the trigger button on the minimap → side panel opens.\n- **Click any button** in the panel → addon action runs, panel closes.\n- **Re-click the trigger** or press **ESC** → panel closes.\n- **Right-click the trigger** → settings panel.\n- **Drag the trigger** around the minimap edge to reposition it. Position persists per-character.\n\n### Slash commands\n\n| Command | Action |\n|---|---|\n| `/mbc` | Toggle the side panel |\n| `/mbc config` | Open the settings panel |\n| `/mbc exclude \u003cButtonName\u003e` | Keep a specific button on the minimap (never collect it). Case-sensitive — use `/mbc list` to see exact names |\n| `/mbc include \u003cButtonName\u003e` | Undo an exclusion; the button goes back into the panel |\n| `/mbc rescan` | Re-detect minimap buttons (rarely needed — new LibDBIcon buttons are captured live) |\n| `/mbc list` | Print a summary of collected buttons grouped by source |\n| `/mbc list full` | Print the full list of collected buttons (debug) |\n\n## Compatibility\n\nThe side panel is an independent frame anchored to the minimap via `SetPoint`. It does not manipulate the minimap's alpha or reparent Blizzard frames, so it coexists cleanly with ElvUI minimap skinning and other addons that reshape the minimap.\n\n## Development\n\nThis repo is set up for serious iteration. See [CONTRIBUTING.md](CONTRIBUTING.md) for the full workflow. Architectural decisions are recorded in [docs/adr/](docs/adr/).\n\n### Quick start\n\n```bash\ngit clone https://github.com/mikarregui/MinimapButtonCollector.git\ncd MinimapButtonCollector\n```\n\nSymlink the addon folder into your WoW install (PowerShell as Administrator):\n\n```powershell\nNew-Item -ItemType SymbolicLink `\n  -Path \"C:\\BattleNet\\World of Warcraft\\_anniversary_\\Interface\\AddOns\\MinimapButtonCollector\" `\n  -Target \"$PWD\\MinimapButtonCollector\"\n```\n\nThen edit in the repo, `/reload` in-game, iterate.\n\n### How releases are built\n\nPush a tag `vX.Y.Z` to `main`. The [BigWigs Packager](https://github.com/BigWigsMods/packager) GitHub Action resolves library externals, injects the version into the `.toc`, and publishes a ZIP to GitHub Releases. No manual packaging step.\n\n## Roadmap\n\nPlanned:\n\n- **v2.2.0** — search / filter at the top of the panel\n- **v2.3.0** — [Masque](https://www.curseforge.com/wow/addons/masque) skin support\n\nFuture ideas: drag \u0026 drop reorder inside the panel, additional layout options if users ask for them with data.\n\n## Tech stack\n\n- **Lua 5.1** (the version WoW's client runs)\n- [LibStub](https://www.wowace.com/projects/libstub)\n- [CallbackHandler-1.0](https://www.wowace.com/projects/callbackhandler)\n- [LibDataBroker-1.1](https://github.com/tekkub/libdatabroker-1-1)\n- [LibDBIcon-1.0](https://www.wowace.com/projects/libdbicon-1-0)\n- [BigWigs Packager](https://github.com/BigWigsMods/packager) for release automation\n\n## Support\n\nOpen an issue on GitHub if you spot something off — `/mbc list full` or `/mbc debug \u003cButtonName\u003e` gives me the context I need.\n\n### Tip jar ☕\n\nIf this addon saves you some minimap real estate, consider buying me a coffee. Entirely optional — the addon is free and stays free.\n\nWhen tipping, you can optionally leave your in-game name + server (or GitHub handle) and I'll add you to a supporters list in the next release. Anonymous tips are just as welcome.\n\n[![Support on Ko-fi](https://storage.ko-fi.com/cdn/kofi2.png?v=3)](https://ko-fi.com/mikarregui)\n\n## License\n\n[MIT](LICENSE) © mikarregui\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikarregui%2Fminimapbuttoncollector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmikarregui%2Fminimapbuttoncollector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikarregui%2Fminimapbuttoncollector/lists"}