---
title: "UsePlayerGangZoneCheck | open.mp"
description: "Ativa o callback quando um jogador entra/sai desta zona"
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/UsePlayerGangZoneCheck
language: pt-BR
---

# UsePlayerGangZoneCheck

aviso

Esta função foi adicionada no omp v1.1.0.2612 e não funcionará em versões anteriores!

## Descrição

Ativa o callback quando um jogador entra/sai desta zona.

| Nome | Descrição |
| --- | --- |
| playerid | O ID do jogador para o qual você deseja ativar o acionamento de callback quando o jogador entra/sai desta zona. |
| zoneid | O ID da zona do jogador para ativar a detecção de área. |
| bool:enable | A detecção de entrada deve ser iniciada ou interrompida? (`true`/`false`) |

## Retornos

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

**false** - Falha na execução da função. A gangzone especificada não existe.

## Exemplos

```c
// Esta variável é usada para armazenar o id da gangzone
// para que possamos usá-lo em todo o script
new gGangZoneID[MAX_PLAYERS] = {INVALID_GANG_ZONE, ...};

public OnPlayerConnect(playerid)
{
    // Crie a zona de gangue
    gGangZoneID[playerid] = CreatePlayerGangZone(playerid, 2236.1475, 2424.7266, 2319.1636, 2502.4348);

    // Habilitado o retorno de chamada quando um jogador entra em /leaves nesta zona
    UsePlayerGangZoneCheck(playerid, gGangZoneID[playerid], true);
}

public OnPlayerEnterPlayerGangZone(playerid, zoneid)
{
    if (zoneid == gGangZoneID[playerid])
    {
        new string[64];
        format(string, sizeof(string), "You are entering player gangzone %i", zoneid);
        SendClientMessage(playerid, 0xFFFFFFFF, string);
    }
    return 1;
}

public OnPlayerLeavePlayerGangZone(playerid, zoneid)
{
    if (zoneid == gGangZoneID[playerid])
    {
        new string[64];
        format(string, sizeof(string), "You are leaving player gangzone %i", zoneid);
        SendClientMessage(playerid, 0xFFFFFFFF, string);
    }
    return 1;
}
```

## Callbacks Relacionadas

Os retornos de chamada a seguir podem ser úteis, pois estão relacionados a esta função de uma forma ou de outra.

-   [OnPlayerEnterPlayerGangZone](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerEnterPlayerGangZone): Este callback é chamado quando um jogador entra em uma gangzone de jogador.
-   [OnPlayerLeavePlayerGangZone](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerLeavePlayerGangZone): Este callback é chamado quando um jogador sai de uma gangzone de jogador.

## Funções Relacionadas

As funções a seguir podem ser úteis, pois estão relacionadas a esta função de uma forma ou de outra.

-   [CreatePlayerGangZone](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/CreatePlayerGangZone): Criar gangzone de jogador.
-   [PlayerGangZoneDestroy](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneDestroy): Destrua a gangzone do jogador.
-   [PlayerGangZoneShow](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneShow): Mostrar zona de gangue do jogador.
-   [PlayerGangZoneHide](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneHide): Ocultar zona de gangue do jogador.
-   [PlayerGangZoneFlash](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneFlash): Inicia o flash da gangzone do jogador.
-   [PlayerGangZoneStopFlash](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneStopFlash): Interrompe o flash da gangzone do jogador.
-   [PlayerGangZoneGetFlashColour](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneGetFlashColour): Obtenha a cor piscante da gangzone de um jogador.
-   [PlayerGangZoneGetColour](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneGetColour): Obtenha a cor da gangzone de um jogador.
-   [PlayerGangZoneGetPos](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/PlayerGangZoneGetPos): Obtenha a posição de uma gangzone, representada pelas coordenadas minX, minY, maxX, maxY.
-   [IsValidPlayerGangZone](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsValidPlayerGangZone): Verifique se a gangzone do jogador é válida.
-   [IsPlayerInPlayerGangZone](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsPlayerInPlayerGangZone): Verifica se o jogador está na gangzone do jogador.
-   [IsPlayerGangZoneVisible](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsPlayerGangZoneVisible): Verifique se a gangzone do jogador está visível.