Testing New Data

From PCGen Wiki
Jump to: navigation, search

When you have finished your work and often also while working on your dataset, you will want to test your data. Here are some steps that you can follow to do this:

  • Run prettylst.pl on your files. I know this has been said before, but it can't be said often enough. Don't forget to generate the <~ERROR_FILE> and check its content. The generated messages are invaluable.


  • Eyeball your data. There are still so many errors that cannot be caught by software, e.g. typos in output text fields like DESC or SPROP, tags that are spelled correct but do not belong there, or errors in JEP formulas, to name just a few. I know that 'Eyeballing the data' is very difficult for newbies, and seems very daunting to try to catch everything that way. Don't look at it that way - you won't catch _everything_ on any single pass over the data- and you shouldn't try to... For someone like a Chimp eyeballing is much more useful, based on his cumulative experience in the area of how proper entry should look. However, after running prettylst, a go over with the file - even by an newbie - by eye, esp. after going through the error report, will quickly teach one a lot about the LST and how it all goes together. -- Tir Gwaith


  • Glancing at your new file, and then glancing at a similar file from a CORE source (such as looking at a ranged weapon file in the Core when you are doing a new ranged weapon file) and comparing the two files can quickly show you potentially missing tags, badly formed syntax tags, etc. (Like what all to put in a TYPE tag for weapons) -- Tir Gwaith


  • Start PCGen. Select Debug > Debug Mode and also Debug > Console and click Clear in the console. Now load your data and check whether that caused any error messages to appear in the console window.


  • Run your data in PCGen. Apply your data to a character and see whether it behaves the way you intended it to.


  • Finally a tip: When entering data that is somewhat similar, it will look very tempting to copy and paste a line and then apply the necessary changes. Try to avoid that. Very often the cost of copy and paste is higher than the gain, as leftovers from the copied entry are that kind of errors that are the hardest to catch.