FightCard



I’ve tried a number of different schemes for tracking initiative in my role-playing games—notes on paper, initiative cards, simple clockwise advancement, and various software packages, commercial and free. Most that I’ve tried delivered what they offered, but none have feature sets that match exactly what I want.

Enter FightCard—a JavaScript application of my own creation that runs inside a web browser and tracks the current actor, initiative for monsters (and optionally for PCs), ready/delay states, hit points, round count, and brief notes for each combatant—and that’s about all. It’s only for managing initiative and a combatant identification during combat; it’s not a full-fledged campaign manager. But I find it useful for my GMing style, and I hope that you will, too.

By the way, FightCard supports (with tighter or looser fit) any role-playing game that organizes combats into rounds where each combatant has one turn, uses an initiative number to sequence combat rounds, and tracks combatant health using hit points or the equivalent. That describes a very large number of RPGs, including all varieties of my favorite fantasy and science fiction role-playing games

.

System Requirements

FightCard runs in your web browser—and if you’re reading this, you have a web browser. FightCard runs straight from your hard drive, so you can run it whether or not you have an active Internet connection during your game. If you do have an active Internet connection available during your game, you can link individual monsters to D&D Compendium entries, if you also have a D&D Insider account.

Installing FightCard

FightCard runs from a folder on your local storage device. Download the compressed folder here, then expand it into any location you choose on your hard drive, flash drive, or other storage gizmo. The FightCard folder includes two subfolders, Campaigns and Reference. Store all your FightCard campaigns in the FightCard/Campaigns folder; store any local resources you want FightCard to display (text files with monster notes, images saved from the D&D Monster Builder, PDF character sheets, or whatever) in the FightCard/Reference folder. If you choose not to do it this way, FightCard will fail due to security precautions built into all modern browsers.

Upgrading FightCard

Note: The current version of FightCard is 1.2.

New versions of FightCard will always be released as compressed folders that include the full first-time installation package. If you are upgrading from an earlier version of FightCard, download the new version to a safe place on your hard drive, and copy only the FightCard.html file into your existing FightCard folder. Do not overwrite your Campaigns and Reference folders, or you will lose all previous data!

Adding Data to FightCard

FightCard needs encounters for you to run, and creatures (run by the GM) and characters (run by the players) to populate those encounters. You can save all those things in a campaign file.

Enter creature and character data on the Manage Creatures tab. The controls should be pretty much self-explanatory. If you’re using a creature from the D&D Compendium and you know that creature’s ID number in the Compendium database (the number after "monster.aspx?=" in a creature’s direct URL, such as 2940 for a fell taint pulsar), you can link the creature to the Compendium entry. (If you are using Safari, you can even import data from the D&D Compendium, and then save it locally.) The same holds for local files; you can link a creature to an image or PDF file stored in the Reference folder, and quickly access it in a browser window during play.

Tip:For now, the feature that imports data from the D&D Compendium (using the public D&D Compendium API) only works in Safari, not in Firefox (the two browsers I use most often). Safari is available for both Mac OS and Windows, so everybody can share the love. Even if you prefer Firefox, you might find it convenient to fire up Safari long enough to download the Compendium Data (it takes about ten minutes) and save that data in a campaign called "Monster Manual" or something like that. Then you can load that campaign into FightCard and save it with a different name to easily create a new campaign with all the Compendium monsters listed. Once you’ve finished the download-and-save process, you can switch back to Firefox—but once a month, after the Compendium is updated, you may want to run FightCard in Safari long enough to download the updates. Caution: The import-from-Compendium process can take ten or more minutes to complete, depending on your connection speed and processor speed. Be patient, and if your browser prompts you to let the script run, let it run.

Another Tip: If your creature is linked to a D&D Compendium entry or a local file, you can double-click on that creature’s name in the "Select Creature" pane to view that file.

Create encounters and add creatures to them on the Manage Encounters tab. Again, the controls’ functions should be pretty obvious. Once you’ve added a creature to an encounter, use the "Unique Marker" field to differentiate copies of the same creature. Since I use miniatures, I use the "Unique Marker" field to hold a note about which miniature represents which iteration of a creature (e.g., "kobold with spear" or "kobold with sword"). You can just leave this field blank if you prefer.

The FightCard folder "ships" with an example campaign containing six creatures (all linked to the D&D Compendium) and two encounters for you to play around with while you learn the program controls.

Once you have some creatures and encounters in your campaign, please be sure to save it! Just look for the Save … button in the upper right-hand corner. Follow the instructions for your particular browser very carefully. Then, the next time you run FightCard, you can open your saved campaign using the Choose … button. You can also visit the Preferences tab to set up a default campaign to load automatically whenever you launch FightCard.

Running Combat in FightCard

If your campaign has at least one encounter in it, you can run combat on the Manage Combat tab. You should be able to tell pretty much at a glance what all the controls do. Select an encounter in the Configure Combat pane, set the other options the way you want them, and click Begin Combat … Presto! You’re in combat. The Combat Editor lets you add more creatures, or even a whole separate encounter, while a combat is running. (For the moment, however, don’t try to go add a whole new creature on the fly—the Manage Combat pane will forget what it was doing. I’ll try to fix that in a future release.)

One More Tip: When FightCard sorts combatants, it uses their initiative modifiers to break ties. Thus, a creature with an initiative modifier of +4 who rolls 16 on the initiative die (assuming 1d20) has an initiative of 20 and a first tie-breaker of 4, so it would go before a creature that rolled 17 and has an initiative value of +3, again for a total of 20. You can also sneak in a second tie-breaker by entering the initiative modifier as a decimal number, with your second tie-breaker after the decimal. For example, when entering a creature with a Dexterity of 17 and an initiative modifier of +3, you could enter "3.17" for the initiative modifier. If this creature rolled 17 on its initiative roll, it would act ahead of a creature with 16 Dex whose initiative modifier was entered as "3.16." Or you can enter all PC initiative modifiers with an extra .1 added on if you want to ensure that PCs always act before monsters with the same initiative count.

Known Bugs/Issues

If you import creatures from another FightCard campaign file, FightCard might not enable the "Save …" button properly. If you encounter this problem, just use the "Rename …" button to change the campaign name (you don’t actually have to change the name; just using the "Rename …" feature will trigger FightCard to turn on the "Save …" button).

As I mentioned before, the import-from-Compendium features only work in Safari (and, of course, only if you’re logged into the Compendium).

I have only tested FightCard with Safari on Mac OS X, and Firefox on both Mac OS X and Windows. I don’t care a handful of beans about making the app IE compatible, and I haven’t tried out other browsers like Opera, Camino, or iCab.

Technical Support and Feature Requests

I’m only an amateur programmer with a more-than-full-time job as a college professor. I can really only devote enough effort to FightCard to keep it running smoothly for my own games. Even so, I’ll try to answer any questions you might have, and I certainly want to hear about any problems that I might be able to fix at the code level. You’re also welcome to dig in and improve the code yourself, as long as you share-alike, distribute the code freely and openly, and don’t try to make money off it. To state that more formally, Fight Card is ©2009 Christopher Heard and released to the public under the GNU General Public License 2.0. Any trademarked names or terms mentioned in the application or documentation remain the property of their respective trademark holders.

If you do have comments, questions, feature requests, and so on, please leave them as comments on this page.

13 Comments so far

  1. July 27th, 2009

    | 6:56 pm

    [...] FightCard. Learn more on FightCard’s dedicated [...]

  2. July 30th, 2009

    | 5:27 am

    [...] Fight Card: Another browser based initiative tracking tool. This one you download and have to manually configure some files though. [...]

  3. August 21st, 2009

    | 4:22 pm

    [...] more on the FightCard information page. Download the application and give it a shot. I hope some of you find it useful; I [...]

  4. IamSparticles
    September 3rd, 2009

    | 12:52 pm

    It’s a good start, but I have a few issues. I’m using Firefox on a Netbook running Win7:

    I think putting the control buttons at the bottom (previous, next, and clear delays) is a poor interface choice, forcing the user to scroll to the bottom of the actor list every time someone finishes a turn. I would either put the buttons at the top, on the side, or put the list in a fixed size control that can be scrolled itself.

    I noticed that if I put 0 in for starting hit points, the list shows it as “NaN” and you can’t add or subtract to fix it. You have to end combat and fix the creature/player record.

    At the end of a round, check to see if there are any delay flags set before prompting the user to clear them.

    When you clear someone’s delay flag, it puts them at the bottom of the current initiative value. So if you have multiple actors with the same initiative value, the actor that was delaying gets inserted after all of them. It should be possible to insert either before or after the current actor.

    Things I like: That it allows you to prompt for player initiatives when you start combat, and the easy interface for tracking HPs. I haven’t had a chance to try the compendium integration yet, but I like the idea. Is there a way I could include info for customized monsters? Editing XML in local files I suppose?

  5. September 3rd, 2009

    | 3:55 pm

    @IamSparticles: Thanks for the great suggestions. To take them one by one:

    1. Control button position: You’re right, and making the buttons/list easier to use is on my punch list.

    2. “If I put in 0 for starting hit points” … where? On the Manage Creatures tab when making a new creature?

    3. Delay flags: you’re right again, and I’ll try to fix that one before my next D&D session (9/12).

    4. Moving actors around in the initiative order is a little bit tricky. I will work on this. You’re right: the DM should have easy control over where the character coming out of a delay state lands.

    5. Customized monsters: all that FightCard imports from the Compendium is name, initiative modifier, hit points, and ID code (for linking back to the stat block). For customized monsters, you can save a PDF or image file from the Monster Builder, or open a Compendium monster, save the HTML source, and edit that. Put that PDF, JPEG/PNG, or HTML file in the Reference folder. Then you can link to that local file. Of course, FightCard can’t read any data from a PDF or JPEG/PNG file, or even a local HTML file. But it can link to those files so you have one-click reference during play. You’ll still have to type in the initiative modifier and starting HP—I don’t know any elegant way to avoid that.

  6. IamSparticles
    September 3rd, 2009

    | 9:11 pm

    Cool. If I really get into using your tool, I guess I could copy stat block images from the monster builder and use those.

  7. Brad
    September 21st, 2009

    | 4:18 pm

    I am trying to get help with importing data from the Compendium. I am making sure that I am logged into insider and using Safari, but every time I try and import data Safari seems to freeze up. I cannot tell why. I am getting both of the dialog boxes the first telling me to make sure I am logged in, the second telling me it will take a while. I leave it for an hour and nothing appears to have happened and when I click on anything I am told that Safari is non-responsive. I am using Vista.

  8. December 27th, 2009

    | 6:45 pm

    [...] you’re not yet using FightCard, visit the FightCard information page for full details about what it is and what it does. If you’re already using FightCard, I [...]

  9. Bill
    April 3rd, 2010

    | 9:32 am

    Do you know if this would run on an iPad? It’d almost be worth buying one to have a tabletop initiative manager.

  10. April 4th, 2010

    | 10:47 pm

    I don’t know … yet! I’m getting an iPad, but I’m waiting for the 3G model. I will certainly test it using Safari for iPad as soon as I can!

  11. April 10th, 2010

    | 2:09 pm

    Nice App! :)
    Streamined yet contains the basics for fast use at the table.
    I was wondering if you could put a drop-down menu in the notes section for the standard conditions? These are very common and would save on the typing…
    Thanks
    PS: Waiting to see if it works on the iPad too!

  12. Craig
    July 8th, 2010

    | 12:49 am

    How can you tell if Safari is downloading the compendium info? I go through and click all the boxes and nothing seems to happen. No progress bar or anything to let you know if it is downloading…

    Any thoughts?

    Thanks for the awesome podcast Chris. It makes my daily commute much more enjoyable.

  13. July 8th, 2010

    | 7:58 am

    Unfortunately, no progress bar. Since it’s running in Javascript, I can’t update the screen while looping through the data.

Leave a reply