Agency-Vending: Máquinas de venda que realmente movimentam a economia do seu servidor

O objeto mais subutilizado do GTA V

O GTA V está repleto de máquinas de venda automática que são puramente decorativas em servidores FiveM padrão. Agency-Vending dá função a todas elas: os jogadores se aproximam, interagem, compram comida ou bebidas por preços razoáveis e recebem efeitos apropriados. É algo simples e presente por todo o mapa, que o deixa mais vivo do que na versão padrão.

Estoque que acaba

Cada máquina tem seu próprio estoque, que diminui conforme os jogadores compram itens. Máquinas vazias exibem o estado "sem estoque" até serem reabastecidas. Parece algo pequeno, mas cria uma nova função: operador de rota de máquinas de venda automática. Os jogadores que reabastecem as máquinas recebem uma parte das vendas dos produtos que abasteceram. De repente, cada objeto passa a ter atividade econômica.

Variedade de itens por tipo de máquina

Máquinas de refrigerante vendem bebidas com efeitos leves de hidratação. Máquinas de lanches vendem alimentos com efeitos de saciedade. Quiosques de café vendem bebidas quentes que aliviam o cansaço. Agency-Vending identifica automaticamente o tipo de máquina pelo modelo do objeto e abastece cada uma de forma adequada. Nenhuma configuração é necessária para posicionamentos padrão.

Sinais de preço

Os preços são intencionalmente menores que os de refeições em restaurantes, mas maiores que os de comida feita em casa. Isso cria uma hierarquia econômica sensata: casa > máquinas de venda automática > fast food > restaurantes. Os jogadores escolhem naturalmente a opção mais adequada à situação, exatamente como acontece nas decisões de compra do mundo real.

Relatórios para administradores

Os administradores do servidor recebem um resumo semanal da atividade das máquinas: quais dão mais lucro, quais precisam de reabastecimento e quais bairros têm demanda não atendida. Esses dados são valiosos para equilibrar o mapa e identificar novas oportunidades de jogabilidade, sem precisar incomodar os jogadores com pesquisas.

Instalação e configuração

Agency-Vending requer oxmysql para rastrear o estoque de cada máquina. Importe vending.sql , coloque o recurso no seu servidor e adicione ensure agency-vending a server.cfg. Na primeira inicialização, o recurso procura no mapa todos os objetos nativos de máquinas de venda automática e os registra automaticamente no banco de dados. Não é necessário inserir coordenadas manualmente para os posicionamentos padrão das máquinas.

Os itens dispensados pelas máquinas precisam existir no registro de itens do seu framework. A configuração inclui nomes padrão de itens de comida e bebida para QBCore e ESX. Para usar nomes de itens personalizados, basta fazer uma alteração de uma linha por tipo de máquina.

Opções de configuração

O config.lua abrange o comportamento das máquinas e as configurações econômicas:

• Estoque por máquina, quantas unidades cada máquina comporta antes de precisar ser reabastecida. Padrão: 50.
• Método de reabastecimento, reabastecimento automático em intervalos programados (simples), reabastecimento por jogadores (função econômica) ou reabastecimento exclusivo para administradores.
• Requisito de emprego para reabastecimento, opcionalmente, limite o reabastecimento a jogadores com emprego de entregador ou vendedor.
• Divisão dos lucrosporcentagem da receita das vendas destinada ao jogador que reabasteceu a máquina por último.
• Sobrescritas por tipo de máquina, defina manualmente uma lista de itens diferente para modelos específicos de props de máquinas.
• Duração do efeito, por quanto tempo os bônus de comida e bebida duram. Configurável por tipo de item.
• Visual de máquina sem estoque, alterne o estado visual de "vazia" nos props das máquinas.

Compatibilidade com frameworks

Os adaptadores QBCore e ESX estão incluídos. Para standalone, implemente Config.GiveItem(src, item, count) e Config.TakeMoney(src, amount). A leitura das máquinas, o gerenciamento de estoque, a economia de reabastecimento e os relatórios administrativos são independentes de framework.

Por que isso importa para o roleplay

A densidade do mapa é um dos fatores subestimados na qualidade de um servidor de RP. Quando os jogadores podem interagir com mais props já existentes no mapa, como máquinas, bancadas, lixeiras e portas, o mundo parece habitado, em vez de cenográfico. Agency-Vending é uma das maneiras mais fáceis de melhorar isso: cada prop de máquina de venda automática se torna um ponto econômico interativo, sem nenhum trabalho adicional da equipe do servidor.

A função de operador de rota de abastecimento é talvez a jogabilidade emergente mais interessante que o script possibilita. Um personagem que ganha a vida reabastecendo máquinas e gerenciando rotas, acompanhando quais bairros têm maior demanda, tem um papel cotidiano, mas legítimo, de RP que alguns jogadores realmente gostam. Nem todo personagem precisa ser criminoso ou policial.

A camada de relatórios administrativos é uma ferramenta prática para manter a economia do servidor saudável. Se uma máquina em um local específico está sempre vazia (alta demanda), mas outra está sempre cheia (baixo movimento), isso fornece informações úteis para posicionar NPCs de lojas personalizadas ou ajustar os pontos de surgimento dos jogadores. Os dados das máquinas mostram onde seus jogadores realmente passam o tempo.

Perguntas frequentes

Posso adicionar locais de máquinas personalizadas que não sejam props nativos de GTA V?

Sim. Defina máquinas personalizadas em Config.CustomMachines com coordenadas, modelo do prop e lista de itens. É assim que você adiciona máquinas de venda automática dentro de interiores MLO personalizados, onde o scanner de props nativos não consegue chegar.

Os jogadores podem roubar máquinas de venda automática?

Há uma mecânica opcional de roubo em config.lua. Ative-a e defina a duração para forçar a abertura, a chance de falha e a faixa de saque. Roubos bem-sucedidos rendem uma parte do estoque atual como itens e marcam a máquina como danificada até que seja reabastecida. Isso adiciona uma possibilidade de uso criminoso sem desequilibrar a economia, o saque por máquina é intencionalmente pequeno.

Como funciona a divisão dos lucros quando vários jogadores reabastecem a mesma máquina?

O jogador que fez o reabastecimento mais recente fica com a participação nos lucros daquela máquina até que ela fique sem estoque e seja reabastecida novamente. Não há divisão entre vários jogadores que reabastecem: quem fez o último abastecimento fica com os ganhos do próximo ciclo. Isso mantém a contabilidade simples e cria uma competição natural entre operadores de rotas de abastecimento.

Isso funciona apenas no lado do servidor (sem recurso de cliente)?

Não. A leitura das máquinas e a interface de interação são executadas no lado do cliente. Agency-Vending usa scripts de servidor e de cliente. O servidor gerencia o estado do estoque e as transações da economia; o cliente cuida da detecção de props, da renderização da interface e dos gatilhos de proximidade dos jogadores.

Requisitos

• Servidor FiveM (QBCore, ESX ou standalone)
• oxmysql
• conta cfx.re com uma licença válida de Agency-Vending
• Opcional: ox_lib (para componentes da interface, há uma alternativa caso não esteja presente)

Expandindo a economia das máquinas de venda automática

A economia das máquinas de venda automática funciona melhor quando é parte de um sistema mais amplo de comida e bebida, e não a única opção. Veja como criar camadas de forma eficaz:

A comida feita em casa (por meio de um script de criação) deve ser a opção mais barata para obter comida com os melhores valores de bônus, mas exige ingredientes e tempo. As máquinas de venda automática são a opção conveniente: sem preparo, compra imediata, custo moderado e bônus moderados. Restaurantes administrados por jogadores são a opção premium: os melhores bônus de comida, custo mais alto e exigem um cozinheiro jogador. Os NPCs de fast food ficam entre as máquinas de venda automática e os restaurantes.

Quando os quatro níveis existem, os jogadores tomam decisões econômicas naturais de acordo com a situação. Um jogador no meio de uma missão usa uma máquina de venda automática porque não pode parar em um restaurante. Um jogador com tempo e dinheiro vai a um restaurante administrado por um jogador para ter a experiência de RP e receber o bônus. Essa estrutura em níveis cria escolhas significativas em toda a economia, em vez de uma única opção dominante.

Agency-Vending também funciona bem como fonte de renda para donos de negócios de bairro em um RP de cidade. Um dono de loja que "controla a rota de máquinas de venda automática" do bairro tem uma forma de renda passiva e um motivo para patrulhar e defender seu território.