Magic Assistant Overview

Workspace

Workspace is the directory where Magic Assistant store all its data, by default it is in your home directory, in sub-directory MagicAssistantWorkspace. Check installation instructions if you want to change it. Please ensure you back it up regularity or sync to avoid data loss. See Setting up cloud sync or version control for more details.

Overview

Magic Assistant is application for browsing "Magic: The Gathering" ™ cards (see official wizards website) and organizing cards into decks and library collections. Also contains tournament organizer for MTG in-house tournaments. You can also switch to "Tournament Organizer" from Windows menu.

For more information on Magic Assistant check Magic Assistant website.

Few terms that Magic Assistant uses:
card - magic card;
card printing - abstract representation of printed card, contains card properties such as name, type, rating etc.;
card instance - concrete representation of card, has reference to printing, but also has additional properties such as count, comment, special tags (foil, online, mint condition, fortrade, etc);
collection - set of magic cards stored in a specific location or virtually grouped;
deck - specialized collection which is designed for play (when application refers to term collection it usually means both deck or non-deck collection);
own card - card that you own physically or online;
virtual card - card you don't own, but want to play with, by creating virtual decks or wishlists;
card pile - representation of card instances in a single element, with count, pile can be split if you need to move individual cards around;
card database - set of card printings cashed locally representing all cards that app knows about (usually synced with "Gatherer" web site)

Car Organizer perspective contains several views (panels):

MTG Database - To browse existing mtg cards,
Card Info - To view detailed card information and picture,
Card Navigator - To browse your own decks and collections,
My Cards - To browse all card instances your created in app (own or virtual cards),
Decks - To look at the cards in each deck or collection individually, and run deck analysis tools,
Printings - To show card printing, sets in which selected card is available and languages currently loaded to local database.
Instances - To show all instances of card with given name in your collection (real or virtual)
Collector - View of your personal cards with fields and grouping relevant to card collector, rather than player

You can changes layout of your views but dragging them around by the header. If you get lost you can reset to original layout using menu "Window->Reset Perspective...".

If you are not familiar with eclipse please note that some actions are available from the "view menu", this is small triangle at the top right corner of each view. Context sensitive actions are available from context menu, which is invoked by "mouse right click" on windows and linux.

Updating Magic Card Database Online

MTG Database View shows all available cards. By default it will only show cards witch pre-loaded with application. It can quickly be out of date, to keep database in sync you have to perform cards updates. App will check for update automatically on startup (unless you turned it off). To update cards manually, see updating database section. Cards are updated from the official magic maker website called Gatherer http://gatherer.wizards.com. If you see something wrong with database info please check this website first and report issues to them. For sets they don't have, there is a complicated procedure of how you can extend database manually, check the end of updating database section or ask on forum.

Browsing and Searching

To browse cards you can use grouping, sorting and filtering:

You can sort by any column by clicking on the column header in the views that display card tables. If you click again sorting order is reversed. You can also see more columns, control is available from "Preferences..." menu of the view menu triangle button. You can also sort cards by column which is not currently visible using sorting menu.

You can filter cards in the view by opening filter. Filter action is on view toolbar and also available from the view menu. You can select one of more criteria from the filters. See details in Filter Dialog reference. You can also filter cards by name, type and colour using quick filter - the bar on top of card tables. Grouping is also available from the action bar of view menu, there is few fields and field combination you can group by.

You can bring up search control using Ctrl-F key or using view menu "Find...". It allows you to find a card in the view by name (or part of name). Comparing to filter it does not remove the cards from the list. See details in Search Bar reference.

Card details and scanned card picture are shown in the Card Info view. It shows card image if available (downloads it from internet), and also shows card name, description and type below the image. Click on the card in any of the tables to see card info in this view. See more details in Card Info View reference.

Building a deck

To build a deck you need Card Navigator view, from there you can add a new deck and place it in the desired folder. After deck is created you can populate it by moving cards from database or from other decks or collection, or using deck Import. When moving own card from collection to deck, the location changes. If you prefer just to create virtual decks, create deck with virtual flag and use copy drag instead. See more details in Creating and Populating a Deck or Collection.

You can edit cards in your decks and collections. To edit card properties you can select one or more cards from the table and choose "Edit..." from context menu (or double click on a card). Editable card properties currently are: count, comment, ownership and price.

You can analyse you deck using some tools: Mana Curve, Colors, Card Types, Draw, Legality - these are tabs at the bottom of the deck view. Also you can group cards to achieve same statistics in the main table tab using Group By menu (from the view menu).
Mana Curve - shows chart of your deck mana curve (number of cards vs cost) for spells (land is not there). Average bars - is normal distribution of cards in average deck adjusted to number of cards in your deck (hardcoded in program, it is not based on your decks) .
If you have sideboard it is stored in the separate list. To bring it up use Open Sideboard action from toolbar or view menu of Deck view. Drag and drop cards to sideboard from other sources same as for main deck. If you want to see sideboard and main deck at the same time drag sideboard view to the bottom (and have main on the top). Sideboard is linked the the main deck, tabs like Legality and Export are also looking at sideboard cards (while tabs like Mana Curve don't). Operations like deck Rename or Delete will also affect its sideboard.

Storage and Internet

All data is stored in directory called "workspace" (conceptually, the real name is whatever you named it). When app first starts it will ask where your workspace is. You only need one workspace. Don't put it inside installation dir - that can create problems with software update and upgrade. Decks and Collection as well as database itself are stored in xml format, means you can edit it in editor if you really wish. All card images and set images are loaded from internet and cached in workspace as well. If you choose to do so you can work offline, controlled by settings. If you behind firewall there are settings to allow a redirect proxy.

If you want to host your decks on the cloud you can do so by enabling syncronization of your workspace or its subfolders into the cloud storage such as box, dropbox, google drive, etc. Syncing whole workspace is probably a not a good idea since it contains cached images which would take majority of the space. Next option is to sync workspace/magiccards folder which is all your cards and database. See Setting up cloud sync or version control for more details.

It is recommended to backup your data once in a while by zipping contents of magiccards folder. You can also use File->Backup action that does that.

If you have issues with software you can send a bug Help->Send Bug or Feature Request and attach the log file found at workspace/.metadata/.log if this is a bug.

Other stuff

Some other actions available from main menu, context menu (right click) or from view menu (triangle button in the view header triangle button). See also MTG Database View reference.

MTG Database.