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.5
is: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 |
|