Sword Illustration - 'Staid' by Jessica T. Harvey PCGScry Logo Sword Illustration - 'Staid' by Jessica T. Harvey

Description | Features | Screenshots | Download | Documentation | To Do List | Revision History | Contact

Current Version: 1.3.1 Released: October 12, 2002
 
Description
PCGScry is a Pocket PC character viewer for the popular Dungeons & Dragons Third Edition character generator, PCGen. My gaming friends and I all use PCGen to create our characters and print our character sheets, but being the hopeless techno-geek that I am, I wanted a way to view my character sheet on my handheld computer.

I originally had a Handspring Visor, on which I ran a great little utility called PCGenView. That program works great for the Palm OS platform, but I eventually switched to the Pocket PC platform by way of the Compaq iPaq. Much to my dismay, there were no PCGen character sheet viewers for my new device. Thus, I set out to write one. That's what this page is all about.

PCGScry now has a mailing list via Yahoo! Groups. Feel free to sign up here. This group will be used for announcements of new versions, discussion of potential new features, etc. This site will still be the primary location for downloading the software.

 
Features
  • Characters are loaded using an XML export template for PCGen.
  • All main stats on one page for quick reference.
  • Ability to enter temporary modifiers for most stats.
  • Tracks hit points and subdual damage.
  • Weapon listing with damage, to hit bonus, threat range, etc.
  • Armor listing with AC bonus, check penalty, spell failure percentage, etc.
  • Skill listing with breakdown of modifiers.
  • Feat listing with descriptions.
  • Spell listing supports multiclass characters.
  • Tracks number of each class and level of spell cast.
  • Equipment listing with encumbrance display and total value.
  • Charges page for tracking wands and other limited-use items.
  • Coin and gem listing with total value.
  • Displays general assets, magic items, and companions.
  • Proficiencies, special abilities and languages listings.
  • Bio page with general stats and optional portrait.
  • Free-text sratchpad for general notes.
  • Temporary note section for passing notes to DM.
  • Spell search feature, with full descriptions.
  • Saves status of cast spells and temporary modifiers between sessions.
 
Screenshots
Open Character
Open Character
Main Screen
Main Screen
AC Popup
AC Popup
Melee Popup
Melee Popup
Weapons/Armor
Weapons/Armor
Skills/Feats
Skills/Feats
Spells
Spells
Equipment
Equipment
Money/Magic
Money/Magic
Charges
Charges
Miscellaneous
Miscellaneous
Companions
Companions
Bio Page
Bio Page
Portrait
Portrait
Notes
Notes
DM Notes
DM Notes
Spell Search
Spell Search
Spell Info
Spell Info
 
Download
Note: This program is a work in progress. It has only been tested with a couple of my characters, and only on my iPaq. I haven't tested it on any other Windows CE device. Use this software at your own risk. I am not liable for any damage or loss of data resulting from the use of this software.

This is my first Windows CE application. It is written in Embedded Visual Basic (eVB). I'm sure there are much more graceful ways of making installer applications for handheld software, but all I'm providing here is the basic CAB files. That should be all you need, but if there's something missing, let me know. Again, this is untested on anything but my iPaq which has a StrongARM processor.

Installation:

Copy the appropriate CAB file into a folder on your handheld. Click the CAB file and it should install all necessary DLLs and VB files. You should then have a new (albeit generic) icon in your program listing.

 
Documentation
To load a character, you must first export it from PCGen using the XML template I provide above. Copy the resulting XML file to any folder within the "My Documents" on your handheld. Launch the program. Click the "Open" button located at the upper right corner of the initial screen. Select your character. Do battle with evil.

If you would like to have a portrait of your character, save it in the PCGScry folder under the Program Files folder. This folder will be created the first time you run PCGScry. This bitmap must be an 8-bit windows bitmap, and it must be 240x250 pixels in size. Otherwise it won't display properly.

When you exit the program, or load a new character, you will be asked if you want to save the state of your current character. If you answer yes, certain bits of information will be stored in a text file on disk and restored the next time you load the character. This information includes any temporary stat modifiers you have entered, your current hit points, your current subdual damage, the number of spells you have cast of each class and level, the text in the note pad, etc.

To enter a temporary modifier for any of your ability scores, saving throws, or attack bonuses, just enter a number in the small text box to the right of each stat. Negative numbers are allowed. Once you click somewhere outside of the box, the stat will be updated.

To see your full list of attack bonuses for all given attacks in a round, click on the total attack bonus for either melee or ranged attacks, and a small popup box will be appear showing the bonus for all attacks.

To cast a spell, click on the spell name in the spell list and click the "Cast" button. You will be asked to confirm that you actually want to cast the chosen spell. The text below the spell list will update each time you click on a spell or cast a spell. To reset the number of available spell slots you have, click the "Reset" button on the spells tab.

Note that DM notes are not saved between sessions. If you wish to save any data from the DM notes page, cut and paste it into the normal notepad area on the previous tab.

When you exit the program, if you choose to save the state of the character, two files will be created. They both have the same name as your character XML file, but different extensions. One has an extension of .state which stores the state data. The other has an extension of .notes which stores the notepad text. You can delete these files, but you will obviously lose the data stored in them.

That's it! Feel free to email me suggestions for additions. Enjoy!

 
To Do List
  • Add Perform section (Bards)
  • Add Turning section (Clerics/Paladins)
  • Add Rage section (Barbarians)
  • Add Wholeness of Body section (Monks)
  • Add Domains section (Spellcasters)
  • Add Prohibited section (Spellcasters)
  • Add Racial Abilities section
  • Add Jump calculations section
  • Support spell DC calculation based on feats (Spell Focus, etc.)
Some folks may want to see a dice roller added to this application. I however, am of the opinion that rolls should always be made with real dice. Not because I think people would attempt to cheat by using a computer to roll their dice for them, but because real dice are just fun to use. If you really want a dice roller on your handheld PC, there are several out there for download. Tucows is one place to find them.
 
Revision History

Version 1.3.1 - October 12th, 2002

  • Fixed minor bug with spell DC calculation.
  • Fixed bug where notes windows would be partially covered by the user-input area.
  • Added XML template with revisions for PCGen version 3 or higher. This fixes the Type mismatch: 'CInt' error. (Thanks to Kent Behrends for the template update.)

Version 1.3.0 - June 1st, 2002

  • Added "Charges" page for keeping track of wands and other limited-use items.
  • Added support for devices with SH3 and MIPS processors.

Version 1.1.0 - May 7th, 2002

  • Added spell information page using XML files from d20-XML project.
  • Fixed intPerDay type mismatch bug with loading spell caster info.
  • Added menu bar with File and Page menus.
  • Changes to the width of columns in the various list views are now saved between sessions, on a per-character basis.
  • Added spell search feature

Version 1.0.1 - May 2nd, 2002

  • Added full saving throw info to spell cast confirmation popup.
  • Added additional column to the Money listing to show subtotal values per line.
  • Adjusted Money listing so 3 full lines are shown at a time, instead of 2 1/2. :)
  • A few minor cosmetic changes.
  • Fixed bug with display of classes and levels for multiclass characters.
  • Added "About" tab.
  • Fixed bug with loading/saving state of spells cast.

Version 1.0.0 - April 30th, 2002

  • Initial Release