GiveWeapon - Revision history

FileEX: /* See Also */

2024-09-06T22:39:38Z

Lopez: rephrase required args a bit

2021-12-04T22:57:31Z

rephrase required args a bit

← Older revision		Revision as of 22:57, 4 December 2021
Line 13:		Line 13:
	===Required Arguments===		===Required Arguments===
	*'''thePlayer:''' A [[player]] or [[ped]] object referencing the specified player (or [[ped]])		*'''thePlayer:''' A [[player]] or [[ped]] object referencing the specified player (or [[ped]])
	*'''weapon:''' A whole number integer that refers to a [[Weapon]] ID~~. Click [[Weapon\|here]] for a list of possible weapon IDs~~.		*'''weapon:''' A whole number integer that refers to a [[Weapon]] ID.

	===Optional Arguments===		===Optional Arguments===

Lettify: Transl

2021-04-19T23:58:50Z

Transl

← Older revision		Revision as of 23:58, 19 April 2021
Line 66:		Line 66:
	[[ru:giveWeapon]]		[[ru:giveWeapon]]
	[[pl:giveWeapon]]		[[pl:giveWeapon]]
			[[pt-br:giveWeapon]]

XLive at 07:52, 4 November 2020

2020-11-04T07:52:15Z

← Older revision		Revision as of 07:52, 4 November 2020
Line 29:		Line 29:
	giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo		giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo
	end		end
	addEventHandler ( "onPlayerSpawn", ~~getRootElement()~~, giveWeaponsOnSpawn ) -- attach the event handler		addEventHandler ( "onPlayerSpawn", root, giveWeaponsOnSpawn ) -- attach the event handler
	</syntaxhighlight>		</syntaxhighlight>

WilQ at 14:59, 13 September 2018

2018-09-13T14:59:34Z

← Older revision		Revision as of 14:59, 13 September 2018
Line 65:		Line 65:
	{{Weapon functions}}		{{Weapon functions}}
	[[ru:giveWeapon]]		[[ru:giveWeapon]]
			[[pl:giveWeapon]]

Thisdp: Undo revision 59055 by Lizzalka (talk)

2018-09-09T06:02:52Z

Undo revision 59055 by Lizzalka (talk)

← Older revision		Revision as of 06:02, 9 September 2018
Line 1:		Line 1:
	<~~font face~~="~~sans-serif~~">		__NOTOC__
	~~<div style~~=~~"background~~:~~#333;">~~		{{Server function}}
	~~<div style~~=~~"height~~:~~4px;background~~:~~#AAA;"></div>~~		giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.
	~~<font color~~=~~"#FFF" size~~=~~"5">~~		{{Note\|
	~~<p> Ваша версия Adobe Flash Player устарела</p>~~		*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1
	~~</font>~~		*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5, the ammo is added
	~~<div style~~=~~"background~~:~~#FFF;">~~		*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced
	<~~font color~~="~~#F00~~" ~~size=~~"2">		}}
	~~<p>Требуется срочное обновление до текущей версии!~~</p>
	~~</font>~~		==Syntax==
	~~<font color=~~"~~#000~~" ~~size="4~~">		<syntaxhighlight lang="lua">bool giveWeapon ( ped thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
	<p>~~Adobe Flash Player 30~~.~~0.0.164~~ <~~font color~~="~~#888~~" ~~size~~=~~"2">~~(~~~18 kB~~)~~</font></p>~~
	~~</font>~~		===Required Arguments===
	~~<font color=~~"~~#444~~" ~~size=~~"2">		*'''thePlayer:''' A [[player]] or [[ped]] object referencing the specified player (or [[ped]])
	~~<p><b>Операционная система:~~</b> ~~Windows<br><b>Язык~~:</b> ~~Выбирает пользователь~~</p>		*'''weapon:''' A whole number integer that refers to a [[Weapon]] ID. Click [[Weapon\|here]] for a list of possible weapon IDs.
	<~~/font~~>
	~~<font color~~="~~#000~~" ~~size~~=~~"4">~~		===Optional Arguments===
	~~<p>Скачать обновление с Яндекс.Диска: yadi.sk/d/AfbiMAr1PkGdww~~</p>		{{OptionalArg}}
	~~</font>~~		*'''ammo:''' A whole number integer serving as the ammo amount for the given weapon. For weapons that do not require ammo, such as melee, this should be at least 1.
	~~</div>~~		*'''setAsCurrent:''' A boolean value determining whether or not the weapon will be set as the players current.
	~~</div>~~
	~~</font>~~		===Returns===
			Returns ''true'' if weapon was successfully acquired, ''false'' otherwise.

			==Example==
			'''Example 1:''' This example gives a player an M4 with 200 ammo whenever they spawn.
			<syntaxhighlight lang="lua">
			function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
			giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo
			end
			addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn ) -- attach the event handler
			</syntaxhighlight>


			'''Example 2:''' This example adds a "give" command in console which allows giving of any weapon by entering "give <id> <amount>".
			<syntaxhighlight lang="lua">
			function consoleGive ( thePlayer, commandName, weaponID, ammo )
			local status = giveWeapon ( thePlayer, weaponID, ammo, true ) -- attempt to give the weapon, forcing it as selected weapon
			if ( not status ) then -- if it was unsuccessful
			outputConsole ( "Failed to give weapon.", thePlayer ) -- tell the player
			end
			end
			addCommandHandler ( "give", consoleGive )
			</syntaxhighlight>


			'''Example 3:''' This example creates a ped in certain coordinates. You can give him a weapon with "give <weaponID> <amount>" command in console.
			<syntaxhighlight lang="lua">
			ped = createPed( 19, -1634.5775, 1203.85, 7.1796 )

			addCommandHandler( "give",
			function ( player, command, id, amount )
			if not tonumber ( id ) then return end

			if not tonumber ( amount ) then
			amount = 9001
			end

			giveWeapon( ped, id, amount, true )
			end
			)
			</syntaxhighlight>

			==See Also==
			{{Weapon functions}}
			[[ru:giveWeapon]]

Lizzalka at 06:00, 9 September 2018

2018-09-09T06:00:28Z

← Older revision		Revision as of 06:00, 9 September 2018
Line 1:		Line 1:
	~~__NOTOC__~~		<font face="sans-serif">
	~~{{Server function}}~~		<div style="background:#333;">
	~~giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.~~		<div style="height:4px;background:#AAA;"></div>
	~~{{Note\|~~		<font color="#FFF" size="5">
	*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1		<p> Ваша версия Adobe Flash Player устарела</p>
	*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5, the ammo is added		</font>
	*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced		<div style="background:#FFF;">
	}}		<font color="#F00" size="2">
			<p>Требуется срочное обновление до текущей версии!</p>
	~~==Syntax==~~		</font>
	<~~syntaxhighlight lang~~="~~lua~~">~~bool giveWeapon ( ped thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )~~<~~/syntaxhighlight>~~		<font color="#000" size="4">
			<p>Adobe Flash Player 30.0.0.164 <font color="#888" size="2">(~18 kB)</font></p>
	=~~==Required Arguments===~~		</font>
	*'''thePlayer:~~''' A [[player]] or [[ped]] object referencing the specified player (or [[ped]])~~		<font color="#444" size="2">
	*'''weapon:''' A whole number integer that refers to a [[Weapon]] ID. Click [[Weapon\|here]] for a list of possible weapon IDs.		<p><b>Операционная система:</b> Windows<br><b>Язык:</b> Выбирает пользователь</p>
			</font>
	=~~==Optional Arguments===~~		<font color="#000" size="4">
	~~{{OptionalArg}}~~		<p>Скачать обновление с Яндекс.Диска: yadi.sk/d/AfbiMAr1PkGdww</p>
	*'''ammo:~~''' A whole number integer serving as the ammo amount for the given weapon. For weapons that do not require ammo, such as melee, this should be at least 1.~~		</font>
	*'''setAsCurrent:~~''' A boolean value determining whether or not the weapon will be set as the players current.~~		</div>
			</div>
	==~~=Returns===~~		</font>
	~~Returns ''true'' if weapon was successfully acquired, ''false'' otherwise.~~

	=~~=Example==~~
	~~'''Example 1~~:~~''' This example gives a player an M4 with 200 ammo whenever they spawn.~~
	<~~syntaxhighlight lang~~="~~lua~~">
	~~function giveWeaponsOnSpawn ( theSpawnpont, theTeam )~~
	~~giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo~~
	~~end~~
	~~addEventHandler (~~ "~~onPlayerSpawn~~"~~, getRootElement(), giveWeaponsOnSpawn ) -- attach the event handler~~
	</~~syntaxhighlight~~>


	~~'''Example 2:''' This example adds a~~ "~~give~~" ~~command in console which allows giving of any weapon by entering~~ "~~give <id~~> <~~amount~~>".
	<~~syntaxhighlight lang~~="~~lua~~">
	~~function consoleGive~~ ( ~~thePlayer, commandName, weaponID, ammo~~ )
	~~local status~~ = ~~giveWeapon ( thePlayer, weaponID, ammo, true ) -- attempt to give the weapon, forcing it as selected weapon~~
	~~if ( not status ) then -- if it was unsuccessful~~
	~~outputConsole (~~ "~~Failed to give weapon.~~"~~, thePlayer ) -- tell the player~~
	~~end~~
	~~end~~
	~~addCommandHandler (~~ "~~give~~"~~, consoleGive )~~
	</~~syntaxhighlight~~>


	~~'''Example 3~~:~~''' This example creates a ped in certain coordinates. You can give him a weapon with "give~~ <~~weaponID~~> <~~amount~~>~~" command in console.~~
	<~~syntaxhighlight lang~~="~~lua~~">
	~~ped = createPed( 19, -1634~~.~~5775, 1203~~.~~85, 7.1796 )~~

	~~addCommandHandler( "give",~~
	~~function ( player, command, id, amount )~~
	~~if not tonumber ( id ) then return end~~

	~~if not tonumber ( amount ) then~~
	~~amount = 9001~~
	~~end~~

	~~giveWeapon( ped, id, amount, true )~~
	~~end~~
	)
	</~~syntaxhighlight~~>

	~~==See Also==~~
	~~{{Weapon functions}}~~
	~~[[ru:giveWeapon]]~~

Ccw at 05:39, 28 August 2013

2013-08-28T05:39:08Z

← Older revision		Revision as of 05:39, 28 August 2013
Line 4:		Line 4:
	{{Note\|		{{Note\|
	*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1		*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1
	*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5 ~~or the weapon is the same the peds current weapon~~, the ammo is added		*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5, the ammo is added
	*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the weapon is ~~not the same the peds current weapon~~, the ammo is replaced		*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced
	}}		}}

Ccw at 08:50, 22 January 2013

2013-01-22T08:50:04Z

← Older revision		Revision as of 08:50, 22 January 2013
Line 3:		Line 3:
	giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.		giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.
	{{Note\|		{{Note\|
	*When setting ammo for weapons in slot 0,1,10,11 or 12, the ammo max is 1		*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1
	*When setting ammo for weapons in slot 3,4,5 or the weapon is the same the peds current weapon, the ammo is added		*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5 or the weapon is the same the peds current weapon, the ammo is added
	*When setting ammo for weapons in slot 2,6,7,8,9 and the weapon is not the same the peds current weapon, the ammo is replaced		*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the weapon is not the same the peds current weapon, the ammo is replaced
	}}		}}

Ccw at 08:48, 22 January 2013

2013-01-22T08:48:17Z

← Older revision		Revision as of 08:48, 22 January 2013
Line 2:		Line 2:
	{{Server function}}		{{Server function}}
	giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.		giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.
			{{Note\|
			*When setting ammo for weapons in slot 0,1,10,11 or 12, the ammo max is 1
			*When setting ammo for weapons in slot 3,4,5 or the weapon is the same the peds current weapon, the ammo is added
			*When setting ammo for weapons in slot 2,6,7,8,9 and the weapon is not the same the peds current weapon, the ammo is replaced
			}}

	==Syntax==		==Syntax==

← Older revision		Revision as of 05:39, 28 August 2013
Line 4:		Line 4:
	{{Note\|		{{Note\|
	*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1		*When setting ammo for [[Weapon\|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1
	*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5 ~~or the weapon is the same the peds current weapon~~, the ammo is added		*When setting ammo for [[Weapon\|weapons in slot]] 3,4,5, the ammo is added
	*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the weapon is ~~not the same the peds current weapon~~, the ammo is replaced		*When setting ammo for [[Weapon\|weapons in slot]] 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced
	}}		}}

← Older revision		Revision as of 22:39, 6 September 2024
Line 63:		Line 63:

	==See Also==		==See Also==
	{{Weapon functions}}		{{Weapon functions\|server}}
	[[ru:giveWeapon]]		[[ru:giveWeapon]]
	[[pl:giveWeapon]]		[[pl:giveWeapon]]
	[[pt-br:giveWeapon]]		[[pt-br:giveWeapon]]