Coding Cards in C Tutorial

Before you start coding new cards, make sure you know the basics of how to add non-coded cards. This can all be found in the basic tutorial, level 0.

Getting Started

The hardest part about coding cards in C may be getting started! These are the steps I followed to get up and running. Several of them may be unnecessary, but it's he only way I know. (I did this in Win XP)

1. Download and install Camelbox (http://www.softpedia.com/progDownload/CamelBox-Download-105269.html)
2. Choose to install all of the components offered, and make sure camelbox/bin is added to your path.
3. Download the latest copy of the manalink distribution.
4. Unzip the distribution into c:\magic as well as c:\camelbox\bin. (you should now have a c:\camelbox\bin\src directory with lots of stuff in it, as well as c:\camelbox\bin\build.pl)
5. Make sure that yasm.exe and make.exe are in that directory.
6. Open up the command prompt (programs->accessories->command prompt) and cd c:\camelbox\bin
7. Run 'perl build.pl' from the command line. The code should compile without errors.

Adding a New Card

Now we'll try to add a trivial card, Rorix Bladewing. This same card is added in the tutorial, level 1.

1. Open src\cards\cards.c in a text editor.
2. Copy and paste any other card function (they all start with card_), and change the name of the function to card_rorix_bladewing.
3. Delete all of the code in the card except the function declaration.
4. Rorix has 2 coded abilities, haste and legendary. Look at the API for Magic Coding in C and see if those functions are available.
5. They are both available in the API, so just add calls to those functions in your function.
6. Your code should look like:

code...

1. Run build.pl from the command line. Since we are creating a card for the first time, also pass to build the name of the card. I.e. build.pl rorix_bladewing
2. Note the address at which rorix is added.
3. Hopefully everything compiled. If not, fix any syntax errors and try again. When you call build, though, do not pass in the name of the card again. That is only required the first time.
4. Open SkyMagic Editor and add your card. The address mentioned earlier is the code pointer for your card.
5. Save, run csv2dat, etc. Your card has been added. Congratulations.