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