READ

NotesUNeed

___________________________________________________

NotesUNeed v6.35.20300 - Telic of Dragonblight (EU)
___________________________________________________


Sorry if you can't read some of this text easily, but this web site is bugged and won't display some standard characters :(




Feature-rich, searchable Notes database with many automated features, and additional NuN tooltips for viewing note details.

Make Contact Notes on other Players, or General Notes on anything else.

This AddOn is for making your own custom notes on players, and quests, and items, etc. and does not come with any pre-made notes.
It does provide an Export and Import Feature for sharing of sets of notes, or publishing of note databases.

There is no longer an "Alternative" version of NuN, and the default Modifier keys for creating notes from Container Items and Hyperlinks is now simply "<Alt>-Left Mouse Click". For anyone unhappy with this key-Combo, then they can now specify their own via the NotesUNeed Options frame.

Below is a summary of NotesUNeed functionality, but you should read the Readme.txt file for much more detailed discussion on these subjects.


Main Features of NuN
--------------------

1.) Create Player Notes (aka Contact Notes) :
- Create Contact notes :
a) using new NuN buttons in the Friends Frame
b) using the NuN Micro Buttons described in point 3
c) using slash commands
d) via new NuN options in the player context menu
e) Or via any of the automated methods mentioned below
- NuN can auto-populate many details about race, class, guild, etc.
- Also add your own free Text notes
- auto maintain Friend / Ignore Lists across different Alts
- auto-note people you Party with
- auto-note Guild members
- auto maintain notes on your own Characters plus Levelling notes
- Rate Players via Right click menu and see that Rating in Tooltips
or tagged to Player Names in Chat

2.) Create General text notes on anything you like :
- Create General notes :
a) via the Micro Buttons in point 3 below;
b) via slash commands;
c) use the NuN Modifier when clicking on Container Items or Hyperlinks
(Default "<Alt>-Left Mouse Click" but can be changed in Options)
d) importing from a Plugin database
e) receiving notes in-game from other NuN users
f) Or via any of the automated methods below
- Options to auto maintain Quest Notes which will save a few kinds of notes
a) Quest notes that record quest details plus Quest Giver name and location
b) Quest progress notes which record location when completing quest objectives
c) Quest History detailing when a given Toon Accepted, and Completed quests
- General notes can be saved at Account or Realm level
- Scripting - LUA scripts can be executed from General notes by :
a) Using the Run Script button in the frame
b) Slash command "/nun -x <NOTE_NAME>"
c) Execute one NuN Note from another NuN Note with the following command :
NuN_ExecuteNote("<Note Name>")
- General notes can be assigned the following Types for easy searching :
a) ITM - Item notes
b) QST - Quest notes, and quest objective notes
c) NPC - Notes made on NPCs and Mobs
d) LOG - NotesUNeed records Transmission logs when you send/receive notes
e) LUA - Keep your own in-game scripts library and execute notes like Macros
f) - or just leave blank ;p

3.) NuN has a MicroButtons panel with 4 buttons for quick access to features.
This frame can be moved by dragging the small border surrounding the buttons, and can be hidden if not needed (see slash commands). From left to right the buttons are :
- Options : toggle the NuN Options frame
- Note Browser : toggle the NuN Note Browser frame
<Alt> Left Click to browse General notes only
Right Click to browse Quest History
- Contact Note : create a note for the current target
will create a General note if current target is an NPC
<Alt> Click to re-open the last opened Contact Note
- General Note : create a General note
will create an NPC note if current target is an NPC
<Alt> Click to re-open the last opened General Note

4.) Note Browser Window.
This is where you can view the list of notes you have :
- default sorting is your Faction, then Opposing, then General Notes
- search for notes containing text you specify in the edit box
a) Left click : Case insensitive search
b) Right click : Case sensitive search
- filter visible notes from the Options Frame
e.g. to only show Quest Notes, or NPC Notes
- a tick indicates a General note is saved at Account level
- hover over a note to see its contents in a Tooltip
- Right-Click to open the sticky NuN PinUp Tooltip
- <Shift>Left-Click to paste the note name in to open chat box
- After filtering and searching to narrow down the visible set of Notes, you can :
a) Mass delete those listed in the browser frame
b) Export listed notes for other players to install and Import

5.) Options frame - open via the Microbuttons or slash command "/nun"
Configure NotesUNeed here, or filter the notes to appear in the Note
Browser frame. For example, to just look at NPC notes, or browse
Quest History for one of your Toons

6.) Backup and Restore functionality to save your database
This functionality is kept in separate LoadOnDemand AddOns to save memory.
Both the Backup and Restore processes will execute a ReloadUI()

7.) Import and Export of notes Databases
Share sets of notes with friends, or publish notes databases as a Plugin
for others to Import

8.) Broadcasting & Sending of NotesUNeed Notes
Broadcast Raid Instructions for Boss enchounters or PvP strategy, or
just your enchant selling menu; Or send formatted notes for other
NotesUNeed users to add to their database.


** -- SEE THE ENCLOSED README.TXT FILE FOR FURTHER DETAILS -- **
** -- ON THE ABOVE FUNCTIONALITY LIST -- **

______________

Slash Commands
______________

/nun : Toggles the NotesUNeed Options window

/nun -h : Displays this list of Slash commands

/nun <note title> : Will attempt the following :
1. Fetch a saved Contact note with that name
2. Fetch a saved General note with that title
3. Create a new Contact note if a player of that name is in your party/raid group or is within target range
4. Toggles the NotesUNeed Options window

/nun -t : Fetches the saved Contact note for the current target, or creates a new one, or shows your own characters note if no valid target. Since v2.00.1800, this command will create notes for NPCs and populate some basic information about them.

/nun -g : Creates a new General Note, untitled.

/nun -g <note title> : Fetches the existing General note with that title, or Creates a new General note with that title.

/nun -ch <name> : Create a Horde Player Character note for the given name without validating it
/nun -ca <name> : Create an Alliance Player Character note for the given name without validating it

/nun -tt : Toggle NotesUNeed Tooltips on/off

/nun -micro : Toggle the NotesUNeed Microbuttons panel hide/show

/nun -x <note title> : Tries to execute the specified note as a Lua Script. If no note exists, then will open the Note Search window

/nun -i <name> : to stop NotesUNeed trying to ignore a player

/nun -f <name> : to stop NotesUNeed trying to befriend a player

/nun -resetlists : to reset NotesUNeed's Friend/Ignore lists to those of the currently logged Alt

/nun -purgeexport : to clear Exported records and allow the creation of a newly named set of records

/nun -delay [number of seconds] : transmissions to channels have a default delay between each line being sent of 0.33 Use this slash command to change this value. Will report the current value if you do not pass any seconds value.

/nun -restrictwho : stops NuN from automatically trying to gather /who information


Slash Commands for Sending Messages
-----------------------------------

/nun -sendG "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends General type note text

/nun -sendGF "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends General type note as Formatted text

/nun -sendC "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends Contact type note text

/nun -sendCF "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends Contact type note as Formatted text

where -
"NOTE_NAME" = the name of the note or note title
"SEND_METHOD" = how to send the note e.g. "GUILD", "RAID", "WHISPER", "CHANNEL", etc.
"SEND_PARAMETER" = Optionally required (i.e. who to WHISPER to -OR- the Channel ID/Name)
NOTE: using any of these slash commands will close any currently open note.

Patch notes for NotesUNeed
Changes in v6.35.20300 from v6.31.20300
---------------------------------------

- can now customise the Player Ratings.
Open up any Player note;
Click on the Player Rating DropDown button;
&lt;Control&gt;-Click on any Player Rating button to change it via 2 dialog boxes :
Box 1 allows you to change the Player Rating text
Box 2 allows you to change the Tooltip text
&lt;Alt&gt;-Click on a Player Rating button to reset it (and the tooltip) to the NuN default value

- compatibility changes to work with the &quot;Black List&quot; AddOn
When customising Player Ratings using the technique described above, then checkboxes will allow you to specify whether that Player Rating should also Black List the player;
A further two check boxes allow you to specify whether the black listed player should also be Ignored, or trigger a Warning.
Now when you select that Player Rating for a Player, then they will be automatically be added to the Black List AddOn database.
The Black List reason will be auto populated with the NuN Player Rating and Tooltip text.
If you select a different NuN Player Rating with different Black List criteria, then the Black List details will be updated in the background.
If you select a different NuN Player Rating with no Black List criteria, then the Black List details will be left untouched.
If you remove someone from your Black List, then their NuN Player Rating will be reset to blank if it can detect that the Player was Black Listed from NuN;
i.e. players Black Listed from NuN will have a reason for black listing pre-fixed with a purple NuN !
&gt; Black List AddOn : http://wowui.incgamers.com/?p=mod&amp;m=4926

- the Options Frame is now moveable

- the Options Frame and MicroButtons are now Clamped-To-Screen and can't be 'lost'

- fixed a small graphical problem on the Options frame



Changes in v6.30.20300 from v6.25.20300
---------------------------------------

- more information now recorded and displayed when auto-noting Party members
When hovering over the &quot;Parties : &quot; label on the Contact note, NotesUNeed will display a tooltip with the following information :
a.) Which of your Alts has partied with that player
b.) How many times that Alt has partied with that player
c.) The date on which that Alt last partied with that player

- Verbose Guild Reporting now 'toned down' a little, and now completely silent when turned off

- fixed a problem displaying the NuN Tooltip when using the &quot;Tooltip&quot; key word in the Contact note user definable buttons

- updated BG detection to prevent party member noting in Battlegrounds where parties can often be random with players from different Realms
(Parties pre-made before entering the BG obviously WILL be noted if the option is enabled)



Changes in v6.25.20300 from v6.05.20300
---------------------------------------

NEW FUNCTIONALITY IN LFM FRAME
- support for NuN Buttons on the Looking For More Frame

- new Tooltip support when mousing over players on the LFM Frame :
NotesUNeed will display an extra Tooltip to show Player Ratings for all party members you have noted



NEW FUNCTIONALITY TO COLOUR TEXT
- can now select your own text colours in notes via colour selection buttons on the note frames.
There are 5 Preset colour buttons, and one Custom colour button for opening the Colour Picker Frame to choose any other colour.
So simply, highlight the text you want to colour in and click on the colour you want.
You MUST highlight the text you want to colour by USING THE MOUSE.
(i.e. text highlighted by holding down the &lt;Shift&gt; key and using the keyboard arrows will not be coloured by NuN)

- Preset colour buttons
1.) Left click to apply the colour to highlighted text
2.) Right click to open up the colour picker and choose your own preset colour choice
3.) &lt;Alt&gt;-Right click to reset the preset colour to its default value

- Custom colour button
1.) Left click to open up the Colour Picker Frame and choose a colour.
NOTE that the colour is NOT applied to the text until you click the &quot;Okay&quot; button.
2.) Right click on the Custom colour button to Toggle the display of the colour Tags in the text. This ability should be useful when trying to see
NOTE : YOU CAN NOT USE THE BUTTONS TO COLOUR TEXT WHILE SHOWING COLOUR TAGS !!!
The Custom colour button will remember the last colour you chose (even between sessions).

- improved native support for manually entered colour codes
i.e. you can now type in your own colour code tags and they will be applied when you save the note
(e.g. &quot;colour the word |cff0000ffblue|r with the colour it describes&quot;)
General type Note names can also be coloured by manually applying colour tags.

PLEASE SEE THE &quot;Whatever you do DONT READ THIS.txt&quot; FILE FOR MORE DETAILS



NEW FUNCTIONALITY FOR NOTING ALTS
- can now include the names of People's Alts in their Tooltip.
Their Note text needs to include the name of their Alts in the format :
&lt;ALT:Altname1&gt;
&lt;ALT:Altname2&gt;
etc.

- with the Guild Frame Open, and a Players Note open, you can specify their Alts by :
&lt;Alt&gt;-Clicking on the other Guild member NuN Note symbols for Alts of that Player
This will paste the ALT's name in to the currently open Player note, where it will then be visible in the Tooltip for that Player



MISCALLANEOUS
- new Text box on the Transmit Note frame detailing the delay between messages, and allowing easy update of this value
NOTE that you have to press &lt;Enter&gt; or click on Transmit for the value in this edit box to be saved.
(Not all messages are sent with a delay e.g. Whispers, Party, etc.)

- included a checkbox for toggling NuN Microbuttons on the NuN Options frame

- Cosmos Feature Frame button for accessing NuN Options

- NuN Tooltips will now try to inherit the Alpha settings of the Game and WorldMap Tooltips to try and be compatible with other AddOns that change these settings

- fixed a problem when removing friends

- fixed a problem displaying Abandoned Quests in Red text

- code clean up and greatly reduced the number of Global and Local Variables

Please NOTE that if you have a note with old Hyperlinks that have been replaced by newer versions, then sending that note to another user or channel will cause you to disconnect from the server. For example, I have notes with details of PvP armour that were made before a recent wow patch upgraded the armour. The hyperlink is still semi-valid due to Blizzards bizarre policy; For example, it is still possible to see Tooltips for these items, and some coding functions still recognise them as valid - BUT if they are pasted in to a chat box, or sent via NotesUNeed notes, then you will be disconnected from the server

If you have trouble with NuN and frequent visible /who information requests, then use the following slash command :

/nun -restrictwho


download:
INPUT:admin

 
PRV:AutoInvite2
NEXT:
ABOUT NEWS