decklist

The code behind decklist.xyz, which generates Magic: The Gathering tournament Registration Sheets, an enhanced version of the original decklist project created by April King.

This fork includes additional features and improvements aimed at providing a more comprehensive and user-friendly experience for generating MTG deck lists.

Features

Modern User Interface

• Dark Mode: Toggle between light and dark themes with persistent preference storage
• Responsive Design: Fully optimized for mobile, tablet, and desktop viewing
• Modern Styling: Clean, professional interface with smooth transitions and hover effects
• Accessible: High contrast ratios and keyboard-friendly controls

Deck Management

• Save/Load Functionality: Save your decklist locally and load it anytime
• Clear All: Quick reset button to start fresh
• Card Autocomplete: Smart card name suggestions as you type (supports 2+ character searches)
• Multiple Format Support: Import from MTGO, MTG Goldfish, Tappedout, MWS, MTG Salvation, and Deckbox

Deck Organization

• Multiple Sort Options:
  • Alphabetical
  • CMC (Converted Mana Cost)
  • Color
  • Numeric
  • Type (recommended)
  • Original order
• Separate Basic Lands: Option to group basic lands separately

Registration Sheets

• WotC Format: Official Wizards of the Coast tournament registration sheets
• SCG Format: Star City Games tournament registration sheets
• Custom Logos: Support for multiple tournament organizer logos
• Direct Linking: Pre-fill forms via URL parameters for tournament organizers

Card Database

• Daily Updates: Automated card database updates from mtgjson.com
• Comprehensive Coverage: Includes all Magic: The Gathering cards with metadata
• Smart Validation: Real-time deck validation with helpful warnings and errors

Direct Linking

Interested in directly linking to decklist.xyz for your tournament or for your deck building application? It's super easy! Simply set the following GET parameters to have the fields automatically populated:

• firstname: the participant's first name (e.g. April)
• lastname: the participant's last name (e.g. King)
• event: the name of the event (e.g. RCQ Minneapolis)
• eventdate: the date of the event (e.g. 2027-12-31)
• eventlocation: the physical location of the event (e.g. Minneapolis Convention Center)
• decksheet: the deck sheet to use (either wotc or scg, defaults to wotc)
• deckname: the name of the deck (e.g. "RUG Twin")
• deckdesigner: the name of the designer of the decklist
• deckmain: the deck itself; this can be in any format the website understands (use %0A for newlines)
• deckside: the side itself; this can be in any format the website understands (use %0A for newlines)
• decksort: change the order of the cards in the mainboard and sideboard (choices: alphabetical, cmc, color, numeric, original, type, defaults to type)
• disableediting: prevent users from editing the fields above
• logo: available logos for WotC format: mtg, dci, elojodeugin, or custom. Tournament stores can contact us to add their custom logo.

Please note that any field not specifically set will simply be left blank on the form.

Tournament organizer example, for an unregistered player:

https://www.decklist.xyz/?eventdate=2027-12-31&event=RCQ%20Minneapolis&eventlocation=Minneapolis%20Convention%20Center

Or a preregistered player:

https://www.decklist.xyz/?firstname=April&lastname=King&eventdate=2027-12-31&event=RCQ%20Minneapolis&eventlocation=Minneapolis%20Convention%20Center

Just replace the values above with your tournament's values; that's all! Please note that when creating a link, to replace spaces with %20; this is important! :)

Deck building website example:

https://www.decklist.xyz/?deckmain=2%09Arid%20Mesa%0A4%09Brainstorm%0A1%09Council%27s%20Judgment%0A4%09Counterbalance%0A2%09Counterspell%0A2%09Entreat%20the%20Angels%0A4%09Flooded%20Strand%0A4%09Force%20of%20Will%0A4%09Island%0A3%09Jace%2C%20the%20Mind%20Sculptor%0A2%09Plains%0A2%09Polluted%20Delta%0A4%09Ponder%0A2%09Scalding%20Tarn%0A4%09Sensei%27s%20Divining%20Top%0A3%09Snapcaster%20Mage%0A4%09Swords%20to%20Plowshares%0A4%09Terminus%0A3%09Tundra%0A2%09Volcanic%20Island&deckside=1%09Council%27s%20Judgment%0A1%09Counterspell%0A1%09Disenchant%0A3%09Flusterstorm%0A1%09Keranos%2C%20God%20of%20Storms%0A1%09Path%20to%20Exile%0A1%09Pyroblast%0A2%09Red%20Elemental%20Blast%0A2%09Rest%20in%20Peace%0A1%09Supreme%20Verdict%0A1%09Surgical%20Extraction%0A

Everything all together:

https://www.decklist.xyz/?firstname=April&lastname=King&eventdate=2027-12-31&event=RCQ%20Minneapolis&eventlocation=Minneapolis%20Convention%20Center&deckname=Miracles&deckdesigner=CubeApril&deckmain=2%09Arid%20Mesa%0A4%09Brainstorm%0A1%09Council%27s%20Judgment%0A4%09Counterbalance%0A2%09Counterspell%0A2%09Entreat%20the%20Angels%0A4%09Flooded%20Strand%0A4%09Force%20of%20Will%0A4%09Island%0A3%09Jace%2C%20the%20Mind%20Sculptor%0A2%09Plains%0A2%09Polluted%20Delta%0A4%09Ponder%0A2%09Scalding%20Tarn%0A4%09Sensei%27s%20Divining%20Top%0A3%09Snapcaster%20Mage%0A4%09Swords%20to%20Plowshares%0A4%09Terminus%0A3%09Tundra%0A2%09Volcanic%20Island&deckside=1%09Council%27s%20Judgment%0A1%09Counterspell%0A1%09Disenchant%0A3%09Flusterstorm%0A1%09Keranos%2C%20God%20of%20Storms%0A1%09Path%20to%20Exile%0A1%09Pyroblast%0A2%09Red%20Elemental%20Blast%0A2%09Rest%20in%20Peace%0A1%09Supreme%20Verdict%0A1%09Surgical%20Extraction%0A