Original code: Sir.Bender <Meog on WoW Forums>
Contributors:
ciphersimian
... and MANY others whose names didn't appear in the code anywhere
***********
Description
***********
Adds a note system to the WorldMap helping you keep track of interesting locations.
MapNotes(Fan's Update) also provides a Plugin interface for other AddOns to take advantage of the note making ability. AlphaMap(Fans Update) uses this interface to allow Note creation on AlphaMap Maps of Instances, BattleGrounds, and World Boss Maps. This version of MapNotes comes with in-built support for creation of notes on Atlas maps, also using this Plugin interface.
For these purpose MapNotes offers the following main functions:
1. Marking notes on the WorldMap
2. Showing one of these notes on the MiniMap (see MiniNote)
3. Allows any other AddOn to use MapNotes note creation ability to mark notes on frames within their own AddOn :
- Marking notes on AlphaMap (Fan's Update) Instance maps
- Marking notes on Atlas maps
"/tloc" can be used to toggle this AddOns minimap coordinates instead of Thottbott's minimap coordinates.
NOTE : PLEASE still use "/mn -tloc xx,yy" to place a Thottbott marker on the map. "/tloc" ONLY toggles Minimap Coordinates.
Should be compatible with both Cartographer, although you may no longer be able to create notes on the map with the in-built functionality provided by that AddOn - only with the functionality provided by MapNotes (Fan's Update).
********
Features
********
[Slash Commands] - NOTE : See separate file "LegacySlashCommands.txt" for old style commands
================
/mapnote OR /mapnotes OR /mn
Use without any other parameters to see which version of MapNotes is installed, and access the list of available Slash Commands.
Otherwise can be used to insert a Map Note by a slash command (which you can create in the Send Menu), for example, to put a note at the Entrance of Stormwind City on the map Elwynn Forest:
NOTE: The above would all be on one line Description of the identifiers:
k<#> - Key based on the map name from GetMapInfo() prefixed by "WM " (English name on all clients - never localised) Varies for other AddOns using the Plugin functionality
x<#> - X coordinate, based on the GetPlayerMapPosition() function
y<#> - Y coordinate, based on the GetPlayerMapPosition() function
t<text> - Title for the MapNote
i1<text> - first line of text displayed under the Title in the MapNote (Info 1)
i2<text> - second line of text displayed under the Title in the MapNote (Info 2)
cr<text> - Creator of the MapNote
i<#> - icon to use for the MapNote, AddOns/MapNotes/POIIcons/Icon#.tga
tf<#> - color of the Title, AddOns/MapNotes/POIIcons/Color#.tga
i1f<#> - color of the Info 1 line (colors as above)
i1f<#> - color of the Info 2 line (colors as above)
mn<1> - (optional) If included, then a value of 1 will set the note as a mininote also. Any other value and the note will NOT be set as a mininote.
/mn -allow OR /mn -a
Allows you to receive the next note, even if you have disabled receiving in the options. If invoked with no parameters, it will toggle the current state.
/mn -automini
Shows the next note created (using any method) as a MiniNote and also puts it on the WorldMap. If invoked with no parameters, it will toggle the current state.
/mn -allmini
Toggle all MapNotes off/on as Mininotes
(Keybinding also available)
/mn -nextmini
Shows the next note created (using any method) as a MiniNote and also puts it on the WorldMap. If invoked with no parameters, it will toggle the current state.
/mn -minionly
Like the previous command, but doesn't put the note on the WorldMap.
/mn -minioff
Turns the MiniNote off.
/mn -tloc tbX,tbY
Sets a "Thottbot location" on the map. Use it with no arguments to toggle it off.
See the Section on Formatting of X,Y Coordinates
/mn -q [icon] [name]
Adds a note at your current location, icon and name are optional (icon any number from 0 to 9, AddOns/MapNotes/POIIcons/Icon#.tga)
If no [name] is passed, then the Note will be named based on the MiniMap Text, and the second/third lines will be populated with more zone information and/or the default QuickNote text.
/mn -qtloc xx,yy [icon] [name]
See the Section on Formatting of X,Y Coordinates
Adds a note on the map you are currently on at the given thottbot location, icon and name are optional (icon any number from 0 to 9, AddOns/MapNotes/POIIcons/Icon#.tga)
NEW SLASH COMMANDS IN MapNotes(Fan's Update)
/mn -s [search text]
If you want to search for a note, to see if one exists, or where it is, then you can use this command, and MapNotes will print out a report in the chat window, displaying the names of all maps which have a note containing that text
/mn -hl [note name]
If you have lots of notes and want to clearly identify a single one on a map, or if you want a certain note to remain highlighted, then use this command and they will be displayed with a green circle around them.
If there are several notes with that name or containing that text, then they will ALL be highlighted.
The note name does not have to be case sensitive, and doesn't have to be an exact match - all notes containing the [note name] text will be highlighted.
If the EXACT NAME is specified (not case-sensitive), the note will also be marked as a MiniNote on the Minimap
/mn -mapc
Toggle the display of Player and Cursor Coordinates on the World Map
Control-Left-Click and drag the coordinates to move them to a different position on the World Map if you are not happy with the default.
/mn -minic
Toggle the display of Player coordinates below the Minimap.
/mn -t [icon] [name]
Creates a quicknote at the Player's current location if the Player has no target.
If the Player does have a target, then it will create a note for that target at the Player's current location, icon and name are optional (icon any number from 0 to 9, AddOns/MapNotes/POIIcons/Icon#.tga)
/mn -m
Creates a note for the Player's target at the Player's current location.
OR Merges the details for the Player's current target in to a Map Note that has already been created at the Player's current location.
MUST have targetted a Player/NPC/Mob for this to work.
/mn -scale [0.5 - 1.5]
The size of MapNotes Menus and Frames are now fixed no matter what the scale of the World Map or other AddOn Map being used.
This command can be used to change the default size of MapNotes Menus and Frames if the user finds it too small or large.
The default value is 0.7
Therefore "/mn -scale 1.0" will make the Menus and Frames appear larger than they do by default.
/mn -undelete
Will undelete the last deleted MapNote.
IMPORTANT NOTE ON THE IMPORT FUNCTIONS BELOW
All of the functions below are mainly designed for people who have just installed MapNotes (Fan's Update). If you have been using this version of MapNotes for some time already, and have your own notes, then these functions may overwrite your existing notes. YOU HAVE BEEN WARNED.
/script MapNotes_ImportCarto()
NOTE: only works with English localisation currently
If you want to move from Cartographer 2 to MapNotes, then log in to the game with both AddOns enabled, ust the above command, after which you will receive notification in the chat window on how many notes have been imported.
/MapNotes_Import_MetaMap
If you want to move from MetaMapNotes to MapNotes, then log in to the game with both AddOns enabled, use the above command, after which you will receive notification in the chat window on how many notes have been imported.
/MapNotes_Import_AlphaMap
If you have AlphaMap installed, and want to convert the in-built Instance and World Boss notes in to MapNotes notes, then use the above command, and you will see a message in the chat window informing you of how many notes have been imported in to MapNotes.
This does NOT import Battleground notes by default, as AlphaMap's in built Battleground functionality works best without MapNotes overlaying the BG Objectives.
NOTE: You don't have to import notes from AlphaMap, to make MapNotes on AlphaMap Instance/Battleground/WorldBoss maps. You can create any notes you like manually.
/MapNotes_Import_AlphaMapBG
As mentioned above, the basic "/MapNotes_Import_AlphaMap" command does not import Battleground notes by default. If you do want to import AlphaMap Battlegournd map notes, then use this command to do so.
/MapNotes_Import_CTMapMod
If you want to move from using CTMapMod to MapNotes (Fan's Update), then log in to the game with both AddOns enabled, use the above command, after which you will receive notification in the chat window on how many notes have been imported; Then log out, and disable CTMapMod.
[Key Bindings]
==============
QuickNote/TargetNote
--------------------
Creates a quicknote at the Player's current location if the Player has no target.
If the Player does have a target, then it will create a note for that target at the Player's current location.
-OR CLICK MINIMAP COORDINATES-
If you are NOT targetting anything, then ALT-Left-Click on the Minimap Coordinates to create a QuickNote.
If you are targetting something, then ALT-Left-Click to create a Target note with details about the current target at the PLAYER'S current location - you will be warned if you are too near to an existing note to create a new note.
(Slash Command "/mn -t" also available)
TargetNote/MergeNote
--------------------
Creates a note for the Player's target at the Player's current location.
OR Merges the details for the Player's current target in to a Map Note that has already been created at the Player's current location.
MUST have targetted a Player/NPC/Mob for this to work.
-OR CLICK MINIMAP COORDINATES-
If you are targetting something, then you may also ALT-Right-Click on the Minimap Coordinates if you wish to create a note for your Target at the PLAYER'S current location. However, if a MapNote already exists at Player's location, then the details will be merged with the existing note.
(Slash Command "/mn -m" also available)
- <Control>+<Alt>+Right-click on a MAP/FRAME to create a Quicknote at that point
- <Control>+<Alt>+Right-click on a NOTE to quickly go to the note Editing Frame
- <Control>+<Alt>+Left-clicking to drag NOTES to new positions
- <Alt>+Right-click on a NOTE to toggle it as a Minimap note
- <Alt>+<Shift>+DOUBLE Right-click on a note to quickly delete it.
- <Control>+<Shift>+Right-click will create a temporary blue Group note on a map
If created on a World map, then it will also be displayed in the Minimap for you to track
If in a Raid group, then the note will be shared with other Raid members who have MapNotes installed
Otherwise, if in a Party, then the note will be shared with the Party members who have MapNotes installed
Otherwise, its just your own quick temporary marker
Change Log - MapNotes
=======================================
Changes in v5.16.30200 from v5.16.30100
=======================================
there's a README.txt file in the MapNotesIconLib folder that explains exactly what you need
It's a small file, and the bit your interested in is quickly explained in point 1 of the Advanced Use section.
HOWEVER, I do recognise that some people don't want to learn about MapNotesIconLib when the ONLY thing they want to do is get back to the original icons; So I have published a little patch called "MapNotesOriginalIcons" which you can install in order to replace the new default icons, with the originals.
This 'patch' addon is in the 'Optional Files' Tab on the MapNotes AddOn page.
It should be unzipped like any other AddOn in the /Interface/AddOns folder, and should be allowed to replace existing files.
Because it does NOT contain any .toc or .lua files, it probably will NOT be recognised by automatic site installers as a 'proper' AddOn - so you will probably HAVE TO INSTALL IT MANUALLY.
Have fun
Telic,
Quote:
Originally posted by tattooedpierre I hope this is not a completely dense question... but.. I've been using this great addon for ages and there were (relatively) recent changes to the default display of icons.
Now there is a secondary addon MapNotesIconLib which appears to manage icon packs, however, try as I might I cant get MapNotes to revert back to the original icons (before there were icon libs; legacy I believe they're called now).
As far as I know, GetPlayerMapPosition() only works for certain kinds of 'unitid', because Blizzard wanted to make sure people couldn't develop complex range checking mods. In particular, I'm pretty sure it won't work for "target" - and I'm even more certain it doesn't work when the target is an NPC.
GetPlayerMapPosition() does work for Raid and Party members I think e.g. 'raid29', etc.
However, this functionality was developed for marking NPCs mainly - because their positions are static more often than not; And I'm not gonna change it just for Raid and Party members who won't be standing still for long
Now, perhaps things have changed, and if Blizz have now updated GetPlayerMapPosition() so that it works on NPCs, then let me know and I'll re-consider the situation
Quote:
Originally posted by Durotan Greetings,
I would like to make a suggestion changing the "mn -t" command for notes on a target at the target position.
At the moment "/mn -t" does it on player position with infos about the target (eg. Name).
maybe it's possible to change it in this way:
if i have no target -> do it based on GetPlayerMapPosition("player")
if i have a target -> do it based on GetPlayerMapPosition("target")
Therefore, it's not necessary to stand next by the target to get the coordinates/position
For me it seems slightly more logical with "mn -t(arget)"
Greetings,
I would like to make a suggestion changing the "mn -t" command for notes on a target at the target position.
At the moment "/mn -t" does it on player position with infos about the target (eg. Name).
maybe it's possible to change it in this way:
if i have no target -> do it based on GetPlayerMapPosition("player")
if i have a target -> do it based on GetPlayerMapPosition("target")
Therefore, it's not necessary to stand next by the target to get the coordinates/position
For me it seems slightly more logical with "mn -t(arget)"
I hope this is not a completely dense question... but.. I've been using this great addon for ages and there were (relatively) recent changes to the default display of icons.
Now there is a secondary addon MapNotesIconLib which appears to manage icon packs, however, try as I might I cant get MapNotes to revert back to the original icons (before there were icon libs; legacy I believe they're called now).
Right click on a MapNote and Set As Mininote from the right click menu.
Or
<Alt>+Right-click on a NOTE to toggle it as a Minimap note
There are also check boxes for controlling Mininotes on the Options frame.
Quote:
Originally posted by Drakah How do I get to show the notes i have on the worldmap to also show on the minimap? I checked options and dont see anything.
I was wondering more about which version of Cartographer you were using in terms of version 3 (i.e. the new Google Map style one...) or version 2 the (i.e. the 'legacy' one...)
I was only trying to support the legacy style version 2 ... but as different people seem to be resurrecting it, I'm not sure I can guarantee compatibility - but I will take a look at the version you mention.
I now understand what you mean by hooked - I guess I'm just more used to people saying ticked or checked
Finally, I hope you weren't thanking me in advance for an Export feature as I won't be writing one. It's not really in my interests to write it, whereas it IS in the interests of those mod authors to provide an Import feature from there side...
should i roll back to v2.3.6a ? (aka r2290 afaik. 1.12.2008)
b)
with "permaenabled by yellow hook" i tried to describe that :
The option to set a waypoint is greyed out, (instead of white and clickable).
Additionally in front of the grey line is a little yellow hook, usually used to confirm settings when u click something (in general).
so i called it 'permaenabled' (even though it doesnt work), since the hook is set, and the option is not toggleable.
but i guess, i should take a screenshot and upload it somewhere, pics > words
na, ur not supposed to do, neither do (i) expect anything. the difference is , u seem to be active and know the format of both, cartographer and metamap. So its in 'melee range' to suggest that, since the 'proc' chances are highest here (to stay in wow terms
should i roll back to v2.3.6a ? (aka r2290 afaik. 1.12.2008)
b)
with "permaenabled by yellow hook" i tried to describe that :
The option to set a waypoint is greyed out, (instead of white and clickable).
Additionally in front of the grey line is a little yellow hook, usually used to confirm settings when u click something (in general).
so i called it 'permaenabled' (even though it doesnt work), since the hook is set, and the option is not toggleable.
but i guess, i should take a screenshot and upload it somewhere, pics > words
Quote:
p.s. now I'm supposed to write an Export feature too
Jeez, how about the authors of those mods do some share of the work and write their own Import features
na, ur not supposed to do, neither do (i) expect anything. the difference is , u seem to be active and know the format of both, cartographer and metamap. So its in 'melee range' to suggest that, since the 'proc' chances are highest here (to stay in wow terms
Sorry, but I'm really not sure what the following means :
Quote:
...and "permaenabled" by a yellow hook...
p.s. now I'm supposed to write an Export feature too
Jeez, how about the authors of those mods do some share of the work and write their own Import features
Quote:
Originally posted by coldsun When i use mapnotes in conjunction with cartographer (and TomTom), the Option to set a waypoint/arrow for a note is greyed out and "permaenabled" by a yellow hook - but there is no arrow for that note.
Same happens with only Cartographer loaded.
Id really like to use mapnotes since i can import stuff from metamap and cartographer. But its useless if i cant set waypoint arrows on notes.
Tried the latest version 5.14.3000
thx in adance
p.s a notes EXport to metamap/cartographer would be cool too, so its not a one-way decision what note addon a player uses.
When i use mapnotes in conjunction with cartographer (and TomTom), the Option to set a waypoint/arrow for a note is greyed out and "permaenabled" by a yellow hook - but there is no arrow for that note.
Same happens with only Cartographer loaded.
Id really like to use mapnotes since i can import stuff from metamap and cartographer. But its useless if i cant set waypoint arrows on notes.
Tried the latest version 5.14.3000
thx in adance
p.s a notes EXport to metamap/cartographer would be cool too, so its not a one-way decision what note addon a player uses.
Originally posted by bitechu Is there a way i can get a package of pre made notes, i.e. horde/ally towns and FPs, uhm... thats all i can think of now. Oh, and i have been looking for something that inserts the level of the area/instance by the name like cartographer used to do. I am happy that there are instance pins in the map tho! lol
Try searching around for Ciphersimian's latest version of WoWKb - it should be working with MapNotes
Is there a way i can get a package of pre made notes, i.e. horde/ally towns and FPs, uhm... thats all i can think of now. Oh, and i have been looking for something that inserts the level of the area/instance by the name like cartographer used to do. I am happy that there are instance pins in the map tho! lol
Thanks for the extra info Dridzt - someone else pointed out that there was an error, but didn't say what it was
Perhaps I should say that I still don't have a PC to test with, and this release was finally retrieved from WoWInterface's SVN on Saturday (with no help from site staff I might add )
I released it cos it had an important fix for legacy slash commands that I remember working but I guess I left a debug message in
Sorry folks, I'll fix that asap,
Telic,
P.S. for those who are intereseted (probably zero) I'm currently working on a 10 year old Dell laptop running Windows Me, and replaying the original Thief game
Quote:
Originally posted by Dridzt /mn -t (which I use quite extensively) gives following error on 5.12.30000
Code:
[2008/11/22 21:00:05-5605-x1]: MapNotes-5.12.30000\MapNotes.lua:623: attempt to call global 'NuN_Message' (a nil value)
MapNotes-5.12.30000\MapNotes.lua:532: in function `value'
Previous version works ok.
Edit: most slash commands I tried error similarly.
Edit2: Guessing that it only errors for people that don't happen to have NotesUNeed too?
You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.
*Clicking the donate button above will take you to PayPal.com
*Clicking the donate button above will take you to Pledgie.com
)
