Scripts 2026-04-15

Agency-Reports: a ferramenta de relatos de admin para FiveM que é mesmo usada

TDYSKY

TDYSKY

Founder & Lead Developer at Agency Scripts

O estado dos relatos em FiveM em 2026

A maioria dos servidores continua a usar tickets no Discord ou um comando de chat dentro do jogo para os relatos de jogadores. Ambos estão partidos. O Discord não tem qualquer contexto do jogador; um comando de chat perde tudo assim que o jogador que fez o relato se desliga. Os admins acabam por andar a fazer de detetives quando deviam estar a fazer de árbitros. O Agency-Reports é a ferramenta que gostaríamos de ter tido quando geríamos o nosso próprio servidor.

Contexto capturado automaticamente

Quando um jogador submete um relato, capturamos automaticamente as coordenadas dele, os IDs dos jogadores por perto, a arma equipada, o veículo e os últimos 60 segundos de chat. Os admins veem a cena, não só a acusação. Só isto já corta o tempo de investigação para metade.

Encaminhamento inteligente

Os relatos são encaminhados para o staff consoante o tipo, a prioridade e a equipa que está online. Batota vai para admins técnicos, disputas de RP para admins de RP, assédio para quem estiver de serviço. Relatos offline ficam em fila e lançam alertas no Discord. Acabou o 'alguém está a tratar disto?' no chat do staff.

Acompanhamento da resolução

Cada relato tem um estado: aberto, assumido, em investigação, resolvido, fechado. Os admins escrevem notas de resolução que ficam ligadas ao relato para sempre. Seis meses depois, quando o mesmo jogador submete outro relato, o histórico dele está a um clique. É assim que as equipas de moderação profissionais funcionam em MMOs - em FiveM já vai atrasado.

Ciclo de feedback para o jogador

Quando um relato é resolvido, quem o submeteu recebe uma mensagem curta a explicar o que aconteceu. Mesmo que a resposta seja 'analisado, não foi necessária qualquer ação', os jogadores sentem-se ouvidos em vez de ignorados. As comunidades que se sentem ouvidas mantêm-se fiéis; esse é o verdadeiro mecanismo de retenção por trás de boas ferramentas de moderação.

Instalação e Configuração

Agency-Reports requer oxmysql para armazenar o histórico de relatórios. Os relatórios devem persistir entre sessões do servidor para que os admins possam revisar atividades passadas e rastrear jogadores com múltiplos relatórios ao longo do tempo.

Opções de Configuração

  • Categorias de relatórios — personalize as categorias de relatório para corresponder às regras do seu servidor
  • Cooldown entre relatórios — evita spam de relatórios de jogadores mal-intencionados
  • Notificações de admin — como os admins são alertados sobre novos relatórios
  • Retenção de dados — por quanto tempo os registros de relatórios fechados são mantidos

Compatibilidade com Frameworks

Agency-Reports opera independentemente do framework pois é principalmente uma ferramenta de comunicação entre jogadores e admins. A integração com framework é mínima: usada apenas para autenticação básica do jogador e verificação de cargo de admin.

Reduzindo a Carga dos Admins

O esgotamento dos admins é um problema real nas comunidades do FiveM. Agency-Reports ajuda ao organizar essa carga de trabalho eficientemente: modelos de resposta, ordenação automática, atribuição de relatórios e notificações de acompanhamento para jogadores.

Integração com Discord

Agency-Reports pode enviar webhooks do Discord para novos relatórios críticos. Isso significa que seus admins seniores recebem alertas imediatos para incidentes graves mesmo se não estiverem conectados.

Perguntas Frequentes

  • Os jogadores podem rastrear o status dos seus próprios relatórios? Sim, os jogadores recebem notificações no jogo quando seu relatório é reconhecido e fechado.
  • Os admins podem responder privadamente aos relatórios? Sim, as respostas dos admins podem ser apenas para o remetente do relatório ou públicas.
  • Agency-Reports pode lidar com relatórios de múltiplos servidores? Sim, com um banco de dados compartilhado, os relatórios de todas as instâncias do servidor aparecem em um único painel de admin.

Sobre o Agency Scripts

Agency Scripts é uma coleção de recursos premium do FiveM projetados para servidores de roleplay que levam a imersão a sério. Cada recurso é construído com os mesmos princípios: compatibilidade multi-framework, desempenho otimizado e configuração flexível para se adaptar a qualquer conceito de servidor.

Todos os recursos do Agency estão disponíveis através do sistema de licenças da cfx.re Keymaster. Uma vez comprado, você pode implantar o recurso em qualquer servidor que possua, com suporte ativo disponível através do Discord do Agency Scripts.

Suporte e Comunidade

A comunidade do Agency Scripts inclui milhares de servidores FiveM que usam esses recursos. O Discord oficial é onde os desenvolvedores compartilham suas configurações, fazem perguntas e sugerem novos recursos. As atualizações são regulares e incluem tanto correções de bugs quanto novos recursos baseados no feedback da comunidade.

Para dúvidas de instalação, problemas de compatibilidade ou solicitações de recursos, o Discord é o melhor canal. A documentação é mantida atualizada e cobre todas as configurações com exemplos práticos.

Requisitos do Sistema

Para usar os recursos do Agency Scripts, seu servidor FiveM precisa atender aos seguintes requisitos mínimos:

  • Versão do servidor FiveM — artifact 4752 ou superior recomendado
  • Framework — ESX 1.2+, QBCore (qualquer versão principal) ou configuração standalone
  • Banco de dados — MariaDB ou MySQL 5.7+ com oxmysql como camada de banco de dados
  • ox_lib — recomendado para elementos de UI aprimorados, nem sempre obrigatório

Os recursos do Agency Scripts são testados nos artifacts de servidor mais recentes e atualizados regularmente para acompanhar as mudanças do FiveM. As licenças são por servidor mas não têm data de expiração uma vez compradas através do Keymaster.

Por Que os Servidores Escolhem Agency Scripts

A principal razão pela qual os servidores FiveM escolhem Agency Scripts é a consistência. Quando todas as suas ferramentas vêm do mesmo fornecedor, elas têm o mesmo estilo de configuração, o mesmo suporte e o mesmo padrão de qualidade. Não há surpresas ao atualizar um recurso porque você sabe o que esperar.

Para administradores de servidor que querem passar mais tempo no roleplay e menos tempo solucionando problemas de scripts, essa consistência tem valor real. Em vez de ter dez recursos diferentes de dez desenvolvedores diferentes, todos com filosofias de design diferentes e documentação inconsistente, você tem um ecossistema coeso.

Integração Entre Recursos

Os recursos Agency são projetados para funcionar juntos. Agency-Notify é usado por Agency-Reports para alertar admins. Agency-HUD complementa Agency-Phone para uma experiência de interface unificada. Agency-Admin pode suspender jogadores que abusaram do sistema Agency-Blackmarket. Essas integrações não são acidentais — são recursos planejados que fazem o ecossistema funcionar melhor como um todo do que como partes separadas.

Quando você adiciona um novo recurso Agency a um servidor que já usa outros recursos Agency, a compatibilidade está garantida. Não é preciso testar se os eventos colidem, se as configurações do banco de dados conflitam ou se os estilos de UI são inconsistentes. Tudo se encaixa.

Share this article

Ready to upgrade your server?

Check out our premium FiveM scripts in the Agency Scripts store or join our Discord community for support and updates.