# The CHOOSE Tag

This file will attempt to show the countless different examples of this extremely versatile tag.

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

Notes on using CHOOSE within feats:

If a feat contains a CHOOSE tag you must use ADD:FEAT to activate the selection window. Using VFEAT, MFEAT or FEATAUTO will bypass the CHOOSE tag.

CHOOSE must be paired with a MULT:YES tag in feats for it to work properly.

Tag Name: CHOOSE:ARMORPROF|x|y

Variables Used (x):UNDOCUMENTED

Variables Used (y):UNDOCUMENTED

What it does:

UNDOCUMENTED.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:CCSKILLLIST|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all skills in the appropriate category for that character (root skills are added only once).

Example:

`CHOOSE:CCSKILLLIST|LIST`

This will produce a list of all skills in the appropriate category for that character.

Tag Name: CHOOSE:COUNT=w|STAT|x|y|z

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

Variables Used (x): Text (UNDOCUMENTED)

Variables Used (y): Text (UNDOCUMENTED)

Variables Used (z): Text (UNDOCUMENTED)

What it does:

UNDOCUMENTED

Example:

`CHOOSE:COUNT=1|STAT|Con[tab]BONUS:HP|CURRENTMAX|(%VAR-CON)`

Will allow the selection of a stat (excluding constitution) and then use that stat modifier to adjust the HP total (%VAR is replaced with the value of the stat modifier before calculations).

Tag Name: CHOOSE:FEAT=x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list from the list choices associated with the named feat (Should replace WEAPONFOCUS).

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:FEATLIST|x

Variables Used (x): Text (Feat Name)

Variables Used (x): Text (Type=<Feat Type>)

What it does:

UNDOCUMENTED.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

*** New

Tag Name: CHOOSE:EQBUILDER

Variables Used (x): :UNDOCUMENTED

Variables Used (y): :UNDOCUMENTED

What it does:

UNDOCUMENTED.

Example:

`UNDOCUMENTED.`

Tag Name: CHOOSE:HP|x

Variables Used (x): Number (Used)

What it does:

The 'used' parameter is added to the list as many time as the feat has been taken, but the list only displays it once. The number of choices is converted into an equal number of "CURRENTMAX" entries associated with the feat.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:NONCLASSSKILLLIST|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all skills in the appropriate category for that character (root skills are added only once).

Example:

`CHOOSE:NONCLASSSKILLLIST|LIST`

UNDOCUMENTED.

Tag Name: CHOOSE:NUMBER|MIN=x|MAX=y|TITLE=z

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

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

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

What it does:

You get a pop-up dialogue that allows you to select a number between (and including) he high and low values

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

Tag Name: CHOOSE:NUMCHOICES=x

Variables Used (x): Number (The maximum number of times the CHOOSE can be selected)

What it does:

NUMCHOICES is not a choose, but a pre-fix for any Choose. It sets the number of choices that a feat can be selected at most.

Example:

`MULT:YES`

`STACK:YES`

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

The user can select the same choice more than once, but the user will never be allowed to select the feat more than 3 times.

Tag Name: CHOOSE:SALIST|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all skills in the appropriate category for that character (root skills are added only once).

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:SCHOOLS|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all schools of magic from System\schools.lst.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:SKILLLIST|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all skills in the appropriate category for that character (root skills are added only once).

Example:

`CHOOSE:SKILLLIST|LIST`

UNDOCUMENTED.

Tag Name: CHOOSE:SKILLS|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all skills currently attached to the character, regardless of rank.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

*** Updated 5.4

Tag Name: CHOOSE:SKILLSNAMED|x|y

Variables Used (x): Text (Skill Name)

Variables Used (x): Text (Type=<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 (y): Number (Number of choices)

What it does:

This will produce a list named skills.

Example:

`CHOOSE:SKILLSNAMED|CLASS|1`

displays a list of class skills from which the character can pick one.

Tag Name: CHOOSE:SKILLSNAMEDTOCCSKILL|x

Variables Used (x): Text (Skill Name)

Variables Used (x): Text (Type=<Skill Type>)

What it does:

This will produce a list named skills.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:SKILLSNAMEDTOCSKILL|x

Variables Used (x): Text (Skill Name)

Variables Used (x): Text (Type=<Skill Type>)

What it does:

This will produce a list named skills.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:SPELLCLASSES|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of all classes which don't have a base spell stat of "None".

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:SPELLLEVEL|x

Variables Used (x): UNDOCUMENTED

What it does:

UNDOCUMENTED. Bonuses are applied based on choice.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

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

Variables Used (w): Number or Text (number of choices)

Variables Used (x): Text (CLASS=<Spellcaster class> or TYPE=<Spell type>)

Variables Used (y): Number (Minimum Level)

Variables Used (z): Number (Maximum Level)

What it does:

- Special CHOOSE: tag which can be used with the ADD:LIST tag in class.lst and BONUS:SPELLCAST and BONUS:SPELLKNOWN
- SPELLLEVEL is the only one that works with ADD:LIST currently.

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.

Tag Name: CHOOSE:SPELLLIST|x

Variables Used (x): UNDOCUMENTED

What it does:

This tag only works for Wizards with an INT > 11. All their known spells are placed into a list and they can pick up to their INT mod of them.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:WEAPONFOCUS|x

Variables Used (x): UNDOCUMENTED

What it does:

This will produce a list of weaponprofs associated with the Weapon Focus Feat.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

*** 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): Text (DEITYWEAPON)

Variables Used (y): Text (Feat=<feat name>)

Variables Used (y): Text (WIELD.WieldCategory)

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= which must be any feat that requires a weapon proficiency (such as Simple, Martial, Exotic, Weapon Focus, etc)
  - WIELD.WieldCategory (Wield category, can be Light, OneHanded or TwoHanded. NOT can be specified with the TYPE tag by using a "!" before the TYPE. You can have any as many !TYPE tags as you like, but they all MUST be at the end.

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

Tag Name: CHOOSE:WEAPONPROFS|x

Variables Used (x): Text (Proficiency types)

What it does:

- The actual listing of the types of weapon proficiencies the character may have is made up of:
  - LIST (All character's weapon profs are added to list)
  - Size.sWEAPONPROF (weapon is added to list if character is at least small size - other options are F=Fine, D=Diminutive, T=Tiny, S=Small, M=Medium, L=Large, H=Huge, G=Gargantuan, C=Colossal).
  - WSize. (UNDOCUMENTED)
  - Spellcaster (UNDOCUMENTED)
  - ADD.string (UNDOCUMENTED)
  - TYPE.weaponproftype (UNDOCUMENTED)
  - weaponprof (UNDOCUMENTED)

Example:

`UNDOCUMENTED`

UNDOCUMENTED.

Tag Name: CHOOSE:WEAPONPROFTYPE|x

Variables Used (x): Text (SIMPLE, MARTIAL, EXOTIC etc.)

What it does:

This will produce a list of all weaponprofs of the given type the PC doesn't have.

Example:

`UNDOCUMENTED`

UNDOCUMENTED.