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.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)
Sorry to hear about your PC, that sucks. Hope you get things back up and running, not having a PC really blows. However, I had a question that hopefully someone can answer, why is it that when I go to create a note and if I take out the Creator which it says is optional, the note is never created? If I do leave in the creator though, the note is created.
sadly my computer has died, so I won't be able to release any fixes or updates any time soon.
There are new versions of MapNotes (Fan's Update) and AlphaMap (Fan's Update) on the SVN at WoWInterface.com but I can't access or promote them myself. I have asked a couple of site administrators there if they can help so I'm keeping my fingers crossed.
The AlphaMap update includes all the WotLK Instance maps, plus new dungeon location markers on the world maps and the ability to zoom between them via Alt-Clicking.
The MapNotes update includes a fix for users of legacy slash commands plus a data fix for affected notes :
If they have not been updated, please feel free to post a comment asking the site to help release them
Or add a forum post maybe
It could take some weeks for insurance to come through before I can get a new PC, so this is the ONLY route to getting the latest updates any time soon.
I think that with LightHeaded, some coords cannot be clicked because when a person leaves a comment on WoWhead, they may have written the coordinate incorrectly. I think the format has to be exactly one way or else it will not be clickable, but I have not used this addon in a long time.
__________________
I post as Avanina on wowace.com.
Originally posted by Telic The script wasn't intended to work the way you think - its for importing notes that have been permanently / manually created in your Cartographer database - I'm not sure how CQI is interacting with Carto, but I could look in to making MapNotes compatible with CQI. It depends what CQI is doing and how complex it is.
Strictly speaking, this should be handled from the CQI side to interact with MapNotes (although i'd be happy to supply specific functionality it requires). I'm not sure how willing CQI will be to do this however, as they have tied all their work to Carto, rather than broad compatibility.
Even if I do manage to get MapNotes to work with CQI, I still wouldn't really like to allow the sort of import you have requested, as I don't think it would be fair to the author of CQI who has put a lot of work in to providing the database, and probably wouldn't be happy to see another AddOn just copy all its data and then discard it - if possible, I might make them work together while CQI remains enabled; Thereby giving that AddOn its due credit.
Clear ?
Telic,
I know little about lua.....hehe..
I have read the source codes of CQI.
the questdata is in \data\quest.lua
it seems you can call the CQI:GetQuest func to get the quest.
but there are sth difficult to get the questdata:
as in CQI you should click the questlog, then the map would show the cords .
but using mapnotes, i think Telic would not do this job(click questlog show cords), it would should all the mapnotes on the maps... and that would be a mess....
Telic : Can you suggest some book about lua, I wanna study
Understood on all fronts, thank you for your clarification. I do not know how exactly CQI interacts with Cartographer, though I know Cartographer is a dependency. I would appreciate it if you could look into compatibility, though would understand if it was not possible.
It has been suggested that CQI be made to work as a standalone, or at least to provide compatibility with Mapster. However no direct response has been given, thereby leaving those of us interested to try and find alternate means.
__________________
I post as Avanina on wowace.com.
The script wasn't intended to work the way you think - its for importing notes that have been permanently / manually created in your Cartographer database - I'm not sure how CQI is interacting with Carto, but I could look in to making MapNotes compatible with CQI. It depends what CQI is doing and how complex it is.
Strictly speaking, this should be handled from the CQI side to interact with MapNotes (although i'd be happy to supply specific functionality it requires). I'm not sure how willing CQI will be to do this however, as they have tied all their work to Carto, rather than broad compatibility.
Even if I do manage to get MapNotes to work with CQI, I still wouldn't really like to allow the sort of import you have requested, as I don't think it would be fair to the author of CQI who has put a lot of work in to providing the database, and probably wouldn't be happy to see another AddOn just copy all its data and then discard it - if possible, I might make them work together while CQI remains enabled; Thereby giving that AddOn its due credit.
Clear ?
Telic,
Quote:
Originally posted by Sec I have posted this also on Cartographer_QuestInfo's comments section, as I am not sure which addon (MapNotes or CQI) is causing the problem.
Here are the steps I took, yet unfortunately they would not work.
1) Downloaded and installed Cartographer2, MapNotes and CQI.
2) Loaded the game and made sure those 3 addons were enabled.
3) Ran /script MapNotes_ImportCarto()
Now, after I do those 3 steps, I get a message in my chat box saying "<MapNotes>: 0 Notes Imported"
If I go through the CQI menu and show available and active quests, my map becomes full of ! yet if I run the script again, no notes are copied.
For some reason, it seems that MapNotes will not "copy" all of CQI's data.
I am using the English/US client of WoW; 3.0.2. My goal was to have MapNotes store all of Cartographer_QuestInfo's data so that I could use MapNotes+Mapster. As it stands, CQI+Mapster is a combination that will not work.
Is there some flaw? Is MapNotes working as intended, thereby meaning that this importing is not compatible?
I have posted this also on Cartographer_QuestInfo's comments section, as I am not sure which addon (MapNotes or CQI) is causing the problem.
Here are the steps I took, yet unfortunately they would not work.
1) Downloaded and installed Cartographer2, MapNotes and CQI.
2) Loaded the game and made sure those 3 addons were enabled.
3) Ran /script MapNotes_ImportCarto()
Now, after I do those 3 steps, I get a message in my chat box saying "<MapNotes>: 0 Notes Imported"
If I go through the CQI menu and show available and active quests, my map becomes full of ! yet if I run the script again, no notes are copied.
For some reason, it seems that MapNotes will not "copy" all of CQI's data.
I am using the English/US client of WoW; 3.0.2. My goal was to have MapNotes store all of Cartographer_QuestInfo's data so that I could use MapNotes+Mapster. As it stands, CQI+Mapster is a combination that will not work.
Is there some flaw? Is MapNotes working as intended, thereby meaning that this importing is not compatible?
__________________
I post as Avanina on wowace.com.
Originally posted by Telic - 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)
1. CQI: Cartographer_QuestInfo(Based on Cartographer) Available on wowi
2. QuestLibary: A addon using mapnotes and have its own database. (I guess)The main site is : http://wowbox.tw/bbs/viewtopic.php?f=84&t=12190 (Taiwan)
It seems the database of CQI is better than Questlibary.
The author is Alfred.
Personally, I didnot like Cartographer, I use Cartographer only for:
1. CQI.
2. Mining.
I am looking for a substitution for a long time....
However, I had a question that hopefully someone can answer, why is it that when I go to create a note and if I take out the Creator which it says is optional, the note is never created? If I do leave in the creator though, the note is created.
