ticket

O ticket é um sistema de atendimento (helpdesk) com NUI. Jogadores abrem chamados por categoria e a equipe responde, assume e gerencia tudo em uma central administrativa que também reúne ferramentas de moderação. Duas interfaces NUI a partir do mesmo arquivo, com comunicação via Tunnel (ticket).

Funcionalidades

Central do Jogador

OpenTickets: abre/visualiza os próprios chamados e troca mensagens.

Central Administrativa

OpenAdmin: exclusiva do grupo Config.Administrator; lista todos os tickets e habilita ações de staff.

Categorias e cooldowns

Chamados organizados por categoria, com limites por jogador e intervalos configuráveis.

Ferramentas de moderação

Spectate, revive, freeze, goto/bring, gerência de grupos, banco, gemas e ações de servidor.

O acesso é pelo menu dynamic (não há comando de chat): quando ticket está started, o dynamic dispara ticket:Dynamic e adiciona o menu “Atendimento”. Permissões: jogador comum recebe Tickets = true; admin recebe todas as flags de Characters e Server.

Dependências

vRP

Framework base

oxmysql

Persistência dos tickets

dynamic

Entrada do menu

discord

Webhook("Print")

Eventos externos consumidos: paramedic:Reset, hud:RemoveGemstone, Notify, hud:Active.

Configuração

shared-side/shared.lua — tabela Config

Chave	Padrão	Descrição
`Administrator`	`"Admin"`	Grupo com acesso à central administrativa.
`MaxTicketCategory`	`1`	Máx. de tickets abertos por jogador/categoria (0 = ilimitado).
`Cooldown`	`10`	Intervalo (s) entre mensagens.
`Categories`	`Dúvidas/Problemas/Outros`	Categorias válidas.
`MessagesLoad`	`10`	Mensagens carregadas por scroll.
`CreateInterval`	`600`	Intervalo (s) para abrir novo ticket.

Eventos

Interfaces Tunnel

Interface ticket (servidor), consumida pela NUI/cliente para todas as operações de ticket e moderação.

Cliente

Evento	Descrição
`ticket:Dynamic`	Adiciona o item “Atendimento” ao menu dynamic.
`ticket:Opened`	Abre a central (jogador ou administrativa, conforme `Admin`).
`ticket:Notify`	Exibe notificação relacionada a tickets.
`ticket:Update`	Atualiza os dados/tabela exibidos na NUI.
`ticket:Freeze`	Congela/descongela o jogador (ação de staff).
`ticket:Waypoint`	Cria um waypoint guiado até as coordenadas.
`ticket:StopWaypoint`	Interrompe o waypoint ativo.
`ticket:initSpectate`	Inicia o modo espectador sobre o alvo.
`ticket:resetSpectate`	Encerra o modo espectador.

Recebidos no servidor

Evento	Descrição
`Disconnect`	Trata a saída do jogador (limpeza de estado).

NUI Callbacks

Encaminham para funções Tunnel Core.* no servidor. Jogador / tickets

Callback	Descrição
`Tickets`	Lista os tickets do jogador.
`Ticket`	Abre um ticket específico.
`LoadMessages`	Carrega mais mensagens (scroll).
`SendMessage`	Envia mensagem (valida cooldown e 2000 chars).
`CreateTicket`	Cria ticket (valida `CreateInterval`/`MaxTicketCategory`/categoria).
`Config`	Retorna configuração/categorias para a NUI.
`Close`	Fecha a interface.

Staff / gestão do ticket

Callback	Descrição
`AssumeTicket`	Staff assume o atendimento.
`CloseTicket`	Fecha o ticket.
`ReopenTicket`	Reabre um ticket fechado.
`ChangeSubject`	Altera o assunto.
`ChangeCategory`	Altera a categoria.
`AddParticipant`	Adiciona participante ao ticket.
`RemoveParticipant`	Remove participante do ticket.
`SendPrivateMessage`	Envia mensagem privada a um jogador.

Ferramentas de moderação

Callback	Descrição
`Characters`	Lista personagens/jogadores online.
`Character`	Detalhes de um personagem.
`Spectate`	Espectar o alvo.
`Revive`	Reanima o alvo.
`Kill`	Mata o alvo.
`Freeze`	Congela/descongela o alvo.
`Goto`	Teleporta o staff até o alvo.
`Bring`	Traz o alvo até o staff.
`Waypoint`	Cria waypoint guiado até o alvo.
`SetPed`	Define o ped/modelo do alvo.
`ClearInventory`	Limpa o inventário do alvo.
`AddGroup`	Adiciona grupo/permissão ao alvo.
`RemoveGroup`	Remove grupo/permissão do alvo.
`Bank`	Ajusta o saldo bancário do alvo.
`Gemstone`	Ajusta as gemas do alvo.
`Screenshot`	Captura a tela do alvo.
`Server`	Ações gerais de servidor.
`SetTime`	Define o horário do jogo.
`SetWeather`	Define o clima (whitelist `WeatherWhitelist`).

Ações de staff exigem vRP.HasPermission(Passport, Config.Administrator).

Banco de Dados

Tabela	Colunas
`tickets_creative`	`id`, `Subject`, `Category`, `Assumed` (passaporte do staff), `Status` (1=aberto, 0=fechado), `CreatedAt`/`ClosedAt`, `Author`, `Members` (JSON), `MessageAdmin`.
`tickets_creative_messages`	`id`, `Ticket` (FK ON DELETE CASCADE), `Type` (`User`/`System`), `Author`, `Staff`, `Message`, `CreatedAt`.

Customização

Categorias, limites e cooldowns em shared-side/shared.lua.
Grupo de acesso da equipe em Config.Administrator (deve existir como permissão vRP).
Whitelist de climas do SetWeather fixa em server-side/core.lua (WeatherWhitelist).

Começando

Configuração da Base

Referência Rápida

Recursos

Scripts

Framework vRP

Funcionalidades

Central do Jogador

Central Administrativa

Categorias e cooldowns

Ferramentas de moderação

Dependências

vRP

oxmysql

dynamic

discord

Configuração

Eventos

Interfaces Tunnel

Cliente

Recebidos no servidor

NUI Callbacks

Banco de Dados

Customização

​Funcionalidades

Central do Jogador

Central Administrativa

Categorias e cooldowns

Ferramentas de moderação

​Dependências

vRP

oxmysql

dynamic

discord

​Configuração

​Eventos

​Interfaces Tunnel

​Cliente

​Recebidos no servidor

​NUI Callbacks

​Banco de Dados

​Customização

Funcionalidades

Dependências

Configuração

Eventos

Interfaces Tunnel

Cliente

Recebidos no servidor

NUI Callbacks

Banco de Dados

Customização