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

# Logger

> Documentação oficial do sistema de auditoria e segurança RKT.

# Introdução

O **RKT Logger** é uma ferramenta de auditoria avançada para FiveM que combina registros detalhados de eventos com um sistema inteligente de monitoramento de integridade. Ele foi projetado para fornecer aos administradores uma visão clara e incontestável de todas as ações críticas realizadas no servidor.

<CardGroup cols={2}>
  <Card title="Auditoria Forense" icon="magnifying-glass">
    Rastreamento de IP, Localização, VPN e Hardware IDs.
  </Card>

  <Card title="Monitoramento Ativo" icon="eye">
    Registro de movimentações, combate e integridade de eventos.
  </Card>
</CardGroup>

## Instalação Rápida

1. **Download**: Coloque a pasta `rkt_logger` no diretório `resources` do seu servidor.
2. **Dependências**: Requer `ox_lib` para funções de rede e utilitários.
3. **Webhooks**: Configure seus canais de auditoria no `config.lua`.
4. **Inicialização**: Adicione `ensure rkt_logger` ao seu arquivo de configuração do servidor.

***

# Configuração de Auditoria

O `config.lua` permite definir quais ações devem ser logadas e para onde os relatórios devem ser enviados.

### Webhooks de Relatórios

```lua theme={null}
Config.Webhook = {
    Enabled = true,
    URLs = {
        Anticheat    = "WEBHOOK_PARA_ALERTAS_CRITICOS",
        Connections  = "WEBHOOK_PARA_CONEXOES",
        Deaths       = "WEBHOOK_PARA_OBITOS",
        Evidence     = "WEBHOOK_PARA_PRINTS_DE_EVIDENCIA",
    }
}
```

***

# Módulos de Monitoramento

O sistema audita diversos comportamentos para garantir a conformidade com as regras do servidor.

### Auditoria de Movimentação

<CardGroup cols={3}>
  <Card title="Desvios de Coordenadas" icon="route" />

  <Card title="Velocidades Atípicas" icon="gauge-high" />

  <Card title="Salto Vertical" icon="up-long" />
</CardGroup>

### Integridade de Eventos e Entidades

* **Fluxo de Spawns**: Monitora a criação massiva de entidades para evitar sobrecarga.
* **Auditoria de Explosões**: Registra e previne o uso de explosões não autorizadas.
* **Segurança de Token**: Validação de origem para todos os eventos críticos disparados pelo cliente.

***

# Integração (Bridge)

O `server/bridge.lua` é o ponto de conexão com o seu framework.

| Função                         | Finalidade                                               |
| :----------------------------- | :------------------------------------------------------- |
| `Bridge.GetIdentifier(source)` | Obtém a licença ou CitizenID do jogador.                 |
| `Bridge.IsStaff(source)`       | Verifica permissões para ignorar auditorias específicas. |
| `Bridge.GetPlayerName(source)` | Retorna o nome de registro do personagem.                |

***

# Captura de Evidências (Evidence)

Para incidentes críticos, o logger utiliza o `screenshot-basic` para anexar uma prova visual ao relatório.

<Info>
  As capturas são enviadas automaticamente para o webhook definido em
  `Evidence`, facilitando a análise da equipe de staff.
</Info>