# 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. EXCEPTION: `MULT:YES` is not to be used with `CHOOSE:NUMBER`.

This page is organized into two sections:

- Global Choose Dictionary
- Choose Tag Prefixes

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

- Will present a list of abilities of the specified category that matches the stipulated criteria.
- Using the `FEAT=Text` sub-tag will provide a list of abilities chosen by the referenced feat. The feat referenced must contain a `CHOOSE:ABILITY` tag.
- Global qualifiers work with abilities. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all abilities of the designated ability category.
  - PC - Will return a list of all abilities already taken by the Player Character.
  - QUALIFIED - Will return a list of all abilities that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

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

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

- This will produce a list of "Alignments". (e.g. LG, TN, CE, etc. for 3.5e gameMode)
- Use of the `FEAT` subtag will provide the alignment selected by the referenced feqt. The feat referenced must contain a `CHOOSE:ALIGNMENT` tag.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

CHOOSE:ALIGNMENT|ALL

This will produce a list of all alignments available.

Where it is Used:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:ARMORPROFICIENCY - Remove 6.2

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

Example Conversion to New Syntax:

`CHOOSE:ARMORPROF|Chainmail` becomes `CHOOSE:ARMORPROFICIENCY|EQUIPMENT[Chainmail]`

`CHOOSE:ARMORPROF|ALL` becomes `CHOOSE:ARMORPROFICIENCY|EQUIPMENT[ALL]`

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

- This will produce a list of all armor proficiencies matching the criteria.
- Using the `FEAT=Text` sub-tag will provide a list of armor proficiencies selected by the referenced feat. The feat referenced must contain a `CHOOSE:ARMORPROFICIENCY` tag.
- When using the `EQUIPMENT` qualifier the parameters included inside the brackets are used to identify a list of equipment from which the armor proficiencies are taken and added to the final list of provided proficiencies. The criteria included in the brackets ([x]) are used to summarize armor and not armor proficiencies.
- Global qualifiers work for armor proficiencies. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all armor proficiencies.
  - PC - Will return a list of all armor proficiencies already taken by the Player Character.
  - QUALIFIED - Will return a list of all armor proficiencies that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:ARMORPROFICIENCY - Remove 6.2

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

*** New 5.17.4

Tag Name: CHOOSE:CKECK|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:

- This will produce a list of checks (e.g. Will, Reflex, etc).
- Use of the `FEAT` subtag will provide the stat selected by the referenced feat. The feat referenced must contain a `CHOOSE:CHECK` tag.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:CHECK|ALL`

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

Where it is Used:

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

- Will present a list of classes that matche the stipulated criteria.
- Using the `FEAT=Text` sub-tag will provide a list of classes chosen by the referenced feat. The feat referenced must contain a `CHOOSE:CLASS` tag.
- Using the `SPELLCASTER` sub-tag will provide a list of classes that can cast spells.
- Global qualifiers work with abilities. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all classes.
  - PC - Will return a list of all classes already selected by the Player Character.
  - QUALIFIED - Will return a list of all classes that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files.

*** Deprecated Syntax 5.17.4 - Use CHOOSE:SKILL - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:CSKILLS` becomes `CHOOSE:SKILL|CLASS`

Where it is Used:

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

- Will present a list of deities that matches the stipulated criteria.
- Using the `ALIGN=Text` sub-tag will provide a list of deities of the referenced alignment.
- Using the `FEAT=Text` sub-tag will provide a list of deity selected by the referenced feat. The feat referenced must contain a `CHOOSE:DEITY` tag.
- Using the `PANTEON=Text` sub-tag will provide a list of deities of the referenced pantheon.
- Global qualifiers work for equipment. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all deities.
  - PC - Will return the name of the deity already taken by the Player Character.
  - QUALIFIED - Will return a list of all deities that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

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

- Will present a list of domains that match the stipulated criteria.
- Using the `DEITY=Text` sub-tag will provide a list of domains for the referenced deity.
- Using the `FEAT=Text` sub-tag will provide a list of domains selected by the referenced feat. The feat referenced must contain a `CHOOSE:DOMAIN` tag.
- Global qualifiers work for equipment. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all domains.
  - PC - Will return the name of the domains already taken by the Player Character.
  - QUALIFIED - Will return a list of all domains that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- 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`

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.

Deprecated Syntax: Deprecated 5.17.4 - Remove 6.2

`CHOOSE:DOMAIN|QUALIFY`

Example Conversion to New Syntax:

`CHOOSE:DOMAIN|QUALIFY` becomes `CHOOSE:DOMAIN|QUALIFIED,!PC`

Where it is Used:

Global except for Equipmod Files

*** New 5.17.4

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): PC

Variables Used (y): QUALIFIED

What it does:

- Will present a list of equipment that matches the stipulated criteria.
- Using the `WIELD=Text` sub-tag will provide a list of equipment of the referenced wield type. The wield type must one of the following three type: Light, One-Handed, Two-Handed.
- Global qualifiers work for equipment. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all equipment.
  - PC - Will return a list of all equipment already taken by the Player Character.
  - QUALIFIED - Will return a list of all equipment that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:EQUIPMENT|TYPE=Melee.Simple`

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

`CHOOSE:EQUIPMENT|TYPE=Simple,PC`

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

Where it is Used:

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

*** Deprecated 5.17.4 - Use CHOOSE:EQUIPMENT (See example below) - Remove 6.2

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

Example Conversion to New Syntax:

`CHOOSE:EQUIPTYPE|Melee.Simple` becomes `CHOOSE:EQUIPMENT|TYPE=Melee.Simple`

*** Deprecated Syntax 5.17.3 - See Conversion Notes Below - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:FEAT=Weapon Focus` becomes `CHOOSE:WEAPONPROFICIENCY|FEAT=Weapon Focus|PC` - Use CHOOSE:WEAPONPROFICIENCY

Where it is Used:

Global except for Equipmod Files

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

- This will produce a list of feats matching the stipulated criteria.
- Using the `FEAT=Text` sub-tag will provide a list of feats chosen by the referenced feat. The feat referenced must contain a `CHOOSE:FEAT` tag.
- Global qualifiers work for feats. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all feats.
  - PC - Will return a list of all feats already taken by the Player Character.
  - QUALIFIED - Will return a list of all feats that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** Deprecated 5.17.3 - Use CHOOSE:FEAT (See example below) - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:FEATADD|Dodge|Toughness` becomes `CHOOSE:FEATSELECTION|Dodge|Toughness <tab> AUTO:FEAT|%LIST`

Where it is Used:

Global except for Equipmod Files

*** Deprecated 5.17.3 - Use CHOOSE:FEAT (See example below) - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:FEATLIST|TYPE=Fighter` becomes `CHOOSE:FEAT|PC[TYPE=Fighter]`

Where it is Used:

Global except for Equipmod Files

*** Deprecated 5.17.3 - Use CHOOSE:FEAT (See example below) - Remove 6.2

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

Example:

`CHOOSE:FEATSELECT|TYPE=Fighter` becomes `CHOOSE:FEAT|TYPE=Fighter`

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

- This will produce a list of feats, resolved down to the internal feat selections, matching the stipulated criteria.
- Global qualifiers work for feats. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all feats.
  - PC - Will return a list of all feats already taken by the Player Character.
  - QUALIFIED - Will return a list of all feats that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** Deprecated - Use CHOOSE:STRING - Remove for 6.2

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

- This presents a list of languages for selection.
- Use of the `FEAT` sub-tag will provide the language selected by the referenced feat. The feat referenced must contain a `CHOOSE:LANG` tag.
- Use of `LANBONUS` will provide a list of languages granted to the character by the `LANGBONUS` tag through the character's race, class or template.
- Global qualifiers work for languages. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all languages.
  - PC - Will return a list of all languages already taken by the Player Character.
  - QUALIFIED - Will return a list of all languages that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:LANG|Common|Goblin`

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

`CHOOSE:LANG|Common,Goblin`

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

`CHOOSE:LANG|Common|TYPE=Foo,PC`

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

*** New 5.9.4

Tag Name: CHOOSE:NOCHOICE

What it does:

- Suppresses the pop-up window for this CHOOSE tag.
- `MULT:YES` must be used when using this tag.
- 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.

*** Deprecated Syntax 5.17.4 - Use CHOOSE:SKILL - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:NONCLASSSKILLLIST|LIST` becomes `CHOOSE:SKILL|CROSSCLASS`

`CHOOSE:NONCLASSSKILLLIST|LIST|Spot,Search` becomes `CHOOSE:SKILL|CROSSCLASS|Spot|Search`

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
- Unlike other `CHOOSE` tags, `MULT:YES` is not to be used with `CHOOSE:NUMBER`.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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

- This will produce a list of all stats listed or otherwise meets the criteria included.
- The stats listed, including the type, must be defined in the Game Mode file.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

Example:

`CHOOSE:STAT|DEX|CON`

This will produce a list of stats consisting of STR, DEX, and CON.

Example Conversion to New Syntax:

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

Where it is Used:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:WEAPONPROFICIENCY - Remove 6.2

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=Text (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.

Example Conversion to New Syntax:

`CHOOSE:PROFICIENCY|WEAPON|UNIQUE|TYPE=Exotic` becomes `CHOOSE:WEAPONPROFICIENCY|!PC[TYPE=Exotic]`

Where this is used at:

Feat and Ability Files

*** New 5.9.5

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

- This will produce a list of all races matching the criteria.
- Using the `FEAT=Text` sub-tag will provide a list of races selected by the referenced feat.The feat referenced must contain a `CHOOSE:RACE` tag.
- Using the `RACETYPE=Text` sub-tag will provide a list of races selected by the referenced race-type. The referenced race-type is defined in the race's `RACETYPE` tag.
- Using the `RACESUBTYPE=Text` sub-tag will provide a list of races selected by the referenced race-subtype. The referenced race-subtype is defined in the race's `RACESUBTYPE` tag.
- Global qualifiers work for races. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all races.
  - PC - Will return a list of all races already selected by the Player Character.
  - QUALIFIED - Will return a list of all races that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- 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.

`CHOOSE:RACE|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.

Deprecated Syntax: Deprecated 5.17.4 - Remove 6.2

The use of brackets ([ ]) to group comma-delimited (,) items to perform a logical AND function is no longer required. The brackets are now used to group items so that a "qualifier" can be applied.

Example Conversion to New Syntax:

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

Where it is Used:

Global except for Equipmod Files

*** Deprecated - Remove in 6.2

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

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

- This will produce a list of "Schools" of magic. (e.g. Abjuration, Evocation, etc.)
- Use of the `FEAT` subtag will provide the SCHOOL selection made in the referenced feat. The feat referenced must contain a `CHOOSE:SCHOOLS` tag.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:SHIELDPROFICIENCY - Remove 6.2

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

Example Conversion to New Syntax:

`CHOOSE:SHIELDPROF|Buckler` becomes `CHOOSE:SHIELDPROFICIENCY|EQUIPMENT[Buckler]`

`CHOOSE:SHIELDPROF|ALLbecomes` becomes `CHOOSE:SHIELDPROFICIENCY|EQUIPMENT[ALL]`

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

- This will produce a list of all shield proficiencies matching the criteria.
- Using the `FEAT=Text` sub-tag will provide a list of shield proficiencies selected by the referenced feat. The feat referenced must contain a `CHOOSE:SHIELDPROFICIENCY` tag.
- When using the `EQUIPMENT` qualifier the parameters included inside the brackets are used to identify a list of equipment from which the shield proficiencies are taken and added to the final list of provided shield proficiencies. The criteria included in the brackets ([x]) are used to summarize shields and not shield proficiencies.
- Global qualifiers work for shield proficiencies. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all shield proficiencies.
  - PC - Will return a list of all shield proficiencies already taken by the Player Character.
  - QUALIFIED - Will return a list of all shield proficiencies that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

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

- This will produce a list of sizes (e.g. Small, Colossal, etc).
- The size list is a pipe (|) delimited list representing the logical OR.

Example:

`CHOOSE:SIZE|ALL`

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

Where it is Used:

Global except for Equipmod Files

*** New 5.17.3

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): PC

Variables Used (y): QUALIFIED

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:

- This will produce a list of skills matching the stipulated criteria.
- Using the percent sign (%) following a skill name forms a search pattern that will provide a list of skills that match the partial name provided.
- Using the `FEAT=Text` sub-tag will provide a list of skills chosen by the referenced feat. The feat referenced must contain a `CHOOSE:SKILL` tag.
- Using the `CLASS` sub-tag will provide a list of all class skills for the PC.
- Using the `CROSSCLASS` sub-tag will provide a list of all crossclass skills for the PC.
- Using the `EXCLUSIVE` sub-tag will provide a list of all exclusive skills for the PC.
- Using the `NORANK` sub-tag will provide a list of all skills in which the PC has no rank.
- Using the `RANKS=n` sub-tag will provide a list of all skills in which the PC has n or more ranks.
- Global qualifiers work for feats. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all skills.
  - PC - Will return a list of all skills already taken by the Player Character.
  - QUALIFIED - Will return a list of all skills that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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|PC`

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

`CHOOSE:SKILL|Knowledge%`

This will produce a list of all knowledge skills.

Where it is Used:

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

*** Deprecated Syntax 5.17.4 - Use CHOOSE:SKILL - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:SKILLS` becomes `CHOOSE:SKILL|PC`

Where it is Used:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:SKILL - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:SKILLSNAMED|...` becomes `CHOOSE:SKILL|...`

Where it is Used:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:CLASS|SPELLCASTER - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:SPELLCLASSES` becomes `CHOOSE:CLASS|SPELLCASTER`

Where it is Used:

Global except for Equipmod Files

*** New 5.17.4

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): 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 (Minimum level)

Variables Used (z): Formula (Maximum level)

What it does:

- Display a list of a character's spell levels for the specified class or type.
- `TITLE` provides a descriptive title for the chooser.
- `SPELLTYPE` will include spell levels of the designated spell type.
- `TYPE` will include, or exclude in the case of `!TYPE`, spell levels of the designated spell type.
- Levels will only be included if they fall between the range of minimum Level (y) and maximum Level (z), inclusive.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:SPELLLEVEL - Remove 6.2

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 spell levels for the specified class or type.
- Spell levels will only be included if they fall between the range of Minimum Level and Maximum Level.
- `MAXLEVEL` will include spell leves up to the highest level the character can cast.
- `NUMCHOICES` cannot ne used with `CHOOSE:SPELLLEVEL`, as it has an integrated choice count.
- A bonus can be associated with the choice by appending it in square brackets ([]), providing a bonus based upon the spell level.

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, and Wizard 2 for a 5th level Wizard, and Cleric 1, Cleric 2, and 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 levels of Arcane spells and allow one level to be chosen to get as a bonus spell per day.

Where it is Used:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use TBD - Remove 6.2

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

- 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|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 ([ ]).

Deprecated Syntax: Deprecated 5.17.18 - Remove 6.2

`CHOOSE:SPELLS|ANY` has been deprecated in favor of `CHOOSE:SPELLS|ALL`.

Example Conversion to New Syntax:

`CHOOSE:SPELLS|ANY` becomes `CHOOSE:SPELLS|ALL`

Where it is Used:

Global except for Equipmod Files

*** Deprecated - Use CHOOSE:PCSTAT - Remove for 6.2

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

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

- This presents a list of templates for selection.
- Use of the `FEAT` sub-tag will provide a list of templates selected by the referenced feat. The feat referenced must contain a `CHOOSE:TEMPLATE` tag.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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 is 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 is already selected by the Player Character.

Where it is Used:

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

- 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

*** Deprecated Syntax 5.17.4 - Use CHOOSE:WEAPONPROFICIENCY - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:WEAPONPROF|1|Dagger|Club` becomes `CHOOSE:WEAPONPROFICIENCY|Dagger|Club`

`CHOOSE:WEAPONPROF|3|DEITYWEAPON` becomes `CHOOSE:WEAPONPROFICIENCY|DEITYWEAPON <tab> SELECT:3`

`CHOOSE:WEAPONPROF|1|WIELD.OneHanded|WIELD.Light` becomes `CHOOSE:WEAPONPROFICIENCY|WIELD=OneHanded|WIELD=Light`

`CHOOSE:WEAPONPROF|1|WIELD.OneHanded|!TYPE.Exotic` becomes `CHOOSE:WEAPONPROFICIENCY|WIELD=OneHanded,!TYPE=Exotic`

Where it is Used:

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

- This will produce a list of all weapon proficiencies matching the criteria.
- Using the `DEITYWEAPON` sub-tag will provide the weapon listed as the favored weapon for the player character's selected deity.
- Using the `FEAT=Text` sub-tag will provide a list of weapon proficiencies selected by the referenced feat. The feat referenced must contain a `CHOOSE:WEAPONPROFICIENCY` tag.
- Using the `WIELD=Text` sub-tag will provide a list of weapon proficiencies for weapons of the referenced wield type. The wield type must one of the following three types: Light, 1 Handed, 2 Handed. WIELD type is set for each weapon in the equipment LST file.
- Using the `WIELD=Text` sub-tag in an `EQUIPMENT` qualifier will provide a list of weapon proficiencies for weapons of the referenced wield type. The wield type must one of the following three types: Light, 1 Handed, 2 Handed. Wield type is set for each weapon in the equipment LST file. Note: Not all game modes support `WIELD`.
- Using the `EQUIPMENT` qualifier will allow the selection of proficiencies based on weapons. It can be combined with `TYPE=Text` and `WIELD=Text` criteria, contained in square-brackets ([x]) to restrict the proficiencies offered.
- When using the `SPELLCASTER` qualifier will provide a list of proficiencies matching the included criteria as long as the player character is a spellcaster.
- Global qualifiers work for weapon proficiencies. Use of the qualifiers has the following effect:
  - ANY - Will return a list of all weapon proficiencies.
  - PC - Will return a list of all weapon proficiencies already taken by the Player Character.
  - QUALIFIED - Will return a list of all weapon proficiencies that the player character is otherwise qualified for.
- Qualifiers can be logically negated by prefacing with the exclamation point (!), i.e. `!PC` is a valid usage.
- Criteria can be logically combined by using the comma (,), logical AND, and the pipe (|), logical OR. Logical ANDs are evaluated before logical ORs.
- The SELECT tag is used in conjunction with this `CHOOSE` tag to define the number of "selections" that can be made.

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:

Global except for Equipmod Files

*** Deprecated Syntax 5.17.4 - Use CHOOSE:WEAPONPROFICIENCY - Remove 6.2

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.

Example Conversion to New Syntax:

`CHOOSE:WEAPONPROFS|LIST` becomes `CHOOSE:WEAPONPROFICIENCY|PC`

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.