# The ADD Tag

*NOTE: The ADD tag MUST be used with at least one valid choice (like the CHOOSE tag) or it will not function.
i.e. If `ADD:FEAT(TYPE=Foo)` and the character does not qualify for any TYPE=Foo feat, there will be no pop-up or choice.

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:SA tag instead.

Tag Name: ADD:x(y,y)z

Variables Used (x): Text (Name of special ability)

Variables Used (y): Text (List of items from type that can be selected)

Variables Used (z): Number, Variable or Formula (Number of choices granted)

What it does:

This creates a popup choice for the users to select from of Special Abilities. The text used (x) tells PCGen what the name of the Special Ability it is, and the choices contained within the parenthesis (y,y) are the options to choose from. Optionally, the number of choices granted appears as (z). This is output on the OS in the Special Abilities section in the form of "Name of Special Ability(Option Chosen)".

TYPE.xxx for reference, TYPE=xxx for assignment.

Examples:

`ADD:MyChoices(choice1,choice2)`

Choose between the choices listed

`ADD:MyChoices(choice1,choice2,Choice3)2`

Select two of the choices granted

`ADD:Native Environment(woods,sea shore,dessert,mountains)1`

Select one of the choices granted. Might appear on the OS as Native Environment(woods)

`ADD:FAVOREDCLASS|LIST|1|TYPE=Base`

Select one of the base choices granted

*** New 5.8 -- Updated 5.11.11

Tag Name:ADD:.CLEAR

Tag Name:ADD:.CLEAR.LEVELx

Variables Used (x): Number (Class level)

What it does:

Used to clear an ADD tag. This can be used in conjunction with the .MOD tag to alter a class or other objects.

However, please note in the docs that using an ADD.CLEAR.LEVELx on a class line or on a level line where the level does not equal X will result in a warning, and may not be supported in the future.

Example:

`ADD:.CLEAR.LEVEL2`

If this were used in a CLASS:Rogue.MOD line it would clear the `ADD:FEAT(Evasion, Improved Evasion)` tag normally found there and allow you to add a new one, perhaps: `ADD:FEAT (Evasion,Improved Evasion,Shadow)`.

`ADD:.CLEAR`

If this were used in a Zombie.MOD line it would clear the `ADD:FEAT (TYPE=SlamWeapons)` tag normally found in that template.

`CLASS:Gunslinger.MOD <tab> ADD:.CLEAR.LEVEL2 <tab> ADD:.CLEAR.LEVEL3 <tab> ADD:.CLEAR.LEVEL6 <tab> ADD:.CLEAR.LEVEL8 <tab> ADD:.CLEAR.LEVEL9`

This modification of the Gunslinger Class removes the benefits of level 2,3,6,8, and 9, replacing them with nothing.

*** New 5.11.11

Tag Name: ADD:ABILITY|[w|]x|y|z[,z..]

Variables Used (w): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (x): Ability Category (The Ability Category this ability will be added to).

Variables Used (y): Ability Nature (The nature of the added ability: NORMAL, AUTOMATIC, or VIRTUAL)

Variables Used (z): Text (Key of the ability to select from)

Variables Used (z): TYPE.AbilityType (Type of ability to select from)

What it does:

- ABILITY will give the character a choice of one from the listed abilities.
- Abilities listed are all "," (comma) delimited
- Valid TYPE's are TYPE=REGION, TYPE=SUBREGION, TYPE=ALLREGION, and TYPE=<abilitytype> (i.e. the type of ability, not the word "abilitytype".)
- If the ability being added has a chooser ADD:ABILITY is the only tag which will activate it (ABILITY will not).
- TYPE.xxx for reference, TYPE=xxx for assignment.

Example:

`ADD:ABILITY|2|FEAT|NORMAL|Alertness,TYPE=Fighter,Electric Boogalo`

Add two feats from "Alertness", any "Fighter" type feats or "Electric Boogalo".

`ADD:ABILITY|FEAT|VIRTUAL|TYPE=General,TYPE=Metamagic,TYPE=ItemCreation`

Add one virtual feat from "General", any "Metamagic", any "ItemCreation" type feats .

*** Deprecated 5.11.11 - Remove 6.0 - Use BONUS:SKILLRANK tag instead.

Tag Name: ADD:CLASSSKILLS(y,y,y)z

*** New 5.11.11

Tag Name: ADD:CLASSSKILLS|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (Name of item)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- CLASSSKILLS with no additional parameters will increase the quantity of the items by 1.
- CLASSSKILLS with parameters will give the character a choice of one from the items listed in the parenthesis.
- CLASSSKILLS listed in the parenthesis are all "," (comma) delimited

Example:

`ADD:CLASSSKILLS|[3|]ANY`

Add three of skill listed.

`ADD:CLASSSKILLS|Knowledge (Reverie)`

Add one to the "Knowledge" with a specility of "Reverie".

`ADD:CLASSSKILLS|TYPE=Craft`

Add one to the "TYPE" of "Craft".

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:EQUIP| tag instead.

Tag Name: ADD:EQUIP(y,y)z

Variables Used (x): EQUIP

Variables Used (y): Text (Name of item)

Variables Used (y): TYPE.EquipmentType (Type of item)

Variables Used (z): Number, Variable or Formula (Number of choices granted)

What it does:

- EQUIP with no additional parameters will increase the quantity of the items by 1.
- EQUIP with parameters will give the character a choice of one from the items listed in the parenthesis.
- EQUIP listed in the parenthesis are all "," (comma) delimited

Example:

`ADD:EQUIP(Torch,TYPE=Goods,Lantern)1`

Add one of either a "Torch", any "Goods" type equipment or a "Lantern".

*** New 5.11.11

Tag Name: ADD:EQUIP|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (Name of item)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- EQUIP with no additional parameters will increase the quantity of the items by 1.
- EQUIP with parameters will give the character a choice of one from the items listed in the parenthesis.
- EQUIP listed in the parenthesis are all "," (comma) delimited

Example:

`ADD:EQUIP|[1|]Torch,Lantern`

Add one of either a "Torch" or a "Lantern".

`ADD:EQUIP|Blastpowder (10)`

Add one of "Blastpowder" with a quantity of "10" charges.

`ADD:EQUIP|Synchronicity Watch,Secret Pockets,Daylight Flares`

Add one of "Synchronicity Watch", "Secret Pockets" and "Daylight Flares".

`ADD:EQUIP|Dagger (Sarishan Steel)`

Add one of "Sarishan Steel Dagger".

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:FEAT| tag instead.

Tag Name: ADD:FEAT(y,y)z

Variables Used (x): FEAT

Variables Used (y): Text (Name of feat)

Variables Used (y): TYPE=<FeatType> (Type of feat)

Variables Used (y): TYPE.<FeatType> (Type of feat)

Variables Used (y): ALL (all feats)

Variables Used (z): Number, Variable or Formula (Number of choices granted)

What it does:

- FEAT with parameters will give the character a choice of one from the feats listed in the parenthesis.
- Feats listed in the parenthesis are all "," (comma) delimited
- Valid TYPE's are TYPE=REGION, TYPE=SUBREGION, TYPE=ALLREGION, and TYPE=<feattype> (i.e. the type of feat, not the word "feattype".)
- ADD:FEAT with no additional parameters will increase the number of feats the character knows by 1, however this use is not recommended and will be deprecated. To increase the number of points in the characters feat pool use the BONUS:FEAT|POOL tag.
- If the feat being added has a chooser ADD:FEAT is the only tag which will activate it (VFEAT, MFEAT and FEATAUTO will not).
- TYPE.xxx for reference, TYPE=xxx for assignment.

Example:

`ADD:FEAT(Alertness,TYPE=Fighter,Electric Boogalo)2`

Add two feats from "Alertness", any "Fighter" type feats or "Electric Boogalo".

`ADD:FEAT(TYPE=General,TYPE=Metamagic,TYPE=ItemCreation)`

Add one feat from "General", any "Metamagic", any "ItemCreation" type feats .

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:FEAT| tag instead.

Tag Name: ADD:FEAT

*** New 5.11.11

Tag Name: ADD:FEAT|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (the feats to be chosen from)

Variables Used (y): TYPE=<FeatType> (Type of feat)

Variables Used (y): TYPE.<FeatType> (Type of feat)

Variables Used (y): ALL (all feats)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- FEAT with parameters will give the character a choice of one (option count) from the feats listed in the y,y list.
- Feats listed are all "," (comma) delimited
- Valid TYPE's TYPE=<feattype> (i.e. the type of feat, not the word "feattype".)
- If the feat being added has a chooser ADD:FEAT is the only tag which will activate it (VFEAT, MFEAT and FEATAUTO will not).
- TYPE.xxx for reference, TYPE=xxx for assignment.

Example:

`ADD:FEAT|[2|]Alertness,TYPE=Fighter,Electric Boogalo`

Add two feats from "Alertness", any "Fighter" type feats or "Electric Boogalo".

`ADD:FEAT|TYPE=General,TYPE=Metamagic,TYPE=ItemCreation`

Add one feat from "General", any "Metamagic", any "ItemCreation" type feats.

`ADD:FEAT|[2|]ALL`

Add two feats from all feats listed.

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:LANGUAGE| tag instead.

Tag Name: ADD:Language(y,y)z

Variables Used (x): Language

Variables Used (y): Text (Name of defined language)

Variables Used (y): TYPE=LanguageType (Language type)

Variables Used (z): Number, Variable or Formula (Number of choices granted)

What it does:

This is a "," (comma) delimited list of language choices that the character can choose from. The choice is added to their Known Languages.

The list will also accept language types as in "TYPE=Spoken".

Example:

`ADD:Language(Draconic,Elven,Undercommon)1`

Add "Draconic", "Elven" or "Undercommon" to the list of languages known.

`ADD:Language(TYPE=Spoken)2`

Adds two of any spoken type languages to the list of languages known.

`ADD:Language(TYPE=Imperial,TYPE=Infernal)2`

Adds two of any Imperial or Infernal type languages to the list of languages known.

*** New 5.11.11

Tag Name: ADD:LANGUAGE|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (the Language to be chosen from)

Variables Used (y): TYPE=<LanguageType> (Type of language - Spoken or Written or Read)

Variables Used (y): TYPE.<LanguageType> (Type of language - Spoken or Written or Read)

Variables Used (y): ALL (all Language)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- This is a "," (comma) delimited list of language choices that the character can choose from. The choice is added to their Known Languages.
- The list will also accept language types as in "TYPE=Spoken".

Example:

`ADD:Language|Draconic,Elven,Undercommon`

Add "Draconic", "Elven" or "Undercommon" to the list of languages known.

`ADD:Language|[2|]TYPE=Spoken`

Adds two of any spoken type languages to the list of languages known.

`ADD:Language|[2|]TYPE=Imperial,TYPE=Infernal`

Adds two of any Imperial or Infernal type languages to the list of languages known.

*** Deprecated 5.11.11 - Remove 6.0

Tag Name: ADD:LIST(

*** New 5.11.11

Tag Name: ADD:SA|x|[y|]z,z

Variables Used (x): Text (name of the Special Ability to be chosen)

Variables Used (y): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (z): Text (the choices; comma delimited)

What it does:

- The optional count has a pipe [y|] that is not needed, unless the count is used.
- SA with no additional parameters will assign the first of the items.
- SA with parameters will give the character a choice of one to the limit of count from the items listed in the list.
- SA listed are all "," (comma) delimited

Example:

`ADD:SA|Brick Wall|[3|]Damage Reduction,Concussion Resistance,Remain Concious, Melee Smash,Extreme Effort`

Add three of special abilities listed.

`ADD:SA|Shadow Slayer|Detect Shadow,Shadow Immunity`

Add one of the two special abilities.

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:SKILL| tag instead.

Tag Name: ADD:SKILL(y,y)z

Variables Used (x): SKILL

Variables Used (y): Text (Name of skill)

Variables Used (z): Number, Variable or Formula (Number of choices granted)

What it does:

Give the character a choice of the skills listed within the parenthesis.

Example:

`ADD:SKILL(Ride,Spellcraft,Listen)2`

Adds a skill point to two of these skills: "Ride", "Spellcraft" or "Listen".

*** New 5.11.11

Tag Name: ADD:SKILL|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (Name of skill)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- SKILL with no additional parameters will increase the quantity of the items by 1.
- SKILL with parameters will give the character a choice of one from the items listed in the y,y list.
- SKILL with parameters will give the character a choice up to the count parameter from the items listed in the y,y list.
- SKILL listed are all "," (comma) delimited

Example:

`ADD:SKILL|[1|]Read/Write Language`

Add one of either a "Read/Write Language".

`ADD:SKILL|[5|]Balance,Craft (Structural),Demolitions`

Add five skill levels of "Balance" or "Craft (Structural)" or "Demolitions".

`ADD:SKILL|[2|]Speak Language`

Add two of "Speak Language".

*** Deprecated - Remove 6.0 - Special abilities are now set using hidden feats

Tag Name: ADD:SPECIAL(<Special Ability>,<Special Ability>)<Number of choices>

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:SPELLCASTER| tag instead.

Tag Name: ADD:SPELLCASTER(y,y)z

Variables Used (x): SPELLCASTER

Variables Used (y): Text (Class name)

Variables Used (y): Type (Spellcasting class type such as Arcane or Divine)

Variables Used (y): ANY (Any spellcasting class the character has levels in)

Variables Used (z): Number (Number of choices granted, Optional)

What it does:

- This grants a one bonus level to the spell casting class chosen.
- The bonus level confers only it's spellcasting capabilities, no other bonuses or benefits from the class are granted.
- When used on a class line the list of choices that come up will NOT include the class that the tag is in.
- The specified class must have its own spell list.
- This tag will not grant a bonus spell casting level for a class that uses the CASTAS tag or in some other way rides on another classes spell list.
- The ANY property will present a list of all the spellcasting classes the PC already has levels in.
- When using a type such as Divine or Arcane the SPELLTYPE of all the spellcasting classes the PC has levels in are checked and those that match are presented.
- When using specific class names those are the classes presented, the PC does NOT need to have any levels in those classes in order to select them.
- When using the z variable to grant more than one choice multiple classes can be selected but the same class cannot be selected twice.
- If that is desired you should simply use two tags.

Examples:

`ADD:SPELLCASTER(ANY)`

Adds a bonus level of spellcasting to any spellcasting class the character has levels in.

`ADD:SPELLCASTER(Divine)`

Adds a bonus level of spellcasting to any Divine spellcasting class the character has levels in.

`ADD:SPELLCASTER(Arcane)`

Adds a bonus level of spellcasting to any Arcane spellcasting class the character has levels in.

`ADD:SPELLCASTER(Bard,Sorcerer)`

Adds a bonus level of spellcasting of either Bard or Sorcerer.

*** New 5.11.11

Tag Name: ADD:SPELLCASTER|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (Class name)

Variables Used (y): TYPE (Spellcasting class type such as Arcane or Divine)

Variables Used (y): ANY (Any spellcasting class the character has levels in)

Variables Used (z): Number (Number of choices granted, Optional)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- This grants a one bonus level to the spell casting class chosen.
- The bonus level confers only it's spellcasting capabilities, no other bonuses or benefits from the class are granted.
- When used on a class line the list of choices that come up will NOT include the class that the tag is in.
- The specified class must have its own spell list.
- This tag will not grant a bonus spell casting level for a class that uses the CASTAS tag or in some other way rides on another classes spell list.
- The ANY property will present a list of all the spellcasting classes the PC already has levels in.
- When using a type such as Divine or Arcane the SPELLTYPE of all the spellcasting classes the PC has levels in are checked and those that match are presented.
- When using specific class names those are the classes presented, the PC does NOT need to have any levels in those classes in order to select them.
- When using the z variable to grant more than one choice multiple classes can be selected but the same class cannot be selected twice.
- If that is desired you should simply use two tags.

Examples:

`ADD:SPELLCASTER|ANY`

Adds a bonus level of spellcasting to any spellcasting class the character has levels in.

`ADD:SPELLCASTER|Divine`

Adds a bonus level of spellcasting to any Divine spellcasting class the character has levels in.

`ADD:SPELLCASTER|Arcane`

Adds a bonus level of spellcasting to any Arcane spellcasting class the character has levels in.

`ADD:SPELLCASTER|Bard,Sorcerer`

Adds a bonus level of spellcasting of either Bard or Sorcerer.

`ADD:SPELLCASTER|[3|]Arcane ADD:SPELLCASTER|Psionic`

Adds three bonus level of spellcasting to Arcane and one bonus level of spellcasting to Psionic.

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:SPELLLEVEL| tag instead.

Tag Name: ADD:SPELLLEVEL:

What it does:

Adds spells to a class at a level specified.

Example:

`ADD:SPELLLEVEL:CLASS|SPELLCASTER.Arcane=1|Change Self`

Adds the Change Self spell to the 1st level Arcane list.

*** New 5.11.11

Tag Name: ADD:SPELLLEVEL|

What it does:

Adds spells to a class at a level specified.

Example:

`ADD:SPELLLEVEL|CLASS|SPELLCASTER.Arcane=1|Change Self`

Adds the Change Self spell to the 1st level Arcane list.

*** New 5.11.11

Tag Name: ADD:TEMPLATE|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (Name of template)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- TEMPLATE with no additional parameters will increase the quantity of the items by 1.
- TEMPLATE with parameters will give the character a choice of one from the items listed in the y,y list.
- TEMPLATE with parameters will give the character a choice of up to count parameter from the items listed in the y,y list.
- TEMPLATE listed in the parenthesis are all "," (comma) delimited

Example:

`ADD:TEMPLATE|[1|]Scholar,Soldier`

Add one of either a "Scholar" or a "Soldier".

`ADD:TEMPLATE|Robot`

Add one of "Robot".

`ADD:TEMPLATE|[2|]Suite of St. Daris,Suite of St. Feldin,Suite of Lothian`

Add teo of "Suite of St. Daris", "Suite of St. Feldin" and "Suite of Lothian".

*** Deprecated 5.11.11 - Remove 6.0 - Use ADD:VFEAT| tag instead.

Tag Name: ADD:VFEAT(y,y)z

Variables Used (x): VFEAT

Variables Used (y): Text (Name of feat)

Variables Used (y): TYPE.FeatType (Type of feat)

Variables Used (z): Number, Variable or Formula (Number of choices granted)

What it does:

- VFEAT will give the character a choice of one from the feats listed in the parenthesis WITHOUT checking PRExxx of the feats.
- They are also not removable after the ADD:VFEAT pop-up unlike ADD:FEAT().
- Valid TYPE's are TYPE=REGION, TYPE=SUBREGION, TYPE=ALLREGION, and TYPE=<feattype> (i.e. the type of feat, not the word "feattype").

Example:

`ADD:VFEAT(Alertness,TYPE=Fighter,Electric Boogalo)2`

Add two virtual feats from "Alertness", any "Fighter" type feats or "Electric Boogalo" regardless if the PC qualifies. These cannot be removed after selection.

`ADD:VFEAT(Weapon Master(TYPE=Weapon))1`

Add one virtual feat with any "Weapon" type regardless if the PC qualifies. These cannot be removed after selection.

*** New 5.11.11

Tag Name: ADD:VFEAT|[x|]y,y

Variables Used (x): Number, Variable or Formula (Optional - Number of choices granted)

Variables Used (y): Text (the feats to be chosen from)

Variables Used (y): TYPE=<FeatType> (Type of feat)

Variables Used (y): TYPE.<FeatType> (Type of feat)

Variables Used (y): ALL (all feats)

What it does:

- The optional count has a pipe [x|] that is not needed, unless the count is used.
- VFEAT with parameters will give the character a choice of one (up to option count) from the feats listed in the y,y list.
- Feats listed are all "," (comma) delimited
- Valid TYPE's TYPE=<feattype> (i.e. the type of feat, not the word "feattype".)
- If the feat being added has a chooser ADD:FEAT is the only tag which will activate it (VFEAT, MFEAT and FEATAUTO will not).
- TYPE.xxx for reference, TYPE=xxx for assignment.

Example:

`ADD:VFEAT|Weapon Master(TYPE=Weapon)`

Add one virtual feat with any "Weapon" type regardless if the PC qualifies. These cannot be removed after selection.

`ADD:VFEAT|TYPE=General,TYPE=Metamagic,TYPE=ItemCreation`

Add one virtual feat from "General", any "Metamagic", any "ItemCreation" type feats.

`ADD:VFEAT|[2|]ALL`

Add two virtual feats from all feats listed.

*** Deprecated 5.11.11 - Remove 6.0 - Use BONUS:WEAPON tag instead.

Tag Name: ADD:WEAPONBONUS(y|y|y|)

*** Deprecated 5.11.11 - Remove 6.0 - Use BONUS:WEAPON tag instead.

Tag Name: ADD:WEAPONBONUS|y|y|y