Doninha Esquadrão Suicida

O que é e por onde começar

doninha esquadrão suicida é uma ferramenta de automação para servidores de RPG/roleplay no FiveM, focada em gerenciar comandos personalizados, filtros de texto e lógica de scripts sem depender inteiramente dos sistemas nativos da plataforma. A maior parte dos servidores brasileiros que eu conheço usa ela como camada intermediária entre o queue original e os comandos customizados que os devs montam. Se você está tentando rodar algo do zero, o primeiro problema que encontra é que o setup inicial não é intuitivo — não tem um instalador único, o repositório oficial costuma mudar de branch, e a documentação que existe está espalhada entre Discord e pastas do GitHub. O download em si é direto. Você entra no repositório, baixa o .zip mais recente da pasta release, extrai dentro da pasta resources do seu servidor e adiciona o resource no server.cfg com ensure. O que não aparece na readme é que, na prática, quase todo mundo precisa ajustar o cfg/doninha_config.lua antes de rodar pela primeira vez. Eu passei duas horas tentando entender por que os comandos não apareciam no chat até perceber que o fallback do sistema de permissões estava desabilitado por padrão. O workaround foi simples: abrir o arquivo de config e mudar perm_fallback de false para true, depois reiniciar o resource. A partir daí os comandos começaram a ser resolvidos corretamente pelo motor interno. O que a maioria dos tutoriais não menciona é que o sistema de parsing de comandos tem um comportamento diferente quando dois resources tentam registrar o mesmo comando. Em vez de dar erro, ele silencia o segundo registro e mantém o primeiro. Isso parece inofensivo, mas já vi servidor inteiro ficar horas investigando comando que "não funcionava" porque outro resource com menor prioridade no queue estava sobrepondo silenciosamente. A solução é verificar o log de inicialização — você vê uma linha avisando sobre conflito de registro se habilitar o debug_log como true nas config options.

Outro detalhe que pega muito gente: a dependência de cache. doninha esquadrão suicida usa um cache de strings para acelerar a verificação de comandos frequentes. Por padrão, o cache expira a cada 300 segundos. Isso é confortável para servidores pequenos, mas em servidores com 60+ jogadores ativos e muito spam de comando, o cache pode ficar desatualizado durante eventos de grande escala, como assaltos em grupo ou missões simultâneas. O cenário que eu enfrentei foi específico — tinha um script de grade policial que chamava um comando interno a cada 2 segundos durante uma operação de cerco, e o cache não refletia atualizações de permissão que haviam ocorrido minutos antes. O workaround que eu encontrei foi configurar cache_ttl para 60 segundos e aumentar o tamanho máximo do cache de 512 para 2048 entries. Isso resolveu sem impactar performance de forma perceptível. Se você está começando do zero, o caminho mais seguro é usar a versão estável mais recente, não a master branch. A master contém mudanças de API que ainda não estão documentadas e quebras de compatibilidade com resources mais antigos. Eu já perdi um dia inteiro de teste porque atualizei para a master e o sistema de hooks de comando parou de responder. Voltei para a última release marcada e tudo funcionou imediatamente. A versão atual roda sem problemas em servidores com até 48 slots usando configuração padrão. Acima disso, especialmente se você estiver usando muitos scripts customizados que se comunicam via doninha, recomendo dedicar tempo para ajustar os limites de conexão e o timeout de requisições. O servidor que eu administro tem 64 slots e rodava instável na configuração default — aumentei o worker_pool de 4 para 8 threads e o read_timeout de 5 para 15 segundos. A estabilidade melhorou drasticamente, mas notei um leve aumento no consumo de memória, algo em torno de 120 MB extras. Vale a pena se o servidor realmente precisa disso.

Existem alternativas ao doninha esquadrão suicida, claro. Tem o sistema nativo de commands do FiveM, que funciona bem para coisas simples, e tem resources como esx_commands ou vMenu que cobrem parte do que o doninha faz. Mas se você precisa de filtros avançados, hooks customizados e integração com sistemas de permissão que não sejam o padrão do FiveM, o doninha continua sendo uma das opções mais completas no cenário brasileiro. O ponto negativo é que a comunidade de suporte é pequena fora do Discord oficial, e se você encontrar um bug específico, dificilmente vai achar solução pronta em fóruns públicos. Nesse caso, ajustar a config ou escrever um workaround próprio é o caminho mais rápido. A instalação em si leva cerca de 10 a 15 minutos se você já tem experiência com gerenciamento de resources FiveM. Se for a primeira vez, reserve uma hora, porque vai precisar ler os arquivos de config com atenção e testar cada comando individualmente antes de subir o servidor para produção. Não pule essa etapa — eu já vi gente colocar no ar direto e levar duas horas descobrindo que o banco de dados de permissões não estava conectado corretamente.