Maintainer: Telic <telic@hotmail.co.uk>
Original code: Sir.Bender <Meog on WoW Forums>
Contributors:
ciphersimian
... and MANY others whose names didn't appear in the code anywhere
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.
/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 (Fan's Update)
=======================================
Changes in v5.14.30000 from v5.13.30000
=======================================
- attempt to stop new notes being turned on as Mininotes by accident
=======================================
Changes in v5.13.30000 from v5.12.30000
=======================================
- fix to slash command handler
"Sorry about that now." - Dougal looks sheepish
- update to TomTom and Cartographer pointer support
=======================================
Changes in v5.12.30000 from v5.11.30000
=======================================
- fix to some legacy slash commands which were not toc 30000 compliant
- datafix script for users who fell foul of the legacy slash command bug
/script MN_IntegrityCheck()
- option to set MapNotes as Cartographer Waypoint arrow from note right click menu (Beta functionality)
- option to set MapNotes as TomTom arrow from note right click menu (Beta functionality)
=======================================
Changes in v5.11.30000 from v5.10.30000
=======================================
- introduced a way to import Cartographer notes
Log in with both Cartographer2 & MapNotes;
Execute the following slash command script;
/script MapNotes_ImportCarto()
NOTE: sorry, but this may only work on an English client
(alhtough it should be safe to try it on other clients;
it just might not do much)
=======================================
Changes in v5.10.30000 from v5.02.30000
=======================================
- added option to the basic menu's Special options to toggle the display of MapNotes notes
IF YOU CAN'T SEE YOUR OLD NOTES DO THE FOLLOWING :
Ctrl-Right click on the World Map
Mouse over the "Special" button
The "Show Notes" option should be checked in order to see notes.
If it isn't then click on it to toggle note display On.
- now includes a companion "MapNotesBrowser" AddOn
Open up the Note Browser frame by Control-Right-Clicking on a note frame like the World Map.
Then select the new menu item "MapNotes Browser"
A scroll list of notes within the current zone sorted alphabetically.
Filter listed notes via the provided text box.
Mouse over notes to highlight them on the map.
Right click to open the standard MapNotes right click menu to edit, delete, track notes via the Minimap.
Left click to bookmark a particular note, highlighting it on the map, and setting it as a Mininote.
When you have bookmarked a note, a red arrow in the top left of the frame will appear.
Mouse over the bookmark to see the note tooltip.
Left click the bookmark, and if made on a World Map, then the map will change to show the map with that note.
Right click to clear the bookmark.
Also allows you to carry out global searches for notes containing certain text, via the 'All Maps' button.
If you carry out an 'All Maps' global text search, then left clicking on World Map notes in different zones will open up that particular map.
This map changing feature only works with world map type notes, and not for custom-map AddOn notes.
(Disable from the AddOn screen before logging in if not required)
- added note location details to note tooltips
- fix to 1916 error when opening note edit frame by Ctrl-Alt-Right clicking
- fix to some note creation messages
Changes in v5.02.30000 from v5.01.30000
=======================================
- fix to prevent the taint of unit drop down Focus & ClearFocus buttons
- fix to make sure new notes are set as Mininotes if holding down the CONTROL key when Creating from right click menu
- manual fix available for re-positioning of Stormwind City notes
ONLY EXECUTE THE FOLLOWING SLASH COMMAND IF YOU NEED -ALL- OF YOUR STORMWIND CITY NOTES ADJUSTING
Your Stormwind City note positions will be scaled and shifted to account for the new city map
/script Stormwindy()
You should receive a message in the chat frame informing you of the number of notes that have been adjusted.
This fix will place old notes closer to where they should be on the new map, but I can't guarantee they will be EXACTLY where you want them.
Remember that it is easy to fine tune your MapNotes icon positions via the following MapNotes feature :
Hold down CONTROL & ALT and left-click drag your notes to move them, and leave them exactly where you need them.
- note icons now displayed in tooltip
(Of some use when mousing over closely packed notes (with different icons))
- some code clean up of globals, and consolidation of Tooltip display in to a single function
- some compatibility changes for new MapNotes Browser frame companion AddOn
Changes in v5.01.30000 from v5.00.30000
=======================================
- fix to stop Minimap coordinates reappearing the next time you log in, when disabled
- fix to some slash command issues
Changes in v5.00.30000 from v4.16.20400
=======================================
- updated for WoW v3 and WotLK
MAJOR UPDATE - compatible with older versions of MapNotes
- updated look and feel with new Menus, Frame styles, and map Icons and note highlighting
(Note : if you wish to revert to the old MapNotes icons,
then please use the included "MapNotesIconsLib" AddOn to change back
to your old, legacy icons.)
- Right click menus can be raised by :
a.) CTRL-Right clicking on the World Map, or plugin frames like AlphaMap
b.) Right clicking on the Minimap Coordinates
c.) Right clicking on the MapNotes themselves
d.) CTRL-Right clicking on Minimap notes
- new menu options such as Cut, Copy, Paste, Mass Delete
Mass delete by text or Creator across ALL maps by Right clicking on Minimap Coordinates
Mass delete by text or Creator in one specific map by CTRL-Right clicking on the map
- support for 0, 1 or 2 decimal point formatting of coordinates controlled via a slider
on the Options frame
- MapNotesIconLib now packaged with MapNotes for a greater selection of note icons
(Please see the Readme.txt file in that AddOn's folder for more details)
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?
/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?
I'll have a look at the tomtom arrow error - should be fixable.
As for the note filtering by creator options, they were there in the original AddOn when I took over development, roughly 3 years ago, so this 'issue' has been around since then too
I guess its a question of how best to treat blank creators - notes that should be filtered, or notes that should always appear valid no matter what the creator filtering...
Perhaps the original author thought that people would not be interested in both types of options - either they would blank the creator and not be interested in creator filtering, or they would like the filtering and always leave the creator to default in...
To be fair, it is behaving as you might expect - a blanked creator is basically a way of flagging 'not created by me'...
It would be as simple for me to make blank creators always appear as valid notes to be displayed as it would to stop editing of the creator field...
Originally posted by Telic I'd love to test, but I'm restricted to releasing a pre-developed version of MapNotes retrieved from an SVN for the time being...
Couple of things to check however -
There are 2 checkboxes on the MapNotes Options frame to do with displaying notes created by the player / displaying notes created by other players - I'd make sure to see if you are filtering some notes ?
It's possible that these options are set OK for you, but are behaving oddly when the creator is left blank.... so let me know.
Thanks,
Telic,
Yea I was filtering the showing of notes by other characters and by removing the creator, it treated as another character had made it. So once I removed the filtering of that, my old note I made showed up. I'd almost say to not make the creator optional and make it default to the current character making it and have it where it can't be changed by someone. I say this cause what's the idea behind having it be optional when if we remove it, it treats it like someone else made it? Anyway, just my 2 cents, love the addon and thanks for all the hard work you put into it.
)