This file covers the glodal CHOOSE tag in its many different forms. For the eqmod versions of the CHOOSE tag see CHOOSE:ABILITY (Equipment Modifiers)
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:
MULT:YES
     is
not to be used with
     CHOOSE:NUMBER
     .
    
   This page is organized into two sections:
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:
FEAT=Text
    sub-tag will provide a list of
abilities chosen by the referenced feat. The feat referenced must
contain a
    CHOOSE:ABILITY
    tag.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files. For the eqmod version see CHOOSE:EQUIPMENT (Equipment Modifiers)
Tag Name: CHOOSE:ABILITYSELECTION|v|w|x|y|y[z]|y[x,x]|x,y,y[x],y[x,x]
Variables Used (v): TITLE=Text (Chooser title)
Variables Used (w): Text (Ability Category)
Variables Used (x): Text (Ability 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:
!PC
    is a valid usage.
   CHOOSE
    tag to define the
number of "selections" that can be made.
   Example:
   CHOOSE:ABILITYSELECTION|FEAT|Weapon
Focus
  
Will display a list of feats comprised of the "Dodge" and "Toughness" feats.
   CHOOSE:ABILITYSELECTION|Ranger ~ Favored
Enemy,PC
  
This will produce a list of all the character's favored enemies.
Where it is Used:
Ability, Domain, Feat, Race, and Template files.
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:
FEAT
    subtag will provide the alignment
selected by the referenced feat. The feat referenced must contain a
    CHOOSE:ALIGNMENT
    tag.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
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.
   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.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
Tag Name: CHOOSE:CHECK|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:
FEAT
    subtag will provide the stat
selected by the referenced feat. The feat referenced must contain a
    CHOOSE:CHECK
    tag.
   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:
Ability, Domain, Feat, Race, and Template files.
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): SPELLTYPE=Text (Spell type)
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:
FEAT=Text
    sub-tag will provide a list of
classes chosen by the referenced feat. The feat referenced must
contain a
    CHOOSE:CLASS
    tag.
   SPELLTYPE=Text
    sub-tag will provide a
list of classes that cast spells of the designated type.
   SPELLCASTER
    sub-tag will provide a list
of classes that can cast spells.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
ALIGN=Text
    sub-tag will provide a list
of deities of the referenced alignment.
   FEAT=Text
    sub-tag will provide a list of
deities selected by the referenced feat. The feat referenced must
contain a
    CHOOSE:DEITY
    tag.
   PANTEON=Text
    sub-tag will provide a list
of deities of the referenced pantheon.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
DEITY=Text
    sub-tag will provide a list
of domains for the referenced deity.
   FEAT=Text
    sub-tag will provide a list of
domains selected by the referenced feat. The feat referenced must
contain a
    CHOOSE:DOMAIN
    tag.
   !PC
    is a valid usage.
   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.
Where it is Used:
Ability, Domain, Feat, Race, and Template files.
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): OWNED
Variables Used (y): QUALIFIED
Variables Used (y): CARRIED
Variables Used (y): EQUIPPED
What it does:
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.
   !PC
    is a valid usage.
   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,OWNED
  
A list of all simple equipment that the PC has already selected will be presented.
Where it is Used:
Ability, Domain, Feat, Race, and Template files. For the eqmod version see CHOOSE:EQUIPMENT (Equipment Modifiers)
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:
FEAT=Text
    sub-tag will provide a list of
feats chosen by the referenced feat. The feat referenced must
contain a
    CHOOSE:FEAT
    tag.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
!PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
FEAT
    sub-tag will provide the language
selected by the referenced feat. The feat referenced must contain a
    CHOOSE:LANG
    tag.
   LANBONUS
    will provide a list of languages
granted to the character by the
    LANGBONUS
    tag through
the character's race, class or template.
   !PC
    is a valid usage.
   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 language is both "Common" and "Goblin".
   CHOOSE:LANG|Common|TYPE=Foo,PC
  
Presents the "Common" language and any languages that have the "Foo" type which are already selected by the Player Character.
Ability, Domain, Feat, Race, and Template files.
Tag Name: CHOOSE:NOCHOICE
What it does:
MULT:YES
    must be used when using this tag.
   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.
Ability, Domain, Feat, Race, and Template 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:
CHOOSE
    tags,
    MULT:YES
    is
not to be used with
    CHOOSE:NUMBER
    .
   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:
Ability, Domain, Feat, Race, and Template files.
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:
CHOOSE
    tag to define the
number of "selections" that can be made.
   Example:
   CHOOSE:STAT|DEX|CON
  
   Un-intuitively, this produces a list of all stats
   
    except
   
   DEX
   and
   CON
   . Due to the potential for confusion, the
   CHOOSE:STAT
   syntax has been replaced by the
   CHOOSE:PCSTAT
   syntax below.
  
Example Conversion to New Syntax:
   CHOOSE:STAT|STR|CON
   becomes
   CHOOSE:PCSTAT|DEX|INT|WIS|CHA
  
Where it is Used:
Ability, Domain, Feat, Race, and Template files.
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): BASESIZE=Text (Size value)
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:
FEAT=Text
    sub-tag will provide a list of
races selected by the referenced feat. The feat referenced must
contain a
    CHOOSE:RACE
    tag.
   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.
   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.
   BASESIZE=Text
    sub-tag will provide a
list of races selected by the referenced size as defined in the
    
     sizeAdjustment.lst
    
    gameMode file. The
size referenced will be compared to the base size, e.i. the
contents of the
    SIZE
    tag in the
    
     RACE
    
    LST file, and will ignore any modifications to the size granted
through any means.
   !PC
    is a valid usage.
   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|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.
   CHOOSE:RACE|BASESIZE=M
  
This will produce a list of all races that have a size of "M".
Where it is Used:
Ability, Domain, Feat, Race, and Template files.
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:
FEAT
    subtag will provide the
    
     SCHOOL
    
    selection made in the referenced feat. The
feat referenced must contain a
    CHOOSE:SCHOOLS
    tag.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
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.
   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.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
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.
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): QUALIFIED
Variables Used (y): USEUNTRAINED
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:
FEAT=Text
    sub-tag will provide a list of
skills chosen by the referenced feat. The feat referenced must
contain a
    CHOOSE:SKILL
    tag.
   CLASS
    sub-tag will provide a list of all
class skills for the PC.
   CROSSCLASS
    sub-tag will provide a list
of all crossclass skills for the PC.
   EXCLUSIVE
    sub-tag will provide a list of
all exclusive skills for the PC.
   NORANK
    sub-tag will provide a list of
all skills in which the PC has no rank.
   RANKS=n
    sub-tag will provide a list of
all skills in which the PC has n or more ranks.
    MAXRANK
      can be used with the
      RANKS
      qualifier to identify skills that are currently
at the maximum ranks allowed.
     !PC
    is a valid usage.
   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|RANKS=1
  
This will produce a list of all skills the character's has one or more ranks in.
   CHOOSE:SKILL|!RANKS=MAXRANK
  
This will produce a list of all skills the character's has that are not at the maximum ranks allowed.
   CHOOSE:SKILL|Knowledge%
  
This will produce a list of all knowledge skills.
Where it is Used:
Ability, Domain, Feat, Race, and Template files. For the eqmod version see CHOOSE:ABILITY (Equipment Modifiers)
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): CLASS=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 or formula (Minimum level)
Variables Used (z): Formula (Maximum level)
What it does:
TITLE
    provides a descriptive title for the
chooser.
   CLASS=Text
    will include spell levels of the
designated classe.
   SPELLTYPE=Text
    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.
   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:
Ability, Domain, Feat, Race, and Template files.
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:
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.
   SPELLBOOK
    sub-tag is used to reference the
specific spell book, such as "Innate", in which the spells is
located.
   SPELLTYPE
    sub-tag above
MUST be used in a
    SPELLTYPE
    tag within a loaded
class.
   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.
   LEVELMIN
    sub-tag references all spells of the
specified level and higher within the context of the "y" variable
preceding the brackets.
   LEVELMAX
    sub-tag references all spells of the
specified level and lower within the context of the "y" variable
preceding the brackets.
   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 ([ ]).
  
Where it is Used:
Ability, Domain, Feat, Race, and Template files.
Tag Name: CHOOSE:STRING|x|x
Variables Used (x): Text (Choice to be offered)
What it does:
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.
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:
FEAT
    sub-tag will provide a list of
templates selected by the referenced feat. The feat referenced must
contain a
    CHOOSE:TEMPLATE
    tag.
   !PC
    is a valid usage.
   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 are 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 are already selected by the Player Character.
Where it is Used:
Ability, Domain, Feat, Race, and Template files.
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:
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.
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:
DEITYWEAPON
    sub-tag will provide the
weapon listed as the favored weapon for the player character's
selected deity.
   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.
   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,
One-Handed, Two-Handed.
    
     WIELD
    
    type is set for each
weapon in the equipment LST file.
   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, One-Handed,
Two-Handed. Wield type is set for each weapon in the equipment LST
file. Note: Not all game modes support
    WIELD
    .
   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.
   SPELLCASTER
    qualifier will provide
a list of proficiencies matching the included criteria as long as
the player character is a spellcaster.
   !PC
    is a valid usage.
   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:
Ability, Domain, Feat, Race, and Template files.
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.
Tag Name: NUMCHOICES=x
Variables Used (x): Number or Formula (Maximum number of total selections that can be taken)
What it does:
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 up to 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 taken 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.