ItemInfo Readme

INTRODUCTION

ItemInfo by Nathanmx (nathan@executus)

This addon primarily does two things:
- shows detailed information about items (everything that one can possibly know about an item)
- allows you to create item links (fake items or existing items)

The first part of this addon is easy - getting information about links. All you have to do is type "/iinfo " and then shift-click a link into the chat edit box, and hit enter. The second part is also very easy - all you need is the id of the item you want to play around with and you can create that item link (even if you've never seen it before). You can also make up items, change their rarity, stats, enchants, who created them, and more. The details are explained more in-depth below.

UNDERSTANDING ITEMLINKS

Item links are actually just plain old text, but the game processes them in a special way so you can click them in the chat frame. In your chat frame they appear as, for example [Arcanite Bar], however it is actually more like this:

One of the things this addon does is create this kind of text from scratch so as to provide you with the link - even if you've never seen the item at all (and you can still link it your friends, etc). All you need to provide is the item id (in the sample above the id is 12360). You can also optionally add "fake" enchants to the item, or add suffixes like "of the Eagle" to the item and give the item additional stats. If you do it correctly, these "fake" items will still link perfectly to everyone.
You can also just for fun make up totally new item links like a legendary [Nathanmx's Worn Dagger of Leetness] ... but you won't be able to link those items to your friends (it will more than likely disconnect you from the server).

Now, creating item links is a very easy process. This addon does not work like lootlink where you can pick from a list of items to link. You'll need to do some research to create links. The upside is that this addon uses virtually 0 memory, is fast and clean. The downside is that it takes sligtly longer to make links, even though that's hardly a downside considering the power you have in the link creation process with this addon. Lootlink lets you relink items you've seen. ItemInfo lets you link ANY item (even if you've never seen it) and ADD stuff to it (like enchants, suffixes, and more). Also, one of the features of ItemInfo allows you to save items links between playing sessions. See below for more information on how to do this.

Note: ItemLink info is saved across sessions.

GUI OPTIONS

[X] Safe Mode - Checking this will prevent IINFO from querying the server
[X] Advanced Mode - This builds the link from scratch using pre-entered data via slash commands when you hit 'Create!'. Same thing as "/ilink adv".
[X] Verbose iinfo - Checking this sends all the iinfo about items to the chat frame. Otherwise, only the most important item information will be shown in the GUI.

The "Report" button tells you the values of the variables for creating item links, the "Clear" button clears those values, the "sLink" button shows you your currently saved links, and the "Inspect" button allows you to inspect your target from any distance (so you can shift-click their gear and whatnot*). The Safe Mode check box, if unchecked, queries the server for itemlink information if it is not found in your local cache (may result in a disconnect).

* Note that the Inspect feature has been changed and inspecting at any range is no longer easily possible. However, in upcoming versions the InspectFrame will NOT close when you move out of range, and later on you will be able to inspect players at any distance as long as another player has ItemInfo and can inspect them (their inspect data will be passed to you). And even further down the road, you will be able to inspect players of the opposite faction as long that player or a nearby opposing faction player (within inspect range) has ItemInfo.

COMMANDS LIST

ITEM INFO (find info about item links)
  Usage:

  /iinfo [itemlink] 	-- This will add info to the tooltip about the linked item.*
  /iinfo 		-- This will bring up the ItemInfo GUI. Enter in
			   an item ID and click "Create!" to create
			   the link for it (if it is in your local cache). 
  /iload [itemlink]	-- simply loads item data into iteminfo variables
	
	* If you /info an item link, all it's data will be kept so
	  that you can type /link and it will build that link without
	  any further work.

ITEM LINK (create item links)
  /item name <text> 	-- sets the name of the new item link
  /item color <text> 	-- sets the color of the new item link (gold, purple, 
  			   blue, green, white, gray, or a hexadecimal value)
  /item id <text> 	-- sets the id of the new item link
  /item suffix <text> 	-- sets the suffix id of the new item link
  /item unique <text> 	-- sets the unique id of the new item link
  /item enchant <text> 	-- sets the enchant id of the new item link
  /item gemX <text> 	-- sets the id for gemX, where X is a number from 1-4

  /ilink 	-- compiles the link using data solely from the item id
  /ilink adv 	-- compiles the link using data from the /item commands
  /ilink clear 	-- resets the values of the itemlink variables
  /ilink report	-- reports the contents of itemlink variablies

ITEM SAVE (for storing item links)
  /slink save [item link]	-- saves an itemlink so that you can easily
				   retrieve it later
  /slink clear		 	-- clears your saved item links
  /slink edit <text>		-- removes all instances of <text> from your 
  				   currently saved item links
  /slink show			-- shows all the item links you have saved

EXAMPLE
  Link Creation Basic Example (slash commands only):
  /item id 17182
  /ilink

  This will give you the link for [Sulfuras, Hand of Ragnaros].

Link Creation Advanced Example (slash commands only):
/item id 2073
/item suffix 1592
/item enchant 436
/ilink adv

This will give you the link for [Dwarven Hatchet of Power] that has +92 Attack power and +70 Critical Strike rating. Best of all, this item is completely linkable. ;)

LINK CREATION HELP

ITEM ID (/item id):
- They can be found at http://wow.allakhazam.com/ or http://www.Curse-Gaming.com/.
Allakhazam: Simply search for an item, click on the item when the search is finished, then find the "XML" link under it. In between <id> and </id> is the ID of that item.
Curse-Gaming: When you click on any item in the database, just check the URL of that page. It should say something like "http://www.curse-gaming.com/en/wow/items-XXXXX-YYYYYYYYY.html" where XXXXX is the item id and YYYYYY is the item name.

ITEM NAME (/item name)
Accepts: any value
- Just enter the item name. See Thottbot or Allakhazam if you can't remember how to spell it.

ITEM COLOR (/item color)
Accepts: any hexidecimal value, red, gold, purple, blue, green, white, gray, artifact, epic, superior, rare, uncommon, poor
- This just determines what color the item link will be. Notice you can also use a hexidecimal code instead of the color words and it will use that instead.

ITEM SUFFIX (/item suffix):
Accepts: an itemsuffix number
- This is the end part of the link that gives the item additional bonuses, like "of the monkey" or "of Shadow Resistance", etc. A list of suffix id's can be found here: http://www.wowwiki.com/API_TYPE_ItemString. Note that this only adds the stats to the item, it does not add "of the Monkey" to the item name. You have to do that yourself with /iname.

ITEM ENCHANT (/item enchant)
Accepts: an enchant id number
- This is the enchant on the item. You can enchant ANY item, even potions and mounts and arrows, etc. Find enchant id's on this page: http://www.wowwiki.com/API_TYPE_ItemString

ITEM UNIQUE (/item unique)
Accepts: a unique id number
- There's no way to easily and accurately make this up. You just have to get it from items you've seen in game. I.E., /iinfo a crafted item you made and you'll see a sample of a unique id.

ADVANCED FEATURES

-------------------------
FindEnchants(t,n)
-------------------------
- Allows you to find every enchant that exists.

Make a macro with the following line:

/script FindEnchants(t,n)

where t is enchant id to start with and where n is any number. If n is 1, the enchant id will increment by 1, otherwise it will decrement by 1.

Note: "item id" and "item name" have to be set beforehand, you can manually set them or just /iinfo any item (the enchants will be shown on that item, regardless of compatibility).