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 where you want to add a new line.
    Example: “At the end of your turn,\nyou have a 50% chance\nto 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.

Previous
Previous

TEXT VARIABLES

Next
Next

PRINTING