troussej / mtg-photoshop-automation

Photoshop scripting to generate high-quality Magic card renders, inserting Scryfall data into Photoshop frame templates.

MTG Photoshop Automation

Photoshop scripting to generate high-quality Magic card renders, inserting Scryfall data into Photoshop frame templates.

Trademark and copyright Wizards of the Coast 2021. Templates for this project include Wizards of the Coast's IP, including: the Beleren font, mana symbols, set icons, background textures, and card text. Templates for this project include the appropriate copyright disclaimers. Read WotC's fan content policy here: https://company.wizards.com/en/legal/fancontentpolicy

Example

Requirements

• A copy of Photoshop. I tested the system using CS5 and CC 2018, but other versions may work as well.
• The Photoshop templates:
  • Automated templates (compatible with this project)
  • Manual templates which may also be of interest
• The following fonts:
  • Beleren Smallcaps, MPlantin and MPlantin-Italics and Beleren2016,
  • My custom Magic symbols font, NDPMTG,ttf, included in the repo,
  • Keyrune and Mana, for the expansion symbol and transform symbols,
  • Relay Medium and Calibri.
• json2.js, included but you may need to download a more recent version.
• A standard installation of Python 3.

Install and Usage Guide

• Clone to a folder of your choice, referred to as the working directory.
• Install the included font and the other fonts specified above.
• Download the Photoshop templates, create a folder called templates in the working directory, and extract them into the folder.
• Create a folder called art in the working directory, and another called out.
• Move all of your card artwork to the art folder. File names should be structured like <CARDNAME> (<ARTIST NAME>).jpg. Artist name is optional - if omitted, it will be retrieved from Scryfall. You can optionally specify the card's set by structuring the file name like <CARDNAME>$<SET> (<ARTIST NAME>).jpg.
• Run the script render_all to render each card in the art folder, and store the results in the out folder. render_target does the same but for a single image.
• Modify settings.jsx to change how the scripts behave - change the expansion symbol; force the system to use a particular template; or force the system to stop before saving your cards and exiting so you can adjust them manually.
• Optional: Copy the files from /scripts/utils to the Scripts folder in your Photoshop installation. For me, this was C:\Program Files\Adobe\Adobe Photoshop CC 2018\Presets\Scripts. Modify the paths in those files to point to the corresponding files in /scripts. This enables the use of a few utility scripts which are handy when making renders manually.

FAQ

• I want to change the set symbol to something else. Head over to https://andrewgioia.github.io/Keyrune/cheatsheet.html - you can use any of these symbols for the set symbol for your cards. Copy the text of the symbol you want on the cheatsheet, then replace the expansion symbor character in quotations at the top of the file with the character you copied.
• I'm getting an error message saying that the Python call failed and card.json was not created. This is a result of the Python command not executing properly on your computer. The error message contains a copy of the command the system attempted - copy this command and try running it from the command line. You may need to adjust the command in call_python() in render.jsx depending on how your Python installation is configured.

Scope

• Modern style cards, normal and extended; transform and mdfc, front and back; basic lands, normal, Theros, and Unstable styles; planeswalkers, normal and extended; mutate, adventure, miracle, and snow cards; and various flavours of fancy frames - stargazing, universes beyond, masterpiece, ZNE expedition, and womensday.
• Leveler and saga cards require manual intervention to position text layers, but are automated up until that point.
• Planeswalkers also require manual intervention to position text layers and the ragged textbox divider, but are automated up until that point.
• Flavour text divider is not supported, as rules text & flavour text are formatted in the same text layer, and it would be impractical to position the flavour text divider programmatically with Adobe's JavaScript library.

Customisation

The repo includes a set of helper functions and boilerplate classes which make automating any given template straight-forward. You'll need reference layers (check out my templates on google drive for examples) for artwork to be positioned against, and for any text layers that need to be positioned vertically within a textbox. Check out the comments at the top of templates.jsx for more info, and you can review how I've automated my templates there for reference as well. You'll also need to adjust the function select_template() in render.jsx to point to your template class(es).