Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Cria um veículo no mundo. Pode ser usado no lugar de AddStaticVehicleEx a qualq
| Float:spawnX | A coordenada X do veículo. |
| Float:spawnY | A coordenada Y do veículo. |
| Float:spawnZ | A coordenada Z do veículo. |
| Float:angle | O ângulo de direçao do veículo. |
| Float:angle | O ângulo de direção do veículo. |
| [colour1](../resources/vehiclecolorid) | O ID da cor primária. |
| [colour2](../resources/vehiclecolorid) | O ID da cor secundária. |
| respawnDelay | O tempo de espera até que o veículo reapareça sem um motorista, em segundos. Usar -1 impedirá que o veículo reapareça. |
Expand Down Expand Up @@ -49,7 +49,7 @@ Trens só podem ser adicionados com [AddStaticVehicle](AddStaticVehicle) e [AddS

## Funções Relacionadas

- [DestroyVehicle](DestroyVehicle): Destrói o veículo.
- [DestroyVehicle](DestroyVehicle): Destroi o veículo.
- [AddStaticVehicle](AddStaticVehicle): Adiciona um veículo estático.
- [AddStaticVehicleEx](AddStaticVehicleEx): Adiciona um veículo estático com tempo de reaparecimento customizado.
- [GetVehicleParamsSirenState](GetVehicleParamsSirenState): Verifique se a sirene de um veículo está ligada ou desligada.
Expand Down
43 changes: 43 additions & 0 deletions docs/translations/pt-BR/scripting/functions/DestroyVehicle.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: DestroyVehicle
description: Destroi um veículo.
tags: ["vehicle"]
---

## Descrição

Destroi um veículo. Ele desaparecerá instantaneamente.

| Nome | Descrição |
| --------- | -------------------------------- |
| vehicleid | O ID do veículo a ser destruído. |

## Retornos

**true** - A função foi executada com sucesso.

**false** - A função falhou ao ser executada. O veículo não existe.

## Exemplos

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
if (strcmp(cmdtext, "/destroyveh", true) == 0)
{
if (IsPlayerInAnyVehicle(playerid))
{
new vehicleid = GetPlayerVehicleID(playerid);
DestroyVehicle(vehicleid);
}
return 1;
}
return 0;
}
```

## Funções Relacionadas

- [CreateVehicle](CreateVehicle): Cria um veículo.
- [RemovePlayerFromVehicle](RemovePlayerFromVehicle): Expulsa um jogador de seu veículo.
- [SetVehicleToRespawn](SetVehicleToRespawn): Faz um veículo reaparecer.
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: GetPlayerVehicleID
description: Esta função obtém o ID do veículo em que o jogador está atualmente.
tags: ["player", "vehicle"]
---

## Descrição

Esta função obtém o ID do veículo em que o jogador está atualmente.

**Nota:** NÃO é o ID do modelo do veículo. Veja [GetVehicleModel](GetVehicleModel) para isso.

| Nome | Descrição |
| --------- | ---------------------------------------------------------------- |
| playerid | O ID do jogador no veículo do qual você deseja obter o ID |

## Retornos

ID do veículo ou **0** se não estiver em um veículo

## Exemplos

```c
// Adiciona 10x Nitro se o jogador estiver em um carro. Pode ser chamado em um comando.
new vehicleId = GetPlayerVehicleID(playerid);
if (vehicleId != 0)
{
AddVehicleComponent(vehicleId, 1010);
}
```

## Funções Relacionadas

- [IsPlayerInVehicle](IsPlayerInVehicle): Verifica se um jogador está em um determinado veículo.
- [IsPlayerInAnyVehicle](IsPlayerInAnyVehicle): Verifica se um jogador está em qualquer veículo.
- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está.
- [GetVehicleModel](GetVehicleModel): Obtém o ID do modelo de um veículo.
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: GetPlayerVehicleSeat
description: Descobre em qual assento um jogador está.
tags: ["player", "vehicle"]
---

## Descrição

Descobre em qual assento um jogador está.

| Nome | Descrição |
| --------- | ----------------------------------------------- |
| playerid | O ID do jogador do qual você quer saber o assento. |

## Retornos

O ID do assento em que o jogador está.

**-1** indica que não está em um veículo, **0** é o motorista, **1** é o passageiro da frente, e **2** e **3** são os passageiros traseiros.

## Exemplos

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
if (strcmp(cmdtext, "/myseat", true) == 0)
{
new
playerSeat = GetPlayerVehicleSeat(playerid);

// Como você pode descartar suas informações.
if (playerSeat == 128)
{
return SendClientMessage(playerid, 0xFFFFFFFF, "Um erro impediu que retornássemos o ID do assento.");
}

new
string[24];

format(string, sizeof(string), "Seu assento: %i", playerSeat);
SendClientMessage(playerid, 0xFFFFFFFF, string);
return 1;
}
return 0;
}
```

| ID | Assento |
| --- | ------------------------------ |
| 0 | Motorista |
| 1 | Passageiro da frente |
| 2 | Passageiro traseiro esquerdo |
| 3 | Passageiro traseiro direito |
| 4+ | Assentos de passageiros (coaches etc.) |

## Funções Relacionadas

- [GetPlayerVehicleID](GetPlayerVehicleID): Obtém o ID do veículo em que o jogador está.
- [PutPlayerInVehicle](PutPlayerInVehicle): Coloca um jogador em um veículo.
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: GetVehicleDistanceFromPoint
description: Esta função pode ser usada para calcular a distância (como um float) entre um veículo e outra coordenada do mapa.
tags: ["vehicle"]
---

## Descrição

Esta função pode ser usada para calcular a distância (como um float) entre um veículo e outra coordenada do mapa. Isso pode ser útil para detectar quão longe um veículo está de um local.

| Nome | Descrição |
| --------- | -------------------------------------------------- |
| vehicleid | O ID do veículo para calcular a distância. |
| Float:x | A coordenada X do mapa. |
| Float:y | A coordenada Y do mapa. |
| Float:z | A coordenada Z do mapa. |

## Retornos

Um float contendo a distância do ponto especificado nas coordenadas.

## Exemplos

```c
/* quando o jogador digitar 'vendingmachine' na caixa de chat, ele verá isso.*/
public OnPlayerText(playerid, text[])
{
if (strcmp(text, "vendingmachine", true) == 0)
{
new
string[64],
vehicleid = GetPlayerVehicleID(playerid);

new
Float:distance = GetVehicleDistanceFromPoint(vehicleid, 237.9, 115.6, 1010.2);

format(string, sizeof(string), "Você está a %.2f de nossa máquina de vendas.", distance);
SendClientMessage(playerid, 0xA9C4E4FF, string);
}
return 0;
}
```

## Funções Relacionadas

- [GetPlayerDistanceFromPoint](GetPlayerDistanceFromPoint): Obtém a distância entre um jogador e um ponto.
- [GetVehiclePos](GetVehiclePos): Obtém a posição de um veículo.
41 changes: 41 additions & 0 deletions docs/translations/pt-BR/scripting/functions/GetVehicleModel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: GetVehicleModel
description: Obtém o ID do modelo de um veículo.
tags: ["vehicle"]
---

## Descrição

Obtém o ID do modelo de um veículo.

| Nome | Descrição |
| --------- | ---------------------------------------- |
| vehicleid | O ID do veículo para obter o modelo. |

## Retornos

O [ID do modelo do veículo](../resources/vehicleid), ou **0** se o veículo não existir.

## Exemplos

```c
public OnPlayerEnterVehicle(playerid, vehicleid, ispassenger)
{
if (GetVehicleModel(vehicleid) == 411) // 411 é o modelo do Infernus
{
SendClientMessage(playerid, 0xFFFFFFFF, "Nice Infernus!");
}
return 1;
}
```

## Funções Relacionadas

- [GetPlayerVehicleID](GetPlayerVehicleID): Obtém o ID do veículo em que o jogador está.
- [GetVehiclePos](GetVehiclePos): Obtém a posição de um veículo.
- [GetVehicleZAngle](GetVehicleZAngle): Verifica o ângulo atual de um veículo.
- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está.

## Recursos Relacionados

- [IDs de Veículos](../resources/vehicleid)
58 changes: 58 additions & 0 deletions docs/translations/pt-BR/scripting/functions/GetVehiclePos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: GetVehiclePos
description: Obtém a posição de um veículo.
tags: ["vehicle"]
---

## Descrição

Obtém a posição de um veículo.

| Nome | Descrição |
| ---------- | ----------------------------------------------------------------------- |
| vehicleid | O ID do veículo para obter a posição. |
| &Float:x | Uma variável float para armazenar a coordenada X, passada por referência. |
| &Float:y | Uma variável float para armazenar a coordenada Y, passada por referência. |
| &Float:z | Uma variável float para armazenar a coordenada Z, passada por referência. |

## Retornos

**true** - A função foi executada com sucesso.

**false** - A função falhou ao ser executada. O veículo especificado não existe.

## Exemplos

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
if (strcmp(cmdtext, "/vehpos", true) == 0)
{
new vehicleid = GetPlayerVehicleID(playerid);

// se vehicleid for igual a 0
if (vehicleid == 0)
{
return SendClientMessage(playerid, -1, "Você não está em nenhum veículo!");
}

new
Float:vehX, Float:vehY, Float:vehZ,
string[128];

GetVehiclePos(vehicleid, vehX, vehY, vehZ);
format(string, sizeof(string), "As posições atuais do veículo são: %f, %f, %f", vehX, vehY, vehZ);
SendClientMessage(playerid, 0xFFFFFFFF, string);
return 1;
}

return 0;
}
```

## Funções Relacionadas

- [GetVehicleDistanceFromPoint](GetVehicleDistanceFromPoint): Obtém a distância entre um veículo e um ponto.
- [SetVehiclePos](SetVehiclePos): Define a posição de um veículo.
- [GetVehicleZAngle](GetVehicleZAngle): Verifica o ângulo atual de um veículo.
- [GetVehicleRotationQuat](GetVehicleRotationQuat): Obtém o quaternário de rotação de um veículo.
37 changes: 37 additions & 0 deletions docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: GetVehicleSeats
description: Gets the number of seats in the vehicle.
tags: ["vehicle"]
---

<VersionWarn version='omp v1.1.0.2612' />

## Description

Gets the number of seats in the vehicle.

| Name | Description |
| --------- | ------------------ |
| modelid | ID of the vehicle model. |

## Return Values

Returns the number of seats.

**255** if the model is invalid.

## Examples

```c
new vehicleid = GetPlayerVehicleID(playerid);
new modelid = GetVehicleModel(vehicleid);
new seats = GetVehicleSeats(modelid);

new string[64];
format(string, sizeof(string), "Number of seats in this vehicle: %d", seats);
SendClientMessage(playerid, -1, string);
```

## Related Functions

- [PutPlayerInVehicle](PutPlayerInVehicle): Puts a player in a vehicle.
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
title: IsPlayerInAnyVehicle
description: Verifica se um jogador está dentro de qualquer veículo (como motorista ou passageiro).
tags: ["player", "vehicle"]
---

## Descrição

Verifica se um jogador está dentro de qualquer veículo (como motorista ou passageiro).

| Nome | Descrição |
| --------- | ----------------------------- |
| playerid | O ID do jogador a ser verificado. |

## Retornos

**true** - O jogador está em um veículo.

**false** - O jogador não está em um veículo.

## Exemplos

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
if (strcmp(cmdtext, "/invehicle", true) == 0)
{
if (IsPlayerInAnyVehicle(playerid))
{
SendClientMessage(playerid, 0x00FF00FF, "Você está em um veículo.");
}
else
{
SendClientMessage(playerid, 0xFF0000FF, "Você não está em nenhum veículo.");
}
return 1;
}
return 0;
}
```

## Funções Relacionadas

- [IsPlayerInVehicle](IsPlayerInVehicle): Verifica se um jogador está em um determinado veículo.
- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está.

Loading