# The CHOOSE Tag

This file covers the glodal CHOOSE tag in its many different forms.

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:

- Use ADD:ABILITY or ADD:FEAT to activate the selection window. Using ABILITY or VFEAT will bypass the CHOOSE tag.
- Use it in conjunction with a MULT:YES tag for it to work properly.

This page is organized into two sections:

- Global Choose Dictionary
- Choose Tag Prefixes

### Global CHOOSE Dictionary

*** New 5.15.6

Tag Name: CHOOSE:ABILITY|x|y,y

Variables Used (x): Text (Ability category)

Variables Used (y): Text (Ability name)

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

What it does:

- Will present a list of abilities, by name and/or type, of the specified category.
- At least one ability or ability type must be designated for this tag to function properly.

Example:

`CHOOSE:ABILITY|FEAT|TYPE=Rogue Abilities`

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

Where it is Used:

Global except for Equipmod Files. For the eqmod version see CHOOSE:ABILITY (Equipment Modifiers)

Tag Name: CHOOSE:ARMORPROF|x|y|y

Variables Used (x): Number (The maximum number of choices that can be selected)

Variables Used (y): Text (Armor name)

Variables Used (y): TYPE=Text (Armor type)

What it does:

This will produce a list of all armors matching the criteria.

Example:

`CHOOSE:ARMORPROF|2|TYPE=Heavy`

Allow the choice of up to two heavy armors.

`CHOOSE:ARMORPROF|1|Scale Mail|Chainmail`

Allow the choice of one of Scale Mail or Chainmail.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:ARMORTYPE

Variables Used: None

What it does:

- This will produce a list of all armor types that the character is proficient with.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:ARMORTYPE`

This will produce a list of all the armor types with which the character is proficient. If the character in question was a Fighter the list produced would be Light, Medium, and Heavy.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:CSKILLS

Variables Used: None

What it does:

- This will produce a list of all class skills for the character, regardless of rank.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:CSKILLS`

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

Where it is Used:

Global except for Equipmod Files

*** New 5.9.4

Tag Name: CHOOSE:DOMAIN|x|x

Variables Used (x): ANY

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

Variables Used (x): QUALIFY

Variables Used (x): PC

Variables Used (x): Text (Domain name)

What it does:

- This will produce a list of Domains.
- `ANY` returns a list of all loaded Domains.
- `DIETY=<text>` returns a list of Domains granted by specified Deity.
- `QUALIFY` returns a list of loaded Domains the PC qualifies for but does not have.
- `PC` returns a list of all domains a character actually has.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:DOMAIN|Air|Fire|Sun`

Will allow selection Air, Fire or Sun Domains.

`CHOOSE:DOMAIN|DIETY=Kong`

Will allow selection any Domain granted by the deity "Kong".

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:EQUIPTYPE|x.x

Variables Used (x): Text (Equipment type)

What it does:

- This will produce a list of all known equipment that are of all of the named types.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:EQUIPTYPE|Melee.Simple`

Will allow selection from all simple melee weapons.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:FEAT=x

Variables Used (x): Text (Feat name)

What it does:

- This will produce a list of choices associated with the named feat (Should replace WEAPONFOCUS).
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:FEAT=Weapon Focus`

Will display a list of all the character's choices for the Weapon Focus feat.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:FEATADD|x|x

Variables Used (x): Text (Feat Name)

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

What it does:

- This will produce a list of feats that match the type or name specified. The selected feat will be added to the characters feats.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:FEATADD|TYPE=Fighter`

This will produce a list of all fighter feats. The selected feat will be added to the character's feats.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:FEATLIST|x|x

Variables Used (x): Text (Feat Name)

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

What it does:

- This will produce a list of feats possessed by the character that match the type or name specified.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:FEATLIST|TYPE=Fighter`

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

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:FEATSELECT|x|x

Variables Used (x): Text (Feat Name)

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

What it does:

- This will produce a list of feats that match the type or name specified.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:FEATSELECT|TYPE=Fighter`

This will produce a list of all fighter feats.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:HP|x

Variables Used (x): Text (Display name)

What it does:

- Displays a list with the display name
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:HP|+3 hp`

Will display a list with "+3 hp" .

Where it is Used:

Global except for Equipmod Files

*** New 5.9.4

Tag Name: CHOOSE:NOCHOICE

What it does:

- Suppresses the pop-up window for this CHOOSE tag.
- Used in conjunction with `MULT:YES`.
- When used in a feat, this tag will simply add the feat to the character without a chooser window. After the first time it is added, a "(x2)", "(x3)" etc. will be displayed, indicating the number of times the feat was chosen.
- When used for a "nested" choice, the "outer" choice isn't displayed. Example: Given feats "X" and "Y" where feat "X" includes the `ADD:FEAT|Y` tag and feat "X" also includes a `CHOOSE` tag, the feat "X(Y)" is displayed in the chooser. With this option it will show up as "Y".

Example:

`CHOOSE:NOCHOICE`

The feat is added without a chooser window.

Tag Name: CHOOSE:NONCLASSSKILLLIST|x

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

What it does:

This will produce a list of skills specified or all cross class skills for the character.

Example:

`CHOOSE:NONCLASSSKILLLIST|LIST`

This will produce a list of cross class skills for the character.

Where it is Used:

Global except for Equipmod 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:

- Allows the selections of a number between the high and low values, inclusive
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** New 5.10

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

Variables Used (x): WEAPON (Choose Weapon Proficiencies)

Variables Used (y): PC (Choose from proficiencies already possessed by PC)

Variables Used (y): ALL (Choose from all proficiencies)

Variables Used (y): UNIQUE (Choose from all proficiencies not already possessed by PC)

Variables Used (z): Text (Proficiency to add to list)

Variables Used (z): TYPE= (Type of proficiency)

What it does:

- This will produce a list of all proficiencies that match the criteria specified.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:PROFICIENCY|WEAPON|UNIQUE|TYPE=Exotic`

This will produce a list of all exotic weapon proficiencies the PC does not have.

`Automatic Weapon Proficiency <tab> TYPE:General <tab> MULT:YES <tab> CHOOSE:PROFICIENCY|WEAPON|UNIQUE|TYPE.Automatic <tab> AUTO:WEAPONPROF|%LIST`

This will produce a list of all Automatic weapon proficiencies the PC does not have and may be selected multiple times.

`Exotic Firearms Proficiency <tab> TYPE:General.Soldier <tab> PREFEAT:2,Personal Firearms Proficiency,Advanced Firearms Proficiency <tab> MULT:YES <tab> CHOOSE:PROFICIENCY|WEAPON|UNIQUE|TYPE.ExoticFirearms <tab> AUTO:WEAPONPROF|%LIST`

This will produce a list of all ExoticFirearms weapon proficiencies the PC does not have, must have the two feats Personal Firearms Proficiency,Advanced Firearms Proficiency and may be selected multiple times.

Where this is used at:

Feat and Ability Files

*** New 5.9.5

Tag Name: CHOOSE:RACE|x|x

Variables Used (x): Text (Race name)

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

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

Variables Used (x): TYPE=x (Race's type tag)

What it does:

- This will produce a list of all races that match the criteria specified.
- To group items together so that all the items in the group must be true use "[]" to surround the choices.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:RACE|RACETYPE=Dragon`

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

Example:

`CHOOSE:RACE|[RACETYPE=Humanoid,RACESUBTYPE=Aquatic]`

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

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:SALIST|x,x

Variables Used (x): Text (Start of SA name)

What it does:

- This will produce a list of all special abilities for the character that match the start strings specified.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:SALIST|Turn,Rebuke`

This will produce a list of all Special Abilities that start with Turn or Rebuke possessed by the character.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:SCHOOLS

Variables Used: None

What it does:

- This will produce a list of all schools of magic from schools.lst.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:SCHOOLS`

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

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:SHIELDPROF|x|y|y

Variables Used (x): Number (The maximum number of choices that can be selected)

Variables Used (y): Text (Shield name)

Variables Used (y): TYPE=Text (Shield type)

What it does:

- This will produce a list of all shields of the specified type or name.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:SHIELDPROF|TYPE=Wood`

This will produce a list of all wooden shields.

`CHOOSE:SHIELDPROF|TYPE=Buckler|TYPE=Light|TYPE=Heavy`

This will produce a list of all shields of type "Buckler", "Light" and "Heavy".

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:SKILLS

Variables Used: None

What it does:

- This will produce a list of all skills currently attached to the character, regardless of rank.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:SKILLS`

This will produce a list of all skills usable Untrained and any skills that have ranks for the character.

Where it is Used:

Global except for Equipmod Files

*** Updated 5.9.5

Tag Name: CHOOSE:SKILLSNAMED|x|x

Variables Used (x): Text (Skill name)

Variables Used (x): Text% (Start of skill name)

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

Variables Used (x): ALL (Displays all skills)

Variables Used (x): CLASS (Displays all class skills)

Variables Used (x): CROSSCLASS (Displays all cross class skills)

Variables Used (x): EXCLUSIVE (Displays all exclusive skills)

Variables Used (x): RANKS=Number (Displays all skills the PC has of the listed rank)

Variables Used (x): NORANK (Displays all skills the PC has no ranks in)

What it does:

- This will produce a list of named skills that match the included selection criteria.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:SKILLSNAMED|CLASS`

This will produce a list of class skills from which the character can pick.

`CHOOSE:SKILLSNAMED|Knowledge%`

This will produce a list of skills starting with Knowledge from which the character can pick.

`CHOOSE:SKILLSNAMED|CROSSCLASS|Craft%`

This will produce a list of all cross class skills as well as all Craft skills even if they are not cross class.

`CHOOSE:SKILLSNAMED|RANKS=20`

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

`CHOOSE:SKILLSNAMED|NORANK`

This will produce a list of all skills the character has 0 ranks in.

`STACK:NO <tab> MULT:YES <tab> CHOOSE:SKILLSNAMED|TYPE=Strength|TYPE=Dexterity|TYPE=Constitution|1 <tab> BONUS:SKILL|LIST|CL=Super Soldier|TYPE=Enhancement`

This will produce a list of all skills that are TYPE "Strength", "Dexterity" and "Constitution" and add the ClassLevel of Super Soldier to the selection.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:SPELLCLASSES

Variables Used: None

What it does:

- This will produce a list of all the character's classes which don't have a base spell stat of "None".
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:SPELLCLASSES`

Will produce a list of the character's classes that can cast spells.

Where it is Used:

Global except for Equipmod Files

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

Variables Used (w): Number (Number of choices)

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

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

Variables Used (y): Number (Minimum level)

Variables Used (z): Number (Maximum level)

Variables Used (z): MAXLEVEL

What it does:

- Display a list of character's castable spells for the specified class or type.
- Spells will only be included if they fall between the range of Minimum Level and Maximum Level.
- MAXLEVEL will include spells up to the highest level the character can cast.
- A bonus can be associated with the choice by appending it in square brackets ([]).
- NUMCHOICES= cannot be used with CHOOSE:SPELLLEVEL, as it has an integrated choice count

Example:

`CHOOSE:SPELLLEVEL|2|CLASS=Wizard|0|MAXLEVEL|TYPE=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 and allow two to be chosen.

`CHOOSE:SPELLLEVEL|1|TYPE=Arcane|0|MAXLEVEL[BONUS:SPELLCAST|CLASS=%;LEVEL=%|1]`

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

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:SPELLLIST|x

Variables Used (x): Boolean (Spellbook required. Y or N)

What it does:

- This will produce a list of known spells for each class that matches the spellbook requirement.
- Allows selection of the maximum stat modifier spells for each qualifying class.

Example:

`CHOOSE:SPELLLIST|Y`

Would produce a list of all known spells for each class that uses a spellbook for the character. If the character is a Wizard, for example, it would allow INT mod selections from the list.

Where it is Used:

Ability 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): ANY

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:

- Presents a list of spells matching the criteria defined by the included sub-tags.
- The `PROHIBITED` sub-tag will restrict the presented spell list to prohibited ("YES") spells or non-prohibited ("NO") spells. If it is not included, both are presented.
- The `SPELLBOOK` sub-tag is used to reference the specific spell book, such as "Innate", in which the spells is located.
- The spell type used in the `SPELLTYPE` sub-tag above MUST be used in a `SPELLTYPE` tag within a loaded class.
- The `KNOWN` sub-tag will restrict the presented spell list to known ("YES") spells or unknown ("NO") spells. If it is not included, both are presented.
- The `LEVELMIN` sub-tag references all spells of the specified level and higher within the context of the "y" variable preceding the brackets.
- The `LEVELMAX` sub-tag references all spells of the specified level and lower within the context of the "y" variable preceding the brackets.
- The "z" variable MUST be contained within a set of square-brackets ([ ]) and paired with a single "y" variable. Only one set of square brackets per "y" variable is allowed.
- Independent "z" parameters require the use of multiple sets of square brackets ([ ]), one for each "z" parameter paired with is own "y" parameter. (e.g. y[z]|y[z])
- Dependent "z" parameters can use a common set of square-brackets ([ ]) paired with the associated "y" parameter. (e.g. y[z;z])
- Note: y[z;z]|y[z] is legal, y[z][z] is not.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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|ANY[KNOWN=YES]`

Choose from spells known by the PC.

`CHOOSE:SPELLS|ANY[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:

Global except for Equipmod Files

Tag Name: CHOOSE:STAT|x|x

Variables Used (x): Text (Stat name. Optional)

What it does:

- This will produce a list of all stats except the one(s) listed.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:STAT|CON`

This will produce a list off all stats except CON.

Where it is Used:

Global except for Equipmod Files

*** New 5.13.4

Tag Name: CHOOSE:STRING|x|x

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

What it does:

- This will produce a list of the provided strings.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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".

Tag Name: CHOOSE:TEMPLATE

What it does:

See TEMPLATE:CHOOSE instead.

*** 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:

- This will produce a list of weaponprofs associated with the Weapon Focus Feat.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:WEAPONFOCUS|TYPE.Sword`

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

Where it is Used:

Global except for Equipmod Files

*** Updated 5.7.1

Tag Name: CHOOSE:WEAPONPROF|x|y|y

Variables Used (x): Number (Total Selections allowed)

Variables Used (y): Text (Weapon name)

Variables Used (y): DEITYWEAPON

Variables Used (y): FEAT=Text (Feat name)

Variables Used (y): WIELD.Text (Wield category)

What it does:

- WEAPONPROF is the only viable choice at this time in the domains list file with the CHOOSE tag.
- The actual listing of the types of weapon proficiencies the character may have is made up of:
  - A pipe-delimited ("|") list of weapon proficiencies as they appear in the weapon proficiencies list file.
  - DEITYWEAPON gets the weapon listed in the deities list file.
  - Feat name must be any feat that requires a weapon proficiency, such as Simple, Martial, Exotic, Weapon Focus, etc.
  - Wield category can be "Light", "OneHanded" or "TwoHanded". Specific types of weapon proficiencies may be excluded by using "|!TYPE=<weapon type>" at the end of the tag. You can have as many !TYPE tags as you like, but they all MUST be at the end of the tag.

Special Case: `CHOOSE:WEAPONPROF|1|DEITYWEAPON[WEAPONPROF][FEAT=Weapon Focus]`

- I cannot explain how this tag works but it does.
- This tag is used in the War Domain to grant proficiency in, and the Weapon Focus feat of, the dieties Favored Weapon to the cleric that has selected that domain.
- The syntax using brackets ([]) will be changed in PCGen 6.0.

Example:

`CHOOSE:WEAPONPROF|1|Dagger|Club`

Choice of either a Dagger or Club proficiency.

`CHOOSE:WEAPONPROF|3|DEITYWEAPON`

Choice of three of those allowed by the Deity.

`CHOOSE:WEAPONPROF|2|Dagger|Sword (Long)|Spear|Halberd`

Choice of two of the Dagger, Long Sword, Spear and Halbard.

`CHOOSE:WEAPONPROF|10|FEAT=Martial Weapon Proficiency`

Choice of ten Martial Weapons.

`CHOOSE:WEAPONPROF|1|WIELD.OneHanded|WIELD.Light`

Choice of all weapons which have a WIELD tag of either OneHanded or Light.

`CHOOSE:WEAPONPROF|1|WIELD.OneHanded|!TYPE.Exotic`

Choice of all weapons which have a WIELD tag of OneHanded which are not Exotic.

Where it is Used:

Global except for Equipmod Files

Tag Name: CHOOSE:WEAPONPROFS|x|x.y

Variables Used (x): LIST

Variables Used (x): DEITYWEAPON

Variables Used (x): Text (SIZE.)

Variables Used (y): Text (F=Fine, D=Diminutive, T=Tiny, S=Small, M=Medium, L=Large, H=Huge, G=Gargantuan, C=Colossal)

Variables Used (x): Text (WSIZE.)

Variables Used (y): Text (Light, 1 handed, or 2 handed. Can have optional equipment types as well)

Variables Used (x): Spellcaster.Text (Weapon proficiency))

Variables Used (y): Text (Weapon prof name)

Variables Used (x): ADD.Text (Weapon proficiency)

Variables Used (y): Text (Weapon prof name)

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

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

Variables Used (y): Text (Equipment type or Light, 1 handed, or 2 handed)

Variables Used (y): Not.Text (Proficiency type)

What it does:

- The actual listing of the types of weapon proficiencies the list may have is made up of:
  - LIST - All character's weapon profs are added to list
  - DEITYWEAPON - All the character's Deity's favorite weapons are added to the list
  - Size.y<Weapon prof name> - Weapon prof is added to list if character is at least size specified and the character has the proficiency specified. Other options are F=Fine, D=Diminutive, T=Tiny, S=Small, M=Medium, L=Large, H=Huge, G=Gargantuan, C=Colossal).
  - WSize.string - The character's weapon prof is added to the list if the wield category matches the specified type.
  - Spellcaster.string - The specified weapon proficiency will be added to the list if the character is a spellcaster.
  - ADD.string - The specified weapon proficiency is added to the list unconditionally.
  - TYPE.string - All proficiencies that has equipment that matches the specified type or wield category will be added to the list.
  - TYPE.Not.string - Remove a previously added proficiency that has equipment that matches the specified type or wield category will be added to the list.
  - weaponprof - The specified proficiency will be added to the list if the character has it.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:WEAPONPROFS|LIST`

Displays a list of all the character's weapon proficiencies.

`CHOOSE:WEAPONPROFS|DEITYWEAPON`

Displays a list of all the character's deity's favorite weapon proficiencies.

`CHOOSE:WEAPONPROFS|Size.LGreatsword|Size.LClub|Size.SSling|Size.SDagger`

Displays a list of Greatsword, Club, Sling, and Dagger if the character is at least Large size of Sling and Dagger if the character is at least Small size.

`CHOOSE:WEAPONPROFS|WSize.Light.Wood`

Displays a list of all the character's weapon profs for light weapons if there is a wood weapon of that type.

`CHOOSE:WEAPONPROFS|Spellcaster.Longsword|Spellcaster.Longbow`

Displays a list of Longsword and Longbow if the character is a spellcaster.

`CHOOSE:WEAPONPROFS|ADD.Longsword|ADD.Longbow`

Displays a list of Longsword and Longbow.

`CHOOSE:WEAPONPROFS|TYPE.Melee`

Displays a list of weapon proficiencies for melee weapons.

`CHOOSE:WEAPONPROFS|LIST|TYPE.Not.2 handed`

Displays a list of weapon proficiencies for all weapons that are not 2 handed.

`CHOOSE:WEAPONPROFS|Longsword|Longbow`

Displays a list of Longsword and Longbow.

`CHOOSE:WEAPONPROFS|3 <tab> BONUS:COMBAT|TOHIT.%LIST|1|TYPE=Talent`

Choice 3 weapons proficiencies which will be inserted in the %LIST giving you an additional +1 to-hit with them.

Where it is Used:

Global except for Equipmod 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 tags 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:

- Sets the total number of choices that can be made by taking a particular feat multiple times.
- Used in conjunction with the MULT tag.
- When used in conjunction with the `SELECT` tag, the NUMCHOICES value should equal a multiple of the SELECT value.

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 upto 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 takem 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.