MQ2Bzsrch - MMOBugs Wiki

Revision as of 00:20, 26 August 2012 by Htw (talk | contribs) (Updated source availability info, version history, and new level option.)
Plugin Info
Name MQ2Bzsrch
Author htw & DKAA & MQ2 Devs
Link MQ2 Wiki Link
Commands /bzsrch
Source Available Yes (Original MacroQuest2 GPL code is available)
Uses INI File No

Description

MQ2Bzsrch allows commandline bazaar searching.

Commands

/bzhelp Shows help screen in MQ2 window.
/bzreset Clears search results & clears bazaar search window.
/bzsrch [params] [name]

  • [params] can be one of the following:
    • race any, barbarian, dark elf, dwarf, erudite, froglok, gnome, half elf, halfling, high elf, human, iksar, ogre, troll, vah shir, wood elf, drakkin
    • class any, bard, beastlord, berserker, cleric, druid, enchanter, magician, monk, necromancer, paladin, ranger, rogue, shadow knight, shaman, warrior, wizard
    • stat any, armor class, agility, charisma, dexterity, intelligence, stamina, strength, wisdom, vs cold, vs disease, vs fire, vs magic, vs poison, hit points, mana, endurance, attack, hp regen, mana regen, haste, damage shield, damage shield mitigation, heal amount, spell damage, clairvoyance, heroic agility, heroic charisma, heroic dexterity, heroic intelligence, heroic stamina, heroic strength, heroic wisdom
    • slot any, ammo, arms, back, charm, chest, ear, face, feet, fingers, hands, head, legs, neck, power source, primary, range, secondary, shoulders, waist, wrist
    • type any, 1h slashing, 1h blunt, 2h blunt, 2h slashing, 2h piercing, alcohol, alternate ability, all effects, armor, arrow, bandage, book, bow, brass instruments, combinable, drink, focus effect, food, jewelry, key, light, martial, misc, note, percussion instruments, piercing, potion, scroll, shield, stringed instruments, throwing, wind instruments, augmentation, placeable
    • price <low> <high>
    • level <low> <high>
  • [name] is the name or partial name of the item you wish to search for

Macro Data

This plugin adds a new TLO which is used for the search results.

${Bazaar} : bool - Returns true when search is complete

Data types

  • ${Bazaar.Done} : bool - Returns true when search is complete
  • ${Bazaar.Count} : int - The number of search results
  • ${Bazaar.Item[n]} : bazaaritem - Result info by index (1-based)

The bazaaritem DataType has the following members:

  • ${Bazaar.Item[n].Name} : string - Item Name
  • ${Bazaar.Item[n].Trader} : spawn - The trader selling it
  • ${Bazaar.Item[n].Price} : int - The items price
  • ${Bazaar.Item[n].DispPrice} : string - The items price in plat, gold, etc.
  • ${Bazaar.Item[n].Quantity} : int - The quantity of items that trader has for sale
  • ${Bazaar.Item[n].ItemID} : int - The item's ID number
  • ${Bazaar.Item[n].Stat} : int - Value in the "Stat column" (last column of the search window, eg. save vs fire, int, wis, etc). NOT the value of the Item. Returns 0 if nothing is there.

More information can be found at:

Example Usage

  • /bzsrch race any class any stat any slot any type any price 0 9999999 sword
    • Search for any item called "sword" with no other qualifiers
  • /bzsrch race troll class warrior stat strength slot chest type any price 50000 90000 Plate
    • Search for any troll warrior usable +strength chest slot items with "Plate" in the name, and a price of 50-90k plat.

Version History

  • 1.5 htw
    • htw - Added ability to specify min and max level for search.
  • 1.4 htw
    • htw - Corrections to code due to VOA, TLO updates.
  • 1.3 htw
    • htw - Corrections to code due to HOT, TLO updates.
  • 1.2 htw
    • htw - Corrected various params, added missing params, updated level, fixed search window clear, corrected help info, changed help command.
  • 1.1 Lax
    • Reworked by Lax to work like other MQ2Data plugins.
  • 1.0a CyberCide
    • Updated for MQ2Data by CyberCide
  • 1.0 DKAA @ 2003-2004
    • Original release by DKAA

Availability

This plugin is included with the MMOBugs Compile, and its source is available from the MQ2 website. The specific changes that are compatible with MacroQuest2 GPL code will be provided upon request, to assist any individual to compile their own. MMOBUGS VERSION OF THIS PLUGIN IS ABSOLUTELY NOT COMPATIBLE (AND NOT COMPILABLE) AGAINST THE GPL SOURCE CODE (and do not expect help from MacroQuest2.com developers, as active code is used by us)