O problema da compatibilidade de frameworks
A maior parte dos scripts de FiveM sai com um framework hard-coded lá dentro. Se corres QBCore, usas scripts QBCore. Os utilizadores de ESX ficam presos a scripts ESX. Os utilizadores de standalone geralmente amanham as coisas. Os Agency Scripts foram construídos com a filosofia oposta: o framework é um adaptador, não uma pressuposição.
O padrão de adaptador
Cada script Agency expõe um pequeno conjunto de funções de lookup: getPlayerData, getInventory, addMoney, removeItem, getJob. Nós fornecemos adaptadores que as mapeiam para as implementações de QBCore e ESX à partida. Para standalone, implementas tu próprio as quatro ou cinco funções — habitualmente o trabalho de uma manhã — e todos os scripts Agency ficam compatíveis.
O que isto significa na prática
Quando mudas o teu servidor de QBCore para ESX (o que acontece de tempos a tempos, à medida que os frameworks evoluem), os scripts Agency não precisam de ser reinstalados nem reconfigurados. Trocas o adaptador e tudo o resto continua a funcionar. Isto é extremamente raro no ecossistema FiveM e é a razão principal pela qual os donos de servidores padronizam as suas ferramentas connosco a longo prazo.
O que significa cada etiqueta de framework nas nossas páginas de produto
Quando uma página de produto lista "QBCore, ESX", quer dizer que enviamos adaptadores prontos para ambos. Quando diz "Standalone", queremos dizer que o script é agnóstico face ao framework — não precisa de adaptador e corre em qualquer servidor. Na prática, quase todos os scripts Agency são utilizáveis em setups standalone com um pequeno shim de compatibilidade.
Quando perguntar antes de comprar
Se estás a correr um setup fora do comum — framework próprio, QBCore muito modificado ou algo à medida —, abre um ticket no nosso Discord antes de comprar. Dizemos-te com honestidade o que vai funcionar, o que precisa de uma adaptaçãozita e o que não vale a pena. Sem pressão comercial; preferimos que compres um script que encaixe a três que não.
Instalação e Configuração
Nenhuma configuração especial de compatibilidade de framework é necessária. Cada recurso Agency detecta automaticamente seu framework na inicialização verificando quais recursos estão presentes. A detecção ocorre uma vez na inicialização, sem custo de desempenho durante a execução.
Opções de Configuração
- Substituição de framework — força um framework específico se a detecção automática falhar
- Configuração do modo standalone — define fontes de dados personalizadas quando nenhum framework padrão é usado
- Ajustes de compatibilidade de versão — para frameworks com versões antigas que têm APIs diferentes
Compatibilidade com Frameworks
Os recursos Agency suportam ESX (1.2, 1.6, 1.9 e versões mais recentes), QBCore (todas as versões principais) e modo standalone para servidores construídos sobre bancos de dados e eventos personalizados. Alguns recursos também têm compatibilidade declarada com ox_core e nd_core.
Migrando Entre Frameworks com Agency Scripts
Um dos momentos mais estressantes para um desenvolvedor do FiveM é decidir migrar do ESX para o QBCore ou vice-versa. Essa migração normalmente envolve reescrever dezenas de recursos. Com Agency Scripts, a dor é consideravelmente reduzida: você só muda a configuração do framework, e a lógica da aplicação permanece idêntica.
Modo Standalone: Mais Flexível do que Parece
O modo standalone do Agency Scripts não é apenas para servidores sem framework. Alguns operadores de servidores o escolhem deliberadamente porque lhes dá mais controle. Eles constroem sua própria camada de dados minimalista e usam os recursos Agency como blocos de construção.
Perguntas Frequentes
- Os recursos Agency funcionam com frameworks altamente modificados? Geralmente sim, desde que os principais nomes de eventos e funções de exportação não tenham mudado.
- Os recursos Agency podem ser misturados de diferentes versões de framework? Não recomendado — todos os recursos Agency devem detectar o mesmo framework para que os dados sejam consistentes.
- O que acontece durante a migração quando se usa tanto ESX quanto QBCore? É um período de transição difícil. A melhor abordagem é migrar todos os recursos Agency simultaneamente durante uma janela de manutenção do servidor.
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.