Get the average level of the members of the faction.
The object whose faction you wish to examine.
Returns an integer corresponding to the average level of all the creatures in the object's faction.
Return value on error: -1
It is unknown if NPC's in a PC's faction affects this function call and the returned result, such as summoned monsters, henchmen and familiars, or if those creatures can be used as the oFactionMember at all.
"level" will be basically their hit dice. To get a more accurate reading of where they are between levels, for example, it could be that they are very nearly the next level, use GetFactionAverageXP().
This will work exactly the same was as using GetFirst/NextFactionMemeber() and using GetHitDice(), only is much easier to code and probably better on performance.
Try to never use this on an NPC faction, only a PC's party faction, because NPC factions usually have dozens of NPC's, and thus may cause a lot of high CPU usage with faction calls such as this.
// Give 250 per the average level, so if a party had a average level
// of 10, it'd be 2500 XP each.
// Get the PC's party speaker
object oPC = GetPCSpeaker();
// Get the average level of their party
int nLvl = GetFactionAverageLevel(oPC);
// Get the XP to award
int nXP = nLvl * 250;
// Give the XP to the PC's
// * This function is in nw_i0_tool
author: John Shuell, editor: Jasperre, additional contributor(s): Jasperre