# giveWeapon (Servidor)

> Dá uma arma com munição a um ped ou jogador.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Servidor
- **Categoria**: Peds
- **URL**: https://wiki.mymp.gg/pt/giveWeapon

## Sintaxe

```lua
bool giveWeapon(ped ped, string weapon [, int ammo = 30, bool setAsCurrent = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `ped` | `ped` | O ped ou jogador. |
| `weapon` | `string` | Nome da arma no metadado de armas do pacote, como `PISTOL` ou `AK47`. Tanto faz maiúsculas ou minúsculas. |
| `ammo` | `int` | Munição a dar. *(padrão: `30`)* |
| `setAsCurrent` | `bool` | `true` para trocar para a arma na hora. *(padrão: `false`)* |

## Retorno

`true` se a arma foi dada. `false` se o nome da arma for desconhecido, se a munição for negativa ou se o elemento não for um ped nem um jogador.

Se o ped já tem a mesma arma no slot dela, a munição é somada. Uma arma diferente no mesmo slot é substituída. A munição de um slot fica limitada a 99999.

## Exemplo

```lua
addEventHandler("onPlayerSpawn", root, function()
    giveWeapon(source, "PISTOL", 60, true)
    giveWeapon(source, "KNIFE", 1)
end)
```

### Vindo do MTA

Recebe o nome da arma em vez do id.

## Veja também

- [getPedWeapon (Servidor)](https://wiki.mymp.gg/pt/getPedWeapon-server.md): Lê a arma que um ped ou jogador está segurando.
- [setPedArmour (Servidor)](https://wiki.mymp.gg/pt/setPedArmour.md): Define o colete de um ped ou jogador e o envia aos clientes.
- [createPed (Servidor)](https://wiki.mymp.gg/pt/createPed-server.md): Cria um ped no servidor, visto por todos os jogadores.