CSV
Export a CSV file of your project, then make mass changes by editing it in a table editor like Excel and re-importing it. This can be used in conjunction with the Template system to produce new cards as well. CSV import/export is found in the top-right central navigation dropdown menu.
It is encouraged to export the CSV file of your project right before you intend to make changes, so that you always have the most recent state of your cards. Card Engine uses card IDs, so the order of the cards does not matter in the CSV file.
Adding a new card: To add a new card, simply leave the CardID column blank. Alternatively, assign a custom ID. If the ID does not exist, Card Engine will create a new card. Creating new cards requires a templateID to be assigned. If you do multiple lines with the same CardID (By accident?), Card Engine will apply each row to the same card, effectively making only the last row with the correct CardID relevant. To find a card or template ID, open the card in the editor and look for the ID label. Clicking the card ID text will copy it to your operating systems clipboard, allowing you to easily paste it in your CSV file.
Deleting a card: To delete a card, simply place a ! at the beginning of the CardID cell.
Moving a card to another deck: In the deck column, the name you specify is the name of the deck you would like to move the card to. If this deck does not exist, it will be created. If you leave the cell blank, the card will be returned to the default deck.
Adding a new deck: The name you specify in the Deck column is the name of the deck you’d like to place the card in. If this deck does not exist, it will be created.
Deleting a deck: Simply place a ! at the beginning of any of the cells under the Deck column with the deck name you would like to delete. (You don’t need to call it for every single card that was in the deck). All cards that were previously in the deleted deck will be moved to the default deck.
Adding a new line/line break: All text cells must be one line for Card Engine to import them correctly. You cannot use regular “empty” line breaks in the .csv file, as this breaks the CSV formatting. Instead, you can use \n or <br> where you want to add a new line. \n is the internal, hidden line-break, so you might prefer <br> if you want to see the formatting when editing the text.
Example:“At the end of your turn,\nyou have a 50% chance\nto draw a card.”
“At the end of your turn,<br>you have a 50% chance<br>to draw a card.”
Where to find a card/template ID: Open the card or template in the editor, then simply click the id text at the top, next to the card name. Clicking it will copy it to the OS clipboard, so that you can paste it into Excel etc.
Tags
When you assign a tag to an object, for example, “Damage” to a text, a column with the “Damage” header will appear in the CSV file. Changing the cells in this column will update any text tagged “Damage” on the card when the CSV is imported again.
Image IDs and texts use the same cells under their tag column. For images, the cell consist of category_file. For example, an image asset with the name “Warrior” imported to a custom category called “Custom” would have the ID Custom_Warrior.
CSV File Structure
The easiest way to get a CSV with the correct structure for Card Engine is to:
Make a Template card
Create a new normal card and assign the Template to it
Export the CSV file from the top-right menu
That will give you the correct structure. When you add tags in the editor in the top-right "tags" field, they will appear as their own column in the CSV. Otherwise, after the “Name | CardID | TemplateID | Deck” cells, the tag columns are flexible, Card Engine will look for elements with a tag matching the column header and apply the data.
NOTE: When update 0.18 goes live, there will be an additional column for Quantity of cards to export, so the entire current structure will move one cell to the right, and the first column will be used for Quantity.
