Board Game Stats can import plays directly from BoardGameGeek. If you have another source of your plays, you can try to import a file into Board Game Stats in the same format you can export from it.
Be warned: the import process is currently just made to import files created by the app itself, and it is not easy to create a valid file to import. Also, the app isn’t yet set-up to be friendly about its error messages when importing, and will provide no details why when an import fails.
To crate a JSON file to import, use the example file below as a base, or create an export from the app via Settings > Export, import and backup > Export backup file… .
The json file contains separate arrays of Games, Players, Locations and Plays. Each object should get an “id” which is a sequential number within the json file. All references to objects (like from the Play, the played game, the play-location and from the scores the players) use that id to link objects together. The PlayerScore e.g. uses the playerRefId to reference the player that the score is for.
The uuid fields are used by the app to recognise objects uniquely. If the object exists in the app with the same uuid, it will be overwritten during import. If the uuid is not found, or you have not provided an uuid, a new object will be created.
Here is an example file to help you (option-click to download directly):
- A .json file exported from a clean Board Game Stats with just 1 play, 1 location, 1 game, 4 players.
For iOS you can also try the steps below to import a .tsv export-format. This is the previous export format, which is no longer supported. Imports should still work though.
Here are some pointers:
- The file must be tsv (tab-separated, non-quoted), just like the exported file
- The columns must match; each player has a set of nine columns, so the number of columns is determined by the number of players to import
- A player’s first column title is its name, the second its BGG user id
- A player’s first column value is the calculated score, the second its entered score (including +’s and -‘s)
- If you don’t set a unique Play ID Board Game Stats will create one for you on import.
- To be able to import, the file must have Unix Linefeeds, and be encoded in UTF-16 little-endian. A text editor like BBEdit (a free version is available) can help you with that.
An example .tsv file (option-click to download directly):
- A .tsv file exported from a clean Board Game Stats with just 1 play, 1 location, 1 game, 4 players.