Updating Database

By default card database contains only subset of all cards. First of all cards which comes with default installation is snapshot of English cards in gatherer database at the moment of release, so it likely does not contain latest sets. Gatherer is official site for Wizards of the Cost that keeps magic cards database (gatherer.wizards.com). Magic Assistant software only be able to sync with this database online and if something is missing or invalid please check this site first and send them bugs. These are limitations on pre-loaded database Upon first installation database is copied from software into local disk, and from then on you can only update it using card database update commands, new software update will not update your card database. It is actually stored in xml in very simple format, so if you really brave you can fix it manually by editing this xml in rare cases where there are errors in database itself (stored in MagicAssistantWorkspace/magiccards/MagicDB).

Loading latest sets

If you want to load more cards, you can run an update query which will load cards from Gatherer database.

To load missing (new) sets do "Help->Check for Updates to Magic Card Database..." and follow instructions.

Loading localized cards or refreshing

To sync in more advanced way go to "Help->Update Magic Card Database...".

To update from a particular set select it from the drop down list
To update for pre-release set type a name in the combo
To update for latest "released" cards select Standard
To update all cards select All (do it overnight)
then click "Update" button

  • Load all versions of art for basic land - Check this option if you want to load all 4 versions of each basic land in a set, otherwise only one would be loaded
  • Load all printed versions of the same card - For each card in selected set all other printed versions for previous sets would be loaded (same language). For example if set has a card "Air Elemental" all of versions of this card would be loaded, so you will see few of them in your database after update.
  • Also load localized version in: [Language] - Select a different language to load cards in this language

    update db dialog

    Note: Update database does not update extra fields such as Artist, Rating, Legality, etc. See below to update them.

    Loading extra fields

    To load such fields, you need to use Magic DB View. In the view use appropriate filter, then in view menu select "Load Extra Fields..." command, select the fields, and select "Update only cards in the filtered list" (or if no filter enabled - update all). load extra fields

    Extending database: Import

    You can extended database (to add promo cards or some weird sets which gatherer does not support) by importing using table format (csv, pipe, etc).

    First of all you need csv file with cards, usually missing cards are promo cards, which actually exists in another set but were reprinted in some specific set, in this case only fields you need are: NAME|SET|ARTIST|COLLNUM|IMAGE_URL.

    csv example

    In Card Navigator view select Import button, select Extend database options in the bottom and select csv file to import.

    extend db dialog When you press Finish it will tell you that set does not exist and you should create a new set and enter abbreviation for this set. Then your cards should be in the database, and you can add them to your collection or decks (as separate step).

    Extending database: Advanced

    If you brave or know how to program you can extend database by editing xml file representing sets directly. Sets are located in workspace/magiccards/MagicDb/ folder.

    To add set you have to add a line in tables/editions.txt in the folder mentioned above definining properties or the set or you can do the same from UI by going to Window->Preferences->Magic Preferences->Card Sets-> button Add...

    Then you create a set as .xml file with the name of the set but where all non-letter symbols are replaces with _ (underscore). For example Urza's Legacy is called Urza_s_Legacy.xml. Open any of these file to see example of the format. Once you done both steps and restart the app it should pick up new set. The good example is Anthologies.xml - this set is only one that I ship which is not connected to gatherer online database. It shows how to set images URL. Cards id's have to be negative too (positive are used for gatherer now). Html tags in text fields have to be escaped (like <br>)

    xml example