🖧 Funções Server
Esta página documenta todas as funções disponíveis no lado do servidor que você pode usar ou personalizar.🔐 Permissões (permissions.lua)
Sistema de controle de acesso às funcionalidades.
Permissions.init
Inicializa o módulo com o framework.Permissions.check
Verifica se um jogador tem permissão para uma ação.
Retorno:
boolean
Exemplo:
💰 Recompensas (rewards.lua)
Sistema de cálculo e entrega de prêmios.
Rewards.init
Inicializa o módulo com o framework.Rewards.positionBonus
Tabela de bônus por posição final.Rewards.calculate
Calcula o prêmio final baseado na posição.
Retorno:
number - Prêmio calculado
Fórmula:
Rewards.giveSuccessReward
Entrega a recompensa ao jogador que completou com sucesso.- VRP
- Outros
Entrega como item:
Rewards.applyFailPenalty
Aplica penalidade ao jogador que falhou.🚔 Polícia (police.lua)
Sistema de integração com policiais.
Police.init
Inicializa o módulo com o framework.Police.emitEvent
Dispara um evento para todos os policiais online.
Exemplo:
Police.updateRacePosition
Atualiza a posição de um corredor para os policiais.📢 Webhooks (webhooks.lua)
Sistema de notificações Discord.
emitWebhook (interno)
Função base para enviar webhooks.Webhooks.emitRaceStart
Envia notificação quando uma corrida inicia.Webhooks.emitRaceFinish
Envia notificação quando um jogador finaliza.✅ Validators (validators.lua)
Validações do lado do servidor.
Validators.init
Inicializa com dependências.Validators.canEnterRace
Valida se o jogador pode entrar na corrida.- ✅ Permissão para participar de corridas
- ✅ Possui o item necessário (se configurado)
boolean
Validators.nicknameValidation
Valida o nickname do jogador.- ✅ Tamanho entre 3 e 20 caracteres
- ✅ Não está vazio
- ✅ Cooldown respeitado (para atualizações)
params:
📦 Itens (items.lua)
Sistema de verificação de itens.
Items.tryGet
Tenta obter um item do inventário do jogador.
Retorno:
boolean - Se o jogador possui o item
🚗 Veículos (vehicles.lua)
Funções relacionadas a veículos.
🔗 Framework (framework.lua)
Integração com diferentes frameworks.
Framework.getName
Retorna o nome do framework detectado.Framework.getPlayer
Obtém o objeto do jogador do framework.Framework.getPermissionLevel
Obtém o nível de permissão do jogador.string - "USER" ou "ADMIN"
Framework.getPlayersByPermission
Lista todos os jogadores com determinada permissão.🎁 Itens Coletáveis Server (collectable_items.lua)
Lógica de sorteio e gerenciamento de power-ups.
CollectableItems.reachCheckpoint
Processa a chegada em um checkpoint e sorteia item.- Verifica se sistema está habilitado
- Verifica regras de
sortFor - Verifica se jogador já tem item (
replaceItem) - Sorteia item baseado no algoritmo
- Entrega item ao jogador
CollectableItems.clearRaceData
Limpa dados de uma corrida finalizada.CollectableItems.useItem
Processa o uso de um item pelo jogador.boolean, string? - Sucesso e mensagem de erro opcional

