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 |
|
| integrates-with | iw | Matches any game that integrates with the supplied game ID |
|
| is:collection | is:c | Only matches games which are collections of other games. In BGG terms, this means the game must have at least one item listed in the 'Contains' section of its profile |
|
| is:expansion | is:e | Only matches against expansions |
|
| is:integration | is:i | Matches against any game that integrates with at least one other game. In BGG terms, this means the game must have at least one item listed in the 'Integrates With' section of its profile |
|
| is:player-count-expansion | is:pce | Expansions which increase the maximum player count over the base game |
|
| is:reimplementation | is:r | Only matches games which are reimplementations of other games. In BGG terms, this means the game must say 'Reimplements: ...' at the top of its BGG profile, listing at least one other game |
|
| 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 |
|