five_logs

O core_logs é um recurso standalone e exclusivamente server-side (sem NUI, sem client). Centraliza o registro de ações importantes do servidor (entradas/saídas, ações admin, banco, inventário, prisões, roubos, empregos, etc.) e encaminha para um painel web externo. A integração com os outros recursos é por um único ponto: o export AddLog.

Funcionalidades

Ponto único de log

Toda a integração é feita por um só export: AddLog.

Fila com retry

Processa os eventos numa fila interna com tentativas de reenvio.

Painel web externo

Entrega os logs a um painel externo identificado por token.

Filtros automáticos

Chaves especiais (adminId, playerId, etc.) viram filtros no painel.

Os arquivos server/core.lua e server/queue.lua são distribuídos ofuscados: a lógica de fila/retry/transporte não é editável. A personalização é via config/config.lua (token) e pela forma como cada recurso chama o export.

Dependências

Nenhuma declarada. Quem consome usa a guarda:

if GetResourceState("five_logs") == "started" then
    exports["five_logs"]:AddLog(category, data)
end

Configuração

config/config.lua — Token do painel

CoreLogs = {}
CoreLogs.Token = "SEU-TOKEN"   -- token que vincula o servidor ao painel web (troque pelo real)

Comandos

Não registra nenhum comando de chat. Toda a interação é feita pelo export AddLog (server-side).

Localizações

Não possui pontos no mapa. É um recurso standalone, exclusivamente server-side (sem NUI nem client), portanto não usa peds, blips, lojas, garagens nem zonas.

Exports

`AddLog(category, data)`

Registra um evento. Fire-and-forget (não bloqueia, não precisa de pcall). Só existe no server.

exports["five_logs"]:AddLog(category, data)

Parâmetro	Tipo	Descrição
`category`	string	Tipo do evento. Convenção: MAIÚSCULAS, sem espaços/acentos (ex.: `BAN`, `PRISAO`, `ENTROU`).
`data`	table	Dados do log. 5 chaves têm tratamento especial (viram filtros no painel).

Chaves especiais de data: message (frase principal, já montada com nomes/IDs reais), adminName, adminId (number), playerName, playerId (number). Qualquer outra chave é exibida como “dado extra”. Exemplo real:

exports["five_logs"]:AddLog("PRISAO", {
    message = vRP.FullName(Officer).." #"..Officer.." prendeu "..vRP.FullName(Passport).." #"..Passport,
    playerName = vRP.FullName(Passport),
    playerId = parseInt(Passport),
    Policial = vRP.FullName(Officer),
    Pena = Services.." minutos",
})

Padrão de wrapper local usado em vários recursos:

local function CoreLog(category, data)
    if GetResourceState("five_logs") == "started" then
        exports["five_logs"]:AddLog(category, data)
    end
end

É o único export do recurso.

Customização

Token: CoreLogs.Token em config/config.lua.
O que é logado: definido nos recursos que chamam AddLog, escolha category (reaproveite as existentes para consistência: ENTROU, SAIU, SALARIO, MORTE, PRISAO, MULTA, BAN, KICK, CRAFTOU, ROUBO-ATM, DESMANCHE, TUNING-*, EMPREGO-*, etc.), monte a message completa e preencha adminId/playerId (geram os filtros do painel).

Começando

Configuração da Base

Referência Rápida

Recursos

Scripts

Framework vRP

Funcionalidades

Ponto único de log

Fila com retry

Painel web externo

Filtros automáticos

Dependências

Configuração

Comandos

Localizações

Exports

`AddLog(category, data)`

Customização

​Funcionalidades

Ponto único de log

Fila com retry

Painel web externo

Filtros automáticos

​Dependências

​Configuração

​Comandos

​Localizações

​Exports

​AddLog(category, data)

​Customização

Funcionalidades

Dependências

Configuração

Comandos

Localizações

Exports

`AddLog(category, data)`

Customização