Scripts 2026-04-18

Agency-Seatbelt: Porque é que um script de 20kb tem o maior impacto na sensação de condução

TDYSKY

TDYSKY

Founder & Lead Developer at Agency Scripts

Scripts pequenos, grande impacto

O Agency-Seatbelt é um dos scripts mais pequenos que lançamos, mas o feedback coloca-o consistentemente entre os mais apreciados. Há aí uma lição: o RP constrói-se a partir de pequenos toques mecânicos que tornam o mundo coerente, não de lançamentos monolíticos de funcionalidades.

O retorno do realismo

Quando os jogadores têm de pôr fisicamente o cinto antes de conduzir, três coisas mudam. As perseguições tornam-se mais perigosas porque apertar o cinto a meio da perseguição custa-te tempo. Os polícias ganham uma nova coisa pela qual multar. Os passageiros sofrem consequências reais da negligência do condutor. Cada uma destas é um pequeno gancho de RP que acrescenta profundidade sem acrescentar carga cognitiva.

Os detalhes de animação e áudio

Passámos mais tempo na animação de apertar/desapertar do que na lógica principal. Uma animação de dois segundos, um som subtil de clique, e um indicador distinto de cinto no HUD — é o tipo de detalhes de polimento que sinaliza aos jogadores "este servidor leva-se a sério". Quando tudo o resto faz o seu trabalho em silêncio, esses pequenos momentos sobressaem.

Integração com scripts de veículos

O Agency-Seatbelt encaixa de forma limpa em qualquer script de danos de veículos porque expomos um evento simples no cliente — `agency-seatbelt:isBuckled` — que outros scripts podem consultar. O teu script de reboque pode recusar pedidos de reboque de jogadores que acabaram de sair catapultados pelo pára-brisas. O teu script de hospital pode acrescentar modificadores realistas de lesões. O script é suficientemente pequeno para não se importar, mas suficientemente flexível para participar.

Grátis, porque devia ser

O Agency-Seatbelt sai a 0 € para sempre. Uma mecânica básica de segurança não devia estar por trás de uma paywall. Usa-o, faz-lhe fork, modifica-o — tanto faz. Cada servidor que usa os nossos scripts gratuitos é um servidor que um dia talvez compre os premium, e estamos a jogar a longo prazo.

Instalação e Configuração

Agency-Seatbelt se instala como um recurso leve do lado do cliente sem dependências de banco de dados. As informações de status do cinto de segurança são sincronizadas entre jogadores através de eventos padrão do servidor FiveM.

Opções de Configuração

  • Multiplicadores de dano — quanto dano adicional passageiros sem cinto recebem em colisões
  • Aviso sonoro — se um bipe toca ao dirigir sem cinto
  • Velocidade de ejeção — a que velocidade passageiros sem cinto são ejetados do veículo
  • Opções de interface do usuário — onde e como o indicador de status do cinto é exibido

Compatibilidade com Frameworks

Agency-Seatbelt funciona independentemente do framework para o comportamento principal do cinto. A integração com framework só é necessária se você quiser integrar o status do cinto com o sistema de lesões ou infrações do seu framework.

Impacto no Roleplay Médico e de Emergências

O cinto de segurança muda fundamentalmente os cenários de emergências médicas. Sem ele, cada acidente de trânsito se torna potencialmente fatal. Com Agency-Seatbelt, os acidentes contam uma história mais matizada: motoristas com cinto sobrevivem a acidentes graves com ferimentos menores, enquanto passageiros sem cinto em acidentes leves sofrem ferimentos graves.

Aplicação Policial

Servidores com RP policial robusto podem ativar multas por não usar cinto. Os oficiais podem verificá-lo durante abordagens de tráfego, e as multas geradas alimentam o sistema financeiro do servidor.

Perguntas Frequentes

  • Agency-Seatbelt funciona com todos os tipos de veículos? Por padrão, aplica-se a todos os veículos com assentos. Os admins podem excluir veículos específicos através de uma lista negra de modelos.
  • Os jogadores podem colocar o cinto depois de um acidente? O sistema funciona em tempo real — colocar o cinto depois de um acidente não afeta retroativamente o dano desse acidente.
  • O status do cinto pode ser visto por outros jogadores? Sim, há um indicador visual opcional que mostra aos outros se você está usando o cinto.

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.