NetExaltedXP/Trait - Revision history

Wordman: Script: fix links messed up in conversion

2010-06-09T00:20:07Z

Script: fix links messed up in conversion

Conversion script: link fix

2010-04-06T01:17:17Z

link fix

Conversion script: link fix

2010-04-05T08:07:42Z

link fix

Conversion script: link fix

2010-04-03T09:04:31Z

link fix

Xeriar: Enlightenment strikes, hah!

2005-02-01T04:39:40Z

Enlightenment strikes, hah!

New page

== Trait Class ==
The Trait Class is the second main workhorse of this proposal, the first being the /Character class. It has two modes, after a fashion. The first is inside the /NetExalted class, where it is actually relatively inert. It's there to potentially be read into a /Character class, and not much more.

Inside a /Character, it has a lot more power. Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.

=== Data Members ===
* /Data Array - A special, fixed-size Array containing a few members that all Traits will posess
** Name - The name of the Trait
** Type - The type of the Trait
** Group - A Trait Grouping
** Value - The value of the Trait
** Initialize - the first Value of the Trait
** Multiplicity - "Single" Means that the Trait may only be 'taken' once, though its value may be modifiable. "Multiple" Means that it may be taken multiple times, its Value being set to the number of times it's taken ('owns eight Marukani swifts' or somesuch). An equation (even if it's only a number) specifies that it may be taken up to a certain number of times, and that number is stored in Value (Ox-Body and so on).
** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc). If 1, than it can be. A 2 means that the /Character manages the score in some other fashion (for assigning XP and so on). A 3 means it is not governed by any rules (Character name, etc.)
** Range - If specified, a comma-delimited list of acceptable values. For choosing Caste, for example.
*** Something like this will need triggers.
* /Character Parent - a pointer to the parent character. If null, we're residing in the /NetExalted class.
* (/Data Array) - The remaining necessary values the Trait may have. This will vary wildly - the Name Trait, for the Character's Name, will have none of these. A Charm Trait will have several.
** Values with names beginning with the word 'Minimum', 'Maximum', 'Limit', 'Cost', 'Equals', 'Override' and perhaps several others will need to be recognized specifically, so that Traits may govern their own limits, costs and prerequisites.
*** 'Prerequisites' will probably be an alias specifying a comma-delimited list of Traits, all of which get interpreted as 'Minimum(Trait), 1' entries.
=== Private Functions ===
* int Parse (String) - parses one of the Trait's Data.Value elements.
** Must be able to handle addition, subtraction, multiplication, division, if-else statements, conditional and boolean operations.
** Must be able to reference other values and parse them. For example, "Backgrounds->Breeding.Maximum" Would typically return a 5, or a 6 if the character has Legendary Breeding. The order goes (Type) -> (Trait).(Value), where the default is simply putting in (Trait) will return the Trait's basic Value.
** "String:" - should return the following as just a plaintext string, or, getting fancy, use quotes and allow concatenation as such.
** "None" Should return 0
=== Public Functions ===
* boolean <nowiki>IsPrerequisite</nowiki> (String) - Searches for the input word in the Prerequisites in the various 'Minimum', 'Maximum', and 'Equals' fields. Returns True if so, False otherwise.
* String Verify (String New Value) - verifies whether the new value the Trait has received can be legally set. It returns either a null string (success) or an error message explaining why the setting failed.
** This is a public, rather than private, function because it will need to be called by the character when a value gets changed.
* boolean <nowiki>SetValue</nowiki> (String New Value) - Sets the Trait's value if it ends up being legal.
* String <nowiki>GetValue</nowiki> (<nowiki>ValueName</nowiki>) - Retrieves the parsed (if necessary) value. If no name is given, return the Trait's base Value.
* boolean Override (value, string) - Attempts to override one given value with another (typically because someone purchased a Merit or Flaw)
** Stuff like this is going to have to be handled carefulle and perhaps reconsidered, maybe frequently.

* (Array of /Data) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
=== Methodology ===
* The purchasing system
** The /Character class will have a resource manager govern the actual managings of this, but the rules are entirely Trait-governed.
** Traits that can be purchased / upgraded will have two 'keywords' to utilize:
*** Limit - Typically, a Trait will have LimitXP, LimitBP, LimitAbilityDot, and so on. Limit is the keyword, what comes afterwards is the name of the Trait utilized. It can be an equation - it just refers to the maximum purchasable value.
*** Cost - Like Limit. It, also, can be an equation, not only for favored abilities but also for XP costs in general, of course.
*** Type and Group specifically refer to the purchase group. The Resource Manager will concern itself with things having a Cost, and act accordingly.
** The actual resource-providing Trait itself is pretty ignorant. The Resource manager changes its values, and the Trait it purchases provides the rules for it.
== Comments ==

Are you deliberately avoiding exception handling for some reason?
Why a doubly linked list? This is the perfect case for using Hashtable? --[[flymolo]]

: I'm a C++ junky, sorry, I tend to think exception handling is for unexpected errors rather than those predicted and user-caused. It's the results that are needed, though, and the trait, if it picks up the action, needs to be the one to send the appropriate message, whether through the exception handler or a return value.
: A Hash table should be fine, I haven't built one in awhile. I'll need to update this to have Traits handle multiples of themselves (for now, since that only really matters for equipment, and the Hash is going to have to be pretty complex, as some Traits will have the same name, but different types, requiring a two-dimensional setup. That will be the Character class' problem to translate, although it does mean the data junkies aren't going to get away with specifying 'Sword' but almost always 'Weapon->Sword'
: Shouldn't <nowiki>GetPrerequisites</nowiki> return a Value array (I ought to rename that Data array to keep from confusing).-[[Xeriar]]

:: Flip through the Java API if you get a chance specifically java.util , That has all the data structure classes including hashtable. Now this involves casting on the way out, because generics are java 5(1.5) only.

:: I was thinking the insert would look like
:: if (!hash.exists(swordobj.shortname)){
::: hash.put(swordobj.shortname,swordobj);
::: hash.put(swordobj.longname,swordobj);
:: }
:: else {
::: hash.delete(swordobj.shortname);
::: hash.put(swordobj.longname,swordobj);
:: }
:: But that's because I'm ok with scripts breaking if someone creates an artifact called Strength.

:: <nowiki>GetPrequisites</nowiki> I was thinking would return the list of Traits that the skill required, but creating all the Traits seemed too heavy so I settled for skill names. We could return String[][] so we get skill value pairs. --[[flymolo]]

::: We should stick with a standard method of passing around data, less headache in the long run. Anyways, I need to modify this to have one Trait govern one or more other Traits somehow - preferably elegantly. For example, if someone takes the Artifact Background, they get a number of points to purchase Artifacts with. -[[Xeriar]]

:::: I was thinking about making a fake Traits type called points. It would have things like how many <nowiki>PrimaryAttributePoints</nowiki>. This would allow us to code the points to spend into the Traits file, and modify them with either backgrounds(Like Artifact) or merits/flaws like diminished attributes. -[[flymolo]]

::::: I've been thinking of something similar, basically a governing Trait that could be called from by various subtraits. That itself is fine (even with favored abilities) in concept, except for that annoying Primary/Secondary/Tertiary attribute dot spread. -[[Xeriar]]

Xeriar: *

2005-01-31T15:36:57Z

Flymolo: Reply

2005-01-31T13:48:39Z

@@ Line 1: / Line 1: @@
 == Trait Class ==
-The Trait Class is the second main workhorse of this proposal, the first being the[[NetExaltedXP/Trait/Character]] class.  It has two modes, after a fashion.  The first is inside the[[NetExaltedXP/Trait/NetExalted]] class, where it is actually relatively inert.  It's there to potentially be read into a[[NetExaltedXP/Trait/Character]] class, and not much more.
+The Trait Class is the second main workhorse of this proposal, the first being the[[NetExaltedXP/Character]] class.  It has two modes, after a fashion.  The first is inside the[[NetExaltedXP/NetExalted]] class, where it is actually relatively inert.  It's there to potentially be read into a[[NetExaltedXP/Character]] class, and not much more.
-Inside a[[NetExaltedXP/Trait/Character]], it has a lot more power.  Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.
+Inside a[[NetExaltedXP/Character]], it has a lot more power.  Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.
 === Data Members ===
-*[[NetExaltedXP/Trait/Data]] Array - A special, fixed-size Array containing a few members that all Traits will posess
+*[[NetExaltedXP/Data]] Array - A special, fixed-size Array containing a few members that all Traits will posess
 ** Name - The name of the Trait
 ** Type - The type of the Trait
@@ Line 12: / Line 12: @@
 ** Initialize - the first Value of the Trait
 ** Multiplicity - "Single" Means that the Trait may only be 'taken' once, though its value may be modifiable.  "Multiple" Means that it may be taken multiple times, its Value being set to the number of times it's taken ('owns eight Marukani swifts' or somesuch).  An equation (even if it's only a number) specifies that it may be taken up to a certain number of times, and that number is stored in Value (Ox-Body and so on).
-** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc).  If 1, than it can be.  A 2 means that the[[NetExaltedXP/Trait/Character]] manages the score in some other fashion (for assigning XP and so on).  A 3 means it is not governed by any rules (Character name, etc.)
+** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc).  If 1, than it can be.  A 2 means that the[[NetExaltedXP/Character]] manages the score in some other fashion (for assigning XP and so on).  A 3 means it is not governed by any rules (Character name, etc.)
 ** Range - If specified, a comma-delimited list of acceptable values.  For choosing Caste, for example.
 *** Something like this will need triggers.
-*[[NetExaltedXP/Trait/Character]] Parent - a pointer to the parent character.  If null, we're residing in the[[NetExaltedXP/Trait/NetExalted]] class.
+*[[NetExaltedXP/Character]] Parent - a pointer to the parent character.  If null, we're residing in the[[NetExaltedXP/NetExalted]] class.
-* [[NetExaltedXP/Trait/Data]] Array) - The remaining necessary values the Trait may have.  This will vary wildly - the Name Trait, for the Character's Name, will have none of these.  A Charm Trait will have several.
+* [[NetExaltedXP/Data]] Array) - The remaining necessary values the Trait may have.  This will vary wildly - the Name Trait, for the Character's Name, will have none of these.  A Charm Trait will have several.
 ** Values with names beginning with the word 'Minimum', 'Maximum', 'Limit', 'Cost', 'Equals', 'Override' and perhaps several others will need to be recognized specifically, so that Traits may govern their own limits, costs and prerequisites.
 *** 'Prerequisites' will probably be an alias specifying a comma-delimited list of Traits, all of which get interpreted as 'Minimum(Trait), 1' entries.
@@ Line 34: / Line 34: @@
 ** Stuff like this is going to have to be handled carefulle and perhaps reconsidered, maybe frequently.
-* (Array of[[NetExaltedXP/Trait/Data]]) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
+* (Array of[[NetExaltedXP/Data]]) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
 === Methodology ===
 * The purchasing system
-** The[[NetExaltedXP/Trait/Character]] class will have a resource manager govern the actual managings of this, but the rules are entirely Trait-governed.
+** The[[NetExaltedXP/Character]] class will have a resource manager govern the actual managings of this, but the rules are entirely Trait-governed.
 ** Traits that can be purchased / upgraded will have two 'keywords' to utilize:
 *** Limit - Typically, a Trait will have [[LimitXP]], [[LimitBP]], [[LimitAbilityDot]], and so on.  Limit is the keyword, what comes afterwards is the name of the Trait utilized.  It can be an equation - it just refers to the maximum purchasable value.

@@ Line 1: / Line 1: @@
 == Trait Class ==
-The Trait Class is the second main workhorse of this proposal, the first being the [[NetExaltedXP/Trait/Character]] class.  It has two modes, after a fashion.  The first is inside the [[NetExaltedXP/Trait/NetExalted]] class, where it is actually relatively inert.  It's there to potentially be read into a [[NetExaltedXP/Trait/Character]] class, and not much more.
+The Trait Class is the second main workhorse of this proposal, the first being the[[NetExaltedXP/Trait/Character]] class.  It has two modes, after a fashion.  The first is inside the[[NetExaltedXP/Trait/NetExalted]] class, where it is actually relatively inert.  It's there to potentially be read into a[[NetExaltedXP/Trait/Character]] class, and not much more.
-Inside a [[NetExaltedXP/Trait/Character]], it has a lot more power.  Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.
+Inside a[[NetExaltedXP/Trait/Character]], it has a lot more power.  Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.
 === Data Members ===
-* [[NetExaltedXP/Trait/Data]] Array - A special, fixed-size Array containing a few members that all Traits will posess
+*[[NetExaltedXP/Trait/Data]] Array - A special, fixed-size Array containing a few members that all Traits will posess
 ** Name - The name of the Trait
 ** Type - The type of the Trait
@@ Line 12: / Line 12: @@
 ** Initialize - the first Value of the Trait
 ** Multiplicity - "Single" Means that the Trait may only be 'taken' once, though its value may be modifiable.  "Multiple" Means that it may be taken multiple times, its Value being set to the number of times it's taken ('owns eight Marukani swifts' or somesuch).  An equation (even if it's only a number) specifies that it may be taken up to a certain number of times, and that number is stored in Value (Ox-Body and so on).
-** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc).  If 1, than it can be.  A 2 means that the [[NetExaltedXP/Trait/Character]] manages the score in some other fashion (for assigning XP and so on).  A 3 means it is not governed by any rules (Character name, etc.)
+** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc).  If 1, than it can be.  A 2 means that the[[NetExaltedXP/Trait/Character]] manages the score in some other fashion (for assigning XP and so on).  A 3 means it is not governed by any rules (Character name, etc.)
 ** Range - If specified, a comma-delimited list of acceptable values.  For choosing Caste, for example.
 *** Something like this will need triggers.
-* [[NetExaltedXP/Trait/Character]] Parent - a pointer to the parent character.  If null, we're residing in the [[NetExaltedXP/Trait/NetExalted]] class.
+*[[NetExaltedXP/Trait/Character]] Parent - a pointer to the parent character.  If null, we're residing in the[[NetExaltedXP/Trait/NetExalted]] class.
-* ([[NetExaltedXP/Trait/Data]] Array) - The remaining necessary values the Trait may have.  This will vary wildly - the Name Trait, for the Character's Name, will have none of these.  A Charm Trait will have several.
+* [[NetExaltedXP/Trait/Data]] Array) - The remaining necessary values the Trait may have.  This will vary wildly - the Name Trait, for the Character's Name, will have none of these.  A Charm Trait will have several.
 ** Values with names beginning with the word 'Minimum', 'Maximum', 'Limit', 'Cost', 'Equals', 'Override' and perhaps several others will need to be recognized specifically, so that Traits may govern their own limits, costs and prerequisites.
 *** 'Prerequisites' will probably be an alias specifying a comma-delimited list of Traits, all of which get interpreted as 'Minimum(Trait), 1' entries.
@@ Line 34: / Line 34: @@
 ** Stuff like this is going to have to be handled carefulle and perhaps reconsidered, maybe frequently.
-* (Array of [[NetExaltedXP/Trait/Data]]) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
+* (Array of[[NetExaltedXP/Trait/Data]]) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
 === Methodology ===
 * The purchasing system
-** The [[NetExaltedXP/Trait/Character]] class will have a resource manager govern the actual managings of this, but the rules are entirely Trait-governed.
+** The[[NetExaltedXP/Trait/Character]] class will have a resource manager govern the actual managings of this, but the rules are entirely Trait-governed.
 ** Traits that can be purchased / upgraded will have two 'keywords' to utilize:
 *** Limit - Typically, a Trait will have [[LimitXP]], [[LimitBP]], [[LimitAbilityDot]], and so on.  Limit is the keyword, what comes afterwards is the name of the Trait utilized.  It can be an equation - it just refers to the maximum purchasable value.
@@ Line 71: / Line 71: @@
 :::: I was thinking about making a fake Traits type called points.  It would have things like how many <nowiki>PrimaryAttributePoints</nowiki>.  This would allow us to code the points to spend into the Traits file, and modify them with either backgrounds(Like Artifact) or merits/flaws like diminished attributes. -[[flymolo]]
-::::: I've been thinking of something similar, basically a governing Trait that could be called from by various subtraits.  That itself is fine (even with favored abilities) in concept, except for that annoying [[PrimaryNetExaltedXP/Trait/Secondary/Tertiary]] attribute dot spread. -[[Xeriar]]
+::::: I've been thinking of something similar, basically a governing Trait that could be called from by various subtraits.  That itself is fine (even with favored abilities) in concept, except for that annoying Primary/Secondary/Tertiary attribute dot spread. -[[Xeriar]]

@@ Line 1: / Line 1: @@
 == Trait Class ==
-The Trait Class is the second main workhorse of this proposal, the first being the [[/Character]] class.  It has two modes, after a fashion.  The first is inside the [[/NetExalted]] class, where it is actually relatively inert.  It's there to potentially be read into a [[/Character]] class, and not much more.
+The Trait Class is the second main workhorse of this proposal, the first being the /Character class.  It has two modes, after a fashion.  The first is inside the /NetExalted class, where it is actually relatively inert.  It's there to potentially be read into a /Character class, and not much more.
-Inside a [[/Character]], it has a lot more power.  Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.
+Inside a /Character, it has a lot more power.  Primarily, it throws around strings and/or numbers as they are requested of it, and can be quite flexible.
 === Data Members ===
-* [[/Data]] Array - A special, fixed-size Array containing a few members that all Traits will posess
+* /Data Array - A special, fixed-size Array containing a few members that all Traits will posess
 ** Name - The name of the Trait
 ** Type - The type of the Trait
 ** Value - The value of the Trait
 ** Multiplicity - "Single" Means that the Trait may only be 'taken' once, though its value may be modifiable.  "Multiple" Means that it may be taken multiple times, its Value being set to the number of times it's taken ('owns eight Marukani swifts' or somesuch).  An equation (even if it's only a number) specifies that it may be taken up to a certain number of times, and that number is stored in Value (Ox-Body and so on).
-** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc).  If 1, than it can be.  A 2 means that the [[/Character]] manages the score in some other fashion (for assigning XP and so on).  A 3 means it is not governed by any rules (Character name, etc.)
+** Editable - A specialized Value, if its Value is 0, then the Base Value cannot be directly changed by the User (it's a Derived Trait, such as Health Levels, Peripheral Essence, etc).  If 1, than it can be.
-** Range - If specified, a comma-delimited list of acceptable values.  For choosing Caste, for example.
+* /Character Parent - a pointer to the parent character.  If null, we're residing in the /NetExalted class.
-*** Something like this will need triggers.
+* (/Data Array) - The remaining necessary values the Trait may have.  This will vary wildly - the Name Trait, for the Character's Name, will have none of these.  A Charm Trait will have several.
-* [[/Character]] Parent - a pointer to the parent character.  If null, we're residing in the [[/NetExalted]] class.
+** Values with names beginning with the word 'Minimum', 'Maximum', 'Cost', 'Equals', 'Override' and perhaps several others will need to be recognized specifically, so that Traits may govern their own limits, costs and prerequisites.
 *** 'Prerequisites' will probably be an alias specifying a comma-delimited list of Traits, all of which get interpreted as 'Minimum(Trait), 1' entries.
 === Private Functions ===
@@ Line 34: / Line 31: @@
 ** Stuff like this is going to have to be handled carefulle and perhaps reconsidered, maybe frequently.
-* (Array of [[/Data]]) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
+* (Array of /Data) <nowiki>GetPrequisites</nowiki>() - Returns a list of Traits used as prerequisites
 == Comments ==
@@ Line 70: / Line 59: @@
 :::: I was thinking about making a fake Traits type called points.  It would have things like how many <nowiki>PrimaryAttributePoints</nowiki>.  This would allow us to code the points to spend into the Traits file, and modify them with either backgrounds(Like Artifact) or merits/flaws like diminished attributes. -[[flymolo]]