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