PCC files
These are the PCGen Campaign Configuration files. Here you can specify what you want included in this campaign. Note – you cannot anywhere, other than immediately after the tag, use a colon (:) in the CAMPAIGN tag. Doing so will cause PCGen to report errors and not load correctly. It is recommended practice that your pcc files be located in the same directory as your list files, the notable exception being if you have multiple directories, with multiple list files, then you locate a ‘master’ pcc file in the main directory. This will be explained below in the TAGs section.
Tag Name: CAMPAIGN
Variable(s) Used: Text
Example(s): CAMPAIGN:WotC -DnD Supplement– Sword and Fist
WHAT IT DOES: This MUST be first in the file. The standard format Used is Company Short name (WotC) – Campaign Name – name of material
WARNING: The use of the ampersand (&) sign will cause significant problems with PCGen, so recommended usage is to replace with the word 'and' or the letter 'n' to avoid this.
Tag Name: GAME
Variable(s) Used: Text
Example(s):GAME:D&D
WHAT IT DOES: This MUST be 2nd in the file. This tells PCGen what genre this is the genre is hard coded into PCGen and must be entered exactly as shown (sorry, only these and only 1 GAME tag per pcc file, or it will cause errors (only these genres are coded in at this time)
Tag Name: TYPE
Variable(s) Used: Text
Example(s): TYPE:Wizards of the Coast.Core Rules.Core
WHAT
IT DOES: This MUST be third in the file. The 1st type (Wizards
of the Coast) is the name of the company or individual that produced the
material that the data files are based on,
The 2nd type is the format of that original material (e.g. Sourcebook, Web
Enhancement, Magazine, Supplement, etc.),
The 3rd type (optional) is the "campaign setting" for the original material
(such as the publisher's campaign realm)
Tag Name: RANK
Variable(s) Used:Numeric
Example(s):RANK:x
WHAT IT DOES: The highest priority in loading .pcc files is 1 there is no lowest number for loading .pcc files
Tag Name: SOURCELONG
Variable(s) Used: Text
Example(s):SOURCELONG:Wizards of the Coast
WHAT IT DOES:The standard format for this is, full company name
Tag Name: SOURCESHORT
Variable(s) Used: Text
Example(s):SOURCESHORT:WotC
WHAT IT DOES:The standard format for this is, the company initial
Tag Name: SOURCEWEB
Variable(s) Used: Text
Example(s):SOURCEERB:http://www.wizards.com
WHAT IT DOES:The standard format for this is, full company company website/URL
Tag Name: LSTEXCLUDE
Variable(s) Used: >list file name<
Example(s): LSTEXCLUDE:dungeonmgraces.lst
WHAT IT DOES: This must be before PCC/LST file INCLUDE statements if used. Allows you to customize which LST files are loaded. A of the files listed will NOT be loaded, even if referenced later by other included PCC files. The LST file list can be a single LST filename per entry, or can be separated by the "|" character. This example would allow you to load the PHB entries from your own campaign source file, but without the PHB deities and domains.
Tag Name: REQSKILL
Variable(s) Used:ALL
Variable(s) Used:REQSKILL:ALL
Variable(s) Used:UNTRAINED
Example(s):REQSKILL:UNTRIANED
Variable(s) Used:Text
Example(s):REQSKILL:Alchemy|Bluff|Diplomacy|etc
WHAT IT DOES:A | (pipe) delimited list can include UNTRAINED (which means that all untrained skills will be automatically included on any character as if the skill had the REQ tag – see SKILL.LST for details), ALL (which means all skills will have the REQ tag) or a list of specified skill names. If this tag is included it should be after the SKILL: tag.
Tag Name: INFOTEXT
Variable(s) Used: Text
Example(s): INFOTEXT:This pcc loads all the WotC source materials minus the DMG races
WHAT IT DOES: Provides Text information that is displayed in the Information Window on the Source Tab when the source material is selected.
IMPORTANT NOTE: The following tags can (and it is recommended for equipment) have multiple lines. The names of the list files in the example column are also only suggestions. To include the same type of files from the same directory on the same line you would separate each file to be loaded (of the appropriate type i.e. playerhbarmorshields.lst|playershbequip|etc). Sometimes, not all of these tags are required by a source material. If a tag is not required, it cannot be left blank, it must be commented out or deleted entirely. These tags only tell PCGen where to go to get the information it needs, it points it to the right spot. Each list file will be fully explained below, separated by the list file name, with a full list of the tags that can be used in each one.
Tag Name: PCC
Variable(s) Used:Text
Example(s):PCC:@\>path<\xxxx.pcc
WHAT
IT DOES: Use to include other PCGen Campaign Configuration files. It is
recommended that you include this tag before any tags that load LST files.
When including data files you only need to use their filename if they are
located in the same directory as the PCC file, itself. If not, you must include
path information along with the filename.
You may use relative paths (e.g. "PCC:..\peerdirectory\myothersource.pcc") or a
special absolute path; (e.g."PCC:@\wotc\sourcebooks\dungeonsanddragons\core\playershandbook\playershb.pcc").
Using the special character "@" indicates that you want to start the file search
from the root data directory of PCGen instead of the directory where the
current PCC file is located.
Tag Name: INCLUDE
Variable(s) Used: CLASS
Variable(s) Used: COMPANIONMODS
Variable(s) Used: DEITY
Variable(s) Used: DOMAIN
Variable(s) Used: EQUIPMENT
Variable(s) Used: EQUIPMOD
Variable(s) Used: FEAT
Variable(s) Used: LANGUAGE
Variable(s) Used: RACE
Variable(s) Used: SKILL
Variable(s) Used: SPELL
Variable(s) Used: TEMPLATE
Variable(s) Used: WEAPONPROF
Example(s): RACE:phbrace.lst|myrace.lst|(INCLUDE:Happy Elf)
WHAT IT
DOES: This would first load all the races from the phbrace.lst file, then
add to that list all the races defined in myrace.lst but then include only the
Happy Elf class from myrace.lst. The resulting list of races would then be
available for character creation.
Tag Name: EXCLUDE
Variable(s) Used: CLASS
Variable(s) Used: COMPANIONMODS
Variable(s) Used: DEITY
Variable(s) Used: DOMAIN
Variable(s) Used: EQUIPMENT
Variable(s) Used: EQUIPMOD
Variable(s) Used: FEAT
Variable(s) Used: LANGUAGE
Variable(s) Used: RACE
Variable(s) Used: SKILL
Variable(s) Used: SPELL
Variable(s) Used: TEMPLATE
Variable(s) Used: WEAPONPROF
Example(s): RACE:phbrace.lst|(EXCLUDE:Human|Dwarf)|myrace.lst
WHAT IT DOES: This would first load all the races from the phbrace.lst
file and exclude the Human from it, then add to that list all the races defined
in myrace.lst. The resulting list of races would then be available for
character creation.
Tag Name: CLASS
Variable(s) Used: Text
Example(s): CLASS:xxxxclasses.lst
WHAT IT DOES: Tells PCGen to load the classes list file specified
Tag Name: COMPANIONMODS
Variable(s) Used: Text
Example(s): COMPANIONMODS:xxxxcompanionmods.lst
WHAT IT DOES: Tells PCGen to load the companion modifiers list file specified
Tag Name: DEITY
Variable(s) Used: Text
Example(s): DEITY:xxxxdeities.lst
WHAT IT DOES: Tells PCGen to load the deities list file specified
Tag Name: DOMAIN
Variable(s) Used: Text
Example(s): DOMAIN:xxxxdomains.lst
WHAT IT DOES: Tells PCGen to load the domains list file specified
Tag Name: EQUIPMENT
Variable(s) Used:Text
Example(s):EQUIPMENT:xxxxequip.lst
Example(s):EQUIPMENT:xxxxequiparmorsshields.lst
WHAT IT DOES: Tells PCGen to load the equipment list file specified
Tag Name: EQUIPMOD
Variable(s) Used:Text
Example(s):EQUIPMOD:xxxxequipmods.lst
WHAT IT DOES: Tells PCGen to load the equipment modifiers list file specified
Tag Name: FEAT
Variable(s) Used:Text
Example(s):FEAT:xxxxfeats.lst
WHAT IT DOES: Tells PCGen to load the feats list file specified
Tag Name: LANGUAGE
Variable(s) Used:Text
Example(s):LANGUAGE:xxxxlanguages.lst
WHAT IT DOES: Tells PCGen to load the languages list file specified
Tag Name: RACE
Variable(s) Used:Text
Example(s):RACE:xxxxraces.lst
WHAT IT DOES: Tells PCGen to load the races list file specified
Tag Name: SKILL
Variable(s) Used:Text
Example(s):SKILL:xxxxskills.lst
WHAT IT DOES: Tells PCGen to load the skills list file specified
Tag Name: SPELL
Variable(s) Used:Text
Example(s):SPELL:xxxxspells.lst
WHAT IT DOES: Tells PCGen to load the spells list file specified
Tag Name: WEAPONPROF
Variable(s) Used:Text
Example(s):WEAPONPROF:xxxxweapprofsimple.lst
WHAT IT DOES: Tells PCGen to load the weapon proficiencies list file specified