Creating custom content
After loading a Minecraft world with the TCG mod, a new folder will be created in the root Minecraft folder called "tcg". When using on a server, the folder will be in the server's root.
Inside the "tcg" folder will be 2 more folders, "cards" and "packs". This is where jsons for making custom cards and packs will go.
Inside the "cards" folder is an example card called "example.json". This file can be used as a template for making new cards, or it can be deleted/overwritten if desired. For the purposes of this tutorial, we'll be using it as a template. So make a copy of the file and name it whatever you want.
Open the new json file in any text editor to setup the card. Each card file contains 11 variables that define that card:
| Variable | Definition | Example |
|---|---|---|
| cardID | The internal ID for the card. Must be unique!. | tutorial_card |
| cardName | The display name for the card. | Tutorial Card |
| rarity | The "rarity" of the card. You must choose from Common, Uncommon, Rare, Super Rare, Ultra Rare, or Secret Rare | Super Rare |
| desc | The flavor-text for the card. | A tutorial card. |
| pack | The "packID" this card can be found in. Must match to an existing "packID"! | base |
| backColor | The color of the card background in ARGB format (AARRGGBB). Normal hex color codes are in the RGB or RGBA format. To convert RGB to ARGB add "FF" in front of it (FF8800 -> FFFF8800). To convert RGBA to ARGB move the last 2 characters to the front (FF8800DD -> DDFF8800). | FFFF0000 |
| secondaryColor | The color of the art border and "text" of the card in ARGB format. | FF00FF00 |
| borderColor | The color of the card border in ARGB format. | FF0000FF |
| artColor | The color of the "art" of the card in ARGB format. | FFFF00FF |
| shineColor | The color of the card's shine (if it has one) in ARGB format. NOTE: Even if the card does not have a shine (so common cards) a shine value must still be specific! | FFFFFFFF |
| weight | The "weight" of the card in the pack. Or how likely it is to be pulled. | 50 |
Now you can save the file, and you can see your new card in game with /givecard tutorial_card 0 1.
Creating a custom pack is much the same as creating a custom card. Except you cannot remove or edit "base.json". Doing so will result in a crash or unexpected behavior. But you can still make a copy of it to use as a template. We'll call it, "tutorial_pack". Inside our newly created pack is similar to our custom card.
| Variable | Definition | Example |
|---|---|---|
| packID | The internal ID of the pack. Must be unique! | tutorial_pack |
| packName | The display name for the pack. | Tutorial Pack |
| packColor | The color of the pack in ARGB format. Can be either in the form of AARRGGBB or an Integer. Use a website like https://argb-int-calculator.netlify.app/ to find the integer value. | FF5A00BE |
Now you can save the file, and see your new pack in game with /givepack tutorial_pack 1
And we can now go back into our "tutorial_card.json" file and change the pack to "tutorial_pack" so that our tutorial pack gives us our tutorial card.
And now, when we open the tutorial pack in game:
We get 9 tutorial cards! (9 is the default number of cards per pack and this is the only card we've added to the pack in this tutorial).