Board Game Stats 1.6 introduces the ability to import your plays from BoardGameGeek. Because this is the first release of this feature, you might want to know exactly how things are processed. Also, you might encounter issues that I didn’t think of. In that case:
- Tell me, so I can create a workaround.
- There is an option to delete imported plays from a specific period from Board Game Stats. This way you can try again with other settings, or after I’ve added a workaround for the specific issue you encountered.
Please note that Locations, Players and Games added during import are not deleted with this option. Newly added ones will have zero resulting Plays after deletion, making them easily recognizable.
Before importing it might be good to check your existing Games, Locations and Players, so they match the details on BGG. Read below to see how these items are matched during import.
Plays are imported from a specific user, for a selected period, or from all time if selected. All plays will be imported that are linked to this user, from BoardGameGeek, RPGGeek and VideoGameGeek. You can import plays from any user you like. As much of the entered data of the play as possible will be imported. Plays already known to Board Game Stats (posted to BGG from the app or previously imported) are not imported.
There are three specific options:
- Don’t import Plays with quantity < 1
If you turn this on, plays with a quantity setting on BGG of less than 1 (displayed as 0 on BGG) are skipped during import. This is used by some users to enter play of expansions, along with a play of the base game.
- Import quantity > 1 as number of rounds
Normally if you have a quantity set on BGG higer than 1, the play will be imported once for each play. So if the quantity is set to 3, you will get 3 plays in Board Game Stats, of which only one will be linked to the BGG play. If you don’t want this, settings this option puts the quantity in the Rounds field instead, still keeping the basic information, but preventing getting duplicate plays. However, in that case you won’t get a total play count including the entered quantities. If later posting that play back to BGG, the information in the Rounds field is lost, because BGG does not have a field for that. Board Game Stats will always set the quantity on BGG to 1.
- Ignore for stats if no winner set
If the play has now winners set the setting ‘Ignore for statistics’ will be turned on if this is set. This way stats aren’t influenced if you did enter players for a play, but didn’t set a winner.
If the played game was already in Board Game Stats and was set to being Cooperative, the play is imported as usual and ‘the Game’ is considered to have won.
- Both the “Don’t count win stats” and “Incomplete” check boxes on BGG are imported as the “Ignore for statistics” option in Board Game Stats.
- If you did not enter players and scores on BGG, no players or scores will be added to the play on Board Game Stats – not even yourself. This way statistics will not be affected for the number of plays, win percentage or scores.
- If you did enter players but no scores, the players are added to the play in Board Game Stats without scores. These will not effect statistics for scores, because they are empty. They DO effect statistics for number of plays and win percentages.
- If you did not enter names for players, those players will be added as ‘Anonymous 1’, ‘Anonymous 2’, etc. Enough different Anonymous players will be created to be able to assign different players to each play with players without names, the Anonymous players are then reused for the next play that didn’t have names set.
- Plays that do not have a date set on Board Game Geek (yes, this is possible), are ignored during import.
How details are matched:
- When importing, Games are matched by BGG id (which you set by linking a game in Board Game Stats), and if none was matched, by exact name (case insensitive). If no match was found, a new Game is added to Board Game Stats, with the BGG id link in place. The details of this Game will be loaded automatically from BGG the first time you view it.
- When importing, Players are matched by BGG username (which you can set for each player in Board Game Stats), and if none was matched, by exact name (case insensitive). If no match was found, a new Player is added to Board Game Stats, with the BGG username set.
- When importing, Locations are matched by name (case insensitive), and if no match was found, a new Location is added with that name.
If you end up with duplicate Games or Locations on Board Game Stats, you can best browse to the list of Plays of that item, and edit the plays to set it to the one you want to keep. Then delete the Game or Location with zero resulting plays.
If you end up with duplicates Players, you can merge them. Browse to the Player you want to merge into another Player and open the Edit player screen, then select “Merge Player…”. After selecting a Player to merge this one into, all plays of this Player are moved to the selected Player, and the old Player is deleted. You’ll see confirmation dialogs before anything is actually done, explaining exactly who is merged into who.