Item Filters: Difference between revisions

From Discord Dungeons Wiki
Jump to navigation Jump to search
No edit summary
(Minor changes to formatting)
Line 2: Line 2:


Examples:
Examples:
* To get the list of buyable weapons under level 100:
 
*To get the list of buyable weapons under level 100:
 
  #!items type:weapon cost:>:0 level:<=:100
  #!items type:weapon cost:>:0 level:<=:100


* To get all the ores in your inventory:
*To get all the ores in your inventory:
 
  #!inv type:ore
  #!inv type:ore


* To get items in your inv that give boosts to attributes:
*To get items in your inv that give boosts to attributes:
 
  #!inv attributes:
  #!inv attributes:


* To get the list of non-donor items:
*To get the list of non-donor items:
 
  #!items donate:undefined
  #!items donate:undefined


* To get the list of donor items:
*To get the list of donor items:
 
  #!items donate:true
  #!items donate:true


Usable Properties:
Usable Properties:
* name (The item name)
 
* level (The item level)
*name (The item name)
* cost (The buying price of the item; unbuyable items have a cost of -1)
*level (The item level)
* type (The type of the item shown in #!item)
*cost (The buying price of the item; unbuyable items have a cost of -1)
* sell (The selling price of the item)
*type (The type of the item shown in #!item)
* sellable (true or false value showing if an item can be sold)
*sell (The selling price of the item)
* tradable (true or false value showing if an item can be traded)
*sellable (true or false value showing if an item can be sold)
* desc (The item's description)
*tradable (true or false value showing if an item can be traded)
* forage (true or false value of if the item can be foraged)
*desc (The item's description)
* foragedata (Either Object or undefined; same as forage but includes Magic Saplings)
*forage (true or false value of if the item can be foraged)
* ore (Either Object or undefined; same items as type:ore)
*foragedata (Either Object or undefined; same as forage but includes Magic Saplings)
* fish (Either Object or undefined; same as type:fish)
*ore (Either Object or undefined; same items as type:ore)
* plural (The plural name of the object)
*fish (Either Object or undefined; same as type:fish)
* tradable (true or false value showing if an item can be traded)
*plural (The plural name of the object)
* prefix (The grammatical prefix of the object; usually `a` or `an`)
*tradable (true or false value showing if an item can be traded)
* attributes (Either Object or undefined; whether or not the object boosts any attributes)
*prefix (The grammatical prefix of the object; usually <code>a</code> or <code>an</code>)
* def (The percentage of damage blocked by the armor (or undefined))
*attributes (Either Object or undefined; whether or not the object boosts any attributes)
* id (The ID of the item; normally a number. Meta items are `m:number`)
*def (The percentage of damage blocked by the armor (or undefined))
* itemBoost (The amount of extra items received when doing sides with this tool)
*id (The ID of the item; normally a number. Meta items are <code>m:number</code>)
* skillXp (The static boost to skill xp granted by Jades in tools)
*itemBoost (The amount of extra items received when doing sides with this tool)
* gems (The enchantments on an item; is a string like JJ for 2 Jades)
*skillXp (The static boost to skill xp granted by Jades in tools)
* sockets (The number of gem sockets on an item: 1, 2 or undefined)
*gems (The enchantments on an item; is a string like JJ for 2 Jades)
* enchants (An array of enchantments in the form [sx;4,as;10] (don't try to use this; just use gems))
*sockets (The number of gem sockets on an item: 1, 2 or undefined)
* suffix (The end of the name on meta items, such is 2SRR+23)
*enchants (An array of enchantments in the form [sx;4,as;10] (don't try to use this; just use gems))
*suffix (The end of the name on meta items, such is 2SRR+23)


Notes:<br>
Notes:<br>
Not all items can use all properties. For example, not all items have an `ore` field, so if you search `#!items ore:`, any items without `ore` data will be filtered out.<br>
Not all items can use all properties. For example, not all items have an <code>ore</code> field, so if you search <code>#!items ore:</code>, any items without <code>ore</code> data will be filtered out.<br>
To search for items that **don't** have a property, you can use undefined, like #!items donate:undefined.<br>
To search for items that '''don't''' have a property, you can use <code>undefined</code>, like <code>#!items donate:undefined</code>.<br>
The left-hand side of the filter is case-sensitive, so itemBoost will work and itemboost won't.<br>
The left-hand side of the filter is case-sensitive, so itemBoost will work and itemboost won't.<br>
Searches use substrings, so if you search name:log, it'll give all items with "log" in the name.<br>
Searches use substrings, so if you search <code>name:log</code>, it'll give all items with "log" in the name.<br>
If you want to search for multiple words, simply remove the spaces like name:maplelog.<br>
If you want to search for multiple words, simply remove the spaces like <code>name:maplelog</code>.<br>
If you leave the value (the right side of the :) empty, all items with the property will be matched.<br>
If you leave the value (the right side of the <code>:</code>) empty, all items with the property will be matched.<br>
If a value is a number, like level, you can use <, <=, >, and >= to do inequality searches like level:<:100 cost:>:0.
If a value is a number, like level, you can use <, <=, >, and >= to do inequality searches like <code>level:<:100 cost:>:0</code>.

Revision as of 10:06, 23 November 2019

Item filters can be used to reduce the size of a list of items. Current commands that support them are #!items, #!inv, and #!ginv (with #!gbsearch, #!gmsearch, and #!recipe pending).

Examples:

  • To get the list of buyable weapons under level 100:
#!items type:weapon cost:>:0 level:<=:100
  • To get all the ores in your inventory:
#!inv type:ore
  • To get items in your inv that give boosts to attributes:
#!inv attributes:
  • To get the list of non-donor items:
#!items donate:undefined
  • To get the list of donor items:
#!items donate:true

Usable Properties:

  • name (The item name)
  • level (The item level)
  • cost (The buying price of the item; unbuyable items have a cost of -1)
  • type (The type of the item shown in #!item)
  • sell (The selling price of the item)
  • sellable (true or false value showing if an item can be sold)
  • tradable (true or false value showing if an item can be traded)
  • desc (The item's description)
  • forage (true or false value of if the item can be foraged)
  • foragedata (Either Object or undefined; same as forage but includes Magic Saplings)
  • ore (Either Object or undefined; same items as type:ore)
  • fish (Either Object or undefined; same as type:fish)
  • plural (The plural name of the object)
  • tradable (true or false value showing if an item can be traded)
  • prefix (The grammatical prefix of the object; usually a or an)
  • attributes (Either Object or undefined; whether or not the object boosts any attributes)
  • def (The percentage of damage blocked by the armor (or undefined))
  • id (The ID of the item; normally a number. Meta items are m:number)
  • itemBoost (The amount of extra items received when doing sides with this tool)
  • skillXp (The static boost to skill xp granted by Jades in tools)
  • gems (The enchantments on an item; is a string like JJ for 2 Jades)
  • sockets (The number of gem sockets on an item: 1, 2 or undefined)
  • enchants (An array of enchantments in the form [sx;4,as;10] (don't try to use this; just use gems))
  • suffix (The end of the name on meta items, such is 2SRR+23)

Notes:
Not all items can use all properties. For example, not all items have an ore field, so if you search #!items ore:, any items without ore data will be filtered out.
To search for items that don't have a property, you can use undefined, like #!items donate:undefined.
The left-hand side of the filter is case-sensitive, so itemBoost will work and itemboost won't.
Searches use substrings, so if you search name:log, it'll give all items with "log" in the name.
If you want to search for multiple words, simply remove the spaces like name:maplelog.
If you leave the value (the right side of the :) empty, all items with the property will be matched.
If a value is a number, like level, you can use <, <=, >, and >= to do inequality searches like level:<:100 cost:>:0.