LibAction: Difference between revisions
No edit summary |
|||
| Line 43: | Line 43: | ||
|} | |} | ||
==Functions== | ==Functions== | ||
1. ShootPlayer | 1. '''ShootPlayer''' | ||
<source lang="lua">ShootPlayer([integer]playerid)</source> | <source lang="lua">ShootPlayer([integer]playerid)</source> | ||
<poem>The npc pickup a gun from it's available weapons and starts shooting at the player. To shoot with a specific gun set the weapon of npc prior to the call. From npcscripts this can be done using [[SetLocalValue]] with field <source lang="lua" inline>I_CURWEP</source> | <poem>The npc pickup a gun from it's available weapons and starts shooting at the player. To shoot with a specific gun set the weapon of npc prior to the call. From npcscripts this can be done using [[SetLocalValue]] with field <source lang="lua" inline>I_CURWEP</source> | ||
return value: true on success, false on failure (player not streamed in or no proper gun available) | return value: true on success, false on failure (player not streamed in or no proper gun available) | ||
</poem> | </poem> | ||
2. ClearTarget | 2. '''ClearTarget''' | ||
<source lang="lua">ClearTarget()</source> | <source lang="lua">ClearTarget()</source> | ||
<poem>Clears the target and calls OnTargetCleared with reason as <source lang="lua" inline>INSTRUCTION_RECEIVED</source> | <poem>Clears the target and calls OnTargetCleared with reason as <source lang="lua" inline>INSTRUCTION_RECEIVED</source> | ||
return vaue: true (if the npc had a target) or false( if the npc did not had a target)</poem> | return vaue: true (if the npc had a target) or false( if the npc did not had a target)</poem> | ||
3. GetTarget | 3. '''GetTarget''' | ||
<source lang="lua">GetTarget()</source> | <source lang="lua">GetTarget()</source> | ||
return value: The player ID of the target or -1 if there is no target. | return value: The player ID of the target or -1 if there is no target. | ||
Revision as of 04:33, 20 February 2023
Callbacks
1. OnTargetCleared
OnTargetCleared([integer]targetpid, [integer]reason)
The value of reason can be:
| Constant |
|---|
| AMMO_SHORTAGE |
| PLAYER_STREAMEDOUT |
| INSTRUCTION_RECEIVED |
2. OnTargetOutOfRange
OnTargetOutOfRange([integer]targetid)
Called when target is out of range of the weaponrange of the current weapon of npc. If target is not cleared, npc resumes shooting when target comes in range again.
3. OnPullingTrigger
OnPullingTrigger([integer] keys, [Vector]pos, [float]angle, [integer]health, [integer]armour, [integer]weapon, [integer]ammo, [Vector]speed, [Vector]aimpos, [Vector]aimdir, [bool]isCrouching, [bool]isReloading )
This event is called just before sending the Aiming Packet( with decreased ammo) to server. The purpose is to manually change the aimpos/aimdir for accuracy.
To manually change, Call SendOnFootSyncDataEx at this point and then return false.
The automatic sending of aim packet depends on the return value of this function:
| return value | ||
|---|---|---|
| false | will not send packet, assuming the user send it using SendOnFootSyncDataEx or similar functions | |
| 0 | " | |
| null (or no return value) | " |
Functions
1. ShootPlayer
ShootPlayer([integer]playerid)
The npc pickup a gun from it's available weapons and starts shooting at the player. To shoot with a specific gun set the weapon of npc prior to the call. From npcscripts this can be done using SetLocalValue with field I_CURWEP
return value: true on success, false on failure (player not streamed in or no proper gun available)
2. ClearTarget
ClearTarget()
Clears the target and calls OnTargetCleared with reason as INSTRUCTION_RECEIVED
return vaue: true (if the npc had a target) or false( if the npc did not had a target)
3. GetTarget
GetTarget()
return value: The player ID of the target or -1 if there is no target.