# Ability Tags

NOTE: This page is broken into three sections. The first section, the Ability File Tags, lists the new ability file tags, the second section, Global Ability Tags, and the third section, Other Ability Tags, lists the tags located else where in the PCGen documentation.

## The Ability File Tags

*** New 5.11.x

Tag Name: ADDSPELLLEVEL:x

Variables Used (x): Number (Increase in spell slot level)

What it does:

This tag is used in metamagic abilities to denote how much higher the spell level slot requires.

Example:

`ADDSPELLLEVEL:2`

A spell with this metamagic ability applied to it takes up a slot two levels higher than the normal spell.

*** New 5.11.x

Tag Name: BENEFIT:x

Variables Used (x): Text (benefit text)

What it does:

This is the benefit text of the ability from the source material. This text will be displayed in the feat description field if the "Display Feat Description" checkbox in the Appearance/Display Options Preference window is unchecked. Otherwise the text from the DESC tag will be displayed.

Example:

`BENEFIT:This is sample text for the example purposes`

Adds ability benefit.

Tag Name: CATEGORY:x

Variables Used (x): Text (Ability category)

What it does:

This is the ability category [link to docs for Ability Category game mode tag] that the ability belongs to. The ability category is a broad group of abilities, defined in the game mode. An ability's key name need only be unique within its category.

Examples:

`CATEGORY:SpecialAttack`

This ability is part of the "SpecialAttack" ability category.

`CATEGORY:Feat`

This ability is part of the "Feat" ability category, which is a special case of abilities that can be selected as feats.

*** New 5.11.x

Tag Name: COST:x

Variables Used (x): Number (ability point cost)

What it does:

This is how many ability points the ability costs. A decimal value, as the example below, would mean that it only costs 1/2 an ability point.

Example:

`COST:1`

Ability costs one ability point.

`COST:.5`

Ability costs half a ability point.

*** New 5.11.x

Tag Name: MODIFYABILITYCHOICE:x

Variables Used (x):Text (ability name)

Variables Used (x):TYPE=Text (ability type)

What it does:

- This tag allows for a previous ability choice to be replaced by a new one.
- The ability called must allow choices to be a valid ability.

Example:

`MODIFYABILITYCHOICE:TYPE=NinjaMonkeySchool`

An ability with this tag will allow the selection of a new school from a list of schools of type 'NinjaMonkeySchool' to replace a previously selected one.

`MODIFYABILITYCHOICE:Ninja Monkey Primary Weapon Reselection`

Allows a ninja monkey to select a new primary weapon, replacing an earlier selected primary weapon.

*** New 5.11.x

Tag Name: MULT:x

Variables Used (x): Boolean ('YES' or 'NO')

What it does:

This determines if an ability can be taken multiple times. If the value is set to 'YES', then you MUST also use a 'CHOOSE' tag.

Example:

`MULT:YES`

This Ability can be taken multiple times.

*** New 5.11.x

Tag Name: STACK:x

Variables Used (x): Boolean ('YES' or 'NO')

What it does:

This tells PCGen if the ability benefits may be stacked on one another.

Example:

`STACK:YES`

This Ability may be stack on it's self.

*** New 5.11.x

Tag Name: VISIBLE:x

Variables Used (x): YES

Variables Used (x): NO

Variables Used (x): DISPLAY

Variables Used (x): EXPORT

What it does:

- `YES` - Shows the ability name in PCGen and on export to a character sheet. (This is the default setting).
- `NO` - Hides the ability name in PCGen and on export to a character sheet.
- `DISPLAY` - Displays the ability name in PCGen but not on the character sheet.
- `EXPORT` - Hides the ability name from PCGen but displays it on the character sheet.

Example:

`VISIBLE:YES`

Shows the ability name in PCGen and on the Output sheet.

## Global Ability Tags

- ABILITY (Global Other)

## Other Ability Tags

These are not true global tags as the tags in the first section are. All tags are being listed here to make them easier to locate and understand.

### Game Mode - Misc Info File

- ABILITYCATEGORY (Misc Info)
- CATEGORY (Misc Info)
- DISPLAYNAME (Misc Info)
- EDITABLE (Misc Info)
- EDITPOOL (Misc Info)
- FRACTIONALPOOL (Misc Info)
- PLURAL (Misc Info)
- POOL (Misc Info)
- TYPE (Misc Info)
- VISIBLE (Misc Info)

### Game Mode - Stats and Checks File

- ABILITY:ADDSPELLLEVEL (Stats & Checks, in STATNAME Line)

### Bonus Ability Tags

- BONUS:ABILITYPOOL (Global BONUS)

### Starting Kit Tags

- ABILITY:CATEGORY (Starting Kit)
- ABILITY:PROMPT:FEAT (Starting Kit)

### PCC Ability Tags

- ABILITY (PCC)