O problema do HUD
O HUD por defeito do FiveM é um desastre. Os jogadores acabam com meia dúzia de overlays a lutar pelo espaço de ecrã, sem linguagem visual consistente, e com informação crítica enterrada debaixo de enfeites decorativos. Todos os servidores em que entrámos tinham o mesmo problema: HUD a mais, clareza a menos. O Agency-Hud existe para resolver isto.
Hierarquia da informação
Dividimos os elementos do HUD em três níveis. Nível um, sempre visível: vida, armadura, fome, sede. Nível dois, contextual: conta-quilómetros ao conduzir, indicador de alcance de voz ao falar. Nível três, a pedido: toggle do minimapa, estado do trabalho, inventário. Cada nível tem o seu próprio peso visual e anima a entrar e a sair de forma limpa. Nada compete por atenção a não ser que importe mesmo agora.
Acessibilidade de raiz
Modo de alto contraste, tamanhos configuráveis e indicadores de estado seguros para daltónicos vêm de origem. Isto não é opcional em 2026 — entre os teus jogadores haverá pessoas com várias necessidades visuais e um HUD profissional tem isso em conta. Os donos dos servidores podem alternar estes defaults para a sua comunidade.
Desempenho durante spawns de veículos
A maior armadilha de desempenho de um HUD é o redesenho durante spawns pesados de veículos ou NPCs. O Agency-Hud usa um único render target com atualizações delta — só redesenhamos as partes que mudaram, não o overlay inteiro. Num servidor de 64 jogadores durante um evento de heist, o HUD custou-nos um décimo do que nos custaram as alternativas comparáveis nos nossos benchmarks.
Personalização sem caos
Os donos dos servidores podem reposicionar cada elemento do HUD, trocar esquemas de cores, e esconder peças específicas a partir de um único ficheiro de configuração. Mas deliberadamente não lançamos um marketplace de temas nem posicionamento do lado do utilizador — o HUD que constróis é o HUD que cada jogador vê, o que mantém coerente a linguagem visual do teu servidor. A consistência é uma funcionalidade.
Instalação e Configuração
Agency-HUD substitui o HUD padrão do seu framework. Após a instalação, desative o HUD padrão do ESX ou QBCore em seus respectivos arquivos de configuração, depois Agency-HUD assume o controle. Todos os eventos de atualização do HUD do framework se conectam automaticamente.
Opções de Configuração
- Elementos visíveis — quais estatísticas mostrar e quais ocultar
- Valores de limite — em qual porcentagem os elementos do HUD mudam de cor ou piscam
- Modo mínimo — oculta todos os elementos exceto os de status crítico
- Integração de veículo — elementos adicionais do HUD que aparecem apenas durante a condução
Compatibilidade com Frameworks
Agency-HUD integra profundamente com ESX e QBCore para exibir dados do personagem do jogador. Também detecta e exibe automaticamente as estatísticas do personagem do ox_lib se instalado.
O HUD como Ferramenta de Narrativa
Um bom HUD não apenas mostra informações — reforça o tom e o tema do seu servidor. Agency-HUD te dá controle visual para alinhar sua interface com sua visão narrativa. Suporta modos "mínimo" e "completo", permitindo que os jogadores escolham seu nível de preferência.
Notificações vs HUD
Há uma tensão entre o que deve estar no HUD e o que deve ser uma notificação. Agency-HUD e Agency-Notify trabalham juntos: métricas persistentes ficam no HUD, enquanto mudanças de status importantes disparam notificações. Esse sistema de duas camadas evita sobrecarga de informações enquanto mantém os jogadores informados.
Perguntas Frequentes
- Agency-HUD pode mostrar estatísticas personalizadas de recursos de terceiros? Sim, através de um sistema de eventos, qualquer recurso pode enviar valores ao HUD para exibição.
- Os jogadores podem personalizar quais elementos do HUD são visíveis? Sim, se o admin do servidor habilitar preferências do jogador, os jogadores podem ocultar elementos não críticos.
- Agency-HUD impacta nos FPS do cliente? Agency-HUD é otimizado e usa atualizações baseadas em eventos em vez de polling contínuo, mantendo o impacto nos FPS mínimo.
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.