PT-BR/giveWeapon

Template:BR/Funcao servidor Esta função dá uma determinada arma para um determinado jogador ou ped. Há um argumento opcional que se refere à munição. Por exemplo, uma arma branca, ou arma de mão que não são disparados ou não disparam projéteis não precisam de munição.

	Nota: Quando definir munição para as armas no slot 0,1,10,11 or 12, a munição máxima será 1 Quando definir munição para as armas no slot 3,4,5, a munição será adicionada Quando definir munição para as armas no slot 2,6,7,8,9 e a arma deste slot for trocada, a munição é realocada

Sintaxe

bool giveWeapon ( ped thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )

Argumentos Necessários

• thePlayer: O jogador or ped que receberá a arma.
• weapon: Um número inteiro representando o ID da arma. Clique aqui para uma lista de possíveis ID's de armas.

Argumentos Opcionais

NOTA: Ao usar argumentos opcionais, pode ser necessário fornecer todos os argumentos anteriores ao que você deseja usar. Para obter mais informações sobre argumentos opcionais, consulte Argumentos Opcionais.

• ammo: Um número inteiro representando a quantidade da munição para a arma. Para armas que não precisam de munição, como as armas brancas, este argumento deve ser pelo menos 1.
• setAsCurrent: Um valor booleano determinando se a arma vai ou não set definida como atual para o jogador, ou seja, se true, assim que o jogador receber a arma, o jogador vai segurar esta arma.

Retorno

Retorna true se a arma foi adquirida com sucesso, senão false.

Exemplo

Examplo 1: Este exemplo dá uma M4 para o jogador com 200 de munição assim que ele spawnar.

function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
    giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo
end
addEventHandler ( "onPlayerSpawn", root, giveWeaponsOnSpawn ) -- attach the event handler

Example 2: This example adds a "give" command in console which allows giving of any weapon by entering "give <id> <amount>".

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 )

Example 3: This example creates a ped in certain coordinates. You can give him a weapon with "give <weaponID> <amount>" command in console.

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
)

See Also

• getWeaponProperty
• getPickupWeapon
• getOriginalWeaponProperty
• getSlotFromWeapon
• getWeaponIDFromName
• getWeaponNameFromID
• setWeaponAmmo
• setWeaponProperty