GetNearestSeenOrHeardEnemy

From NWN Lexicon
Revision as of 06:59, 24 June 2019 by Shadguy (talk | contribs) (Spelling fix(es))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

GetNearestSeenOrHeardEnemy()

Determines closest visual creature and determines the closest heard creature.

Description

Returns the nearest object that can be seen, then checks for the nearest heard target.

Later AI for HotU and SoU has this remark: Now just a wrapper around GetNearestPerceivedEnemy.



Remarks

Note: Because of later adjustments to the AI, this NEVER returns anything that is merely heard!

This function should probably not be used as much to see if it matches the actual words of the function.

The older version, which merely does what it says on the tin, is below in the code example.


Requirements

#include " x0_i0_enemy "

Version

1.62

Example

// Can put this in your script directly, or in a new include, if you
// want the original functionality of it.
 
// Returns the nearest object that can be seen, then checks for the nearest heard target.
object GetNearestSeenOrHeardEnemy();
 
// Returns the nearest object that can be seen, then checks for the nearest heard target.
object GetNearestSeenOrHeardEnemy()
{
    object oTarget = GetNearestCreature(CREATURE_TYPE_REPUTATION, REPUTATION_TYPE_ENEMY, OBJECT_SELF, 1, CREATURE_TYPE_PERCEPTION, PERCEPTION_SEEN);
    if(!GetIsObjectValid(oTarget))
    {
        oTarget = GetNearestCreature(CREATURE_TYPE_REPUTATION, REPUTATION_TYPE_ENEMY, OBJECT_SELF, 1, CREATURE_TYPE_PERCEPTION, PERCEPTION_HEARD_AND_NOT_SEEN);
        if(!GetIsObjectValid(oTarget))
        {
           return OBJECT_INVALID;
        }
    }
    return oTarget;
}

See Also

functions: 

SetListening

events: 

OnPerception Event



 author: Jody Fletcher, editors: Jasperre, Mistress, additional contributor: Jasperre