EnterTargetingMode(object, int, int)
Makes oPC enter a targeting mode, letting them select an object as a target.
- The player to enter targeting mode.
- An OBJECT_TYPE_* constant specifying the type of object to target.
- The mouse cursor id to use.
Makes oPC enter a targeting mode, letting them select an object or location as a target.
If a PC selects a target, it will trigger the module OnPlayerTarget event.
The OnPlayerTarget script will run whether the player targeted a valid object or manually exited targeting mode.
Since the OnPlayerTarget event won't know what script / reason that has occurred, it is suggested to track this from a standard integer stored on the player entering the targeting mode, eg: a "TARGET_MODE_ID" which then loads the appropriate response.
The nValidObjecTypes can be bitmasked together so that a list can be produced of all the valid types eg:
EnterTargetingMode(oPC, OBJECT_TYPE_CREATURE | OBJECT_TYPE_PLACEABLE);
OBJECT_TYPE_TILE is a new constant used solely in this function that counts as "the ground".
The targeting cursor will appear disabled (gray-colored) when targeting an object that is under a chat window, however, players can successfully target through the chat windows.
This function was added in 1.80.8193.14 of NWN:EE.
|functions:||GetTargetingModeSelectedObject() GetTargetingModeSelectedPosition() GetLastPlayerToSelectTarget()|