MapNotes (Fan's Update)

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 purposes MapNotes offers the following main functions:

1. Marking notes on the WorldMap

2. Showing notes on the MiniMap (see MiniNotes)

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) maps

- Marking notes on Atlas maps

"/tloc" can be used to toggle this AddOns minimap coordinates instead of Thottbot's minimap coordinates.

NOTE : PLEASE use "/mn -tloc xx,yy"  to place a Thottbot marker on the map. "/tloc" ONLY toggles Minimap Coordinates.

Should be compatible with both Cartographer and MetaMap, although you may no longer be able to create notes on the map with the in-built functionality provided by those AddOns - only with the functionality provided by MapNotes (Fan's Update).

Download
http://cosmosui.org/addons.php

Plugins/Links
Utility for quickly entering notes where x,y coordinates are known :

QuickMapNotes

http://www.curse.com/downloads/details/7266/

Skinning AddOns that change the default Icons/TooltipColours used by MapNotes :

Neptunia's MapNotes Skin

http://www.curse.com/downloads/details/6544/

Baloor's MapNotesIcons

http://www.wowinterface.com/downloads/info6952-MapNotesIcons_baloor.html

Installation
Download the latest version and extract the archive in your "World Of Warcraft" folder.

Fast Note Creation/Editing/Deletion
- ++Right-click on a MAP/FRAME to create a Quicknote at that point

- ++Right-click on a NOTE to quickly go to the note Editing Frame

- ++Left-clicking to drag NOTES to new positions

- +Right-click on a NOTE to toggle it as a Minimap note

- ++DOUBLE Right-click on a note to quickly delete it.

(See also Key Bindings and Slash Commands)

First Steps
http://img24.exs.cx/img24/8453/click3.jpg

(The AlphaMap and Atlas Plugins use the same basic functionality as below)

-Right Click (On The Map)
Note : There are some slight differences between the original MapNotes and MapNotes (Fan's Update), but the pictures and instructions displayed in this section are virtually identical

Left clicking on the map (or the player icon) opens the Map Notes menu (see picture above - Nr 1), if the click has not implied a zone change. In this menu you will find 4 different buttons: This will open the Edit Menu and create a note at the position you clicked (clicking on the player icon results in the most accurate positioning of the MiniNote). If the MiniNote is enabled this is one way to turn it off. This opens the Options Menu. Closes the menu.
 * Create Note
 * Turn MiniNote Off
 * Options
 * Cancel

Additional note: A left click on a note also opens the menu, but "Create Note" won't be available. Clicking on the player icon may also result in "Create Note" disabled, if you are standing too close to an existing note.

Move The Mouse Over A Note
http://img122.exs.cx/img122/4505/tooltip.jpg

Move the mouse over a note to see the tooltip with the information you entered.

Right Click (On A Note)
Right clicking on a note opens the other Map Notes menu (see picture above - Nr 2). Right clicking anywhere else results in zooming out. Here you will find the following buttons: This button opens the Edit Menu to change the note you clicked on. Sets the note as the current MiniNote. Opens the Send Menu. Deletes the note without further questioning. Closes the Menu.
 * Edit Note
 * Set As MiniNote
 * Send Note
 * Delete Note
 * Cancel

Edit Menu
http://img122.exs.cx/img122/7923/edit1.jpg With this menu you can create new notes and edit existing notes. Additional note: The title field is mandatory, you cannot create a note without any title - to prevent this the "Save" button is disabled when the title field is empty. Click here to save the changes (or to create the note). Closes the Edit Menu and discards all changes.
 * 1) Select the icon style you want to use for your note.
 * 2) Insert a title in the editbox and select a color in which it will be displayed in the tooltip.
 * 1) Here you can insert additional information for your note and color it in one of the colors below the editbox.
 * 2) Same as Nr 3.
 * 3) Save
 * 1) Cancel

Options Menu
http://img122.exs.cx/img122/8360/options.jpg

NOTE : MapNotes (Fan's Update) Also includes sliders on the Options frame for controlling :

Frame Size

MapNote Icon Size

MapNote Alpha Setting

MapNotes (Fan's Update) also shows check boxes for displaying Player/Cursor coordinates on the Minimap and/or the World Map.

MapNotes (Fan's Update) can also be used to automatically create Landmark notes on maps to denote POIs - this is based on old Magellan functionality.

Here you can adjust how Map Notes behaves in different situations. Additional notes: "your character" means notes created by a character with the same name as the character your playing with. All other notes (also your notes created when logged in as another character) will be threatened as "created by other characters". Notes are only shown if you enabled them in 1. too. Additional note: You can override this option for one note by a Slash Command. In case the lower checkbox is checked Map Notes will decline incoming notes if they would leave less than 5 notes free. Additional notes: You can override this option for one note by a Slash Command. This checkbox is disabled if accept notes is turned off. Click here to save the changes and close the Options Menu. Closes the Options Menu and discards all changes.
 * 1) If the checkbox in front of an iconstyle is checked the notes of this style will be displayed, otherwise they will be hidden.
 * 2) Uses this options to specify if notes from your character should be visible and if notes from other characters should be visible.
 * 1) Uncheck these options to disable the red highlight of the last created note or the blue highlight of the note currently set as MiniNote
 * 2) Uncheck the upper option to prevent receiving notes from other players. All incoming notes will then be declined.
 * 1) Save
 * 1) Cancel

How To Use The MiniNotes
http://img122.exs.cx/img122/5038/mininote.jpg A MiniNote is a note placed on the minimap (see picture above). Moving the mouse over the MiniNote shows the title of the note.
 * To show one of your notes on the minimap goto the worldmap, right click on a note and choose "Set As MiniNote".
 * To hide the note on the Minimap, you can
 * goto the worldmap, left click and choose "Turn MiniNote Off".
 * use a Slash Command.

MapNotes (Fan's Update) allows the User to set multiple notes as Mininotes :D

Send Notes To Other Players
http://img122.exs.cx/img122/5454/send_cosmos.jpg After clicking "Send Note" in the Map Notes Menu the Send Menu (see picture above) will show up. Additional note: Targeting the player before opening the world map will auto insert the name. Choose this options to send the note to the player entered above. Additional note: This notes can also be received by Carto+ users. This will send the note to the entire party. (No player name needs to be filled in.) This will bring up the other send modes: Sends a note to another player using whisper (cannot be received by Carto+ users). Inserts a slash command in the editbox which can be highlighted and then copied to the clipboard. After this you can post it i.e. on a forum and other Map Notes users can insert this note by copying the slash command to the chatline. Closes the menu.
 * 1) Enter the name of the player you want to send a note.
 * 1) Send To Player
 * 1) Send To Party
 * 1) Change Mode
 * 1) *Send through whisper (picture):
 * 1) *Get Slash Command (picture):
 * 1) Cancel

Slash 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:

"/mapnote k x<0.320701> y<0.491480> t i1 i2<> cr i<0> tf<0> i1f<0> i2f<0>"

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 localized) 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 - Title for the MapNote

i1 - first line of text displayed under the Title in the MapNote (Info 1)

i2 - second line of text displayed under the Title in the MapNote (Info 2)

cr - 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 -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 targeted 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

Undeletes 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; Then log out, and disable MetaMap. Don't try to use MapNotes at the same time as MetaMap for any other purposes, as the results may be unpredictable

/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.

Formatting of X,Y Coordinates
The following formatting options apply to the "/mn -tloc xx,yy"  and  "/mn -qtloc xx,yy"  commands.

X and Y are in "Thottbot coordinates" which can be represented as follows:

local tbX,tbY = GetPlayerMapPosition

local tbX = math.floor(x*100)

local tbY = math.floor(y*100)

So basic formatting is "x,y"

e.g. "5,90"   OR   "55,49"    OR    "75,74"

MapNotes (Fan's Update) is quite forgiving about how coordinates are passed however, and you can use a space instead of a comma, or one or more spaces without a comma

e.g. "5, 90"  OR   "5, 90"   OR    "5   ,90"

MapNotes (Fan's Update) also allows for x and y coordinates containing decimal points.

e.g. "26.2443, 39.988"    OR    "26, 39.0"    OR    "25.0 0.9"

Since v3.30.20003, any non-numeric characters can be used as a separator

e.g. "29-50"   OR    "29x50.5"

Can now use the decimal point as a separator between the x and y coordinates e.g. "5.90"

NOTE: if using the decimal point as a separator between the x and y coordinates, then it is advisable to NOT use x and y coordinates that also contain decimal points - if you must use decimal points in the coordinates AND as a separator, then you should use a decimal point in BOTH the x and y coordinates

For Example :

"/mn -tloc 10.50.90.0"    will be correctly located at  '10.5, 90.0'

BUT if passed

"/mn -tloc 10.50.90"   then there's no way for MapNotes to know if you mean   10.5, 90   or   10, 50.9

Dependencies
NO Mandatory Dependencies - can be used as a stand alone AddOn.

Map Notes is optionally dependent on Cosmos. It uses Cosmos for one of the send options.

Counter Dependency: If you are using CTMod you will need to disable or delete CT_Mod's MapMod to use Map Notes. MapMod overrides it.

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 targeting anything, then ALT-Left-Click  on the Minimap Coordinates to create a QuickNote. If you are targeting 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 targeted a Player/NPC/Mob for this to work. -OR CLICK MINIMAP COORDINATES- If you are targeting 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)

FAQ
MapNotes (Fan's Update) was developed from a different version of MapNotes to the one previously found in Cosmos, and has some important differences that people should be aware of; Also some extra functionality that has been added that they should know about.

One thing that people should be aware of is that this version of MapNotes has changed the Keying system for notes, and no longer uses the Continent/Zone as a heading under which to save them. Your MapNotes should be automatically converted the first time you log in. This means that you can't use older versions of Magellan for example, which will still try to create MapNotes under the old Continent / Zone system, and you won't be able to send/receive notes with players using older versions of MapNotes. NOTE : This version of MapNotes includes Magellan functionality via a new checkbox on the Options frame.

Q01 - How do I make notes on the map now ?



A01 - - on the World Map to show the MapNotes menu from where you can Create a new note, or access the Options menu, etc. (The traditional methods of note creation via slash commands, or receiving from other users still work - note that you can only send/receive notes with other users of MapNotes (Fan's Update), and NOT to users of other versions of MapNotes.)

Q02 - The MapNotes in game help shows Slash Commands such as '/mn -q', etc. Can I still use the slash commands I'm used to such as '/quicknote' ?



A02 - Yes. I have introduced a new set of slash commands that I consider to be more consistent, but the legacy Slash commands are still available. If you need help on the Slash commands in game, I have added some Help messages - just type '/mn' on its own to see what version of MapNotes you are playing with, and what commands are available.

New slash commands all follow the form '/mn [-switch] [parameters, ...]'

But you can still use '/mn [MapNote]' to create a new note - see the Readme.txt file for details on how to format a [Mapnote] in order to create one from the command line.

Q03 - Can I still use '/tloc' to show coordinates under the Minimap ?



A03 - '/tloc' can still be used to toggle the display of coordinates under the minimap. There are NO other dependancies apart from MapNotes itself, and this command will display MapNotes' own coordinates whether or not you have Thottbott installed.

'/tloc' is basically identical to the new '/mn -minic' command for toggling minimap coordinates.

Q04 - Can I still use '/tloc xx,yy' to place a Thottbott marker on the World Map ?



A04 - No. Use either '/mn -tloc xx,yy' or '/mntloc xx,yy'. There are various reasons for why I separated the toggling of Minimap coordinates from the creation of a Thottbott Note - see separate posting for details.

Q05 - Is there a way to quickly create a note at my Players current location while I play ?

(i.e. without having to move away so that I can click on the part of the map that my Player arrow was obscuring...)



A05 - MapNotes (Fan's Update) provides several methods for the creation of Quicknotes :

1.) the original Slash command functionality; '/mn -q' OR '/quicknote'

2.) NEW slash command '/mn -t' will create a MapNote at the Players current location if you have nothing Targeted.

However, if you do have a target, then '/mn -t' will create a MapNote with details of your Target at the PLAYER'S current location. If you are too near to an existing MapNote, then you will be warned that no MapNote can be created.

3.) NEW slash command '/mn -m' will also create a MapNote based on the player's current Target, at the PLAYER'S current location.

However, if the player is too near an existing MapNote to create a new one, then the details of the current Target will be Merged with the existing MapNote.

4.) NEW Key-Binding added for the QuickNote/TargetNote ('/mn -t') command; And NEW Key-Binding added for the TargetNote/MergeNote ('/mn -m') command also.

5.) <Alt>-Left-Clicking on the MapNotes Minimap Coordinates will also execute the QuickNote/TargetNote functionality.

6.) <Alt>-Right-Clicking on the MapNotes Minimap Coordinates will execute the TargetNote/MergeNote functionality.

Q06 - The 'Turn Mininote Off' button is no longer available when I bring up the 'Create New Note' menu by <Control>-<Right Clicking> on the World Map. Also, when I type, '/mininoteoff' or '/mn -minioff', the current Mininote does not disappear.

What's going on ?



A06 - MapNotes (Fan's Update) now allows you to use multiple MapNotes as Mininotes that you can track via the Minimap.

You can still only use ONE Party Note OR ONE Thottbott marker - but you can turn on as many MapNotes as you like to use as Mininotes. This means that currently, the '/mn -minioff' command will only turn off Party/Thottbott Mininotes. Any mininote that is based on a permanent MapNote must be turned off by one of 2 methods :

1.) <Control>-<Alt>-<Left Click> on any Mininote on the Minimap to turn off that Mininote - this is probably the easies/quickest method. It will NOT delete the underlying MapNotes - just stop using it as a Mininote.

2.) Right-Click on the MapNote itself on the World Map, and choose the "Turn Mininote Off" option for that note.

(Note that when you use the "Set As Mininote" button for a MapNote, then the option automatically changes to "Turn Mininote Off" when you Right-Click that MapNote again.)

3.) Delete the underlying MapNote - extreme but it works.

Note : Yup, that's right, there is no global way to turn off ALL Mininotes at the moment - I didn't think it was necessary so far, as <Control>-<Alt>-<Left Clicking> the actual Mininotes on the Minimap is a quick easy way to turn them off...

Q07 - Is there an easy way to adjust the position of a Note, other than deleting it, and re-creating it in a new location ?



A07 - Map Notes can easily be moved to new locations by <Control>-<Alt>-Left-Click dragging with the Mouse.

Q08 - Can MapNotes show Player/Cursor Coordinates on the WorldMap ?



A08 - Use '/mn -mapc' to toggle display of Player/Cursor coordinates on the World Map. If you are not happy with the default location of the coordinates, you can <Control>-Click drag them to a different location, and they will remember where you drop them.

Q09 - Can the <Alt>-Click method of line drawing be used again ?



A09 - Yes. The toggling of lines between points by <Alt>-Left-Clicking each point has been fixed in this version.

Q10 - I want to be able to make notes on Atlas Instance maps



A10 - MapNotes (Fan's Update) comes with a Plugins Interface allowing it to make notes on Frames/Maps belonging to other AddOns. But the other AddOns need to use the MapNotes Interface. AlphaMap (Fan's Update) v2.62.11200 and later works with MapNotes (Fan's Update) so that you can create MapNotes on AlphaMap Battleground/Instance/WorldBoss maps in exactly the same way as you do on the WorldMap. MapNotes (Fan's Update) also comes with in-built support for the current version of Atlas, so that you can make MapNotes on any of the Atlas maps.

Q11 - I want to use MapNotes (Fan's Update) to make notes on the Naxxramas Dungeon map in AlphaMap, but nothing happens when I <Control>-<Right Click> on AlphaMap's Naxxramas map ?



A11 - Open up the Naxxramas map in AlphaMap; Open up the AlphaMap Options frame; Click on the first 'General' Tab, and make sure that the "Enable Map Notes" check box is checked. Make sure this option is checked for any map where you want to be able to make MapNotes in AlphaMap.