BattleScribe Army List Creator

Build your army list. Fast.

BattleScribe 2.0

Please remember that BattleScribe 2.0 is now available. Versions 1.15.xx and below are no longer supported. You can download version 2.0 from the downloads page. You will also be able to find downloads for version 1.15.xx there too, should you want to continue using it.

The following help documentation is for version 1.15.xx. The help documentation for version 2.00 can be found here.




A unit / model / upgrade is incorrect

These are problems with the data files you are using. BattleScribe does not create or maintain the data files ourselves for legal reasons and we cannot do anything to fix these kinds of problems. Instead, all data is made by an awesome community of data authors.

What you can do:

  • Make sure you are using the latest version of BattleScribe.
  • Go to Manage Data in BattleScribe and update your data. You may find the problem has been fixed already.
  • Contact the author of the data file to let them know there's a problem. Try the website you got the data from.
  • With the data file loaded, go to About in BattleScribe. You may find the author's contact information here (if they have supplied it).
  • Try some different data. Go to Help in BattleScribe and you will find a search button that will find you some great data sites.

I can't find any data! Where can I get some from?

BattleScribe does not create or maintain the data files ourselves for legal reasons. Instead it is made by an amazing community of data authors. While we cannot give out the address of a website hosting BattleScribe data, you can find some easily by searching Google for "BattleScribe data files". An easy way to do this is to go to Help in BattleScribe - you will find a search button that will find you some great data sites.

I can't load any data into BattleScribe! How do I do it?

The Getting Started guides for desktop and mobile give you step-by-step instructions on how to find and load data into BattleScribe.

How do I delete my old data and re-download fresh data?

It's a good idea to occasionally clear out your data and re-download it fresh. You can end up with old and obsolete data files that are not useful anymore or that are broken in some way.

On mobile:

  1. Go to Manage Data in BattleScribe.
  2. From the menu, select "Delete all data". *
  3. Remove any repository URLs you don't want any more.
  4. Click the refresh button to re-download the data from your repositories.
  5. Optionally, use the search button under "Help" to find some new data repositories to use.

* Sometimes you might not be able to get to Manage Data to delete your data. In this case you can try manually deleting your data using a file manager app or the Dropbox app.

On desktop:

  1. Go to Manage Data in BattleScribe.
  2. Take note of where your data is located - see "Data location" at the bottom.
  3. Browse to the folder your data is stored and open the "data" folder.
  4. Delete the folders containing your data files for each game system.
  5. Go back to Manage Data in BattleScribe and remove any repository URLs you don't want any more.
  6. Click the Update Data button to re-download the data from your repositories.
  7. Optionally, use the search button under "Help" to find some new data repositories to use.

If I buy the Pro version, do I get it on both my mobile device and desktop computer?

Unfortunately not. BattleScribe Pro needs to be purchased separately for desktop computers and for mobile devices (Android, iOS and Amazon). This is because the various mobile app stores cannot be connected to each other, nor to the BattleScribe web store (for the desktop version). Because of this, any purchases on one store cannot be transferred to any of the other stores.

Essentially, the various mobile app store owners want you to purchase from them since they take a cut of the sale!

In addition to this, according to their guidelines, Apple do not allow you to unlock app features (i.e. Pro features) from outside of their app store. Any cross-platform key/bundle would need to work with iOS apps, and this is not allowed.

It would be great to offer some kind of bundle deal that includes both desktop and mobile versions, but unfortunately it's not possible. This is out of our hands as we have no control over the mobile app stores.

BattleScribe gets stuck "Preparing Data" or "Loading Roster" when I start it up or try to load a roster!

When BattleScribe has a major update (e.g. version 1.14.xx to version 1.15.xx), this normally indicates that the format of the data or roster files has changed. When this happens, any old data or roster files you have will need to be upgraded to the new file format so they continue to work. BattleScribe needs to load each file and make changes to it to bring it up to the new file format.

This can take some time, depending on how much data you have, how many rosters you have and whether you have an older or slower device. BattleScribe only needs to upgrade each file once.

What you can do:

  • Try just giving it some time. Be patient! Slower devices can take a few minutes to upgrade all the data.
  • This might be a good opportunity to delete your data and re-download it. Less data means it will be quicker to update, and it is likely that you have old, broken or obsolete data files that you don't want any more.
  • Sometimes on Android you might find you can't get to Manage Data to delete your data. You can try manually deleting your data with a file manager app or through Dropbox.

How can I manually delete my data on Android?

Sometimes you might find that you can't get to Manage Data on Android in order to delete your data. In this case, it's still possible to delete your data manually using a file manager app (if your data is stored on your device) or through Dropbox (if you use Dropbox to store your data).

My data is stored on my device:

  1. Install a file manager app from Google Play or your favourite app store. I use this one, but you can search for "File Manager" in the app store to find alternatives if you prefer.
  2. Launch the file manager app to browse the files on your phone or SD card. You should see a folder called "BattleScribe".
  3. Open the BattleScribe folder, and inside you will see your roster (.rosz) files and a folder called "data".
  4. Delete any roster files you don't want (usually long-clicking files or folders gives you the option to delete).
  5. Open the "data" folder. You will see a list of folders - one for each game system you have data for.
  6. Delete any game system folders you don't want in the same way as before.

My data is stored in Dropbox:

  1. Make sure you have the Dropbox app installed.
  2. Launch the Dropbox app to browse the files stored in Dropbox. You should see a folder called "apps". Inside that you should find a folder called "BattleScribe".
  3. Open the BattleScribe folder, and inside you will see your roster (.rosz) files and a folder called "data".
  4. Delete any roster files you don't want (usually long-clicking files or folders gives you the option to delete).
  5. Open the "data" folder. You will see a list of folders - one for each game system you have data for.
  6. Delete any game system folders you don't want in the same way as before.

I get the error "Some selections have been removed from your roster..." when opening a roster!

This message happens when the data file you made your roster with has been changed since you created the roster. The data file was probably updated by the author to fix bugs or add new features.

All selections in your roster must link back to items in the data file. If an item in the data file has been removed, then it must also be removed from your roster.

When this happens you will need re-select the items in your roster that were removed.

I get the error "More than one file found with the same ID" and I can't create a roster!

This is a problem caused by duplicate data files. The best thing to do is to delete and re-download your data files.

I get the error "There were some problems with your data files..." when I try to create or open a roster!

This means that BattleScribe has detected some problems with your data files. Your data is probably old or broken in some way. You can continue to make or open a roster, but you may run into strange behaviour or crashes. It is highly recommended that you switch to some better data.

In BattleScribe, go to Help and you will find a search button that will find you some great data sites. You may want to delete your old data beforehand:

On mobile:

  1. Go to Manage Data in BattleScribe.
  2. From the menu, select "Delete all data".

On desktop:

  1. Go to Manage Data in BattleScribe.
  2. Take note of where your data is located - see "Data location" at the bottom.
  3. Browse to the folder your data is stored and open the "data" folder.
  4. Delete the folders containing your data files for each game system.

All my categories and profile types have gone missing!

This means that the game system data file is very old, is broken, or has not been edited in a long time. BattleScribe 1.15.xx no longer supports legacy data files, but there is a way for data file authors to fix this.

My data was made by someone else and I downloaded it from the Internet

  • Contact the data file author to let them know about the problem. Direct them to this FAQ page to let them know how to fix it. You can try contacting them through the website you originally got the data from.
  • This might be a good opportunity to switch to some newer data. The data you're using might be old, broken or no longer actively maintained.
  • You can try fixing the data yourself as described below.

I created the data, how do I fix it?

  1. Download BattleScribe version 1.14.07b.
  2. Use this version to open the broken game system file in the editor and increment the revision number.
  3. Save the game system file.
  4. Repeat the above steps for any catalogue files that still cause problems.
  5. If you are hosting the data as a repository on the Internet, update your repository.