✨ MidnightMap V2

MidnightMap started as a simple project to clean up the default World of Warcraft minimap.
Version 2 of the minimap has grown into something much more, underneath the interface is a modular runtime with dedicated systems for appearance, themes, movement, visibility, minimap elements, presets, zoom, calendar integration and addon-button management.

The result is a minimap that remains lightweight while offering considerably deeper customization.

---

🎨 Complete Appearance Control

Build a minimap that actually matches your UI.

Circle or Square:

Switch instantly between:

- **Classic Circle**
- **Pixel-clean Square**

Both shapes use the same V2 Appearance Engine, so your colors, borders, opacity and themes remain consistent when switching between them.

Custom Borders

Control:

- Border thickness
- Border opacity
- Custom border color
- Class-colored borders
- Theme-controlled borders

Changes are applied **live** without requiring `/reload`.

Background Customization

Fine-tune the minimap background with:

- Custom RGB colors
- Transparency
- Theme integration

Appearance updates use MidnightMap's targeted refresh system so changing one setting doesn't unnecessarily rebuild the entire minimap.

---

🌙 Midnight Theme Engine

MidnightMap includes its own theme system designed to integrate with the wider Midnight addon family.

Built-in themes include:

- **Midnight Razor**
- **Midnight Dark**
- **Midnight Classic**

You can let MidnightMap use its own local theme or follow the active **MidnightShared global theme** for a consistent appearance across supported Midnight addons.

### Theme Studio

The Theme Studio provides:

- Visual theme presets
- Global or local theme control
- Live appearance updates
- Theme-aware configuration UI
- Live minimap preview
- Custom appearance overrides

Choose a preset and then customize it to make the minimap your own.

---

🎨 Midnight Color Editor

MidnightMap doesn't rely on Blizzard's standard color-picker interface.

V2 includes a custom Midnight-styled color editor with:

- RGB controls
- HEX color input
- Live color preview
- Border transparency
- Background transparency
- Live minimap updates
- Revert / Cancel controls
- Movable color-picker window
- Saved window positioning

See your changes as you make them.

No `/reload`.

---

🗺️ Minimap Controls

Clean up the Blizzard minimap while keeping the functionality you need.

Control the visibility of:

- Blizzard minimap artwork
- Zone text
- Clock
- Tracking button
- Addon compartment
- Top border
- Calendar indicator
- Mail indicator
- Instance / difficulty information

The minimap itself can also be freely positioned and locked when you're finished.

---

📍 Minimap Elements V2

MidnightMap can add useful information directly around your minimap while keeping each element independently configurable.

Available elements include:

- **Coordinates**
- **Zone Text**
- **Zone + Subzone**
- **Clock**
- **Mail Indicator**
- **Instance / Difficulty information**

Each supported element can be enabled or disabled independently.

### Typography Studio

Customize supported text elements with:

- Font selection
- Font size
- Font outline
- Global typography
- Per-element typography
- SharedMedia font support
- Live preview

---

✥ Edit Layout Mode

MidnightMap includes a visual layout editor for supported minimap elements.

Enter Edit Layout mode to reposition elements directly around the minimap.

Features include:

- Independent element positioning
- Drag-and-drop movement
- Optional snapping
- Saved positions
- Reset Positions
- Immediate visual feedback

Once everything is where you want it, leave Edit Mode and MidnightMap remembers the layout.

---

🎛️ Presentation Presets

V2 includes complete presentation presets for quickly changing the overall minimap setup.

Built-in presets include:

- **Midnight**
- **Minimal**
- **Compact**
- **Streamer**
- **Information**

Presets are deliberately scoped so they don't unnecessarily overwrite unrelated customization.

### Resolution / Layout Presets

Quick layout presets are also available for:

- **1080p**
- **1440p**
- **4K**

MidnightMap creates restore information when applying presets so you can return to your previous setup.

---

🔍 Mousewheel Zoom

Use the mouse wheel directly over the minimap to zoom in and out.

### Auto Zoom Reset

Optionally let MidnightMap automatically restore your normal zoom level after a configurable delay.

No more accidentally leaving the minimap zoomed all the way in.

---

📅 Smart Calendar

MidnightMap can keep the Calendar button hidden during normal gameplay while automatically making it available when you have a **pending calendar invitation**.

Clean when you don't need it.

Visible when you do.

---

🧩 Button Manager V2

MidnightMap includes a dedicated system for managing third-party addon minimap buttons.

Instead of leaving dozens of addon icons scattered around your minimap, supported buttons can be collected into a separate Midnight-styled Button Box.

The Button Manager can:

- Discover supported addon minimap buttons
- Detect LibDBIcon launchers
- Detect supported late-created addon buttons
- Collect buttons into a dedicated Button Box
- Reposition the Button Box
- Change addon icon size
- Choose the default bar side
- Lock the Button Box
- Auto-hide the Button Box
- Manually rescan for buttons
- Exclude selected buttons
- Prevent duplicate collection

Compatibility handling has also been improved for addons including:

- **Hindsight**
- **All The Things**
- **HandyNotes**
- LibDBIcon-based addons

Blizzard minimap controls such as Tracking, Calendar, Mail, Queue and Difficulty controls are protected from ButtonManager capture.

The compatibility layer also avoids taking ownership of protected or forbidden frames.

---

⚡ Lightweight & Responsive

MidnightMap V2 isn't built around repeatedly rebuilding the entire minimap whenever something changes.

Its targeted refresh architecture allows individual systems to update independently.

For example:

- Scale changes update scaling
- Border changes update border visuals
- Theme changes update theme visuals
- Element changes update elements
- Layout changes update layout
- Button changes update ButtonManager

This helps keep configuration changes, sliders, themes and presets responsive without unnecessary work.

Button discovery also uses **bounded scans rather than permanent polling**.

---

⚡ Built for Midnight

MidnightMap V2 has been reorganized around a modular architecture rather than one large minimap script.

Dedicated systems handle:

- Appearance
- Shape
- Themes
- Movement
- Visibility
- Elements
- Typography
- Layout editing
- Presets
- Zoom
- Calendar
- Launcher
- Button management
- Compatibility
- Refresh handling

This allows individual parts of the minimap to update without unnecessarily rebuilding everything else.

The goal is simple:

**Keep MidnightMap responsive, maintainable and lightweight as it grows.**

---

⚙️ Configuration

Open MidnightMap with:

**`/mm`**

The V2 configuration interface contains dedicated pages for:

- General
- Appearance
- Theme
- Elements
- Presets
- Buttons
- Advanced
- About

The configuration window automatically adapts to the content of each page.

Most appearance, layout, theme and element changes happen immediately.

**No reload required.**

---

🛡️ WoW 12.1 Ready

MidnightMap V2 2.0.0 has been developed for:

**World of Warcraft Retail: Midnight 12.1.5**

The V2 runtime includes compatibility safeguards for modern WoW APIs, protected frames, forbidden frames and third-party minimap interactions.

Special compatibility handling is also included for **Leatrix Plus** minimap modifications.

---

🌌 Part of the Midnight UI Family

MidnightMap is being developed as part of the broader **Midnight addon ecosystem**, with a shared visual language and architecture across supported Midnight addons.

When **MidnightShared** is available, MidnightMap can participate in the shared Midnight theme system.

The long-term goal is simple:

**One design language. One consistent experience. Multiple independent addons.**

Use only the Midnight addons you want while keeping a cohesive interface.

---

❤️ About MidnightMap

MidnightMap is a personal project I've wanted to create since I started playing World of Warcraft nearly **20 years ago**.

What began as an idea for a cleaner minimap has gradually turned into one of my favorite projects to work on.

V2 represents the direction I always wanted for it: lightweight underneath, deeply customizable when you want it, and designed to feel like a natural part of World of Warcraft.

---

## 🛠️ Support & Feedback

Found a bug, compatibility problem or have an idea for MidnightMap?

Feedback is always welcome.

**Github:**

---

**Developed by Arrakeen @ Bronzebeard (EU)**  
**Copyright © 2026**

CurseForge: https://www.curseforge.com/wow/addons/midnightmap