A valid query in this language is comprised of any number of terms, combined or modified in certain ways. All terms may be:
-is:expansion (mechanic:"Dice Rolling" best-players=2) or (category:economic best-players=4)
For example, the above query would match any games, which are not expansions, and are **either dice rolling games that play best with 2 players, or are economic games** that play best with 4 players
Most terms have shortcuts, so if you like saving time, the above query could also be written as follows:
-is:e (m:"Dice Rolling" bp=2) or (c:economic bp=4)
There are also some behaviors that are specific to the type of the term:
name:"Race for the Galaxy"average-rating>=7.5is:expansion| Term | Shortcuts | Description | Examples |
|---|---|---|---|
| age | Matches the game's minimum recommended player age |
| |
| art | a | Matches a part of the games primary name |
|
| average-rating | ar | Compares against the average user rating of a game |
|
| average-weight | aw | Compares against the game's average rated complexity |
|
| best-players | bp | Matches against the number of players that are best for a game as determined by the BGG community |
|
| category | c | Matches a part of the name of any of the game's categories |
|
| desc | Matches part of the game's description |
| |
| design | desi | Matches a part of the name of any of the game's designers |
|
| expands | Matches any games that expands the supplied game ID |
| |
| family | f | Matches a part of the name of any of the game's families |
|
| geek-rating | gr | Compares against the game's BGG GeekRating metric |
|
| is:collection | is:c | Only matches against games which are collections of other games |
|
| is:expansion | is:e | Only matches against expansions |
|
| is:player-count-expansion | is:pce | Expansions which increase the maximum player count over the base game |
|
| is:reimplementation | is:r | Games which are reimplementations of others |
|
| language-dependence | ld | Matches against the community-submitted language dependence level of the game. The possible values are as follows:
|
|
| majority-players | mp | Matches against games that play well at a particular player count according to feedback given by a simple majority of the players of said game. This majority includes both best and recommended player ratings |
|
| max-players | mxpr | Matches against the maximum number of players supported by a game |
|
| max-playtime | mxpt | Matches against the maximum number of minutes needed to play a game |
|
| mechanic | m | Matches a part of the name of any of the game's mechanics |
|
| median-playtime | mdpt | Matches against the median number of minutes required to play a game, as sourced by BGG user play data |
|
| median-playtime-1 | mdpt1 | Matches against the median number of minutes required to play a game with 1 player, as sourced by BGG user play data |
|
| median-playtime-2 | mdpt2 | Matches against the median number of minutes required to play a game with 2 player, as sourced by BGG user play data |
|
| median-playtime-3 | mdpt3 | Matches against the median number of minutes required to play a game with 3 player, as sourced by BGG user play data |
|
| median-playtime-4 | mdpt4 | Matches against the median number of minutes required to play a game with 4 player, as sourced by BGG user play data |
|
| median-playtime-5 | mdpt5 | Matches against the median number of minutes required to play a game with 5 player, as sourced by BGG user play data |
|
| min-players | mnpr | Matches against the minimum number of required players |
|
| min-playtime | mnpt | Matches against the minimum number of minutes needed to play a game |
|
| name | n | Matches a part of the games primary name |
|
| own | Games which are owned by a particular BGG user. Currently, you must manually pull your BGG collection to initialize/update it. This must be done before you use this term |
| |
| publish | p | Matches a part of the name of any of the game's publishers |
|
| quorum-players | qp | Matches against games that play well at a particular player count according to feedback given by a quorum (currently 65%) of the players of said game. This quorum includes both best and recommended player ratings |
|
| rating-deviation | rd | Compares against the deviation in the game's ratings |
|
| rating-votes | rv | Compares against the number of user ratings the game has received |
|
| rec-players | rp | Matches against the number of players that are recommended by the BGG community |
|
| weight-votes | wv | Compares against the game's number of complexity ratings |
|
| year | Matches the year a game was released |
|