[Pcgen-trackers_Docs] [ pcgen-Documentation Feature Requests-1886723 ] Add basic CHOOSE:SPELL tag to docs

[SourceForge.net <no...@so...>]

Documentation Feature Requests item #1886723, was opened at 2008-02-04 22:32
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=748235&aid=1886723&group_id=25576

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation New Tag(s)
Group: For 5.14
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Maredudd (maredudd800)
Assigned to: Nobody/Anonymous (nobody)
Summary: Add basic CHOOSE:SPELL tag to docs

Initial Comment:
Re: Spell chooser planning


Okay, I think I've got it this time - had to work out the
(in)dependence on a sheet of paper to get this completely worked out
in the best way.

I have changed the syntax a bit:
- Changing the z separator to ; (this is done because the z variables
will be treated as dependent - all must be met in context with each
other for the criteria to be met... this is different than x, where
the items are a pure, independent AND)
- Moving KNOWN to z (I do not leave it available in x to avoid new
coder confusion, same logic as LEVELMIN= and LEVELMAX= ... if we
really want to go back and add that, we should consider it after 5.14,
once folks get familiar with (in)dependence)
- Adding "ANY" as a y option (allows similar function to KNOWN being
in X, but avoiding confusion of it being in 2 places, and allowing
dependence on level)


CHOOSE:SPELLS|x,y,y[z]|x|y|y[z;z]

X to be one (or more) of the following (function as independent AND)
---------------------------------------
Text (Name of spell to choose from)
TYPE=<type>
SCHOOL=<school>
SUBSCHOOL=<subschool>
DESCRIPTOR=<descriptor>
PROHIBITED=Boolean
(YES limits list to prohibited spells, NO limits spells to
non-prohibited spells)
(If not used both are presented)
SPELLBOOK=<spellbook>
(references specific spell books, such as "Innate")

Y to be one (or more) of the following:
---------------------------------------
ANY
CLASSLIST=<class list>
DOMAINLIST=<domain list>
SPELLTYPE=<spell type>
*Note spell type MUST be used in a SPELLTYPE: token within a loaded
class

Z to be one (or more) of the following (function as dependent AND/AS)
---------------------------------------
KNOWN=Boolean
(YES limits list to known spells, NO limits spells to unknown spells)
(If not used both are presented)
LEVELMIN=#
(references all spells of the specified level and higher)
LEVELMAX=#
(references all spells of the specified level and lower)


One or both of LEVELMAX and LEVELMIN can be used, if you only need a
minimum or maximum

# to take formulas, VARs, MAXCASTABLE (the characters as it relates to
the specified class/domain/spelltype) and plain numbers


Examples:
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|ANY[KNOWN=YES]
Choose from spells known by the PC.

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=MAXCASTABL\
E-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 forces two
[] items)

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 - dependence - can be done with one [] item)

TP.



----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=748235&aid=1886723&group_id=25576