SetWeaponTarget - Revision history

Fernando187: Remove obsolete Requirements section

2024-11-07T17:06:54Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:06, 7 November 2024
Line 93:		Line 93:
	end		end
	addEventHandler("onClientResourceStart", resourceRoot, createWeaponFiringPedHead)</syntaxhighlight>		addEventHandler("onClientResourceStart", resourceRoot, createWeaponFiringPedHead)</syntaxhighlight>

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.3.0-9.04555\|}}~~

	==See also==		==See also==
	{{Client weapon creation functions}}		{{Client weapon creation functions}}

FeaturedPro: grammar

2023-01-16T01:05:22Z

grammar

← Older revision		Revision as of 01:05, 16 January 2023
Line 23:		Line 23:
	*** '''3''': rear right tire.		*** '''3''': rear right tire.
	*** '''255''': center of the car (position returned by [[getElementPosition]]).		*** '''255''': center of the car (position returned by [[getElementPosition]]).
	** '''[[Ped\|Peds]]''' (players '''not''' included; see [[getPedBonePosition]] to know where is located ~~each bone~~):		** '''[[Ped\|Peds]]''' (players '''not''' included; see [[getPedBonePosition]] to know where each bone is located):
	***'''1:''' ''BONE_PELVIS1'' position.		***'''1:''' ''BONE_PELVIS1'' position.
	***'''2:''' ''BONE_PELVIS'' position.		***'''2:''' ''BONE_PELVIS'' position.

Myonlake at 09:54, 21 June 2019

2019-06-21T09:54:02Z

← Older revision		Revision as of 09:54, 21 June 2019
Line 9:		Line 9:
	Fires the weapon at a physical [[element]].		Fires the weapon at a physical [[element]].

	<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255 ] )</syntaxhighlight>

	===Required arguments===		===Required arguments===

AlexTMjugador: /* Example */

2015-08-06T11:29:22Z

Example

← Older revision		Revision as of 11:29, 6 August 2015
Line 85:		Line 85:
	This example creates a Uzi and a pedestrian in the center of the map when the resource which contains it starts and makes the weapon fire the new ped's head non-stop.		This example creates a Uzi and a pedestrian in the center of the map when the resource which contains it starts and makes the weapon fire the new ped's head non-stop.
	<syntaxhighlight lang="lua">local function createWeaponFiringPedHead()		<syntaxhighlight lang="lua">local function createWeaponFiringPedHead()
	-- Create the weapon, set a flag ~~and create the ped~~		-- Create the weapon and set a flag of it
	local weapon = createWeapon("uzi", 0, 0, 10)		local weapon = createWeapon("uzi", 0, 0, 10)
	setWeaponFlags(weapon, "instant_reload", true)		setWeaponFlags(weapon, "instant_reload", true)
	~~local ped = createPed(8, 0, 0, 5)~~		-- Set the weapon target to a ped and fire it forever
	-- Set the weapon target and fire it forever		setWeaponTarget(weapon, createPed(8, 0, 0, 5), 8)
	setWeaponTarget(weapon, ~~ped~~, 8)
	setWeaponState(weapon, "firing")		setWeaponState(weapon, "firing")
	end		end
	addEventHandler("onClientResourceStart", resourceRoot, ~~createWeaponFiringLocalPlayer~~)</syntaxhighlight>		addEventHandler("onClientResourceStart", resourceRoot, createWeaponFiringPedHead)</syntaxhighlight>

	==Requirements==		==Requirements==

AlexTMjugador: Added example and improved a bit some confusing stuff

2015-08-06T11:22:30Z

Added example and improved a bit some confusing stuff

← Older revision		Revision as of 11:22, 6 August 2015
Line 2:		Line 2:
	{{Client function}}		{{Client function}}
	This function sets the target of a [[Element/Weapon\|custom weapon]]. There are 3 different targeting modes, which are explained below.		This function sets the target of a [[Element/Weapon\|custom weapon]]. There are 3 different targeting modes, which are explained below.
	{{Note\|[[Element/Weapon\|Custom weapons]] ~~target its target (assigned by this function)~~ with no recoil. If you want a custom weapon to take into account recoil, you will have to script it by firing at fixed coordinates.}}		{{Note\|[[Element/Weapon\|Custom weapons]] fire targets with no recoil (so they never miss a shot). If you want a custom weapon to take into account recoil, you will have to script it by firing at fixed coordinates.}}

	==Syntax==		{{OOP\|Variable is read only.\|[[Element/Weapon\|weapon]]:setTarget\|target\|getWeaponTarget}}

			==Syntax (target an element)==
	Fires the weapon at a physical [[element]].		Fires the weapon at a physical [[element]].

	<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>


	~~{{OOP\|Variable is read only.\|[[Element/Weapon\|weapon]]:setTarget\|target\|getWeaponTarget}}~~


	===Required arguments===		===Required arguments===
Line 64:		Line 62:
	<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, float targetX, float targetY, float targetZ )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, float targetX, float targetY, float targetZ )</syntaxhighlight>

	===Required ~~Arguments~~===		===Required arguments===
	* '''theWeapon:''' The weapon to set the target of.		* '''theWeapon:''' The weapon to set the target of.
	* '''targetX:''' The target X.		* '''targetX:''' The target X.
Line 74:		Line 72:

	==Syntax (rotational target)==		==Syntax (rotational target)==
	Sets the weapon back to rotation based targeting.		Sets the weapon back to rotation based targeting. It will fire to its front.

	<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, nil )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, nil )</syntaxhighlight>

	===Required ~~Arguments~~===		===Required arguments===
	* '''theWeapon:''' The weapon to clear the target of.		* '''theWeapon:''' The weapon to clear the target of.

	===Returns===		===Returns===
	Returns ''true'' on success, ''false'' otherwise.		Returns ''true'' on success, ''false'' otherwise.

			==Example==
			This example creates a Uzi and a pedestrian in the center of the map when the resource which contains it starts and makes the weapon fire the new ped's head non-stop.
			<syntaxhighlight lang="lua">local function createWeaponFiringPedHead()
			-- Create the weapon, set a flag and create the ped
			local weapon = createWeapon("uzi", 0, 0, 10)
			setWeaponFlags(weapon, "instant_reload", true)
			local ped = createPed(8, 0, 0, 5)
			-- Set the weapon target and fire it forever
			setWeaponTarget(weapon, ped, 8)
			setWeaponState(weapon, "firing")
			end
			addEventHandler("onClientResourceStart", resourceRoot, createWeaponFiringLocalPlayer)</syntaxhighlight>

	==Requirements==		==Requirements==

Dmitry7zip at 21:30, 6 June 2015

2015-06-06T21:30:51Z

← Older revision		Revision as of 21:30, 6 June 2015
Line 4:		Line 4:
	{{Note\|[[Element/Weapon\|Custom weapons]] target its target (assigned by this function) with no recoil. If you want a custom weapon to take into account recoil, you will have to script it by firing at fixed coordinates.}}		{{Note\|[[Element/Weapon\|Custom weapons]] target its target (assigned by this function) with no recoil. If you want a custom weapon to take into account recoil, you will have to script it by firing at fixed coordinates.}}

	~~{{OOP\|Variable is read only.\|[[Element/Weapon\|weapon]]:setTarget\|target\|getWeaponTarget}}~~		==Syntax==
	==Syntax ~~(target an entity)~~==
	Fires the weapon at a physical [[element]].		Fires the weapon at a physical [[element]].

	<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>


			{{OOP\|Variable is read only.\|[[Element/Weapon\|weapon]]:setTarget\|target\|getWeaponTarget}}


	===Required arguments===		===Required arguments===

AlexTMjugador: /* Required arguments */

2014-12-23T17:52:49Z

Required arguments

← Older revision		Revision as of 17:52, 23 December 2014
Line 12:		Line 12:
	===Required arguments===		===Required arguments===
	* '''theWeapon:''' The weapon to set the target of.		* '''theWeapon:''' The weapon to set the target of.
	* '''theTarget:''' The [[element]] to shoot at. It can be a [[player]], [[ped]] or [[object]].		* '''theTarget:''' The [[element]] to shoot at. It can be a [[player]], [[ped]], [[vehicle]] or [[object]].

	===Optional arguments===		===Optional arguments===

AlexTMjugador: /* Syntax (rotational target) */

2014-12-23T17:43:29Z

Syntax (rotational target)

← Older revision		Revision as of 17:43, 23 December 2014
Line 73:		Line 73:
	Sets the weapon back to rotation based targeting.		Sets the weapon back to rotation based targeting.

	<syntaxhighlight lang="lua">~~bool~~ bool setWeaponTarget ( weapon theWeapon, nil )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, nil )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===

AlexTMjugador: Added more explanatory text to /* Syntax (target an entity) */

2014-12-23T17:42:58Z

Added more explanatory text to Syntax (target an entity)

← Older revision		Revision as of 17:42, 23 December 2014
Line 6:		Line 6:
	{{OOP\|Variable is read only.\|[[Element/Weapon\|weapon]]:setTarget\|target\|getWeaponTarget}}		{{OOP\|Variable is read only.\|[[Element/Weapon\|weapon]]:setTarget\|target\|getWeaponTarget}}
	==Syntax (target an entity)==		==Syntax (target an entity)==
			Fires the weapon at a physical [[element]].

	<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool setWeaponTarget ( weapon theWeapon, element theTarget [, int theComponent = 255] )</syntaxhighlight>

AlexTMjugador: /* Optional arguments */

2014-12-23T17:41:21Z

Optional arguments

← Older revision		Revision as of 17:41, 23 December 2014
Line 21:		Line 21:
	*** '''255''': center of the car (position returned by [[getElementPosition]]).		*** '''255''': center of the car (position returned by [[getElementPosition]]).
	** '''[[Ped\|Peds]]''' (players '''not''' included; see [[getPedBonePosition]] to know where is located each bone):		** '''[[Ped\|Peds]]''' (players '''not''' included; see [[getPedBonePosition]] to know where is located each bone):
	***'''1:''' ~~shoots at~~ ''BONE_PELVIS1''.		***'''1:''' ''BONE_PELVIS1'' position.
	***'''2:''' ~~shoots at~~ ''BONE_PELVIS''.		***'''2:''' ''BONE_PELVIS'' position.
	***'''3:''' ~~shoots at~~ ''BONE_SPINE1''.		***'''3:''' ''BONE_SPINE1'' position.
	***'''4:''' ~~shoots at~~ ''BONE_UPPERTORSO''.		***'''4:''' ''BONE_UPPERTORSO'' position.
	***'''5:''' ~~shoots at~~ ''BONE_NECK''.		***'''5:''' ''BONE_NECK'' position.
	***'''6:''' ~~shoots at~~ ''BONE_HEAD2''.		***'''6:''' ''BONE_HEAD2'' position.
	***'''7:''' ~~shoots at~~ ''BONE_HEAD1''.		***'''7:''' ''BONE_HEAD1'' position.
	***'''8:''' ~~shoots at~~ ''BONE_HEAD''.		***'''8:''' ''BONE_HEAD'' position.
	***'''21:''' ~~shoots at~~ ''BONE_RIGHTUPPERTORSO''.		***'''21:''' ''BONE_RIGHTUPPERTORSO'' position.
	***'''22:''' ~~shoots at~~ ''BONE_RIGHTSHOULDER''.		***'''22:''' ''BONE_RIGHTSHOULDER'' position.
	***'''23:''' ~~shoots at~~ ''BONE_RIGHTELBOW''.		***'''23:''' ''BONE_RIGHTELBOW'' position.
	***'''24:''' ~~shoots at~~ ''BONE_RIGHTWRIST''.		***'''24:''' ''BONE_RIGHTWRIST'' position.
	***'''25:''' ~~shoots at~~ ''BONE_RIGHTHAND''.		***'''25:''' ''BONE_RIGHTHAND'' position.
	***'''26:''' ~~shoots at~~ ''BONE_RIGHTTHUMB''.		***'''26:''' ''BONE_RIGHTTHUMB'' position.
	***'''31:''' ~~shoots at~~ ''BONE_LEFTUPPERTORSO''.		***'''31:''' ''BONE_LEFTUPPERTORSO'' position.
	***'''32:''' ~~shoots at~~ ''BONE_LEFTSHOULDER''.		***'''32:''' ''BONE_LEFTSHOULDER'' position.
	***'''33:''' ~~shoots at~~ ''BONE_LEFTELBOW''.		***'''33:''' ''BONE_LEFTELBOW'' position.
	***'''34:''' ~~shoots at~~ ''BONE_LEFTWRIST''.		***'''34:''' ''BONE_LEFTWRIST'' position.
	***'''35:''' ~~shoots at~~ ''BONE_LEFTHAND''.		***'''35:''' ''BONE_LEFTHAND'' position.
	***'''36:''' ~~shoots at~~ ''BONE_LEFTTHUMB''.		***'''36:''' ''BONE_LEFTTHUMB'' position.
	***'''41:''' ~~shoots at~~ ''BONE_LEFTHIP''.		***'''41:''' ''BONE_LEFTHIP'' position.
	***'''42:''' ~~shoots at~~ ''BONE_LEFTKNEE''.		***'''42:''' ''BONE_LEFTKNEE'' position.
	***'''43:''' ~~shoots at~~ ''BONE_LEFTANKLE''.		***'''43:''' ''BONE_LEFTANKLE'' position.
	***'''44:''' ~~shoots at~~ ''BONE_LEFTFOOT''.		***'''44:''' ''BONE_LEFTFOOT'' position.
	***'''51:''' ~~shoots at~~ ''BONE_RIGHTHIP''.		***'''51:''' ''BONE_RIGHTHIP'' position.
	***'''52:''' ~~shoots at~~ ''BONE_RIGHTKNEE''.		***'''52:''' ''BONE_RIGHTKNEE'' position.
	***'''53:''' ~~shoots at~~ ''BONE_RIGHTANKLE''.		***'''53:''' ''BONE_RIGHTANKLE'' position.
	***'''54:''' ~~shoots at~~ ''BONE_RIGHTFOOT''.		***'''54:''' ''BONE_RIGHTFOOT'' position.
	*** '''255''': ~~shoots at the~~ center of the ped (position returned by [[getElementPosition]]).		*** '''255''': center of the ped (position returned by [[getElementPosition]]).

	===Returns===		===Returns===