From 42d7272a409715c059f337ae6986befa58076547 Mon Sep 17 00:00:00 2001 From: DeviceBlack Date: Fri, 27 Sep 2024 14:36:20 -0300 Subject: [PATCH] Translations and grammatical corrections (#1060) * Translation added * Translation added * Translation added * Grammar corrected * Translation added * Translation added --- .../scripting/functions/CreateVehicle.md | 4 +- .../scripting/functions/DestroyVehicle.md | 43 +++++++++++++ .../scripting/functions/GetPlayerVehicleID.md | 37 +++++++++++ .../functions/GetPlayerVehicleSeat.md | 59 +++++++++++++++++ .../functions/GetVehicleDistanceFromPoint.md | 47 ++++++++++++++ .../scripting/functions/GetVehicleModel.md | 41 ++++++++++++ .../scripting/functions/GetVehiclePos.md | 58 +++++++++++++++++ .../scripting/functions/GetVehicleSeats.md | 37 +++++++++++ .../functions/IsPlayerInAnyVehicle.md | 46 +++++++++++++ .../scripting/functions/IsPlayerInVehicle.md | 50 +++++++++++++++ .../scripting/functions/PutPlayerInVehicle.md | 64 +++++++++++++++++++ .../functions/RemovePlayerFromVehicle.md | 48 ++++++++++++++ 12 files changed, 532 insertions(+), 2 deletions(-) create mode 100644 docs/translations/pt-BR/scripting/functions/DestroyVehicle.md create mode 100644 docs/translations/pt-BR/scripting/functions/GetPlayerVehicleID.md create mode 100644 docs/translations/pt-BR/scripting/functions/GetPlayerVehicleSeat.md create mode 100644 docs/translations/pt-BR/scripting/functions/GetVehicleDistanceFromPoint.md create mode 100644 docs/translations/pt-BR/scripting/functions/GetVehicleModel.md create mode 100644 docs/translations/pt-BR/scripting/functions/GetVehiclePos.md create mode 100644 docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md create mode 100644 docs/translations/pt-BR/scripting/functions/IsPlayerInAnyVehicle.md create mode 100644 docs/translations/pt-BR/scripting/functions/IsPlayerInVehicle.md create mode 100644 docs/translations/pt-BR/scripting/functions/PutPlayerInVehicle.md create mode 100644 docs/translations/pt-BR/scripting/functions/RemovePlayerFromVehicle.md diff --git a/docs/translations/pt-BR/scripting/functions/CreateVehicle.md b/docs/translations/pt-BR/scripting/functions/CreateVehicle.md index 2bc862bd8..32bf7dfe5 100644 --- a/docs/translations/pt-BR/scripting/functions/CreateVehicle.md +++ b/docs/translations/pt-BR/scripting/functions/CreateVehicle.md @@ -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. | @@ -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. diff --git a/docs/translations/pt-BR/scripting/functions/DestroyVehicle.md b/docs/translations/pt-BR/scripting/functions/DestroyVehicle.md new file mode 100644 index 000000000..c61015ea4 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/DestroyVehicle.md @@ -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. diff --git a/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleID.md b/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleID.md new file mode 100644 index 000000000..0be0a7782 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleID.md @@ -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. diff --git a/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleSeat.md b/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleSeat.md new file mode 100644 index 000000000..c45fdb0c7 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleSeat.md @@ -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. diff --git a/docs/translations/pt-BR/scripting/functions/GetVehicleDistanceFromPoint.md b/docs/translations/pt-BR/scripting/functions/GetVehicleDistanceFromPoint.md new file mode 100644 index 000000000..5969edfaf --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/GetVehicleDistanceFromPoint.md @@ -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. diff --git a/docs/translations/pt-BR/scripting/functions/GetVehicleModel.md b/docs/translations/pt-BR/scripting/functions/GetVehicleModel.md new file mode 100644 index 000000000..b43c70cca --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/GetVehicleModel.md @@ -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) diff --git a/docs/translations/pt-BR/scripting/functions/GetVehiclePos.md b/docs/translations/pt-BR/scripting/functions/GetVehiclePos.md new file mode 100644 index 000000000..26817f3a8 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/GetVehiclePos.md @@ -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. diff --git a/docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md b/docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md new file mode 100644 index 000000000..6de174f02 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md @@ -0,0 +1,37 @@ +--- +title: GetVehicleSeats +description: Gets the number of seats in the vehicle. +tags: ["vehicle"] +--- + + + +## 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. diff --git a/docs/translations/pt-BR/scripting/functions/IsPlayerInAnyVehicle.md b/docs/translations/pt-BR/scripting/functions/IsPlayerInAnyVehicle.md new file mode 100644 index 000000000..28b407fed --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/IsPlayerInAnyVehicle.md @@ -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á. + diff --git a/docs/translations/pt-BR/scripting/functions/IsPlayerInVehicle.md b/docs/translations/pt-BR/scripting/functions/IsPlayerInVehicle.md new file mode 100644 index 000000000..527f2dc04 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/IsPlayerInVehicle.md @@ -0,0 +1,50 @@ +--- +title: IsPlayerInVehicle +description: Verifica se um jogador está em um veículo específico. +tags: ["player", "vehicle"] +--- + +## Descrição + +Verifica se um jogador está em um veículo específico. + +| Nome | Descrição | +| --------- | --------------------------------------- | +| playerid | ID do jogador. | +| vehicleid | ID do veículo. Nota: NÃO é o modelid! | + +## Retornos + +**true** - O jogador ESTÁ no veículo. + +**false** - O jogador NÃO está no veículo. + +## Exemplos + +```c +new gSpecialCar; + +public OnGameModeInit() +{ + gSpecialCar = AddStaticVehicle(411, 0.0, 0.0, 5.0, 0.0, -1, -1); + return 1; +} + +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (strcmp(cmdtext, "/gSpecialCar", true) == 0) + { + if (IsPlayerInVehicle(playerid, gSpecialCar)) + { + SendClientMessage(playerid, -1, "Você está no carro especial!"); + } + return 1; + } + return 0; +} +``` + +## Funções Relacionadas + +- [IsPlayerInAnyVehicle](IsPlayerInAnyVehicle): Verifica se um jogador está em qualquer veículo. +- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está. diff --git a/docs/translations/pt-BR/scripting/functions/PutPlayerInVehicle.md b/docs/translations/pt-BR/scripting/functions/PutPlayerInVehicle.md new file mode 100644 index 000000000..ededb9b1e --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/PutPlayerInVehicle.md @@ -0,0 +1,64 @@ +--- +title: PutPlayerInVehicle +description: Coloca um jogador em um veículo. +tags: ["player", "vehicle"] +--- + +## Descrição + +Coloca um jogador em um veículo. + +| Nome | Descrição | +| ---------- | ----------------------------------------- | +| playerid | O ID do jogador a ser colocado no veículo. | +| vehicleid | O ID do veículo onde o jogador será colocado. | +| seatid | O ID do assento onde o jogador será colocado. | + +## Retornos + +**true** - A função foi executada com sucesso. + +**false** - A função falhou ao ser executada. O jogador ou o veículo não existem. + +## Exemplos + +```c +public OnPlayerEnterVehicle(playerid, vehicleid, ispassanger) +{ + PutPlayerInVehicle(playerid, vehicleid, 0); + return 1; +} +``` + +| ID | Assento | +| --- | ---------------------------- | +| 0 | Motorista | +| 1 | Passageiro da frente | +| 2 | Passageiro de trás à esquerda | +| 3 | Passageiro de trás à direita | +| 4+ | Assentos de passageiros (ônibus, etc.) | + +## Notas + +:::tip + +Você pode usar [GetPlayerVehicleSeat](GetPlayerVehicleSeat) em um loop para verificar se um assento está ocupado por algum jogador. + +::: + +:::warning + +Se o assento for inválido ou estiver ocupado, causará um crash quando o jogador SAIR do veículo. + +::: + +## Funções Relacionadas + +- [RemovePlayerFromVehicle](RemovePlayerFromVehicle): Expulsa um jogador de seu veículo. +- [GetPlayerVehicleID](GetPlayerVehicleID): Obtém o ID do veículo em que o jogador está. +- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está. +- [GetVehicleSeats](GetVehicleSeats): Obtém o número de assentos no veículo. + +## Callbacks Relacionados + +- [OnPlayerEnterVehicle](../callbacks/OnPlayerEnterVehicle): Chamado quando um jogador começa a entrar em um veículo. diff --git a/docs/translations/pt-BR/scripting/functions/RemovePlayerFromVehicle.md b/docs/translations/pt-BR/scripting/functions/RemovePlayerFromVehicle.md new file mode 100644 index 000000000..5b936b545 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/RemovePlayerFromVehicle.md @@ -0,0 +1,48 @@ +--- +title: RemovePlayerFromVehicle +description: Remove/ejeta um jogador do seu veículo. +tags: ["player", "vehicle"] +--- + +## Descrição + +Remove/ejeta um jogador do seu veículo. + +| Nome | Descrição | +| ----------- | --------------------------------------------------------- | +| playerid | O ID do jogador a ser removido de seu veículo. | +| bool:force | Remover do veículo instantaneamente. (padrão: `false`) | + +## Retornos + +**true** - A função foi executada com sucesso. + +**false** - A função falhou ao ser executada. Isso significa que o jogador não está conectado. + +## Exemplos + +```c +// Exemplo - Jogadores só podem dirigir veículos se tiverem 10 pontos. +public OnPlayerStateChange(playerid, PLAYER_STATE:newstate, PLAYER_STATE:oldstate) +{ + if (newstate == PLAYER_STATE_DRIVER && GetPlayerScore(playerid) < 10) // PLAYER_STATE_DRIVER = 2 + { + RemovePlayerFromVehicle(playerid); + } + return 1; +} +``` + +## Notas + +:::tip + +- A animação de saída não é sincronizada para outros jogadores. +- Esta função não funcionará quando usada em [OnPlayerEnterVehicle](../callbacks/OnPlayerEnterVehicle), porque o jogador ainda não está no veículo quando o callback é chamado. Use [OnPlayerStateChange](../callbacks/OnPlayerStateChange) em vez disso (veja o exemplo acima). +- Se o jogador estiver em um veículo RC, ele não será removido. (Use o parâmetro `.force = true` ou a função [ClearAnimations](ClearAnimations)) + +::: + +## Funções Relacionadas + +- [PutPlayerInVehicle](PutPlayerInVehicle): Coloca um jogador em um veículo.