Creating your own Avatar Collection (manually)

The easiest way to create your own avatar collection is to start a Scoring session, change the avatars and player order to how you like, and then save that collection to use again later.

However you can also create your own avatar collection manually outside of Board Game Buddy. For those of you that are technically inclined, here is how you do it:

Create and Assemble Your Images

  • Image Size: although Board Game Buddy will accept any size of image, using images with a size of (width=300 & height=200) pixels is best
  • Transparent Backgrounds: the program supports transparent backgrounds in image formats such as PNGs.
  • Assign Player Colour:
    • Board Game Buddy likes you to associate a particular colour to your image. This won’t change your image, but will determine what background and scoring colours the program will use. It also helps you relate an image to a particular colour of meeple/token that you use on your board game.
    • You can have multiple images with the same colour in the same avatar set.
    • To associate a particular colour to your image, add the three letter prefix of the colour and two dashes (“–“) to the front of the image file name.
    • examples:
      • hulk.png would become GRN–hulk.png
      • big_banana.png would become YEL–big_banana.png
    • Here are the supported colours and their prefixes:
      • RED – red
      • ORA – orange
      • YEL – yellow
      • CYA – cyan
      • BLU – blue
      • LIM – lime
      • GRN – green
      • PIN – pink
      • PUR – purple
      • TAN – tan
      • BRO – brown
      • WHI -white
      • GRA – gray
      • BLA – black

Create the XML file

The XML file is just a text file that lists the images and tells some information about your avatar set. You can export any current avatar set from Board Game Buddy if you want to see what the XML file looks like.

Here is an example, with descriptions below:

  • XML file name: the XML file name must start with “bgb_set” (without quotes, note the underscore between bgb and set). examples: bgb_set_boxcars.xml, bgb_set_fruit.xml
  • XML tags (the data): Each piece of information in the XML file is identified with a “tag” telling the program what data it is. Here is a list of the tags you can use:
    • <setName> This is the name that Board Game Buddy will display when it lists the avatar sets for you to choose.
    • <setAuthor> This is who created this avatar set (you!)
    • <setNotes> A brief description of this set.
    • <showBarColours> set this value to either true or false depending on whether you want Board Game Buddy to show the coloured background bars behind each players score by default. (the player can always toggle this during a game under settings)
    • <avatarPath> the file name of one of your images. You can have as many of these as you like in this file. You can multiple images with the same associated colour in the same set if you like.
      • Note that the order of the images is the order they default to in Board Game Buddy.

Create ZIP file

  • Put the XML file and all your images in a standard non-encrypted ZIP file.
  • You can now import that collection into Board Game Buddy and it will show up

Have fun and remember to share your creation with your friends !

Adding a new set of Avatars

In Board Game Buddy, not only can you use your own photos as your player avatars, you can also add collections created by other Board Game Buddies!

To import an avatar collection that you have downloaded, just follow these steps:

1- Download the avatar collection to your device that is running Board Game Buddy

2- Run Board Game Buddy, and start a new scoring activity by pressing SCORING and then NEW GAME

3- when you get to the page that allows you to choose your avatar set, press the PLUS sign (next to the SETTINGS icon in the top right corner).

4 – browse the files on your device and find the ZIP file that you just downlaoded and press it

5 – once the program has finished unzipping and importing the avatar collection it will now be available in Board Game Buddy to choose and use !

Exporting a set of avatars to share with your friends

Have you created a collection of avatars of your favourite pop-culture theme and want to share them with your friends or other people on the internet?

It’s easy to export an avatar collection from Board Game Buddy:

Navigate your way to the screen where you would normally choose your avatar set when starting a new game (Scoring > New Game > …)

Press and hold the avatar collection that you would like to export until the pop-up menu appears. Choose the EXPORT option.

Board Game Buddy will then create a ZIP file in the Downloads folder of your device. This ZIP file contains all the images in your avatar collection as well as the XML file that helps describe it. No need to open the ZIP file, just send it to your friends or post it online. Your friends can then import your collection by adding the set of new avatars on their device.

Saving a set of player colours and avatars to use again

Do you play with a regular game-night crew? It’s easy to save the colours and avatars that you set up so you can use them again the next time.

At any time during your game, press the Save/Disk icon in the top right corner.

When prompted, give your avatar set a name and then press the green check mark. That’s it !

Next time you start a new game, you will find your avatar set in the list that you can choose from:

Once you have saved your own avatar set, you can also export it to send to your friends.

Adding your own avatar image/photo

In Board Game Buddy it’s easy to change your avatar to almost any image on your device – including photos from your camera!

While playing your game, simply touch your current avatar and a dialog will open allowing you to choose a new one. Note that the avatars are sorted by their associated colours, but you are free to choose from any colour set.

To add a new image to the avatar collection, press the “add image” button (you may have to scroll to see it if there is a lot of avatars).

Your device image gallery will open and you can choose what file you would like to import.

Once you select your image, you can assign a colour to it. This only affects what set the image will be saved in, and the colour of the colour bar that appears behind it (you can turn that off if you want)

And now your new avatar is available for this and any future games !

Technical details:

  • Horizontal images work best.
  • Optimal image size is 300 x 200 pixels, but you should be able to copy any image to Board Game Buddy. Note that Board Game Buddy makes a copy of your image in its workspace, so nothing will happen to your original image (it will take up more space on your device howere)
  • Board Game Buddy recognizes alpha channels for images with transparent backgrounds (like PNG and WEBP files)