The CHOOSE Tag

This file covers the glodal CHOOSE tag in its many different forms. For the eqmod versions of the CHOOSE tag see CHOOSE:ABILITY (Equipment Modifiers)

While the CHOOSE tag is extremely flexible, it should be noted that support for CHOOSE in class files is still in the works and will cause problems. This is a known issue, and all I can say is that, "We are working on it."

When using CHOOSE within an ability you must:

This page is organized into two sections:


Global CHOOSE Dictionary


*** Updated 5.17.4

Tag Name: CHOOSE:ABILITY|w|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (w): Text (Ability category)

Variables Used (x): Text (Ability name or key)

Variables Used (x): FEAT=Text (Feat, by name or key)

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

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

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:ABILITY|FEAT|TYPE=Rogue Abilities

A list of all "Rogue Abilities" type feats will be presented.

CHOOSE:ABILITY|Special Ability|PC[TYPE=Mercy]

A list of all "Mercy" type abilities will be presented.

Where it is Used:

Ability, Domain, Feat, Race, and Template files. For the eqmod version see CHOOSE:EQUIPMENT (Equipment Modifiers)


*** New 6.01.03

Tag Name: CHOOSE:ABILITYSELECTION|v|w|x|y|y[z]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (v): TITLE=Text (Chooser title)

Variables Used (w): Text (Ability Category)

Variables Used (x): Text (Ability Name or Key)

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

Variables Used (x): !TYPE=Text (Prohibited Ability type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:ABILITYSELECTION|FEAT|Weapon Focus

Will display a list of feats comprised of the "Dodge" and "Toughness" feats.

CHOOSE:ABILITYSELECTION|Ranger ~ Favored Enemy,PC

This will produce a list of all the character's favored enemies.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:ALIGNMENT|x|x

Variables Used (x): Text (Alignment by key)

Variables Used (x): FEAT=Text (Feat, by name or key)

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

Variables Used (x): !TYPE=Text (Prohibited alignment type)

Variables Used (x): ALL

What it does:

Example:

CHOOSE:ALIGNMENT|ALL

This will produce a list of all alignments available.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:ARMORPROFICIENCY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Armor proficiency)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): TYPE=Text (Armor proficiency type)

Variables Used (x): !TYPE=Text (Prohibited armor proficiency type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

Variables Used (y): EQUIPMENT[x] (Special Qualifier)

What it does:

Example:

CHOOSE:ARMORPROFICIENCY|TYPE=Heavy

Will display a list of proficiencies for all heavy armors.

CHOOSE:ARMORPROFICIENCY|Scale Mail|Chainmail

Will display a list consisting of Scale Mail and Chainmail.

CHOOSE:ARMORPROFICIENCY|EQUIPMENT[Chainmail]

Will display a list the proficiencies for Chainmail.

CHOOSE:ARMORPROFICIENCY|EQUIPMENT

Will display a list the proficiencies of all equipment taken.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:CHECK|x|x

Variables Used (x): Text (Check by KEY)

Variables Used (x): FEAT=Text (Feat, by name or key)

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

Variables Used (x): !TYPE=Text (Prohibited check type)

Variables Used (x): ALL

What it does:

Example:

CHOOSE:CHECK|ALL

This will produce a list of all checks available in the gameMode.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** Updated 5.17.4

Tag Name: CHOOSE:CLASS|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Class name or key)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): SPELLTYPE=Text (Spell type)

Variables Used (x): SPELLCASTER

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

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

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:CLASS|TYPE=Prestige,PC

A list of all Prestige type classes that the PC has will be presented.

CHOOSE:CLASS|Wizard|Fighter

A list of all classes consisting of the Wizard and Fighter classes will be presented.

CHOOSE:CLASS|Fighter|TYPE=Prestige,PC

A list of all Prestige type classes that the PC has plus the Fighter class will be presented.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:DEITY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Deity name or key)

Variables Used (x): ALIGN=Text (Alignment abbreviation)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): PANTHEON=Text (Pantheon name)

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

Variables Used (x): !TYPE=Text (Prohibited deity type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:DEITY|Set|Ra

A list of the deities Set and Ra will be presented.

CHOOSE:DEITY|Set,Ra

No deity list will be presented because no deity can be both Set and Ra .

CHOOSE:DEITY|PANTHEON=Olympian,ALIGN=LG

A list of all Lawful Good deities of the Olympian pantheon will be presented.

CHOOSE:DEITY|TYPE=Good,PC

A list of all Good type deities that the PC has already selected will be presented.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** Updated 5.17.4

Tag Name: CHOOSE:DOMAIN|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Domain name or key)

Variables Used (x): DEITY=Text (Deity name)

Variables Used (x): FEAT=Text (Feat, by name or key)

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

Variables Used (x): !TYPE=Text (Prohibited domain type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:DOMAIN|Air|Fire|Sun

A list of domains including Air , Fire and Sun domains will be presented.

CHOOSE:DOMAIN|DIETY=Kong

A list of domains granted by the deity Kong will be presented.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 6.03.02

Tag Name: CHOOSE:EQUIPMENT|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Equipment name or key)

Variables Used (x): WIELD=Text (Equipment wield type)

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

Variables Used (x): !TYPE=Text (Equipment type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): OWNED

Variables Used (y): QUALIFIED

Variables Used (y): CARRIED

Variables Used (y): EQUIPPED

What it does:

Example:

CHOOSE:EQUIPMENT|TYPE=Melee.Simple

A list of all "Simple" and "Melee" type feats will be presented.

CHOOSE:EQUIPMENT|TYPE=Simple,OWNED

A list of all simple equipment that the PC has already selected will be presented.

Where it is Used:

Ability, Domain, Feat, Race, and Template files. For the eqmod version see CHOOSE:EQUIPMENT (Equipment Modifiers)


*** New 5.17.3

Tag Name: CHOOSE:FEAT|w|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (w): TITLE=Text (Chooser title)

Variables Used (x): Text (Feat by key)

Variables Used (x): FEAT=Text (Feat by key)

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

Variables Used (x): !TYPE=Text (Prohibited Feat type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:FEAT|Dodge|Toughness

Will display a list of feats comprised of the "Dodge" and "Toughness" feats.

CHOOSE:FEAT|TYPE=Fighter,PC

This will produce a list of all the character's fighter feats.

CHOOSE:FEAT|PC[TYPE=Fighter]

This will produce a list of all the character's fighter feats.

CHOOSE:FEAT|TYPE=Fighter

This will produce a list of all fighter feats.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.3

Tag Name: CHOOSE:FEATSELECTION|w|x|y|y[z]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (w): TITLE=Text (Chooser title)

Variables Used (x): Text (Feat name or key)

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

Variables Used (x): !TYPE=Text (Prohibited Feat type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:FEATSELECTION|Dodge|Toughness

Will display a list of feats comprised of the "Dodge" and "Toughness" feats.

CHOOSE:FEATSELECTION|TYPE=Fighter,PC

This will produce a list of all the character's fighter feats.

CHOOSE:FEATSELECTION|PC[TYPE=Fighter]

This will produce a list of all the character's fighter feats.

CHOOSE:FEATSELECTION|TYPE=Fighter

This will produce a list of all fighter feats.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:LANG|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Language name)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): LANGBONUS

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

Variables Used (x): !TYPE=Text (Prohibited language type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:LANG|Common|Goblin

Presents the "Common" and "Goblin" languages for selection.

CHOOSE:LANG|Common,Goblin

No languages are presented as no language is both "Common" and "Goblin".

CHOOSE:LANG|Common|TYPE=Foo,PC

Presents the "Common" language and any languages that have the "Foo" type which are already selected by the Player Character.

Ability, Domain, Feat, Race, and Template files.


*** New 5.9.4

Tag Name: CHOOSE:NOCHOICE

What it does:

Example:

CHOOSE:NOCHOICE

The feat is added without a chooser window.

Ability, Domain, Feat, Race, and Template files.


Tag Name: CHOOSE:NUMBER|x|y|z

Variables Used (x): MIN=Number (Lowest value to choose from)

Variables Used (y): MAX=Number (Highest value to choose from)

Variables Used (z): TITLE=Text (Description to output to the chooser)

What it does:

Note: This will only bring up the chooser if invoked from the Temporary Bonus tab.

Example:

CHOOSE:NUMBER|MIN=2|MAX=5|TITLE=Roll 1d4+1 and pick a number

Will let you choose a number between 2 and 5. (Simulates rolling 1d4+1).

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.16.x

Tag Name: CHOOSE:PCSTAT|x|x

Variables Used (x): Text (Stat abbreviation)

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

Variables Used (x): !TYPE=Text (Stat type)

Variables Used (x): ALL

What it does:

NOTE: Most, if not all, game modes distributed with PCGen do not use stat types.

Example:

CHOOSE:STAT|DEX|CON

Un-intuitively, this produces a list of all stats except DEX and CON . Due to the potential for confusion, the CHOOSE:STAT syntax has been replaced by the CHOOSE:PCSTAT syntax below.

Example Conversion to New Syntax:

CHOOSE:STAT|STR|CON becomes CHOOSE:PCSTAT|DEX|INT|WIS|CHA

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** Updated 6.03.02

Tag Name: CHOOSE:RACE|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Race, by name or key)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): RACETYPE=Text (Race-type)

Variables Used (x): RACESUBTYPE=Text (Race-subtype)

Variables Used (x): BASESIZE=Text (Size value)

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

Variables Used (x): !TYPE=Text (Prohibited race type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:RACE|RACETYPE=Dragon

This will produce a list of all races that have the Dragon racial type.

CHOOSE:RACE|Dwarf|Elf

This will produce a list of races including only the Dwarf and the Elf .

CHOOSE:RACE|RACETYPE=Humanoid,RACESUBTYPE=Aquatic

This will produce a list of all Humanoid races that have the Aquatic subtype.

CHOOSE:RACE|BASESIZE=M

This will produce a list of all races that have a size of "M".

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** Updated 5.17.4

Tag Name: CHOOSE:SCHOOLS|x|x

Variables Used (x): Text (School name)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): ALL

What it does:

Example:

CHOOSE:SCHOOLS|ALL

This will produce a list of all schools of magic (abjuration, evocation, etc.).

CHOOSE:SCHOOLS|FEAT=Spell Focus

This will produce a list of all schools for which the character has the "Spell Focus" feat.

Deprecated Syntax:

CHOOSE:SCHOOLS becomes CHOOSE:SCHOOLS|ALL

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:SHIELDPROFICIENCY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Shield proficiency)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): TYPE=Text (Shield proficiency type)

Variables Used (x): !TYPE=Text (Prohibited shield proficiency type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

Variables Used (y): EQUIPMENT[x] (Special Qualifier)

What it does:

Example:

CHOOSE:SHIELDPROFICIENCY|TYPE=Foo

Will display a list of proficiencies for all shield proficiencies of type Foo .

CHOOSE:SHIELDPROFICIENCY|Buckler|Tower Shield

Will display no proficiencies as no shield will have both proficiencies lisyted.

CHOOSE:SHIELDPROFICIENCY|EQUIPMENT[Buckler]

Will display a list the proficiencies for the Buckler.

CHOOSE:SHIELDPROFICIENCY|EQUIPMENT

Will display a list the shield proficiencies of all shields taken.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:SIZE|x|x

Variables Used (x): Text (Size)

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

Variables Used (x): !TYPE=Text (Prohibited size type)

Variables Used (x): ALL

What it does:

Example:

CHOOSE:SIZE|ALL

This will produce a list of all sizes available in the gameMode.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** Updated 6.03.04

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

Variables Used (x): Text (Skill name or key)

Variables Used (x): Text% (Search pattern by skill name or key)

Variables Used (x): FEAT=Text (Feat, by name or key)

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

Variables Used (x): !TYPE=Text (Prohibited skill type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): QUALIFIED

Variables Used (y): USEUNTRAINED

Variables Used (y): CLASS

Variables Used (y): CROSSCLASS

Variables Used (y): EXCLUSIVE

Variables Used (y): NORANK

Variables Used (y): RANKS=number (Skill ranks)

What it does:

Example:

CHOOSE:SKILL|Search|Spot

Will display a list of skills comprised of the Search and Spot skills.

CHOOSE:SKILL|CLASS

This will produce a list of all the character's class skills.

CHOOSE:SKILL|RANKS=1

This will produce a list of all skills the character's has one or more ranks in.

CHOOSE:SKILL|!RANKS=MAXRANK

This will produce a list of all skills the character's has that are not at the maximum ranks allowed.

CHOOSE:SKILL|Knowledge%

This will produce a list of all knowledge skills.

Where it is Used:

Ability, Domain, Feat, Race, and Template files. For the eqmod version see CHOOSE:ABILITY (Equipment Modifiers)


*** Updated 6.3.0

Tag Name: CHOOSE:SPELLLEVEL|w|x|y|z|x|y|z

Variables Used (w): TITLE=Text (Chooser title. Optional)

Variables Used (x): Text (Spellcaster class)

Variables Used (x): CLASS=Text (Spellcaster class)

Variables Used (x): SPELLTYPE=Text (Spell type)

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

Variables Used (x): !TYPE=Text (Class type)

Variables Used (x): ALL

Variables Used (y): Number or formula (Minimum level)

Variables Used (z): Formula (Maximum level)

What it does:

Example:

CHOOSE:SPELLLEVEL|CLASS=Wizard|0|MAXLEVEL|SPELLTYPE=Divine|1|3

Would present a list of the character's castable Wizard levels of spells (e.g. Wizard 0 Wizard 1 Wizard 2 for a 5th level Wizard) and Cleric 1 Cleric 2 Cleric 3 if the character had Cleric as a class.

CHOOSE:SPELLLEVEL|SPELLTYPE=Arcane|0|MAXLEVEL <tab> BONUS:SPELLCAST|%LIST|1

Would present a list of the character's castable Arcane spells and allow one to be chosen as a bonus spell per day.

Example Conversion to New Syntax:

CHOOSE:SPELLLEVEL||2|TYPE.Arcane|4|MAXLEVEL+30[BONUS:SPELLCAST|CLASS=%;LEVEL=%|1] becomes

SELECT:2 <tab> CHOOSE:SPELLLEVEL|SPELLTYPE=Arcane|4|MAXLEVEL+30 <tab> BONUS:SPELLCAST|%LIST|1

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New - 5.13.x

Tag Name: CHOOSE:SPELLS|x,y,y[z]|x|y|y[z;z]

Variables Used (x): Text (Spell name)

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

Variables Used (x): SCHOOL=Text (Spell school)

Variables Used (x): SUBSCHOOL=Text (Spell subschool)

Variables Used (x): DESCRIPTOR=Text (Spell descriptor)

Variables Used (x): PROHIBITED=Boolean (Optional)

Variables Used (x): SPELLBOOK=Text (Spellbook name)

Variables Used (y): CLASSLIST=Text (Class name)

Variables Used (y): DOMAINLIST=Text (Domain name)

Variables Used (y): SPELLTYPE=Text (Spell type)

Variables Used (y): ALL

Variables Used (z): KNOWN=Boolean (Optional)

Variables Used (z): LEVELMIN=Number, Variable, Formula, or MAXCASTABLE (Minimum spell level, Optional)

Variables Used (z): LEVELMAX=Number, Variable, Formula, or MAXCASTABLE (Maximum spell level, Optional)

What it does:

Example:

CHOOSE:SPELLS|Acid Arrow|Magic Missile|Ray of Frost

Choose between Acid Arrow, Magic Missile and Ray of Frost

CHOOSE:SPELLS|CLASSLIST=Psion[LEVELMIN=1;LEVELMAX=3]

Choose from Psion spells between first level and third level

CHOOSE:SPELLS|SPELLTYPE=Arcane,SCHOOL=Evocation

Choose from Arcane Evocation spells

CHOOSE:SPELLS|DESCRIPTOR=Good

Choose from spells with the Good descriptor

CHOOSE:SPELLS|ALL[KNOWN=YES]

Choose from spells known by the PC.

CHOOSE:SPELLS|ALL[LEVELMAX=MAXCASTABLE-1],SPELLTYPE=Arcane

Choose from spells that are both up to the maximum castable (of any spell) level minus 1 AND SPELLTYPE=Arcane .

CHOOSE:SPELLS|CLASSLIST=Sorcerer[LEVELMIN=1;LEVELMAX=MAXCASTABLE-1]

Choose from Sorcerer spells between first level and one less than your max castable level of spell taken from the Sorcerer list

CHOOSE:SPELLS|SPELLTYPE=Psionic[KNOWN=YES]|SPELLTYPE=Psionic[LEVELMAX=MAXCASTABLE-1]

Choose from any Psionic "Spell" known by the PC or available to any Psionic Caster at a level at least one less than the maximum level of Psionic "Spell" castable by the PC. Notice the independence of the KNOWN and LEVELMAX subtags forces the use of two sets of square brackets ([ ]).

CHOOSE:SPELLS|SPELLTYPE=Psionic[KNOWN=YES;LEVELMAX=MAXCASTABLE-1]

Choose from any Psionic "Spell" known by the PC at a level at least one less than the maximum level of Psionic "Spell" castable by the PC. Notice the common case between the KNOWN , LEVELMIN , and LEVELMAX subtags can be done with one set of square brackets ([ ]).

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.13.4

Tag Name: CHOOSE:STRING|x|x

Variables Used (x): Text (Choice to be offered)

What it does:

Example:

CHOOSE:STRING|+1|+2

This will produce a list consisting of "+1" and "+2".

CHOOSE:STRING|Undead|Constructs|Monkeys

This will produce a list consisting of "Undead", "Constructs" and "Monkeys".

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

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

Variables Used (x): Text (Template Name or Key)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): TYPE=Text (Template Type)

Variables Used (x): !TYPE=Text (Template Type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

What it does:

Example:

CHOOSE:TEMPLATE|Mindless|Undead

Presents the "Mindless" and "Undead" templates for selection.

CHOOSE:TEMPLATE|Mindless,Undead

No templates are presented as no template is both "Mindless" and "Undead".

CHOOSE:TEMPLATE|Mindless|TYPE=Foo,PC

Presents the "Mindless" template and any templates that have the "Foo" type which are already selected by the Player Character.

CHOOSE:TEMPLATE|Mindless|PC[TYPE=Foo]

Presents the "Mindless" template and any templates that have the "Foo" type which are already selected by the Player Character.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.11.9

Tag Name: CHOOSE:USERINPUT|x|y

Variables Used (x): Number (Number of inputs. Optional. Defaults to 1)

Variables Used (y): TITLE=Text (Chooser dialog title)

What it does:

Produces a pop-up dialog box asking for the user's entry via keyboard input.

Example:

CHOOSE:USERINPUT|1|TITLE=Hobby Name

This will produce a chooser for the user to enter a single hobby name.

Where it is Used:

Feat and Ability Files


Tag Name: CHOOSE:WEAPONFOCUS|x

Variables Used (x): TYPE.Text (Equipment type)

What it does:

Example:

CHOOSE:WEAPONFOCUS|TYPE.Sword

Present a list of weaponprofs associated with a character's Weapon Focus feats that match a given equipment type.

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


*** New 5.17.4

Tag Name: CHOOSE:WEAPONPROFICIENCY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]

Variables Used (x): Text (Weapon proficiency)

Variables Used (x): DEITYWEAPON (Feat, by name or key)

Variables Used (x): FEAT=Text (Feat, by name or key)

Variables Used (x): WIELD=Text (Weapon wield type. Used in EQUIPMENT qualifier only.)

Variables Used (x): TYPE=Text (Weapon proficiency type)

Variables Used (x): !TYPE=Text (Prohibited weapon proficiency type)

Variables Used (x): ALL

Variables Used (y): ANY (Default)

Variables Used (y): PC

Variables Used (y): QUALIFIED

Variables Used (y): EQUIPMENT[x] (Special qualifier)

Variables Used (y): SPELLCASTER[x] (Special qualifier)

What it does:

Example:

CHOOSE:WEAPONPROFICIENCY|Longsword|Flail

Will display a list of weapon proficiencies including only Longsword and Flail .

CHOOSE:WEAPONPROFICIENCY|Longsword|TYPE=Ranged,PC

Will display a list of weapon proficiencies of the Ranged type that the PC is already proficient with.

CHOOSE:WEAPONPROFICIENCY|SPELLCASTER[Ray]

Will add proficiency with the Ray if the PC is a spellcaster.

CHOOSE:WEAPONPROFICIENCY|EQUIPMENT[TYPE=Finesseable]

Will display a list of weapon proficiencies for all weapons with a type of Finesseable .

CHOOSE:WEAPONPROFICIENCY|EQUIPMENT[TYPE=Melee,WIELD=Light]

Will display a list of weapon proficiencies for all weapons with a type of Melee that also have a wield type of Light .

Where it is Used:

Ability, Domain, Feat, Race, and Template files.


CHOOSE Tag Prefixes

The CHOOSE tag uses "Prefix" tags to modify the application of the CHOOSE tag. The prefix tags are inserted into the CHOOSE tag's syntax immediately after the colon (:) and before the first argument, using a pipe (|) as a delimiter between itself and the first argument.

The valid prefix tags are detailed below.


Tag Name: NUMCHOICES=x

Variables Used (x): Number or Formula (Maximum number of total selections that can be taken)

What it does:

Example:

CHOOSE:NUMCHOICES=3|SKILLSNAMED|Spot|Listen|Search

The user can select the same choice more than once, but the user will never be allowed more than 3 choices total, each made one at a time.

CHOOSE:NUMCHOICES=6|SKILLSNAMED|Craft%|3

The user can select this chooser multiple times and will be allowed to select up to 3 Craft subskills each time the chooser is selected, but may only make 6 Craft subskill sellection total.

CHOOSE:NUMCHOICES=3|SKILLSNAMED|TYPE=Strength|TYPE=Dexterity|TYPE=Constitution|TYPE=Intelligence|TYPE=Wisdom

The user will be allowed to select one skill from "Strength" "Dexterity" "Constitution" "Intelligence" and "Wisdom" skills each time the chooser is taken but is limited to a maximum of three such selections through this chooser.

SELECT:3 <tab> CHOOSE:NUMCHOICES=6|SKILLSNAMED|TYPE=Knowledge

The user can select three (3) "Knowledge" type skills each time he takes the associated feat but may take no more than six (6) "Knowledge" type skills total no matter how many times the feat is taken.

CHOOSE:NUMCHOICES=3|NOCHOICE

A feat, or ability, containing this tag may be applied three times, with no CHOOSER window being displayed, as long as there is no SELECT tag included giving more than 1 choice per feat application.