HereBeDragons is a data API for the World of Warcraft mapping system

HereBeDragons offers a clean and modern API to retrieve the players position, calculate distances and angles between positions, both in global world coordinates and local zone coordinates. The primary goal of this library is to provide an up-to-date and low maintenance alternative to the legacy map libraries like Astrolabe and LibMapData, which both unfortunately are unmaintained and have their own issues due to changes in WoWs API.

On top of a clean API for all map math, HereBeDragons will also provide a second library, HereBeDragons-Pins, which replaces the world map and minimap pin management functionality of Astrolabe. This library is roughly based on the pin management code from GatherMate2, which has been thoroughly tested in years of use.


Note for Battle for Azeroth/WoW 8.0

The map data is getting a huge overhaul in 8.0, which means HereBeDragons will be changing as well and moving to 2.0. The exact details of all map changes are still being worked out, but so far its safe to say that a lot of the map data is going to change - primarily, the "Map ID" and the "Map Filename" are both going away, as well as the C/Z pair, and are replaced by a new "UI Map ID".

I've been talking with a Blizzard UI developer and we hope that we can provide a migration path from the old IDs to the new one. But it will require all addons which interact with the map to update.

More details on these changes and how HBD is evolving to handle them will be documented here when addons become available in the BfA Alpha/Beta.


  • To post a comment, please or register a new account.
Posts Quoted:
Clear All Quotes

About This Project

  • Project ID
  • Created
    Aug 16, 2015
  • Last Released File
    Aug 29, 2017
  • Total Downloads
  • License



Recent Files