HandyNotes (TBC)

Handy Notes for your maps. This addon is intended to be a small and simple replacement for Cartographer_Notes and functions in a similar manner.

Use /handynotes to access options.

You can add notes to the maps in 3 ways:

• Alt-RightClick on the world map to add a note.
• Use “/hnnew” without the quotes to add a note at your current location.
• Use “/hnnew x,y” without the quotes to add a note at location x,y on your current zone’s map.

HandyNotes supports plugins that other authors can write to display their own set of notes on the map. See this link for a list of such addons: https://www.wowace.com/search?search=handynotes

Changes for WoW 8.0 / Battle for Azeroth

• Changed to HereBeDragons-2.0, since HBD-1.0 is not compatible with WoW 8.0 / BfA
  • All plugins that reference HereBeDragons directly need to adjust as well
• Due to the massive changes in the map and all related logic, HandyNotes 1.5.0 will introduce changes to the Plugin API as well. Changes listed below are preliminary, however they are available in the latest Alpha builds if running on the BfA Beta.
  • Removed API: HN:GetMapFile(C, Z), HN:GetCZ(mapFile), HN:GetZoneToCZ(zone), HN:GetCZToZone(C,Z)
    • Rationale: C/Z values no longer exist in WoW 8.0
  • Removed API: HN:GetZoneToMapID(zone) 
    • Rationale: Using localized zone names is generally a bad idea, and the old MapIDs no longer exist
  • Deprecated API: HN:GetMapFiletoMapID(mapFile), HN:GetMapIDtoMapFile(mapID), 
    • These have been deprecated and will be removed in the future, but are still provided for  compatiblity with existing plugins (data is no longer available in-game, mapping provided by HereBeDragons-Migrate)
  • Changed API: HN:GetContinentZoneList(uiMapIdOrmapFile)
    • This API can now be called with either a mapFile (legacy mode), in which case it’ll continue to return a list of legacy mapIDs for old plugins, or called with a new uiMapID, in which case it’ll return a list of uiMapIDs
  • New API: plugin:GetNodes2(uiMapID, minimap)
    • This is equivalent to the old GetNodes call, except that it handles the new uiMapID type.
    • The Iterator should return:
      • coord, uiMapID, iconpath, scale, alpha
      • Mapfile was replaced by uiMapID, level has been dropped
    • The old plugin:GetNodes API is still available and the data is automatically converted, if a conversion is possible. It is strongly recommended to switch to GetNodes2, so you can support new zones!

Changes from v1.2.0 to v1.4.0

• HandyNotes now uses HereBeDragons-1.0 instead of the unmaintained Astrolabe
  • Plugins which referenced Astrolabe directly should be updated, and ideally not require anything the HandyNotes API does not provide
• New HandyNotes API function: HN:GetContinentZoneList(mapFile), retrieve a list of zones inside a continent (Z -> mapID hash table)