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.


(Deprecated, use CHOOSE:PROFICIENCY)

Tag Name: CHOOSE:x

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

What it does:

This will produce a list of all weaponprofs of the given type.

Example:

CHOOSE:EXOTIC

Will produce a list of all Exotic weapon proficiencies.


Tag Name: CHOOSE:x|x

Variables Used (x): Text (Any text)

What it does:

This will produce a list of the provided strings.

Example:

CHOOSE:Choice1|Choice2|Choice3

Will produce a list containing Choice1, Choice2, and Choice3.


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


Tag Name: CHOOSE:ARMORTYPE

What it does:

This will produce a list of all armor types that the character is proficient with. This list is built from the choices for the Armor Proficiency feat.

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.


Tag Name: CHOOSE:CCSKILLLIST|x,x

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

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

What it does:

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

Example:

CHOOSE:CSKILLS

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


Tag Name: CHOOSE:COUNT=x

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

What it does:

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

Example:

MULT:YES

STACK:YES

CHOOSE:COUNT=3|STAT|Con

The user can select up to three stats (but not Con).


*** New 5.9.4

Tag Name: CHOOSE:DOMAIN|x,x

Variables Used (x): ANY

Variables Used (x): DIETY=<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.

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


Tag Name: CHOOSE:EQUIPTYPE|x

Variables Used (x): Text (list of dot separated equipment types)

What it does:

This will produce a list of all known equipment that are of all of the named types.

Example:

CHOOSE:EQUIPTYPE|Melee.Simple

Will allow selection from all simple melee weapons.


Tag Name: CHOOSE:FEAT=x

Variables Used (x): Text (Feat name)

What it does:

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

Example:

CHOOSE:FEAT=Weapon Focus

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


Tag Name: CHOOSE:FEATADD|x|x

Variables Used (x): Text (Feat Name)

Variables Used (x): Text (Type=<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.

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.


Tag Name: CHOOSE:FEATLIST|x|x

Variables Used (x): Text (Feat Name)

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

What it does:

This will produce a list of feats possessed by the character that match the type or name specified.

Example:

CHOOSE:FEATLIST|TYPE=Fighter

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


Tag Name: CHOOSE:FEATSELECT|x|x

Variables Used (x): Text (Feat Name)

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

What it does:

This will produce a list of feats that match the type or name specified.

Example:

CHOOSE:FEATSELECT|TYPE=Fighter

This will produce a list of all fighter feats.


Tag Name: CHOOSE:HP|x

Variables Used (x): Text (Display name)

What it does:

Displays a list with the display name

Example:

CHOOSE:HP|+3 hp

Will display a list with "+3 hp" .


*** New 5.9.4

Tag Name: CHOOSE:NOCHOICE

What it does:

This CHOOSE tag will NOT produce a pop up window. This is useful in feats which use MULT:YES to allow them to be selected multiple times. A feat with this tag will simply be added to the character without a chooser window, after the first time it is added a (x2), (x3) etc. will be displayed indicating how many times the feat was chosen.

When used for a "nested" choice the choice also doesn't show up. For example a if you have a feat Feat X that has an ADD:FEAT(Feat Y) and Feat X has a CHOOSE normally it will appear as Feat X(Feat Y) in the chooser. With this option it will show up as Feat 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.


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

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


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 <tab> STACK:YES <tab> 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.

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

The user can select the this choice once, the user will be allowed to select the Craft subskill 3 times.

CHOOSE:NUMCHOICES=3|SKILLSNAMED|TYPE.Knowledge$|2

The user can select the this choice three times, the user will be allowed to select the Knowledge subskill twice each time.

MULT:YES <tab> STACK:YES <tab> CHOOSE:NUMCHOICES=3|SKILLSNAMED|TYPE=Strength|TYPE=Dexterity|TYPE=Constitution|TYPE=Intelligence|TYPE=Wisdom|3 <tab> BONUS:SKILL|%LIST|MasterAdventurerBonus

The user can select the this choice three times, the user will be allowed to select from the "Strength" "Dexterity" "Constitution" "Intelligence" and "Wisdom" Skills upto three times per cycle.


*** New 5.10

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

Variables Used (x): ARMOR (Choose Armor Proficiencies)

Variables Used (x): SHIELD (Choose Shield Proficiencies)

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.

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.

Exotic Firearms Proficiency.MOD <tab> PREFEAT:.CLEAR <tab> PREFEAT:2,Personal Firearms Proficiency,Advanced Firearms Proficiency

This will replace the PREFEAT that the feat requires with the two feats Personal Firearms Proficiency,Advanced Firearms Proficiency.

Where this is used at:

Feats


*** 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.  A race that matches any of the criteria specified will be added to the list.  To group items together so that all the items in the group must be true use "[]" to surround the choices.

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.


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.

Example:

CHOOSE:SALIST|Turn,Rebuke

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


Tag Name: CHOOSE:SCHOOLS

What it does:

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

Example:

CHOOSE:SCHOOLS

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


Tag Name: CHOOSE:SHIELDPROF|x

Variables Used (x): Text (Shield name)

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

What it does:

This will produce a list of all shields of the specified type or name.

Example:

CHOOSE:SHIELDPROF|TYPE=Wood

This will produce a list of all wooden shields.


Tag Name: CHOOSE:SKILLLIST|x,x

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

Variables Used (x): Text (Skill name)

What it does:

This will produce a list of skills specified or all skills.

Example:

CHOOSE:SKILLLIST|LIST

Will display a list of all skills in the system.


Tag Name: CHOOSE:SKILLS

What it does:

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

Example:

CHOOSE:SKILLS

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


*** 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): 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 (x): NORANK (Displays all Skills the PC has no ranks in)

What it does:

This will produce a list of named skills. More than one can be used and if so the qualifying skills are combined.

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


Tag Name: CHOOSE:SKILLSNAMEDTOCCSKILL|x

Variables Used (x): Text (Skill Name)

Variables Used (x): Text (Start of 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)

What it does:

This will produce a list of named skills. The selected skill will be made a cross class skill for the character.

Example:

CHOOSE:SKILLSNAMEDTOCCSKILL|CLASS

This will display a list of all the characters class skills and allow them to select a skill to be made a cross class skill.


Tag Name: CHOOSE:SKILLSNAMEDTOCSKILL|x

Variables Used (x): Text (Skill Name)

Variables Used (x): Text (Start of 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)

What it does:

This will produce a list of named skills. The selected skill will be made a class skill for the character.

Example:

CHOOSE:SKILLSNAMEDTOCSKILL|CROSSCLASS

This will display a list of all the characters cross class skills and allow them to select a skill to be made a class skill.


Tag Name: CHOOSE:SPELLCLASSES

What it does:

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

Example:

CHOOSE:SPELLCLASSES

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


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

Variables Used (w): Number (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 or MAXLEVEL)

What it does:

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.


Tag Name: CHOOSE:SPELLLIST|x

Variables Used (x): Text (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.


*** New

Tag Name: CHOOSE:SPELLS|x|x

Variables Used (x): Text (CLASS=<Spellcaster class> or DOMAIN=<Domain name>)

What it does:

This will produce a list of all spells of the specified type.

Example:

CHOOSE:SPELLS|CLASS=Wizard

Would produce a list of all Wizard spells.


Tag Name: CHOOSE:STAT|x

Variables Used (x): Text (Stat name to exclude, Optional)

What it does:

This will produce a list of all stats excepted the ones listed.

Example:

CHOOSE:STAT|CON

This will produce a list off all stats except CON.


Tag Name: CHOOSE:TEMPLATE

What it does:

See TEMPLATE:CHOOSE instead.


*** New 5.11.9

Tag Name: CHOOSE:USERINPUT|x|TITLE="y"

Variables Used (x): Number (The number of inputs the chooser should ask for (1 being default))

Variables Used (y): text (string that is displayed as the title of the chooser)

What it does:

This is a feats/abilities only tag that when activated (by choosing the ability it's embedded in) will pop up a 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.


Tag Name: CHOOSE:WEAPONFOCUS|x

Variables Used (x): Text (TYPE.<Equipment Type>)

What it does:

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

Example:

CHOOSE:WEAPONFOCUS|TYPE.Sword

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


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

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.

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.


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

Variables Used (x): Text (LIST)

Variables Used (x): Text (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): Text (Spellcaster.)

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

Variables Used (x): Text (ADD.)

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

Variables Used (x): Text (TYPE. or TYPE=)

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

Variables Used (y): Text (Not. will remove a previously added proficiency)

What it does:

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.