CHOOSE Token Proposal for 6.0 - Revision history

Tom Parker at 22:00, 24 March 2009

2009-03-24T22:00:43Z

Show changes

Tom Parker at 01:48, 24 March 2009

2009-03-24T01:48:47Z

Tom Parker at 01:46, 24 March 2009

2009-03-24T01:46:47Z

Tom Parker at 01:40, 24 March 2009

2009-03-24T01:40:14Z

Tom Parker at 01:39, 24 March 2009

2009-03-24T01:39:30Z

Tom Parker: /* Syntax */

2009-03-24T01:19:48Z

‎Syntax

Tom Parker at 01:16, 24 March 2009

2009-03-24T01:16:22Z

Show changes

Tom Parker at 01:06, 24 March 2009

2009-03-24T01:06:45Z

Tom Parker at 00:58, 24 March 2009

2009-03-24T00:58:05Z

Tom Parker at 00:52, 24 March 2009

2009-03-24T00:52:35Z

← Older revision		Revision as of 01:48, 24 March 2009
Line 764:		Line 764:

	None, CHECK is a new Subtoken for CHOOSE\		None, CHECK is a new Subtoken for CHOOSE\
		+
		+	==CHOOSE:SIZE==
		+
		+	SUBTOKEN: SIZE (new)
		+
		+	===Syntax===
		+
		+	CHOOSE:SIZE\|x\|x
		+
		+	x is a SizeAdjustment PRIMITIVE
		+
		+	A PRIMITIVE is an identifier of objects, and may include any number of specifications. In the case of SizeAdjustment objects, there are are the three global PRIMITIVES:
		+
		+	x = an SizeAdjustment (specified by key)<br>
		+	x = TYPE=w (w is a TYPE identifier for a SizeAdjustment) - note that none of our SizeAdjustments have TYPE today, but this will still work in theory<br>
		+	x = !TYPE=w (w is a TYPE identifier for a SizeAdjustment that would be prohibited)<br>
		+	x = ALL (allow the choice of any SizeAdjustment)<br>
		+
		+
		+	A comma represents "AND", meaning multiple items are evaluated independently and then any item that appears in ALL of the items is added to the list.
		+
		+	CHOOSE:SIZE\|Small,Colossal
		+
		+	will result in NO choices because no SizeAdjustment is both Small and Colossal.
		+
		+
		+	A pipe represents "OR", meaning multiple items are evaluated independently and then any item that appears in any of the items is added to the list:
		+
		+	CHOOSE:SIZE\|Small\|Colossal
		+
		+	will result in a choice between SizeAdjustment Small and SizeAdjustment Colossal.
		+
		+	===Conversion===
		+
		+	None, SIZE is a new Subtoken for CHOOSE
		+
		+	==CHOOSE:ALIGNMENT==
		+
		+	SUBTOKEN: ALIGNMENT (new)
		+
		+	===Syntax===
		+
		+	CHOOSE:ALIGNMENT\|x\|x
		+
		+	x is a PCAlignment PRIMITIVE
		+
		+	A PRIMITIVE is an identifier of objects, and may include any number of specifications. In the case of PCAlignment objects, there are are the three global PRIMITIVES:
		+
		+	x = an PCAlignment (specified by key)<br>
		+	x = TYPE=w (w is a TYPE identifier for a PCAlignment) - note that none of our PCAlignments have TYPE today, but this will still work in theory<br>
		+	x = !TYPE=w (w is a TYPE identifier for a PCAlignment that would be prohibited)<br>
		+	x = ALL (allow the choice of any PCAlignment)<br>
		+
		+
		+	A comma represents "AND", meaning multiple items are evaluated independently and then any item that appears in ALL of the items is added to the list.
		+
		+	CHOOSE:ALIGNMENT\|LG,CN
		+
		+	will result in NO choices because no PCAlignment is both LG and CN.
		+
		+
		+	A pipe represents "OR", meaning multiple items are evaluated independently and then any item that appears in any of the items is added to the list:
		+
		+	CHOOSE:ALIGNMENT\|LG\|CN
		+
		+	will result in a choice between PCAlignment LG and PCAlignment CN.
		+
		+	===Conversion===
		+
		+	None, ALIGNMENT is a new Subtoken for CHOOSE

← Older revision		Revision as of 01:46, 24 March 2009
Line 729:		Line 729:
	CHOOSE:CLASS\|Fighter\|Wizard<br>		CHOOSE:CLASS\|Fighter\|Wizard<br>
	remains unchanged		remains unchanged
		+
		+	==CHOOSE:CHECK==
		+
		+	SUBTOKEN: CHECK (new)
		+
		+	===Syntax===
		+
		+	CHOOSE:CHECK\|x\|x
		+
		+	x is a Check PRIMITIVE
		+
		+	A PRIMITIVE is an identifier of objects, and may include any number of specifications. In the case of Check objects, there are are the three global PRIMITIVES:
		+
		+	x = an Check (specified by key)<br>
		+	x = TYPE=w (w is a TYPE identifier for a Check) - note that none of our Checks have TYPE today, but this will still work in theory<br>
		+	x = !TYPE=w (w is a TYPE identifier for a Check that would be prohibited)<br>
		+	x = ALL (allow the choice of any Check)<br>
		+
		+
		+	A comma represents "AND", meaning multiple items are evaluated independently and then any item that appears in ALL of the items is added to the list.
		+
		+	CHOOSE:CHECK\|Will,Fortitude
		+
		+	will result in NO choices because no Check is both Will and Fortitude.
		+
		+
		+	A pipe represents "OR", meaning multiple items are evaluated independently and then any item that appears in any of the items is added to the list:
		+
		+	CHOOSE:CHECK\|Will\|Fortitude
		+
		+	will result in a choice between Check Will and Check Fortitude.
		+
		+	===Conversion===
		+
		+	None, CHECK is a new Subtoken for CHOOSE\

← Older revision		Revision as of 01:40, 24 March 2009
Line 652:		Line 652:
	becomes		becomes
	CHOOSE:SKILL\|CROSSCLASS\|Spot\|Search		CHOOSE:SKILL\|CROSSCLASS\|Spot\|Search
		+
		+	==CHOOSE:CLASS==
		+
		+	SUBTOKEN: CLASS (unchanged)
		+	SUBTOKEN: SPELLCASTER (deprecated)
		+
		+	===Syntax===
		+
		+	CHOOSE:CLASS\|x\|y\|y[z]\|y[z,z]\|x,y,y[z],y[z,z]
		+
		+	x is an PCClass PRIMITIVE
		+
		+	A PRIMITIVE is an identifier of objects, and may include any number of specifications. In the case of PCClass objects, there are are the four global PRIMITIVES:
		+
		+	x = a PCClass (specified by key)<br>
		+	x = TYPE=w (w is a TYPE identifier for a PCClass )<br>
		+	x = !TYPE=w (w is a TYPE identifier for a PCClass that would be prohibited)<br>
		+	x = ALL (allow the choice of any PCClass)<br>
		+
		+
		+	Note that a KEY for a PCClass whcih contains SubClasses can be a (just the key, indicating the parent class and all subclasses), a.a (indicating just the parent class if ALLOWBASECLASS is YES or indicates just the subclass a if ALLOWBASECLASS if NO), and a.b (indicating just the specific SubClass b
		+
		+	There are also PCClass specific PRIMITIVES:
		+
		+	SPELLCASTER = PCClasses that can cast spells (as defined by the use of the SPELLSTAT: token in the PCClass)
		+
		+	y is a QUALIFIER
		+
		+	A QUALIFIER is a special keyword that identifies a subset of objects that should be returned. Valid qualifiers for PCClass objects are the global qualifiers:
		+
		+	ANY: This means any item in the brackets should be returned (this is implied, so that CHOOSE:CLASS\|Foo,TYPE=Bar is equivalent to CHOOSE:CLASS\|ANY[Foo,TYPE=Bar]
		+
		+	PC: This means any PCClass which has already been taken by the PlayerCharacter.
		+
		+	!PC: This means any PCClass which has NOT already been taken by the PlayerCharacter.
		+
		+	QUALIFIED: This means any PCClass for which the PC qualifies (meets the PRExxx on the PCClass or has QUALIFY:CLASS\|x for that PCClass)
		+
		+	Note that for a QUALIFIER, ALL is the implied PRIMITIVE, so:
		+
		+	CHOOSE:CLASS\|PC[ALL]<br>
		+	is equivalent to <br>
		+	CHOOSE:CLASS\|PC
		+
		+
		+
		+	A comma represents "AND", meaning multiple items are evaluated independently and then any item that appears in ALL of the items is added to the list.
		+
		+	CHOOSE:CLASS\|Wizard,Fighter
		+
		+	will result in NO choices because no PCClass is both Wizard and Fighter.
		+
		+	CHOOSE:CLASS\|TYPE=Foo,PC<br>
		+	would test for any PCClass that has the Foo type (as defined in the PCClass LST file) which is ALSO already selected by the PlayerCharacter
		+
		+	This could also be written (probably more clearly):<br>
		+	CHOOSE:CLASS\|PC[TYPE=Foo]
		+
		+
		+	A pipe represents "OR", meaning multiple items are evaluated independently and then any item that appears in any of the items is added to the list:
		+
		+	CHOOSE:CLASS\|Wizard\|Fighter<br>
		+	will result in a choice between PCClass Wizard and PCClass Fighter
		+
		+	All commas (ANDs) are evaluated before pipes (ORs), so something like:
		+
		+	CHOOSE:CLASS\|Fighter\|TYPE=Foo,PC<br>
		+	would include Fighter unconditionally, in addition to any PCClass that has the Foo type (as defined in the PCClass LST file) which is ALSO already selected by the PlayerCharacter
		+
		+	===Conversion===
		+
		+	CHOOSE:SPELLCLASSES
		+	becomes
		+	CHOOSE:CLASS\|SPELLCASTER
		+
		+	CHOOSE:CLASS\|Fighter\|Wizard<br>
		+	remains unchanged

@@ Line 453: / Line 453: @@
 ===Conversion===
-CHOOSE:DOMAIN|War,Fire<br>
+CHOOSE:DOMAIN|War|Fire<br>
 remains unchanged

@@ Line 554: / Line 554: @@
 x = !TYPE=w (w is a TYPE identifier for a Skill that would be prohibited)<br>
 x = ALL (allow the choice of any Skill)<br>
-There are also two Skill specific PRIMITIVES:
+There are also Skill specific PRIMITIVES:
-ALIGN=w  selects deities with Skill Alignment as specified in the w argument (w must be an alignment abbreviation, e.g. "LG")
+ALIGN=w  selects deities with Skill Alignment as specified in the w argument (w must be an alignment abbreviation, e.g. "LG")<br>
-PANTHEON=w selects deities with Skill Pantheon as specified in the w argument
+PANTHEON=w selects deities with Skill Pantheon as specified in the w argument<br>
 y is a QUALIFIER

@@ Line 189: / Line 189: @@
 A PRIMITIVE is an identifier of objects, and may include any number of specifications.
-In the case of PCStat objects, the only valid PRIMITIVES are the three global PRIMITIVES:
+In the case of PCStat objects, the only valid PRIMITIVES are the four global PRIMITIVES:
 x = a Stat abbreviation (STR, INT, etc.)<br>
-x = TYPE.x (a TYPE identifier for a Stat) - note that none of our STATs actually use TYPE: but this works anyway :)<br>
+x = TYPE=w (w is a TYPE identifier for a Stat) - note that none of our STATs actually use TYPE: but this works anyway :)<br>
 x = ALL (allow the choice of any STAT)<br>
@@ Line 222: / Line 223: @@
 x is an ArmorProf PRIMITIVE
-A PRIMITIVE is an identifier of objects, and may include any number of specifications.  In the case of ArmorProf objects, the only valid PRIMITIVES are the three global PRIMITIVES:
+A PRIMITIVE is an identifier of objects, and may include any number of specifications.  In the case of ArmorProf objects, the only valid PRIMITIVES are the four global PRIMITIVES:
 x = an ArmorProf (specified by key)<br>
-x = TYPE.x (a TYPE identifier for an ArmorProf) - note that none of our ArmorProfs actually use TYPE: but this works anyway :)<br>
+x = TYPE=w (w is a TYPE identifier for an ArmorProf ) - note that none of our ArmorProfs actually use TYPE: but this works anyway :)<br>
 x = ALL (allow the choice of any ArmorProf)<br>
@@ Line 251: / Line 253: @@
 z = a piece of Equipment (specified by key)<br>
-z = TYPE.z (a TYPE identifier for Equipment)<br>
+z = TYPE=w (w is a TYPE identifier for a piece of Equipment)<br>
 z = ALL (use any Equipment)<br>
@@ Line 302: / Line 305: @@
 x is an ShieldProf PRIMITIVE
-A PRIMITIVE is an identifier of objects, and may include any number of specifications.  In the case of ShieldProf objects, the only valid PRIMITIVES are the three global PRIMITIVES:
+A PRIMITIVE is an identifier of objects, and may include any number of specifications.  In the case of ShieldProf objects, the only valid PRIMITIVES are the four global PRIMITIVES:
-x = an ShieldProf (specified by key)<br>
+x = a ShieldProf (specified by key)<br>
-x = TYPE.x (a TYPE identifier for an ShieldProf) - note that none of our ShieldProfs actually use TYPE: but this works anyway :)<br>
+x = TYPE=w (w is a TYPE identifier for a ShieldProf ) - note that none of our ShieldProfs actually use TYPE: but this works anyway :)<br>
 x = ALL (allow the choice of any ShieldProf)<br>
@@ Line 331: / Line 335: @@
 z = a piece of Equipment (specified by key)<br>
-z = TYPE.z (a TYPE identifier for Equipment)<br>
+z = TYPE=w (w is a TYPE identifier for a piece of Equipment)<br>
 z = ALL (use any Equipment)<br>
@@ Line 380: / Line 385: @@
 x is an Domain PRIMITIVE
-A PRIMITIVE is an identifier of objects, and may include any number of specifications.  In the case of Domain objects, there are are the three global PRIMITIVES:
+A PRIMITIVE is an identifier of objects, and may include any number of specifications.  In the case of Domain objects, there are are the four global PRIMITIVES:
-x = an Domain (specified by key)<br>
+x = a Domain (specified by key)<br>
-x = TYPE.x (a TYPE identifier for an Domain)<br>
+x = TYPE=w (w is a TYPE identifier for a Domain )<br>
 x = ALL (allow the choice of any Domain)<br>

@@ Line 218: / Line 218: @@
 ===Syntax===
-CHOOSE:ARMORPROFICIENCY|x|y|y[z,z]|x,y,y[z,z]
+CHOOSE:ARMORPROFICIENCY|x|y|y[z]|y[z,z]|x,y,y[z],y[z,z]
 x is an ArmorProf PRIMITIVE
@@ Line 298: / Line 298: @@
 ===Syntax===
-CHOOSE:SHIELDPROFICIENCY|x|y|y[z,z]|x,y,y[z,z]
+CHOOSE:SHIELDPROFICIENCY|x|y|y[z]|y[z,z]|x,y,y[z],y[z,z]
 x is an ShieldProf PRIMITIVE
@@ Line 376: / Line 376: @@
 ===Syntax===
-CHOOSE:DOMAIN|x|y|y[z,z]|x,y,y[z,z]
+CHOOSE:DOMAIN|x|y|y[z]|y[z,z]|x,y,y[z],y[z,z]
 x is an Domain PRIMITIVE