HandyNotes

Table of Contents

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)

Comments

brunokbcao
- Join Date: 11/9/2022
- Posts: 5
- Member Details
#1082 brunokbcao

View User Profile

Send Message

Posted Nov 17, 2022
If you really don't use the "add a note" feature using alt + click and once that is conflicting with TomTom, you can safely disable it by editing the file Interface\Addons\HandyNotes\HandyNotes_HandyNotes.lua at line 472, replacing

if WoWRetail then

by

if true then elseif WoWRetail then

That will disable the whole block, at least until the author provides a way to configure the shortcuts. You can still add a note with /hnnew x, y after this edit.
Last edited by brunokbcao: Nov 18, 2022

Rollback Post to Revision RollBack
durandal42
- Join Date: 9/19/2019
- Posts: 7
- Member Details
#1083 durandal42

View User Profile

Send Message

Posted Nov 18, 2022
In reply to brunokbcao:

Warning: this will cause the else block (WorldMapFrame:AddCanvasClickHandler) to execute instead. I did something similar, instead replacing the line with

if true then elseif WoWRetail then
Rollback Post to Revision RollBack
brunokbcao
- Join Date: 11/9/2022
- Posts: 5
- Member Details
#1084 brunokbcao

View User Profile

Send Message

Posted Nov 18, 2022
In reply to durandal42:

Great! Thanks for the heads up, I will edit the original post

Rollback Post to Revision RollBack
KarsiTV
- Join Date: 8/22/2008
- Posts: 7
- Member Details
#1081 KarsiTV

View User Profile

Send Message

Posted Nov 17, 2022
For the love of god please listen to the previous comments and change/remove the alt+rightclick keybind, or at the very least give us the option to change it. I like HandyNotes, but not being able to make TomTom waypoints is unbearable.

Rollback Post to Revision RollBack
Zlandicae
- Join Date: 11/10/2022
- Posts: 1
- Member Details
#1076 Zlandicae

View User Profile

Send Message

Posted Nov 10, 2022
I had to stop using Handynote because it is now impossible for me to use it in correlation with Tomtom, all the left or right clicks except one being apparently monopolized by the "addons" internal to Blizzard. Or maybe I missed a configuration option...

Rollback Post to Revision RollBack
Yugawar
- Join Date: 11/14/2022
- Posts: 5
- Member Details
#1078 Yugawar

View User Profile

Send Message

Posted Nov 14, 2022
In reply to Zlandicae:

to make a note on the map, just input /hnnew that will put one where you are, if you want one in a specific location, just do this /hnnew x, y

Rollback Post to Revision RollBack
BowyIcecrown
- Join Date: 11/17/2022
- Posts: 0
- Member Details
#1079 BowyIcecrown

View User Profile

Send Message

Posted Nov 16, 2022
In reply to Yugawar:

That's not the point. TomTom already has a simple command that sets coordinates with a waypoint, we don't need to use an even more complex script in HandyNotes. In TomTom, Alt-Left Click is used to quickly create a waypoint using a specific location on the map without knowing the coordinates of the location. TomTom used to use Control-Left Click, but Blizzard decided to use that command for their crappy built-in coordinate/waypoint system, thereby forcing TomTom to use another command.

Rollback Post to Revision RollBack
BowyIcecrown
- Join Date: 11/17/2022
- Posts: 0
- Member Details
#1080 BowyIcecrown

View User Profile

Send Message

Posted Nov 16, 2022
In reply to Yugawar:

That's not the point. TomTom already has a simple command that sets coordinates with a waypoint, we don't need to use an even more complex script in HandyNotes. In TomTom, Alt-Left Click is used to quickly create a waypoint using a specific location on the map without knowing the coordinates of the location. TomTom used to use Control-Left Click, but Blizzard decided to use that command for their crappy built-in coordinate/waypoint system, thereby forcing TomTom to use another command.

Rollback Post to Revision RollBack
bonesly_007
- Join Date: 11/9/2022
- Posts: 9
- Member Details
#1075 bonesly_007

View User Profile

Send Message

Posted Nov 9, 2022
New feature "Alt-RightClick on the world map to add a note" conflicts with an existing hotkey I was using for TomTom. There needs to be a way to reassign this key in the options (I only see scale, alpha, and profile options but no where is there a way to unbind the key or reassign it).

Rollback Post to Revision RollBack
RawrJayG
- Location: Lancaster
- Join Date: 6/22/2009
- Posts: 9
- Member Details
#1069 RawrJayG

View User Profile

Send Message

Posted Nov 9, 2022
Alt-RightClick on the world map to add a note.

This conflicts with TomTom, please add option to disable or change the keybind for this.
Rollback Post to Revision RollBack
thanyou
- Location: San Diego
- Join Date: 11/9/2022
- Posts: 1
- Member Details
#1070 thanyou

View User Profile

Send Message

Posted Nov 9, 2022
In reply to RawrJayG:

Thankfully TomTom allows you to change the hotkey, whereas it appears handynotes does not.

I have no idea when they changed this, I feel up to like literally earlier today this functionality didn't conflict.

Rollback Post to Revision RollBack
VladTheImplierIII
- Location: Nope
- Join Date: 1/4/2014
- Posts: 18
- Member Details
#1133 VladTheImplierIII

View User Profile

Send Message

Posted Jan 22, 2023
In reply to thanyou:

I came here to try and find out how to stop this conflict as I use the TomTom Alt-RightClick much much more! This definitely did not conflict before as I was using both seamlessly. Thank you for the note about TomTom, I guess I'll have to change on there until HandyNotes makes it toggle-able.

Rollback Post to Revision RollBack
JohntheBarbarian
- Join Date: 10/28/2022
- Posts: 3
- Member Details
#1062 JohntheBarbarian

View User Profile

Send Message

Posted Nov 8, 2022
How do you change the hotkey for adding a new note?

Rollback Post to Revision RollBack
brunokbcao
- Join Date: 11/9/2022
- Posts: 5
- Member Details
#1067 brunokbcao

View User Profile

Send Message

Posted Nov 9, 2022
In reply to JohntheBarbarian:

I noticed this as well. Now I'm not able to add TomTom waypoints the way I've supposed to. I always added a note with /hnnew, so that wouldn't conflict with TomTom.

Rollback Post to Revision RollBack
brunokbcao
- Join Date: 11/9/2022
- Posts: 5
- Member Details
#1068 brunokbcao

View User Profile

Send Message

Posted Nov 9, 2022
In reply to JohntheBarbarian:

I noticed this as well. Now I'm not able to add TomTom waypoints the way I've supposed to. I always added a note with /hnnew, so that wouldn't conflict with TomTom.

Rollback Post to Revision RollBack
bonesly_007
- Join Date: 11/9/2022
- Posts: 9
- Member Details
#1074 bonesly_007

View User Profile

Send Message

Posted Nov 9, 2022
Same issue... New feature "Alt-RightClick on the world map to add a note" conflicts with an existing hotkey I was using for TomTom. There needs to be a way to reassign this key in the options (I only see scale, alpha, and profile options but no where is there a way to unbind the key or reassign it).

Rollback Post to Revision RollBack
pshelton2
- Join Date: 11/1/2022
- Posts: 4
- Member Details
#1056 pshelton2

View User Profile

Send Message

Posted Nov 2, 2022
This is still happening on 11/05/2022

I have the latest version of HandyNotes on the retail DF Pre-patch. I get his error and have to disable the addon for my action buttons to work.

Thanks

1x [ADDON_ACTION_FORBIDDEN] AddOn 'HandyNotes' tried to call the protected function 'UseAction()'.
[string "@Interface/AddOns/!BugGrabber/BugGrabber.lua"]:480: in function <Interface/AddOns/!BugGrabber/BugGrabber.lua:480>
[string "=[C]"]: in function `UseAction'
[string "@Interface/FrameXML/SecureTemplates.lua"]:364: in function `handler'
[string "@Interface/FrameXML/SecureTemplates.lua"]:690: in function <Interface/FrameXML/SecureTemplates.lua:672>
[string "@Interface/FrameXML/SecureTemplates.lua"]:704: in function <Interface/FrameXML/SecureTemplates.lua:697>
[string "@Interface/FrameXML/SecureTemplates.lua"]:746: in function `SecureActionButton_OnClick'
[string "@Interface/FrameXML/ActionButton.lua"]:109: in function `TryUseActionButton'
[string "@Interface/FrameXML/MultiActionBars.lua"]:14: in function `MultiActionButtonDown'
[string "MULTIACTIONBAR1BUTTON10"]:2: in function <[string "MULTIACTIONBAR1BUTTON10"]:1>

Last edited by pshelton2: Nov 5, 2022

Rollback Post to Revision RollBack
rfzm
- Join Date: 8/8/2018
- Posts: 19
- Member Details
#1055 rfzm

View User Profile

Send Message

Posted Nov 1, 2022
Update pls :(

Rollback Post to Revision RollBack
cuttinhoss21
- Join Date: 10/30/2022
- Posts: 1
- Member Details
#1044 cuttinhoss21

View User Profile

Send Message

Posted Oct 30, 2022
HELP! Please? I keep getting this in Boralus when I hit my map to see where I am going

Date: 2022-10-30 11:29:47
ID: 5
Error occured in: Global
Count: 1
Message: Interface/AddOns/HandyNotes/HandyNotes.lua line 376:
bad argument #1 to 'SetAlpha' (Usage: self:SetAlpha(alpha))
Debug:
[string "=(tail call)"]: ?
[string "=[C]"]: SetAlpha()
[string "@Interface/AddOns/HandyNotes/HandyNotes.lua"]:376: OnAcquired()
[string "@Interface/AddOns/Blizzard_MapCanvas/Blizzard_MapCanvas.lua"]:201: AcquirePin()
[string "@Interface/AddOns/HandyNotes/HandyNotes.lua"]:347:
Interface/AddOns/HandyNotes/HandyNotes.lua:325
[string "=[C]"]: ?
[string "@Interface/AddOns/HandyNotes/HandyNotes.lua"]:56:
Interface/AddOns/HandyNotes/HandyNotes.lua:51
[string "@Interface/AddOns/HandyNotes/HandyNotes.lua"]:321: RefreshAllData()
[string "@Interface/AddOns/HandyNotes/HandyNotes.lua"]:422: UpdateWorldMap()
[string "@Interface/AddOns/HandyNotes/HandyNotes.lua"]:643:
Interface/AddOns/HandyNotes/HandyNotes.lua:634
[string "@Interface/AddOns/HandyNotes_BattleForAzeroth/core/map.lua"]:418:
...face/AddOns/HandyNotes_BattleForAzeroth/core/map.lua:417
[string "@Interface/AddOns/HandyNotes_Dragonflight/core/map.lua"]:418:
...nterface/AddOns/HandyNotes_Dragonflight/core/map.lua:417
[string "@Interface/AddOns/HandyNotes_Shadowlands/core/map.lua"]:418:
Interface/AddOns/HandyNotes_Shadowlands/core/map.lua:417
[string "=[C]"]: ?
[string "=[C]"]: ?
[string "@Interface/AddOns/DataStore/libs/AceAddon-3.0/AceAddon-3.0.lua"]:70:
.../AddOns/DataStore/libs/AceAddon-3.0/AceAddon-3.0.lua:65
[string "@Interface/AddOns/DataStore/libs/AceAddon-3.0/AceAddon-3.0.lua"]:527: EnableAddon()
[string "@Interface/AddOns/DataStore/libs/AceAddon-3.0/AceAddon-3.0.lua"]:630:
.../AddOns/DataStore/libs/AceAddon-3.0/AceAddon-3.0.lua:615
Locals:
None
AddOns:
Swatter, v<%version%> (<%codename%>)
AddonFactory, v9.2.006
Altoholic, v9.2.006
AskMrRobot, v114
Auctioneer, v9.1.BETA.5.4 (OneMawTime)
AuctioneerStatsOverTime, v9.1.BETA.5.4 (OneMawTime)
AuctioneerUtilDealFinder, v9.1.BETA.5.4 (OneMawTime)
AuctioneerUtilValuer, v9.1.BETA.5.4 (OneMawTime)
DataStore, v2022.08.05
DataStoreAchievements, v9.2.004
DataStoreAgenda, v9.2.004
DataStoreAuctions, v9.2.004
DataStoreCharacters, v2022.06.05
DataStoreContainers, v9.2.004
DataStoreCrafts, v9.2.004
DataStoreCurrencies, v9.2.004
DataStoreGarrisons, v9.2.004
DataStoreInventory, v9.2.004
DataStoreMails, v2022.06.05
DataStorePets, v9.2.004
DataStoreQuests, v9.2.004
DataStoreReputations, v9.2.004
DataStoreSpells, v2022.06.05
DataStoreStats, v9.2.004
DataStoreTalents, v9.2.004
DBMArchaeology, vr47
DBMCore, v494a4d8
DBMStatusBarTimers, v494a4d8
DBMVPVEM, v47b3faf
Decursive, v2.7.8.11
Details, v#Details.DF.Wrath.10205.146
DetailsEncounterDetails, v
DetailsExplosiveOrbs, vv10.0.0
DetailsRaidCheck, v
DetailsStreamer, v
DetailsTinyThreat, v
DetailsVanguard, v
GatherMate2, v1.48.0
GTFO, v4.69.1
HandyNotes, vv1.6.9
HandyNotesAchievements, v0.6.1
HandyNotesAdorableRaptorHatchlings, v1.12
HandyNotesArgus, vv0.36
HandyNotesBattleForAzeroth, v11
HandyNotesBattleForAzerothTreasures, vv28.1
HandyNotesBrokenShore, vv1.49
HandyNotesCollection, v
HandyNotesCovenantSanctum, vv15
HandyNotesDarkSoilTillers, v1.15
HandyNotesDirections, v1
HandyNotesDraenor, v2.8
HandyNotesDragonflight, v2
HandyNotesDungeonLocations, v1.54
HandyNotesFerryNetwork, vv1.3.3
HandyNotesLegionClassOrderHalls, vv1.48
HandyNotesLegionInstanceWorldQuests, vv1.33
HandyNotesLegionMagePortals, v2.1
HandyNotesLoosePebbles, v1.10
HandyNotesMistsOfPandariaTreasures, vv23.1
HandyNotesNetherwingEggs, v1.11
HandyNotesNooksAndCrannies, v
HandyNotesOribos, vv20
HandynotesPandaria, v1.5.4
HandyNotesShadowlands, v48
HandyNotesShadowlandsTreasures, vv71.2
HandyNotesSpringfurAlpaca, v1.07
HandyNotesStygia, vv90207.0
HandyNotesTimelessIsleChests, v1.24b
HandyNotesTravelGuide, vv2.12.0
HandyNotesTreasureHunter, vv29.1
HandyNotesValdrakken, v0.0.1
HandyNotesWorldMapButton, v100000.02-Retail
HandyNotesWrathOfTheLichKing, vv7.2
HHTD, v2.4.9.13
IcyVeinsStatPriority, v2022-10-30
MountCollector, v2.5.2
MythicDungeonTools, v4.0.1.1
Postal, vv3.8.2
Quartz, v3.7.0
RaiderIO, v10.0.0 (v202210300600)
RaiderIODBUSF, v
RaiderIODBUSM, v
RaiderIODBUSR, v
RareScanner, v10.0.0.3
Simulationcraft, v10.0.0-1
Stubby, v9.1.BETA.5.4 (OneMawTime)
Titan, v6.00.04.100000
TitanBag, v6.00.04.100000
TitanClock, v6.00.04.100000
TitanGold, v6.00.04.100000
TitanLocation, v6.00.04.100000
TitanLootType, v6.00.04.100000
TitanPerformance, v6.00.04.100000
TitanRepair, v6.00.04.100000
TitanVolume, v6.00.04.100000
TitanXP, v6.00.04.100000
VuhDo, v3.142
VuhDoOptions, v3.142
WowUp, v1.0.14
wowupdataaddon, v1.0.14
BlizRuntimeLib_enUS v10.0.0.100000 <none>
(ck=c0b)

Rollback Post to Revision RollBack
Taraezor
- Location: Sydney
- Join Date: 11/17/2012
- Posts: 6
- Member Details
#1043 Taraezor

View User Profile

Send Message

Posted Oct 29, 2022
When in my Garrison I wanted to open a large crate of salvage (item 140590) in my bags. Game asked me to disable Handy Notes due to a conflict. This has happened a couple of times on separate play sessions. After disabling HN I was able to open my salvage crate. A subsequent return to the Garrison, in order to duplicate the error lol, did NOT elicit an abend message. I had not logged out but I had done numerous /reload in the interim for unrelated reasons. With a fresh login from within the Garrison I was still not able to duplicate the error.

Edit: Fairly reliable here: Enter a new zone as a druid. Select Travel Form from the hotbar. Bingo. "HandyNotes has been blocked from an action only available to the Blizzard UI. You can disable this addon and reload the UI.". A /reload does the trick.

Last edited by Taraezor: Oct 29, 2022

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.