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 modificationDate in the import file is newer than the one in the app. If the uuid is not found, or you have not provided a uuid, a new object will be created.

Here is an example file to help you get started (option-click to download directly), note that this is a very basic example:

  • A .json file exported from a clean Board Game Stats with just 1 play, 1 location, 1 game, 4 players.