....·····.....·····/                                   \·····.....·····....
  ·  .  .  ·  ·  . |     Help on:  object filters      | .  ·  ·  .  .  ·
····.....·····.....\                                   /.....·····.....····

Filters can be used to assist in manipulation of objects in the game. Every
object in RoH is of a certain type. The current object types and their filters 
are as follows:

Miscellaneous (most random objects/hold items)..........@misc
Instrument..............................................@instrument
Herb....................................................@herb
Weapon..................................................@weapon
Armor...................................................@armor
Potion..................................................@potion
Scroll..................................................@scroll
Wand....................................................@wand
Container...............................................@container/@bag
Money...................................................@money
Key.....................................................@key
Lightsource.............................................@lightsource
Song Scroll.............................................@songscroll
Poison..................................................@poison
Bandage.................................................@bandage
Lottery Ticket..........................................@lotteryticket
Gemstone................................................@gemstone

Trash items(things that are not pawnable)...............@trash

You can use these filters when inter-acting with objects or checking your inventory.
For example, to check your inventory for all weapons, you can use @weapon:
: inv @weapon
[Using filter: @weapon]
You have: a giant steel longsword, a wooden knife.

You can use the @trash filter to filter for any trash items in your inventory, or to
drop or otherwise manipulate them. Trash items are any item that a pawn broker will not
want to buy from you and you cannot sell in a shop. 
:inv @trash
[Using filter: @trash]
You have: a juggling pin, a silver-tubed scroll (M), some used wacky weedus.
:drop @trash
[Using filter @trash]: (juggling pin)
You drop a juggling pin.
Thanks for recycling.
You have 5201 gold coins.

NOTE: When in a pawn shop or shop, faction comes into play when determining the
value of an item, so what is considered @trash might be different in a shop than
it is outside of a shop. For best accuracy, it is best to use the @trash filter
when you are inside a shop or pawn shop.

You can use them to pick things up or drop them:
:get @gemstone
[Using filter: @gemstone]
You get the medium blue agate.
:drop @gemstone
[Using filter: @gemstone]
You drop a medium blue agate.

Or when selling in pawn shops:
:sell @gemstone
[Using filter @gemstone]: (medium blue agate)
The shopkeep gives you 40 gold coins for the medium blue agate.

Or when giving things to other players:
:give @gemstone markessa
[Using filter @gemstone]: (medium blue agate)
You give a medium blue agate to Markessa.

Or when putting items in a bag or getting things from them:
:put @scroll trav
[Using filter @scroll]: (putrescent scroll)
You put a putrescent scroll (M) in a traveling satchel.
:get @scroll trav
[Using filter @scroll]: (putrescent scroll)
You get the putrescent scroll (M) from the traveling satchel.

You get the idea. Filters work with most commands when manipulating objects. There
are some exceptions that you will find, however. They will not work with "drop all" 
or "get all", which also includes the functionality of those commands to "drop all" or 
"get all" from your bags. The same applies for the "put all" command, as it uses the 
same underlying code as "drop all" does. They also will not work with some other 
commands, such as "buy" when buying things in shops, and a couple others.

Other important things of note: 
- Filters will always use the first item they find when searching your inventory or 
  when searching items on the ground, or basically when searching for objects in general.
- Only pure thieves are able to use filters when using the steal command.