Inventory

* A stub is an article deemed too short to provide encyclopedic coverage of the subject.
* If you are familiar with the topic, please help to expand this article.
* This page is automatically sorted into the category Stub, until this box is removed.

 In the Forge every player can access their inventory for actions like deck building or interacting with the Marketplace.

## Card Filtering

After installing the game, a general documentation file about card filtering is created at `...\BattleForge\docs\advanced_filtering.txt`. Some of its content is displayed below:

### Basic

* Via the buttons on the left side and the drop down menus, players can filter their displayed owned cards.
* Entering a search term always searches all owned cards, considering the active filters.
	+ `*<search input>*`: Searches card names that contain the search term.

### Advanced

More advanced searches are possible using the options below, in non-english languages, localized parameter names exist.

* `=*<search term>*`: Search for a card name or id with an exact match.
* `?*<search term>*`: Search for a card name with error tolerance of 3 for an exact match.
	+ `?*<positive integer>**<search term>*`: Search for a card name with specified error tolerance for an exact match.

* The following options use a binary system to search for a all matches (1) or all non-matches (0).
	+ `promo:*<binary>*`: Search for all (non-)promo cards.
	+ `flying:*<binary>*`: Search for all (non-)flying cards.
	+ `ranged:*<binary>*`: Search for all (non-)ranged cards.
	+ `melee:*<binary>*`: Search for all (non-)melee cards.

* When combining multiple filters, the prefix `name` is required in front of the search term.
	+ This works for any introduced modifying `*<connectors>*`: `:`, `=` or `?`

* Instead of searching for card names, there are also these options for searches of text on the cards:
	+ `ability*<connector>**<search term>*`: Search for cards with this ability name.
	+ `class name*<connector>**<search term>*`: Search for cards with this class name or gender.

* Combining multiple filters they need to be separated:
	+ `*<filter 1>*&*<filter 2>*`: Only results that satisfy both filters will be included.
	+ `*<filter 1>*|*<filter 2>*`: Results that satisfy at least one of the filters will be included.
* There is a limit of 255 input characters for the search bar.

* When searching for values of cards there are the following options to define a `*<number range>*`, using `*<N>*` and `*<X>*` as placeholders for numbers:
	+ `>*<N>*`: Values greater than N.
	+ `>=*<N>*`: Values greater or equal to N.
	+ `<*<N>*`: Values smaller than N.
	+ `>=*<N>*`: Values smaller or equal to N.
	+ `=*<N>*`: Exactly N.
	+ `:*<N>*-*<X>*` or `:*<N>*..*<X>*`: Values greater or equal to N, but smaller than X.
	+ `:*<N>*..=*<X>*`: Values greater or equal to N, but smaller or equal to X.
* Possible supported value searches are:
	+ `damage*<number range>*`: Search for cards with this attack value.
	+ `health*<number range>*`: Search for cards with this life points value.
	+ `upgrade*<number range>*`: Search for cards with this upgrade level.
	+ `charges*<number range>*`: Search for cards with this many applied copies.
	+ `copies*<number range>*`: Search for cards with this many owned unapplied copies.

* Searching for size, counters of affinity can be done as follows:
	+ `size:*<size type>*`: Search for cards with the size types `s`, `m`, `l`, `xl`, `?` or `special`.
	+ `counter:*<counter type>*`: Search for cards with the counter types `s`, `m`, `l`, `xl`, `?` or `special`.
	+ `affinity:*<affinity type>*`: Search for cards with the affinity types `fire`, `frost`, `nature`, `shadow` or `none`/`-`.

## Patch History

Patch #400039 - Mid-Patch Update (16 January 2023)
* Fixed inventory filter extensions not being created by default at `*<...>*\Documents\BattleForge\custom_filter_extensions.json`.

Patch #400039
* Removed the disabled resizing buttons at the top right of the **card inventory menu** and replaced them with a question mark icon that displays a tooltip about inventory filtering while hovering over it.
	+ It includes a list of commands and operators, alongside guiding examples of how to combine them.
	+ Clicking on it opens up a forum post with even more details.
* Added two new inventory filter commands: `rarity` and `power`.
* Added the option for players to define custom filters for advanced inventory filtering at `*<...>*\Documents\BattleForge\custom_filter_extensions.json`.
	+ The file already contains some examples regarding the syntax of custom filters.
	+ Numbers [0-9] are not allowed for the name parameter of custom filters.
	+ In-game custom filters can be called with `**<custom filter name>**`.

Patch #400031
* Added more advanced card filtering options to the Inventory's search bar.
	+ Players can now search their collection by entering advanced parameters or use comparison characters.
	+ Search by the English card name in Non-English languages is now also possible.