Tutorials

  1. Formatting text content
  2. Search reference
  3. How to import sets into PlaneSculptors

Formatting text content

Most input where you enter a block of text, such as set description or user profile page content can be formatted using an extended Markdown syntax. This tutorial will introduce you to Markdown and descibe of all the extensions provided by WebDrafter.

Introduction to Markdown

Markdown is a markup language used to format text on websites like Reddit and GitHub. You can see a quick "cheat sheet" below. For more advanced guide see Mastering Markdown. In addition to standard Markdown, WebDrafter also supports GitHub-style tables (see example below).

# Heading level 1
## Heading level 2
### Heading level 3

*Italic text*
**Bold text**
~~Strikethrough~~

* Unordered list item
* Unordered list item
* Unordered list item

1. Ordered list item
2. Ordered list item
3. Ordered list item

[Link title](http://www.google.com)
![Image title](http://www.github.com/images/logo.png)

First Header | Second Header | Third header
------------ | ------------- | ------------
Content from cell 1 | Content from cell 2 | Content from cell 3
Content from cell 4 | Content from cell 5 | Content from cell 6

Magic symbols

These are all the Magic: the Gathering symbols that you can use in text. The symbols will correspond in size to currrent font size (for example, if you include a symbol in a heading, it will be enlarged appropriately).

Syntax Result Name Note
[C]
Colorless mana  
[W]
Colored mana Available for all 5 colors.
[bW]
Monochrome mana Available for all 5 colors.
[1]
Generic mana Available for numbers 0-20, X, Y and Z.
[T]
Tap  
[UT]
Untap Also available under
[Q]
.
[WU]
Hybrid mana Available for all 10 color pairs, in either order.
[2W]
Twobrid mana Available for all 5 colors.
[PW]
Phyrexian mana Available for all 5 colors.
[P]
Phyrexian mana (colorless)  
[S]
Snow mana  

Most input where you enter a block of text, such as set description or user profile page content can be formatted using an extended Markdown syntax. This tutorial will introduce you to Markdown and descibe of all the extensions provided by WebDrafter.

Introduction to Markdown

Referencing cards

Unlike on traditional Magic: the Gathering message boards, many sets can contain different cards with the same name. Additionally, each set can exist in multiple versions. Because of this, the syntax used to reference cards on WebDrafter is slightly more complicated. Card refernce will be transformed into a hyperlink leading to that card's page, and will also display image of that card when the user hover with his mouse cursor over the link.

The most basic syntax is this:

[[Lightning Bolt]]

This only works when used in a context where it is completely obvious, which set the piece of text content relates to - on set page (the lastest version of the card will be referenced) or on set version (the card fom that version will be referenced).

You can also specify to which set the card belongs to using that set's URL name (applies for set with URL http://www.planesculptors.net/set/modern-masters-2015):

[[modern-masters-2015:Lightning Bolt]]

This will always reference the newest version of the card.

Next step is to specify which version of the card is referenced, by adding that version's URL name (considering version with URL http://www.planesculptors.net/set/modern-masters-2015/version-3):

[[modern-masters-2015:version-3:Lightning Bolt]]

You can also specify text of the link, without affecting which card that link points to using the pipe symbol (works in combination with any of the above):

I love [[modern-masters-2015:version-3:Lightning Bolt|bolting]] my opponents!

If you want to include an image of the card, instead of a link, you can add an exclamation mark symbol before the initial [[ (also works with any of the above notations):

![[modern-masters-2015:version-3:Lightning Bolt]]

Additionally, you can set the image to align left or right:

!l[[modern-masters-2015:version-3:Lightning Bolt]]
!r[[modern-masters-2015:version-3:Lightning Bolt]]

Either of these will also make text flow nicely around the card image (if you don't specify alignment, the image will be placed inline into the text).

Font Awesome

Font Awesome is publically available library of hundreds of symbolic icons for web applications. You can use any of these icons using following syntax, where fa-thumbs-up is name of the icon:

[fa-thumbs-up]

Which will result in this: . All icons from all FA versions up to 4.4.0 are supported. As with the Magic symbols, all of these will scale with current size of the text. :) and :( will be transformed into appropriate Font Awesome emotes even without the explicit syntax.

Inline HTML

You can use HTML arbitrarily in combination with any other syntax offered by WebDrafter, with inline CSS being allowed as well. With HTML, you can achieve many things that the simple markup syntax wouldn't allow you to. Please take care not to interfere with layout of the website, otherwise yoru content will be taken down.

Page source code

You can view the source code of any user-submitted formatted text on any page (user profile, set page etc.) by adding "?source" to the URL of that page, for example http://www.planesculptors.net/set/modern-masters-2015/version-3. If that page specifies a hash fagment (#detail), always add the source parameter before it.

Search reference

This section describes how to use the "Explore cards" field.

The simple "language" used to search the card database is based on the query language used by magiccards.info and Scryfall. As a quick comparison to Scryfall (which has slightly more feature that magiccards.info), these are the main differences:

Basics

The search query is composed from terms that are separated by spaces. Each term may include a keyword, such as color: which determinews what attribute of the card the term applies to. If the keyword is not provided, the term will apply to the card's name, types and rules text. These terms are never case sensitive. Unless specified otherwise, all terms must be matched for the card to match the query.

Terms that include spaces need to be wrapped in double quotes (otherwise they will be considered multiple terms):

! operator can be used either as prefix (exact name match) or infix (exact attribute match):

With some keywords that represent numeric attributes such as "toughness", you can also use numeric comparison operators <, <=, > and >=. You can generally use operator = instead of : (they are treated identically). With most keywords, you can use the != meaning "not equals to".

Negating terms

Prefixing a term with - will match all cards that DO NOT match the term:

  • color:blue -color:red (blue cards that are not red)
  • Colors

    You can find cards that include a particular color using c: or color: followed by a full color name or a single letter. colorless or c and multicolor or m are also supported.

    This color includes all the colors in the mana cost if not specified explicitly by a color indicator (in which case the color is determined by the color indicator).

    Examples:

    Order of colors doesn't matter, even when the exact match operator (!) is used.

    Card types

    You can use t: or types: followed by a string to find cards including particular type (or types) on their type line. If you use a string with multiple words, these words have to appear on the card in the exact order in which they are on the card.

    Examples:

    There are also shortcut classification terms is:spell and is:permanent that match the appropriate card types. is:token also works.

    Rules text

    You can use o: or oracle: or rules: or text: or rt: followed by a string to find cards including that string in their rules text.

    Examples:

    There is also a shortcut term is:etb for cards that include "enters the battlefield" in their rules text.

    Note that automatic replacement of "~" with the card's name is not supported.

    Mana costs

    You can use m: or mana: followed by a mana cost to find cards that include specific string in their mana cost. There are three different ways to enter mana costs:

    These syntaxes can be liberally combined even in a single term.

    Order of the symbols matters.

    Examples:

    You can also use cmc: to find cards with specified mana costs. Arithmetic comparison operators are supported.

    Power and toughness

    You can use pow: or power: and tou: or toughness: to find cards with specific mana costs. Arithmetic comparison operators are supported. You can also compare power and toughness to each other (but not to other attributes).

    Examples:

    Multi-faced cards

    Generally, at least one of a multifaced card's faces must match the search criteria to show up in search results.

    You can query card's "shape" using the is: keyword:

    Rarity

    You can use r: or rarity: to find cards with specific rarity. Use either full name ("common", "uncommon", "rare", "mythic" or "special") or a single letter shorthand:

    Examples:

    Sets, set statuses and authors

    You can use s: or set: or e: or edition: to find cards from specific sets. To specify a set, you can use either a part of its name, part of its URL name or a part of its code.

    You can also chain multiple sets using | or , (cards that appeared in at least one of the chained sets).

    Examples:

    You can use st: or status: to find cards from sets that are in specified status. Valid values are "unplayable"/"un", "design", "development"/"dev", "finishing" and "finished"/"done". You can use arithmetic comparison operators with these values.

    Discontinued sets are not matched unless you specifically ask for them with st:discontinued or st:dis.

    Additionally, you can use st:play or st:playable to find cards from sets that are not in statuses "unplayable and "discontinued".

    You can use au: or author: to find cards from sets made by specific author. The author can be specified using either their user name or their URL name:

    Artist and rules text

    You can use a: or art: or artist: to find cards with art by specific artists (as specified in the card's footer):

    You can also use f: or ft: or flavor: to find cards with specific string in their flavor text:

    Unrolling searches, upload dates

    By default, only cards from the newest version of each set are searched. However, unlike in Scryfall, a card can be matched multiple times if it appears in multiple sets (even if it is exactly the same).

    You can unroll the search by prefixing it with ++, which will cause all versions of all cards to be searched.

    You can also restrict the cards matched by date when they were uploaded to the site using date: keyword. You should use arithmetic comparison operators with date (exact matches make little sense). Note that if you use this keyword without unrolling the search using ++, only cards from sets that were last updated during matching time interval will be matched.

    Date can be specified either in "YYYY-MM-DD" format or intuitively such as "yesterday", "-3weeks" (for details see strtotime PHP function). Note that if you specify a date this way, the exact moment specified is 00:00 of that day.

    For technical reasons, only versions of cards uploaded after 29th September of 2016 are searched (images from set versions older than that are stored off-site and are mostly broken).

    How to import sets into PlaneSculptors

    This tutorial assumes you created your custom set using Magic Set Editor 2.

    1. Export card data file for WebDrafter
      1. Download WebDrafter export template for MSE.
      2. Extract the archive into the "data" directory in the location where MSE2 is installed. Restart MSE, if it was running.
      3. In MSE, go to "File"->"Export"->"HTML". Click OK and choose an export location.
    2. Export card images
      1. In MSE, go to "File"->"Export"->"All card images".
      2. If you want, you can change the file extension to .png for improved image quality (but bigger image files).
      3. Click OK and choose a directory where the files will be exported.
    3. Publish card images on Google Drive
      1. If you don't have Google account, create one. It is completely free.
      2. Download and install Google Drive application on your computer.
      3. Open File Explorer and go to Google Drive (it should be in the Favorites section in the left panel, if you have recent version of Windows). If you can't find it, go to tray bar (on bottom left of the screen, just next of the clock) and look for a Google Drive icon (a green-yellow-blue triangle), click it and click "Open Google Drive folder".
      4. Create a folder where you will put the card images. I recommend to have a nice folder structure, something like "Custom Sets/Khans of Tarkir/Khans of Tarkir 1.0". It is a very good idea to keep older versions of the set intact, so that WebDrafter can keep older drafts in its archive.
      5. Right click the folder in Windows Explorer and in the context menu go to Google Drive -> Share... . In the window that opens go to Advanced and make sure "Who has access" includes "Everyone - public on web".
      6. Copy the card images into the prepared folder. Next time, you can have MSE generate the card images straight onto the Google Drive.
      7. Wait until Google Drive uploads the images into the cloud. You can see the synchronization status when you click on the Google Drive icon in the tray bar.
    4. Import the set into PlaneSculptors
      1. Go the the main page of PlaneSculptors.
      2. Click "login". You will be redirected to a Google page. If you are not yet logged into Google, log in. Then authorize PlaneSculptors. You will be redirected back to the application, the the main page of the member area.
      3. Click create set.
      4. Fill in set name (the name must be unique across all registered sets) and set code (that doesn't have to be unique).
      5. Your set was created. Now go to "Upload card file" tab.
      6. Depending on your card image format, choose appropriate option in "Art file name format".
      7. Add the set files and all the image files to the uploader. You can either click it and select all the files in the popup window or you can drag and drop them into the uploader area. I prefer to export the set file into the same directory as all the images, so that I can just click the uploader, navigate to the directory where all the files are and hit "Ctrl+A" to select all the files.
      8. Click "Proceed". The importer will now check if there are any errors in the import file and then will redirect you to the next stage.
      9. If you have created a Cockatrice package, upload it to some place on the internet and put the link into "Download URL".
      10. Click "Submit". You will be directed back to the set management page.
      11. Your set now has cards. If you want the set to be playable, go to "Development stage" tab and select an appropriate option.
      12. You can also make a beautiful home page for your set on the "Set details" tab.
      13. If you want the set to become publicly listed on the website, click "Make public". Make sure that the set reflects well on you and the custom magic community as a whole. Please don't make effortless dreck public. You can still host events with your private sets.
      14. You can now host events with your set!