8 Searching Items
Raffael Scagnetti edited this page 2026-05-29 17:32:07 +02:00

This article covers the specific tags used when searching items. If you wish to learn about searching in general go to Searching.

When searching through items, the following tags are supported:

Tag Aliases Example Matches
description content, desc, d d:'mount All items that interact with mounting
uses - uses:2|3 All items that can be used two or three times before needing to be recharged
restore res res:long Rest ^• All items that regain charges after finishing a Long Rest
book source, b b:default ^* All items included in Spellbook by default
type t t:Armor ^+ All types of armor
mastery m m:Graze ^x Weapons with the Graze mastery
property properties, p p:finesse ^- All Weapons with the Finesse property
rarity rar, r r:non magical|common ^o All non-magical or common items
attunement a a: ^† All items that require attunement
unique u !u: ^† All items that are not unique

^• A restore condition can only be one of Long Rest, Short Rest, Dawn, or Dusk.

^* You can use this tag to match the name of an imported book (you can see the names of all imported books under Settings > Shared > Books) or you can match Builtin or Default.

^+ An item's type can only be one of Armor (including Heavy Armor, Medium Armor or Light Armor), Shield, Weapon (including Simple Weapon or Martial Weapon), Item, Equipment or Tool.

^x An weapon can only have the following masteries Cleave, Graze, Nick, Push, Sap, Slow, Topple, Vex

^- A weapon's properties must be some of Ammunition, Finesse, Heavy, Light, Loading, Range, Reach, Thrown, TwoHanded, Versatile

^o An item's rarity can only be one of Non Magical, Common, Uncommon, Rare, Very Rare, Legendary or Artifact

^† These tags ignore any text that follows them (but does not affect later tags). To find complementary items, use negative tags (i.e. use !a: or -a: to find items that do not require attunement)

Example Searches

  • d:DC 15 (matches Caltrops, Lock, Manacles, Net and Rope)
  • d:mount t:martial (matches Lance)
  • a: desc:DC b:default (matches nothing since Spellbook does not have magic items builtin yet)
  • p:lIghT p:Thrown -m:nick (matches Handaxe)

Further Reference

You can find the source-code for how item searches are handled in InventoryScreen.kt