Scripts 2026-04-05

Agency-Vending: máquinas de venda que vendem mesmo coisas na tua economia

TDYSKY

TDYSKY

Founder & Lead Developer at Agency Scripts

O prop mais subaproveitado do GTA V

O GTA V está pejado de máquinas de venda que são puramente decorativas nos servidores FiveM vanilla. O Agency-Vending torna cada uma delas funcional — os jogadores aproximam-se, interagem, compram comida ou bebidas a preços razoáveis e recebem os buffs correspondentes. Simples, omnipresente, e faz com que o mapa pareça vivo de uma maneira que o vanilla não consegue.

Stock que se esgota

Cada máquina tem um stock individual que vai diminuindo à medida que os jogadores compram artigos. As máquinas vazias mostram um estado "sem stock" até serem reabastecidas. Pode parecer pormenor, mas cria uma nova função: operador de rota de máquinas. Os jogadores que reabastecem ficam com uma parte das vendas que saem do stock que eles meteram. De repente, cada prop tem atividade económica.

Variedade de artigos por tipo de máquina

As máquinas de refrigerantes vendem bebidas com efeitos ligeiros sobre a sede. As de snacks vendem comida com efeitos sobre a fome. Os quiosques de café vendem bebidas quentes que tiram o cansaço. O Agency-Vending identifica automaticamente o tipo de máquina a partir do modelo do prop e abastece-a em conformidade. Zero configuração para as colocações-padrão.

Sinais de preço

Os preços são intencionalmente mais baratos do que a comida de restaurante, mas mais caros do que cozinhar em casa. Cria-se assim uma hierarquia económica sensata: casa > máquina > fast food > restaurantes. Os jogadores gravitam naturalmente para a opção que se adequa à sua situação, que é exatamente como funciona o comportamento de compra real.

Reporting para administradores

Os administradores do servidor recebem um resumo semanal da atividade dos distribuidores: que máquinas geram mais, quais estão subabastecidas, que zonas têm lacunas de procura. Estes dados valem ouro para equilibrar o mapa e identificar novas oportunidades de jogabilidade sem andar a chatear os jogadores com inquéritos.

Instalação e Configuração

Agency-Vending não requer scripts SQL pois as configurações de máquinas são definidas em arquivos de configuração em vez de no banco de dados. Isso torna a adição e edição de máquinas rápida — basta editar o arquivo de configuração e reiniciar o recurso.

Opções de Configuração

Cada máquina de venda automática é definida com:

  • Coordenadas de posição — onde a máquina aparece no mundo
  • Modelo de prop — qual prop do GTA V usar como máquina
  • Inventário de itens — quais itens vende e a que preço
  • Comportamento de estoque — estoque ilimitado ou quantidades limitadas que são reabastecidas

Compatibilidade com Frameworks

Agency-Vending funciona com os sistemas de inventário do ESX e QBCore. Itens comprados aparecem diretamente no inventário do jogador com os ícones e descrições corretos.

Criando uma Economia de Máquinas de Venda

As máquinas de venda automática não são apenas decoração — podem ser parte da economia do seu servidor. Configure os preços para refletir escassez e demanda, crie máquinas em diferentes bairros com diferentes inventários, e dê aos jogadores um motivo para visitar zonas específicas do mapa.

Máquinas Controladas por Jogadores

Servidores avançados podem permitir que jogadores ou facções possuam máquinas de venda automática. O proprietário configura os preços e os itens, coleta os lucros, e pode ser "atacado" por competidores. Este nível de gameplay econômico que poucas recursos suportam nativamente.

Perguntas Frequentes

  • Os jogadores podem roubar máquinas de venda? Sim, se você configurar a interação de roubo. As máquinas podem ter estado "danificado" e precisar de reparo.
  • Quantas máquinas o servidor pode ter sem problemas de desempenho? Agency-Vending usa carregamento dinâmico — apenas máquinas próximas a jogadores estão ativas, permitindo centenas no mapa.
  • É possível alterar o inventário de máquinas em tempo real? Sim, os admins podem modificar inventários ao vivo através do menu de administração sem reiniciar o recurso.

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.