Scripts 2026-04-13

Agency-Loadingscreen: os primeiros cinco segundos do teu servidor valem tudo

TDYSKY

TDYSKY

Founder & Lead Developer at Agency Scripts

A primeira impressão conta

Cada jogador novo que entra no teu servidor passa entre 30 e 90 segundos a olhar para o ecrã de carregamento antes de ver qualquer outra coisa. Isso é mais tempo do que a maioria dos tutoriais. Um ecrã de carregamento por defeito do GTA V não lhe diz nada sobre o teu servidor; um ecrã ótimo diz-lhe tudo. O Agency-Loadingscreen foi construído em torno desta ideia.

O que entregamos

Uma UI em glassmorphism bem trabalhada que mostra as regras do servidor, o link do Discord, a lista do staff e uma imagem hero rotativa. Um leitor de música personalizado com controlo de volume. Mini-estatísticas do servidor: população atual, uptime, próximo evento. Transições suaves quando o carregamento termina. Tudo com a marca das cores do teu servidor através de uma única config.

Porque é que a música importa

O áudio durante o carregamento define o tom emocional. Lo-fi hip-hop para servidores de RP descontraído, synthwave para os de temática cyberpunk, ambiente cinematográfico para comunidades de RP sério. Os jogadores sintonizam-se inconscientemente com a onda antes sequer de fazerem spawn. Incluímos uma biblioteca de faixas integrada e uma opção de config para apontar para o teu próprio CDN de áudio.

Desempenho

O ecrã de carregamento corre no browser antes de qualquer asset do jogo ser carregado, por isso o desempenho depende do peso da página. O Agency-Loadingscreen pesa menos de 400 KB no total, incluindo tipos de letra. Carrega instantaneamente mesmo em ligações lentas, o que é importante porque alguns dos teus jogadores estão em banda larga rural de 50 Mbps.

Testes A/B para admins

O painel de admin inclui um modo simples de teste A/B: configuras duas variantes de ecrã de carregamento e nós mostramos cada uma a 50% dos jogadores novos, registando quantos chegam ao spawn em cada caso. É o tipo de ferramenta de otimização que os servidores profissionais usam para afinar o funil da primeira impressão.

Instalação e Configuração

Agency-Loadingscreen é colocado na pasta de recursos do seu servidor como qualquer outro recurso. Deve carregar antes de outros recursos, então coloque-o no topo do seu server.cfg. Os arquivos de mídia são servidos diretamente da pasta do recurso.

Opções de Configuração

  • Ativos de mídia — imagens de fundo, logotipo do servidor, arquivos de música
  • Texto de conteúdo — regras do servidor, detalhes do Discord, informações de contato
  • Configuração de música — ordem de playlist, mistura de faixas, controle de volume do jogador
  • Atualizações dinâmicas — URL do endpoint de onde buscar conteúdo atualizado do servidor

Compatibilidade com Frameworks

Os recursos de tela de carregamento são independentes de framework por design: eles são executados antes de qualquer framework carregar. Agency-Loadingscreen pode exibir informações dinâmicas do servidor através de sua própria API simples, sem dependências de framework.

Elementos Técnicos de uma Boa Tela de Carregamento

Uma tela de carregamento não é apenas questão de estética. Considerações técnicas importantes incluem: tempo de carregamento percebido reduzido com música e animações envolventes, e mostrar o progresso real de carregamento para que os jogadores saibam que algo está acontecendo.

Impacto na Retenção de Jogadores

Dados de comunidades do FiveM mostram que servidores com telas de carregamento profissionais têm taxas de retenção mais altas. Os jogadores fazem um julgamento instantâneo: se a tela de carregamento parecer amadora, eles assumem que o resto do servidor também é. Investir nessa primeira impressão pode ter um impacto duradouro na sua comunidade.

Perguntas Frequentes

  • A tela de carregamento pode mostrar jogadores atualmente conectados? Sim, com uma solicitação de API ao endpoint de lista de jogadores do seu servidor.
  • A tela de carregamento pode ser personalizada para temporadas ou eventos? Sim, troque facilmente os ativos de mídia para decorações sazonais ou telas de eventos especiais.
  • Quão leve deve ser a tela de carregamento para não impactar o tempo de conexão? Agency-Loadingscreen é otimizado para carregar ativos progressivamente. Ativos grandes não bloqueiam a própria tela.

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.