Choose Tag - PCGen Documentation

# Pages in Choose Tag

## ABILITY (Global: CHOOSE)

Status Updated 5.17.4 Syntax CHOOSE:ABILITY|w|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters w: Text (Ability category) x: Text (Ability name or key) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Ability type) x: !TYPE=Text (Prohibited ability type) x: ALL y: ANY (Default) y: PC 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.

## ABILITYSELECTION (Global: CHOOSE)

Status New 6.01.03 Syntax CHOOSE:ABILITYSELECTION|v|w|x|y|y[z]|y[x,x]|x,y,y[x],y[x,x] Parameters v: TITLE=Text (Chooser title) w: Text (Ability Category) x: Text (Ability Name or Key) x: TYPE=Text (Ability type) x: !TYPE=Text (Prohibited Ability type) x: ALL y: ANY (Default) y: PC y: QUALIFIED What it does This will produce a list of abilities, resolved down to the internal ability selections, matching the stipulated criteria. Global qualifiers work for abilities. Use of the qualifiers have the following effect: ANY - Will return a list of all abilities.

## ALIGNMENT (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:ALIGNMENT|x|x Parameters x: Text (Alignment by key) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Alignment type) x: !TYPE=Text (Prohibited alignment type) 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 feat. 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 .

## ARMORPROFICIENCY (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:ARMORPROFICIENCY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Armor proficiency) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Armor proficiency type) x: !TYPE=Text (Prohibited armor proficiency type) x: ALL y: ANY (Default) y: PC y: QUALIFIED y: EQUIPMENTx 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.

## CHECK (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:CHECK|x|x Parameters x: Text (Check by KEY) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Check type) x: !TYPE=Text (Prohibited check type) 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 .

## CLASS (Global: CHOOSE)

Status Updated 5.17.4 Syntax CHOOSE:CLASS|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Class name or key) x: FEAT=Text (Feat, by name or key) x: SPELLTYPE=Text (Spell type) x: SPELLCASTER x: TYPE=Text (Class type) x: !TYPE=Text (Prohibited ability type) x: ALL y: ANY (Default) y: PC 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.

## DEITY (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:DEITY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Deity name or key) x: ALIGN=Text (Alignment abbreviation) x: FEAT=Text (Feat, by name or key) x: PANTHEON=Text (Pantheon name) x: TYPE=Text (Deity type) x: !TYPE=Text (Prohibited deity type) x: ALL y: ANY (Default) y: PC 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.

## DOMAIN (Global: CHOOSE)

Status Updated 5.17.4 Syntax CHOOSE:DOMAIN|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Domain name or key) x: DEITY=Text (Deity name) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Domain type) x: !TYPE=Text (Prohibited domain type) x: ALL y: ANY (Default) y: PC 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.

## EQUIPMENT (Global: CHOOSE)

Status New 6.03.02 Syntax CHOOSE:EQUIPMENT|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Equipment name or key) x: WIELD=Text (Equipment wield type) x: TYPE=Text (Equipment type) x: !TYPE=Text (Equipment type) x: ALL y: ANY (Default) y: OWNED y: QUALIFIED y: CARRIED y: EQUIPPED 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 types: Light, One-Handed, Two-Handed.

## FEAT2 (Global: CHOOSE)

Status New 5.17.3 Syntax CHOOSE:FEAT|w|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters w: TITLE=Text (Chooser title) x: Text (Feat by key) x: FEAT=Text (Feat by key) x: TYPE=Text (Feat type) x: !TYPE=Text (Prohibited Feat type) x: ALL y: ANY (Default) y: PC 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.

## FEATSELECTION (Global: CHOOSE)

Status New 5.17.3 Syntax CHOOSE:FEATSELECTION|w|x|y|y[z]|y[x,x]|x,y,y[x],y[x,x] Parameters w: TITLE=Text (Chooser title) x: Text (Feat name or key) x: TYPE=Text (Feat type) x: !TYPE=Text (Prohibited Feat type) x: ALL y: ANY (Default) y: PC 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 have the following effect: ANY - Will return a list of all feats.

## LANG (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:LANG|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Language name) x: FEAT=Text (Feat, by name or key) x: LANGBONUS x: TYPE=Text (Language type) x: !TYPE=Text (Prohibited language type) x: ALL y: ANY (Default) y: PC 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.

## NOCHOICE (Global: CHOOSE)

Status New 5.9.4 Syntax CHOOSE:NOCHOICE Parameters 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.

## NUMBER (Global: CHOOSE)

Status None Syntax CHOOSE:NUMBER|x|y|z Parameters x: MIN=Number (Lowest value to choose from) y: MAX=Number (Highest value to choose from) 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.

## NUMCHOICES (Global: CHOOSE)

Status None Syntax NUMCHOICES=x Parameters 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.

## PCSTAT (Global: CHOOSE)

Status New 5.16.x Syntax CHOOSE:PCSTAT|x|x Parameters x: Text (Stat abbreviation) x: TYPE=Text (Stat type) x: !TYPE=Text (Stat type) x: ALL What it does This will produce a list of all stats listed or that otherwise meet 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.

## PREFIX (Global: CHOOSE)

Status None Syntax None Parameters CHOOSE Tag Prefixes The CHOOSE tag uses “Prefix” tags to modify the application of the CHOOSE tag. The prefix tags are inserted into the CHOOSE tag’s syntax immediately after the colon (:) and before the first argument, using a pipe (|) as a delimiter between itself and the first argument. The valid prefix tags are detailed below.

## RACE (Global: CHOOSE)

Status Updated 6.03.02 Syntax CHOOSE:RACE|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Race, by name or key) x: FEAT=Text (Feat, by name or key) x: RACETYPE=Text (Race-type) x: RACESUBTYPE=Text (Race-subtype) x: BASESIZE=Text (Size value) x: TYPE=Text (Race type) x: !TYPE=Text (Prohibited race type) x: ALL y: ANY (Default) y: PC 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.

## SCHOOLS (Global: CHOOSE)

Status Updated 5.17.4 Syntax CHOOSE:SCHOOLS|x|x Parameters x: Text (School name) x: FEAT=Text (Feat, by name or key) 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.

## SHIELDPROFICIENCY (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:SHIELDPROFICIENCY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Shield proficiency) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Shield proficiency type) x: !TYPE=Text (Prohibited shield proficiency type) x: ALL y: ANY (Default) y: PC y: QUALIFIED y: EQUIPMENTx 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.

## SIZE (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:SIZE|x|x Parameters x: Text (Size) x: TYPE=Text (Size type) x: !TYPE=Text (Prohibited size type) 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 Ability, Domain, Feat, Race, and Template files.

## SKILL (Global: CHOOSE)

Status Updated 6.03.04 Syntax CHOOSE:SKILL|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Skill name or key) x: Text% (Search pattern by skill name or key) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Skill type) x: !TYPE=Text (Prohibited skill type) x: ALL y: ANY (Default) y: QUALIFIED y: USEUNTRAINED y: CLASS y: CROSSCLASS y: EXCLUSIVE y: NORANK y: RANKS=number (Skill ranks) What it does This will produce a list of skills matching the stipulated criteria.

## SPELLLEVEL (Global: CHOOSE)

Status Updated 6.3.0 Syntax CHOOSE:SPELLLEVEL|w|x|y|z|x|y|z Parameters w: TITLE=Text (Chooser title. Optional) x: Text (Spellcaster class) x: CLASS=Text (Spellcaster class) x: SPELLTYPE=Text (Spell type) x: TYPE=Text (Class type) x: !TYPE=Text (Class type) x: ALL y: Number or formula (Minimum level) 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. CLASS=Text will include spell levels of the designated classe.

## SPELLS (Global: CHOOSE)

Status New - 5.13.x Syntax CHOOSE:SPELLS|x,y,y[z]|x|y|y[z;z] Parameters x: Text (Spell name) x: TYPE=Text (Spell type) x: SCHOOL=Text (Spell school) x: SUBSCHOOL=Text (Spell subschool) x: DESCRIPTOR=Text (Spell descriptor) x: PROHIBITED=Boolean (Optional) x: SPELLBOOK=Text (Spellbook name) y: CLASSLIST=Text (Class name) y: DOMAINLIST=Text (Domain name) y: SPELLTYPE=Text (Spell type) y: ALL z: KNOWN=Boolean (Optional) z: LEVELMIN=Number, Variable, Formula, or MAXCASTABLE (Minimum spell level, Optional) 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.

## STRING (Global: CHOOSE)

Status New 5.13.4 Syntax CHOOSE:STRING|x|x Parameters 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”. Ability, Domain, Feat, Race, and Template files.

## TEMPLATE (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:TEMPLATE|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Template Name or Key) x: FEAT=Text (Feat, by name or key) x: TYPE=Text (Template Type) x: !TYPE=Text (Template Type) x: ALL y: ANY (Default) y: PC 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.

## USERINPUT (Global: CHOOSE)

Status New 5.11.9 Syntax CHOOSE:USERINPUT|x|y Parameters x: Number (Number of inputs. Optional. Defaults to 1) 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

## WEAPONFOCUS (Global: CHOOSE)

Status None Syntax CHOOSE:WEAPONFOCUS|x Parameters 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 character’s Weapon Focus feats that match a given equipment type. Where it is Used Ability, Domain, Feat, Race, and Template files.

## WEAPONPROFICIENCY (Global: CHOOSE)

Status New 5.17.4 Syntax CHOOSE:WEAPONPROFICIENCY|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x] Parameters x: Text (Weapon proficiency) x: DEITYWEAPON (Feat, by name or key) x: FEAT=Text (Feat, by name or key) x: WIELD=Text (Weapon wield type. Used in EQUIPMENT qualifier only.) x: TYPE=Text (Weapon proficiency type) x: !TYPE=Text (Prohibited weapon proficiency type) x: ALL y: ANY (Default) y: PC y: QUALIFIED y: EQUIPMENTx y: SPELLCASTERx What it does This will produce a list of all weapon proficiencies matching the criteria.

Documentation built with Hugo using the Material theme.