Difference between revisions of "GetCreatureTalentBest"

From NWN Lexicon
Jump to: navigation, search
Line 1: Line 1:
 
 
 
 
 
=GetCreatureTalentBest(int, int, object)=
 
=GetCreatureTalentBest(int, int, object)=
  
Line 29: Line 25:
 
The creature that has the talent. (Default: OBJECT_SELF)
 
The creature that has the talent. (Default: OBJECT_SELF)
  
<br />
 
  
 
====Description====
 
====Description====
Line 35: Line 30:
 
Returns the best talent (i.e. closest to nCRMax without going over) of oCreature, within nCategory.
 
Returns the best talent (i.e. closest to nCRMax without going over) of oCreature, within nCategory.
  
<br /><br />
+
====Remarks====
 +
 
 +
It is possible for nCreature not to have any talent within the specified nCategory. In this case this function will return an invalid talent, akin to OBJECT_INVALID, but you must use the GetIsTalentValid() to test this.
 +
 
 +
Specifying nCategory 1 actually returns talents of category 11 and vice versa.
 +
 
 +
Returns invalid talent if the creature is immobilized (toolset speed setting, entangle effect or cutscene immobility).
 +
 
 +
If CR = -1 works like random, CR = 0 returns potions, scrolls and other items, spell has CR equal to (InnateLevel*2)-1, feats probably 0 as well
 +
 
 +
If category = 0, returns anything without category, known feats (but not with 0 uses) and skills
  
 
====Version====
 
====Version====

Revision as of 14:55, 10 September 2012

GetCreatureTalentBest(int, int, object)

Determines the best talent of a creature from a group of talents.

talent GetCreatureTalentBest(
    int nCategory,
    int nCRMax,
    object oCreature = OBJECT_SELF
);

Parameters

nCategory

TALENT_CATEGORY_*

nCRMax

The maximum Challenge Rating of the talent.

oCreature

The creature that has the talent. (Default: OBJECT_SELF)


Description

Returns the best talent (i.e. closest to nCRMax without going over) of oCreature, within nCategory.

Remarks

It is possible for nCreature not to have any talent within the specified nCategory. In this case this function will return an invalid talent, akin to OBJECT_INVALID, but you must use the GetIsTalentValid() to test this.

Specifying nCategory 1 actually returns talents of category 11 and vice versa.

Returns invalid talent if the creature is immobilized (toolset speed setting, entangle effect or cutscene immobility).

If CR = -1 works like random, CR = 0 returns potions, scrolls and other items, spell has CR equal to (InnateLevel*2)-1, feats probably 0 as well

If category = 0, returns anything without category, known feats (but not with 0 uses) and skills

Version

1.22

See Also

functions: 

GetIsTalentValid

constants: 

TALENT_CATEGORY_* Constants



 author: Tom Cassiotis