# MQ2LinkDB

## Description

MQ2LinkDB allows you to keep your own personalised database of item links. There are two versions of the plugin:

* **v1:** The original, by Ziggy is available

  [here](https://macroquest2.com/phpBB3/viewtopic.php?t=10375\&start=0)
* **v2:** An updated version of the plugin, which includes a TLO and linkbot functionality, was created by

  rswiders and is available in the VIP Forums

  [here](https://macroquest2.com/phpBB3/viewtopic.php?t=14876)

### Features

* Able to import the huge database of links from <http://eqitems.13th-floor.org/> and add them.
* Watch chat for item links and add them automatically.
* Links are returned as tells and will go into the tell window. They do not go into your log file, nor does LinkDB

  show up when you try and reply.

## Commands

* **/link**

Display statistics

* **/link /import**

Import items.txt as downloaded from [13th-Floor](http://eqitems.13th-floor.org/download.php). To import this file, do the following:

1. Download the items.zip file directly using [this link](http://eqitems.13th-floor.org/download/items.zip)
2. Unzip the items.txt file to the \Release directory
3. In game, type /link /import and wait a few seconds for the items to be added
4. Out of game, edit the MQ2LinkDB.txt file and: 1. Remove the first line (ends in "wornlevel") 2. Search for "iksar left hand" and delete the 3 lines that end in '=\\
5. **/link /max** ***#***

Set maximum number of results (default 10)

* **/link** ***search***

Find items containg *search* string

### Added by v2

* **/link /scan \[on|off]**

Turn on and off scanning incoming chat

* **/link /click \[on|off]**

Click on the link generated?

## Top-Level Objects

**Note:** The TLO is only available in v2.

* [*string*](broken://pages/-Me4I982Obm83SKMG0Zr) **${LinkDB\[\***&#x6E;am&#x65;**\*]}**

Display the link found by *name*. Use =*name* for an exact match.

## Examples

`/link baby joseph sayer`

You will get a tell with a link to the Baby Joseph Sayer.

`/shout OMG I'm a dork! I have ${LinkDB[=Baby Joseph Sayer]} in my pack. Ha!`

If the item is not found, the TLO returns an empty string, so you probably don't want to be directly shouting about Baby Joseph Sayer in your backpack. If you do and misspell his name, you will end up shouting about an empty string which isn't recommended.

## See Also

* [Top-Level Objects](/macroquest/data-types-and-top-level-objects/top-level-objects.md)
* [Plugins](broken://pages/-Me4I94WGlOtA0pQ_0oB)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://macroquest.gitbook.io/macroquest/plugins/community-plugins/mq2linkdb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.