> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fivenetwork.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# five-fuga

> Suporte administrativo ao evento de fuga (prison escape): salva/restaura um ponto de spawn do veículo e turbina a velocidade do veículo durante a perseguição.

O **five-fuga** é um recurso simples para **administradores** darem suporte a um evento de fuga. Não tem NUI, banco de dados nem exports. Toda a funcionalidade é por comandos restritos ao grupo `Admin`, atuando sobre o veículo em que o admin está.

## Funcionalidades

<CardGroup cols={2}>
  <Card title="Salvar ponto de spawn" icon="floppy-disk">
    Salva a posição (coords + rotação) do veículo como ponto de spawn.
  </Card>

  <Card title="Restaurar e reparar" icon="rotate-left">
    Teleporta o veículo de volta ao ponto salvo, reparando-o totalmente.
  </Card>

  <Card title="Turbinar veículo" icon="gauge-high">
    Aumenta velocidade/potência do veículo para a fase de corrida.
  </Card>
</CardGroup>

<Note>
  A posição salva fica em memória no client (por sessão), sem persistência.
</Note>

***

## Dependências

<CardGroup cols={2}>
  <Card title="vrp" icon="cube">
    Framework base (`vRP.HasGroup`).
  </Card>
</CardGroup>

<Info>
  Opcionais: `five_logs` (log das ações), `Notify` (notificações).
</Info>

***

## Configuração

**Sem arquivos de config.** Os valores são fixos no código:

* Permissão: `vRP.HasGroup(Passport, "Admin", 1)` (grupo `Admin`, nível 1).
* `/correr` aplica: `SetEntityMaxSpeed(2500.0)`, `SetVehicleEnginePowerMultiplier(200.0)`, `SetVehicleEngineTorqueMultiplier(200.0)`.
* `/voltarspawn` repara: vida da lataria/motor/tanque = `1000.0`, sujeira = `0.0`, e corrige dano/deformação.

***

## Comandos

Todos restritos ao grupo `Admin` (nível 1).

| Comando        | Descrição                                                       |
| -------------- | --------------------------------------------------------------- |
| `/salvarspawn` | Salva a posição atual do veículo como ponto de spawn.           |
| `/voltarspawn` | Teleporta o veículo para a posição salva e o repara totalmente. |
| `/correr`      | Aumenta velocidade, potência e torque do veículo.               |

***

## Localizações

O recurso não tem coordenadas fixas no código (sem NPCs, blips, lojas, zonas ou markers). O único ponto usado é dinâmico: o `/salvarspawn` grava em memória a posição atual do veículo do admin (via `GetEntityCoords`) e o `/voltarspawn` teleporta de volta para essa posição salva, sem persistência.

***

## Eventos

Eventos server → client que executam as ações dos comandos.

| Evento        | Direção         | Descrição                          |
| ------------- | --------------- | ---------------------------------- |
| `fuga:salvar` | Server → client | Salva a posição atual do veículo.  |
| `fuga:voltar` | Server → client | Teleporta e repara o veículo.      |
| `fuga:correr` | Server → client | Aplica velocidade/potência/torque. |

<Info>
  Consome `Notify` para as notificações.
</Info>

***

## Customização

Como não há config, ajuste editando o código:

* **Permissão:** `vRP.HasGroup(Passport,"Admin",1)` em `server-side/core.lua`.
* **Desempenho na corrida:** valores em `fuga:correr` (`client-side/core.lua`).
* **Reparo:** valores em `fuga:voltar`.
* **Logs:** ações `SALVARSPAWN`/`VOLTARSPAWN`/`CORRER` em `five_logs` (se ativo).