O fosso entre tooling amador e profissional
A maioria dos menus de admin em FiveM é de nível amador: botões para dar armas, teletransportar, noclip, esse tipo de coisas. O Agency-Admin é feito para comunidades que levam a moderação tão a sério como uma equipa de moderação de um verdadeiro estúdio de jogos.
Registo de ações com contexto
Cada ação de admin é escrita num log inviolável com ID do admin, alvo, ação, data e razão. Acabaram-se os mistérios do tipo 'quem é que deu um Rhino àquele jogador?'. Os logs são pesquisáveis através da UI de admin com filtros por admin, intervalo de tempo e tipo de ação. É infraestrutura básica de responsabilização que as equipas de staff precisam mesmo.
Níveis de permissões
Três níveis incorporados: moderador (kick, timeout, verificações básicas de itens), admin (ban, dar itens, teletransportar), admin sénior (alterações de config, gestão de permissões, admin de base de dados). As ações de cada nível são estritamente delimitadas - um moderador não pode fazer autoescalada à procura de uma brecha. Testámos este modelo com várias comunidades grandes ao longo dos últimos dois anos.
Gestão de bans
Os bans suportam duração, razão, URL de prova (captura ou link de vídeo), estado de recurso e notas de revisão. Quando um jogador banido tenta voltar a entrar, a mensagem que vê inclui a razão e - se configurado - um link de recurso. Moderação transparente é moderação eficaz.
Deteção de ameaças em tempo real
O Agency-Admin entrega uma camada de deteção configurável que sinaliza padrões suspeitos: picos súbitos de dinheiro, teletransportes impossíveis, duplicação rápida de itens, spawns de armas invulgares. As sinalizações aparecem no dashboard de admin com o contexto todo. Não somos um anticheat - somos uma ferramenta de deteção que faz com que o tempo de resposta dos admins caia de horas para minutos.
Instalação e Configuração
Agency-Admin requer que as permissões ACE do FiveM estejam configuradas corretamente. O recurso lê suas permissões ACE existentes para determinar quem tem acesso às ferramentas de administração.
Opções de Configuração
- Níveis de permissão — moderador, administrador, administrador sênior, proprietário
- Configuração de log — para onde vão os logs de ação e com que nível de detalhe
- Tecla de atalho do menu de admin — tecla personalizável para abrir o painel
- Visibilidade do modo espectador — se jogadores normais podem ver quando um admin está no modo espectador
Compatibilidade com Frameworks
Agency-Admin funciona com qualquer framework pois opera através do sistema de permissões ACE do próprio FiveM. Os dados do jogador são obtidos através das funções nativas do framework para exibição no painel de administração.
Fluxo de Trabalho de Moderação na Prática
Gerenciar um servidor FiveM ativo significa lidar com dezenas de incidentes por dia. Agency-Admin otimiza esse fluxo de trabalho com uma interface projetada para velocidade. Um relatório chega, o admin localiza o jogador em segundos, observa no modo espectador se necessário, e age com logs automáticos de todas as ações.
Sistema de Permissões Granulares
Nem todos os admins devem ter os mesmos poderes. Agency-Admin suporta hierarquias de administração. Moderadores júniores podem lidar com relatórios básicos enquanto admins seniores têm acesso a ferramentas mais poderosas.
Logs e Histórico
Cada ação de administração é registrada com timestamp, identificador Steam do jogador afetado, razão fornecida e o admin responsável. Esses logs são inestimáveis em apelações de banimento: você tem um histórico completo e pesquisável de cada decisão.
Perguntas Frequentes
- Agency-Admin pode compartilhar banimentos entre múltiplos servidores? Sim, com um banco de dados compartilhado configurado entre suas instâncias de servidor.
- Os jogadores sabem quando estão sendo observados no modo espectador? Configurável — os admins podem escolher o modo espectador visível ou invisível.
- Agency-Admin pode enviar logs para o Discord? Sim, através de webhooks do Discord para ações críticas de moderação.
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.