OBJECTS (ITEMS)

general object manipulation commands - how to interact with items

General Object Manipulation Commands. Type 'HELP '
for more information on a specific command.

 GET       PUT         DROP        GIVE        LOOK
 OPEN      CLOSE       LOCK        UNLOCK      EAT
 DRINK     STEAL       WEAR        EQUIPMENT   HOLD
 PLAY      INVENTORY   REMOVE      USE         FILL
 EMPTY     SACRIFICE   DONATE      HIDE        BURY
 DIG       SHOP        VENDOR      TURN        PULL
 PUSH

SHOP

shop - buy various items and services from a shopkeeper

 Through your travels in Alyria you will come across many merchants seeking
 to sell you goods and services, or buy goods from you.

 You can buy many different types of goods and services from shopkeepers,
 such as weapons, magical spells, horses, pets, etc.

 Shops usually only have a limited amount of inventory on hand. Once that
 inventory is depleted, you must wait until the shopkeeper replenishes their
 supply. Depending on the item, this can take days, weeks, or months. Usually
 the more exotic the item, the less the shopkeeper will have in stock, and
 the longer it takes them to acquire more.

 Most of the shopkeepers in Alyria take gold in exchange for their wares, but
 some specialized shops only accept other currency. The Van Pelt family and
 their agents sell special items in exchange for Reward Units, quest masters
 require quest points to buy their goods, and some shops sell items for use
 by clans in clanhalls, and require maleficarum roots.

 Players can also run their own shops by making use of the VENDOR command
 within the Alyrian Bazaar. See 'HELP VENDOR' for more information.

 SHOP LIST
  Displays a list of items available for purchase, their prices, and item
  numbers. Some shopkeepers may not have anything available for purchase.
  For instance, a merchant who only buys items and then sells them to
  a specific people or a group.

  Be sure to check the SHOP LIST before referencing an item by number, as
  these numbers can change based on the shopkeeper's inventory.

  You can restrict the SHOP LIST to just display the items in a level range
  from <minimum level> to <maximum level>.

  You can also search for a specific text match, or a wildcard text match,
  e.g., SHOP LIST *costume*. This can be combined with level searching via
  the SHOP LIST <minimum level> <maximum level> <search string> syntax.

  Search strings can include the following wildcards:
    * Matches everything (e.g., *fred*, or fred* or *fred)
    ? Matches a single character (e.g., fr?d)

 SHOP BUY [<amount>] <item name or number>
  Allows you to buy an item from a shopkeeper. You may reference the item
  either by the item number displayed using 'SHOP LIST' or by the item name.
  If there are several items with the same name it is usually best to use
  the item number, or you can specify the exact item name by surrounding it
  with single quotes like so: SHOP BUY 'item name'.

  To buy multiple quantities of an item at a time, you may specify an
  amount. You may buy anywhere from 1 to 500 quantities of an item at a
  time, assuming there are that many available in the shopkeeper's
  inventory.

  SHOP BUY will check both your gold on hand and in your default bank
  account when making a purchase.

  SHOP SELL <item name>
  Allows you to sell an item in your inventory to a
     shopkeeper. Some shopkeepers may only buy specific
     items, or they may have more than enough items in
     their inventory and don't want to buy any more. You
     can see how much a shopkeeper will pay for an item
     by using the SHOP VALUE command.

 SHOP VALUE <item name>
  Allows the shopkeeper to give an appraisal on an item - how much that
  shopkeeper would pay for the item.

 SHOP QUOTE <resource name or item number> <quantity>
  This command is similar to SHOP VALUE but is specifically designed for
  resource traders. Unlike most shops, traders sell and purchase varying 
  quantities of resources for a price that is based on supply and demand.
  The prices appearing on a trader's shop list are valid for a quantity of
  only one item. SHOP QUOTE can be used to obtain an accurate quote for both
  the price the trader is willing to pay for the specified quantity of the
  specified resource as well as the price for which the trader is willing to
  sell that quantity of the specified resource.

 SHOP IDENTIFY <item name or number>
  Identifies an item in the shopkeeper's inventory, allowing one to see the
  full attributes of an item before purchase.

 SHOP ESTIMATE <item name>
  Certain shopkeepers can repair damaged items, such as cracked shields,
  dull swords, or broken artifacts. The shopkeeper will estimate how much
  the item will cost them to repair and inform you.

 SHOP REPAIR <item name>
  Certain shopkeepers can repair damaged items, such as cracked shields,
  dull swords, or broken artifacts. The shopkeeper will charge for the
  repair service based on the estimated value of the item.

 SHOP RESTRING <item name> [<field name> or 'reset'] <description>
  Some special shopkeepers have the power to alter the very nature of an
  item and make it look and appear different to the layperson. Restringing
  requires the use of Strange Coins, available in Reward Unit Shoppes.

  Fields that may be restrung are:
   keywords    - words used to reference the item (5 - 120 letters), no
                 color codes allowed
   short       - description of the item as it appears in your inventory (5-
                 60 letters), up to 10 color codes
   long        - description of the item when it is on the ground (5 - 120
                 letters), up to 10 color codes
   specialname - for specific items, namely toy soldiers, toy wizards, and
                 toy shamans. Gives the item a name that shows up when the
                 toy transforms.

  For more information on this, see HELP RESTRINGING.

 SHOP ENGRAVE <item name> <engraving text or 'reset'>
  Engraving works much like restringing, except that the engraving is added
  to the item's description and displayed whenever anyone LOOKs at it. 
  Engravings will appear similar to:
   'An engraving on <object name> reads: <engraving>'

  Engravings follow much of the same rules as restringings, except they can
  be added to items that are set as 'nochange' (which means they cannot be
  restrung). Engravings are limited to 5 color codes and 50 characters
  maximum.

  Strange coins are needed to engrave items, and are available through
  Reward Unit shoppes. Engravings must be game-related in nature and cannot
  contain words or phrases that are anachronistic or violate the normal
  global channel rules. If an item is found to violate the aforementioned
  rules it will be removed permanently, so please be careful.

  If you have an engraved item and wish to remove the engraving, you may use
  the SHOP ENGRAVE <item name> 'reset' version of the SHOP ENGRAVE command.
  This will cost one strange coin.

 SHOP ADDRENEWALS <item name>
  While only a relative handful of shopkeepers offer this service, it can be
  quite useful. When a token of renewal addition is obtained (available from
  a Reward Unit vendor), these specialty shopkeepers can use the oil
  contained within to allow adventurers to renew objects whose renewals have
  all been consumed.

  Tokens of renewal addition can add either 1 or 3 renewals, up to the
  object's maximum; if both kinds of tokens are held, the smaller will be
  consumed first.

 SHOP ADDREPAIRS <item name>
  While only a relative handful of shopkeepers offer this service, it can be
  quite useful. When a token of repair addition is obtained (available from
  a Reward Unit vendor), these specialty shopkeepers can use the oil 
  contained within to allow adventurers to repairs objects whose taints have
  all been consumed.

  Tokens of repair addition can add either 1 or 3 taints, up to the object's
  maximum; if both kinds of tokens are held, the smaller will be consumed
  first.

 SHOP RENEW <item name>
  Shop renew, and renewal tokens, no longer exist.

  In order to renew expired items, `set click-to-renew on` and click the 
  'renew' link in the item's lore, or 'type shop renew <item>' anywhere. The
  Rewardunit Cost will be deducted from your Rewardunits balance.

 SHOP SELLBACK <item name> - Returns an item purchased for 90% of its price.
  Works within 20 Alyrian minutes of the original purchase.
     
 SHOP BAZAAR   
  Transports you to the Alyrian Bazaar from approved locations (usually the
  recall rooms of major cities).
     
 SHOP RETURN
  Sends you from the bazaar back to the location where you used the 'shop
  bazaar' command.

 SHOP CARGO
  Deals with ship cargo purchase and management. Includes the shop cargo list, 
  default, and buy commands. See HELP SHIP-CARGO for more information.

 SHOP REAGENTS
  Purchases enough reagents to fill all silk bags and places the reagents in the
  corresponding reagent bag.

VENDOR

vendor - information on the player and clan-leased shops

 Centrally located between Planes, the Bazaar is viewed as a politically neutral
 ground where vendors of all origins can come together to make a buck. Eccentric
 vendors line the streets, making themselves available to act as
 merchants-for-hire for any Adventurers or Clans who have wares to sell.

 To reach the Bazaar, Adventurers may 'shop bazaar' from the recall rooms of
 Rune, New Rigel, Tellerium, Xaventry, Sigil, Maldra's Keep or Vir; they can
 return from the Bazaar via 'shop return'.

 The vendors all belong to the Bazaar Merchant's Guild, within which they set
 the overall prices for the services they offer based on supply and demand
 within the Bazaar.

 Vendors operate based on leases owned by Adventurers or Clans. Adventurers must
 be at least level 61 to lease a vendor.  These leases may be purchased from the
 vendor for an initial fee. Once the lease is established, the vendor will then
 stock and sell items to other Adventurers based on prices dictated by the lease
 owner. The vendor will collect a percentage of the profit on every item sold,
 as well as a fee for each game hour he is open for business.

 The lease owner (or shoptender, in the case of a Clan-owned shop) must visit
 the vendor once a week (in real time) in order to pay the vendor and to collect
 the profit made from the shop. In order to keep the books straight, the
 vendor's fee will come from the lease owner/shoptender's cash on hand or
 default bank account. In the case of a clan shop, the vendor's fee will come
 from the clan bank account. If the vendor is not paid, the profit cannot be
 collected from the vendor.

 The vendor will not accept payment until a full week has passed, thus
 guaranteeing a weekly visit from the lease owner. There is a three-day grace
 period at the end of the week where the vendor will accept the payment, and
 provide the profits to the lease owner. After the three day grace period the
 vendor will stop selling items until he is paid.

 If the lease owner/shoptender does not pay the vendor for 40 days, the vendor
 will close the shop - destroying any items in the process, and keeping all the
 profit for himself. So it is important for the lease owner/shoptender to
 remember to visit the vendor weekly. Like any enterprise, player-leased shops
 require some time and attention. Do not lease a shop if you cannot attend it
 regularly.

 For a player-run shop, the Vendor Merchant's Guild is currently asking:
     * 200,000 gp to establish a lease
     * 9% commission on gross sale per item
     * 200 gp per game hour the vendor is open for business

 For a clan-run shop, the Vendor Merchant's Guild is currently asking:
     * 3,000,000 gp to establish a lease
     * 10% commission on gross sale per item
     * 400 gp per game hour the vendor is open for business

 GENERAL VENDOR COMMANDS
 The following commands are available to all.

 VENDOR LIST [<'all'>] - provides a numbered list of all currently-leased,
     currently open vendors in the Bazaar. To view all the vendors available
     (even those that are not currently open for business), type VENDOR LIST ALL

 VENDOR WHERE <lease owner name or clan #> - provides a path of directions of
     the specified shop vendor from your current location. You must be in the
     Bazaar to use this command.

     If searching for a lease owner name, wildcards are permitted.
         * Matches everything (e.g., *umlau*)
         ? Matches a single character (e.g., um?a?t)

 VENDOR EXIT - provides a path of directions to the center of the Bazaar from your
     current location in the Bazaar.

 VENDOR SEARCH <string> [<minimum level> <maximum level>] - searches all player
     and clan-leased vendor shops for a specific string. Strings must be from 4
     to 40 characters in length, and can include wildcards:
         * Matches everything (e.g., *sword*)
         ? Matches a single character (e.g., sw?rd)
         % Matches a single word (e.g., sword of %)

     The item fields searched will be the keyword field and the short
     description field.

     You may also provide optional level restriction parameters, from
     1 - 241, to limit the search to items that fall between those levels.

 VENDOR INFO - gives information about the vendor in the room with you. If you
     are the owner of the lease with that specific vendor, additional
     information will be displayed pertaining to the lease.

 VENDOR LEASE - Establishes a lease with the vendor in the room with you. This
     can only be done in the Bazaar, at a vendor-run shop.

 VENDOR CLANLEASE - Establishes a lease with the vendor in the room with you.
     This can only be done in the Bazaar, at a vendor-run shop. You must be in
     a clan and have the SHOPTENDER security flag in order to lease a shop for
     your clan.

 LEASE OWNER VENDOR COMMANDS 
 The following commands can only be used by the lease owner/shoptender(s) for a
 specific vendor. Commands must be issued in the same room as the vendor.

 VENDOR TERMINATE - terminates the lease with the vendor. You will forefit your
     initial fee as well as any profit that has not already been collected
     using the VENDOR PAY command, and the vendor will drop all the items in the
     store at your feet.

 VENDOR STOCK <item name> [<price>] - Takes an item from your immediate
     inventory and gives it to the vendor to stock. If you do not specify a
     price, it will be determined automatically based on the vendor's markup
     percentage and the default value of the item. Once an item is stocked, it
     cannot be unstocked, so please make sure you are careful in the items you
     stock with the vendor.

     You may stock up to twenty-five of the same item with the vendor at the
     same time, and have a maximum of fifty total items stocked in the store at
     once.

 VENDOR REPRICE <inventory #> <new price> - Specify an item already stocked by
     the vendor and adjust its price.

 VENDOR MARKUP <percentage> - Sets the percentage that the vendor will use when
     determining how much to charge per item. The vendor will apply the markup
     to all items sold in the shop. This is an easy way to increase the prices
     of all items if demand is high. Markup percentage may be from 50 to 250. By
     default the markup percentage is set to 100%, which means items will have
     their normal, full values. Anything below 100% reduces the prices.
     Anything over 100% increases them.

 VENDOR HOURS <open hour> <close hour> - Sets the vendor open and close hours.
     The longer the vendor is open, the more the vendor will cost per week.
     Hours must be 0 (midnight), 6 (6 am), 12 (noon), 18 (6 pm), or 24
     (midnight), and the open hour must be an earlier hour than the close hour.

 VENDOR LEVELS <minimum level> <maximum level> - Sets the levels which limits
     who can purchase items from the vendor. Minimum level must be less than or
     equal to maximum level.

 VENDOR TITLE <new title> - Changes the name of the vendor's store.

 VENDOR NOTIFY - Toggles ON or OFF having the vendor notify the lease holder (if
     a player-run shop) or clan members (if a clan-run shop) if they are online
     when a purchase is made.

 VENDOR HISTORY - Displays up to a 10-day history of the vendor's sales
     of what, and to whom.

 VENDOR HAWK <message> - Changes the hawk message for the vendor's store. This
     message will show up in VENDOR LIST, and is useful for highlighting current
     specials your vendor might be offering, or special items that your store
     offers, such as "Seashell Helms 50% off!" or "Visit us today for the lowest
     prices on slugwort antidotes!" Hawk messages must be 75 characters or less
     in length and abide by all global channel rules.
 
 VENDOR SET AUTOPAY - Links a vendor to the shop owner's default bank account
     or to a clan's gold reserves.  When payment comes due to a vendor, the
     money will be automatically deducted from the player's default account or
     the clan's gold.  When an autopayment is deducted, players will recieve a
     message if they were online notifying them of the deduction.  Clan
     vendors will display a message in the clan log indicating the amount paid.
     
     If the default account does not have enough gold to pay the vendor, the
     player will receive a message that their vendor needs to be paid.  A
     player or clan who does not pay their vendor will have their shop
     temporarily closed.  After 4 missed payments, the shop will be closed and
     the shop inventory dropped on the floor.

     Note: This feature is set off by default and does not automatically turn
     off again once toggled on.  Staff are not responsible for drained bank
     accounts or lost items from defunct shops.  Use at your own risk.