Máquinas de venda · Guia de FiveM

Script de máquinas de venda para FiveM: QBCore, Qbox e ESX

As máquinas de venda são pequenas, mas os jogadores as usam o tempo todo: uma bebida depois do expediente, um lanche no hospital, um café na copa do escritório. Quando as máquinas do seu mapa são props fixos no código com itens fixos, cada mudança significa editar a configuração e reiniciar.

Este guia mostra o que esperar de um script de máquinas de venda para FiveM em QBCore, Qbox e ESX, como o Rarx Vending Machines resolve cada ponto, o que ele precisa instalado e as perguntas que os donos de servidor fazem antes de adicioná-lo.

O que conferir antes de comprar

O que um bom script de máquinas de venda para FiveM deve fazer

Use estes pontos para comparar recursos de máquinas de venda, inclusive o nosso.

  1. Máquinas colocadas pela staff, dentro do jogo

    Os admins devem criar e colocar as máquinas onde estão. O Rarx Vending Machines tem um painel de admin e um editor de posicionamento com uma legenda na tela para mover, girar e confirmar cada prop.

  2. Catálogos por tipo de máquina

    Bebidas, lanches, café e cigarros preenchem os seus props automaticamente, e uma categoria personalizada permite montar uma máquina a partir de qualquer prop interativo do catálogo.

  3. Preços e estoque opcional

    Cada item tem o próprio preço e, se você quiser escassez, o próprio estoque. Grupos, itens e posições são salvos no banco de dados, então nada se perde ao reiniciar.

  4. Itens entregues pelo seu inventário

    Os produtos devem ser entregues e verificados pelo inventário que você já usa. Nove inventários são compatíveis, detectados automaticamente ou fixados na configuração.

  5. Acesso e logs

    O gerenciamento deve ficar restrito à staff. Aqui o acesso é controlado por grupos ACE, e os logs por webhook registram cada grupo, item e máquina criado, atualizado ou removido.

  6. Leve para o cliente

    Uma distância de renderização e um raio de interação configuráveis mantêm o stream dos props eficiente, e o aviso [E] só aparece quando o jogador está no alcance.

Recursos da RARX

O script de máquinas de venda da RARX

Um só recurso para todas as máquinas de venda do seu mapa.

Rarx Vending Machines — recurso de FiveM (Scripts)
Novo

Scripts

Rarx Vending Machines

Máquinas de venda automática posicionadas no jogo com produtos, preços e estoque próprios para QBCore, Qbox e ESX.

  • QBCore
  • ESX
  • QBox
Grátis

Rarx Vending Machines

O Rarx Vending Machines substitui os props de máquinas fixos no código por máquinas que a sua staff coloca e abastece a partir de um painel dentro do jogo. As máquinas são organizadas em grupos que compartilham um catálogo e uma lista de produtos, e tudo fica no banco de dados, então não é preciso editar arquivos de configuração nem reiniciar nada. As tabelas do banco de dados são criadas automaticamente na primeira inicialização.

Principais funções

  • Gestão no jogo. Crie, edite e exclua grupos de máquinas e itens por um painel de administração, sem reinícios.
  • Editor de posicionamento. Coloque props no mapa e mova, gire e confirme cada um com uma legenda na tela.
  • Preços e estoque. Preço por item e estoque opcional, salvos no banco de dados.
  • Nove inventários. Detecta automaticamente o seu inventário ou permite fixar um dos sistemas compatíveis.

Compatibilidade

Frameworks, inventários e dependências

Extraído dos dados do produto e da sua documentação. O framework é definido na configuração; o inventário pode ser detectado.

FunçãoRarx Vending Machines
Nome do recursorarx_vmachines
FrameworksQBCore, Qbox, ESX
Configuração do frameworkDefina Config.Core no config.lua como 'qb-core', 'qbx_core' ou 'esx'.
Recursos necessáriosoxmysql, ox_lib, rarx_lib, A supported inventory
Recursos opcionaisNenhum
Inventáriosrarx_inventory, ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory, core_inventory
Banco de dadosTodas as tabelas rarx_vmachines_* são criadas automaticamente na primeira inicialização. Não é preciso importar SQL.
IdiomasInglês, Espanhol
DocumentaçãoNeste site

Planejamento

Planejando as máquinas de venda no seu servidor

Agrupe as máquinas por lugar, não só por tipo. Um hospital, uma delegacia e um escritório podem ter cada um o seu grupo de café com produtos e preços diferentes, e mudar um grupo atualiza todas as máquinas dele. Mantenha os nomes dos itens que você vende idênticos aos do seu inventário, já que os itens são entregues e verificados por esse inventário.

Use estoque onde a escassez acrescenta roleplay e deixe desligado onde só frustraria os jogadores. Máquinas em lugares afastados ou em áreas de evento são boas candidatas a estoque limitado; bebidas e lanches do dia a dia em áreas movimentadas costumam funcionar melhor sem limite. Os logs por webhook de grupos, itens e máquinas mostram quem mudou um preço ou moveu uma máquina.

Instalação

Como instalar um script de máquinas de venda no FiveM

Um resumo da instalação. A documentação cobre categorias, permissões e logs.

Documentação completa
  1. 01

    Baixe pelo Cfx.re Portal

    Baixe o recurso e extraia rarx_vmachines na sua pasta de recursos.

  2. 02

    Inicie depois das dependências

    oxmysql, ox_lib e rarx_lib precisam iniciar antes do rarx_vmachines. As tabelas são criadas na primeira inicialização.

  3. 03

    Defina framework, inventário e idioma

    Defina o core como qb-core, qbx_core ou esx, deixe o inventário em auto ou fixe o seu, e escolha o idioma com a convar rarx-lang.

  4. 04

    Dê acesso e coloque as máquinas

    Adicione a sua conta a um dos grupos de admin ou conceda a ace personalizada, e depois abra o painel com /vmadmin.

Se os itens não forem entregues aos jogadores, verifique se os nomes dos itens que você vende existem no seu inventário. Documentação completa: Rarx Vending Machines

Bom saber

Perguntas frequentes sobre scripts de máquinas de venda

Quais frameworks o Rarx Vending Machines suporta?
QBCore, Qbox e ESX. Defina o core no config.lua de acordo com o seu servidor.
Quais inventários são compatíveis?
rarx_inventory, ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory e core_inventory.
Preciso importar SQL?
Não. Todas as tabelas são criadas automaticamente na primeira inicialização.
Posso limitar quantos itens uma máquina tem?
Sim. O estoque é opcional por item. Deixe desligado para vendas ilimitadas ou defina um valor para criar escassez.
Posso montar uma máquina com os meus próprios props?
Sim. A categoria personalizada começa vazia e permite que um admin escolha qualquer prop interativo do catálogo.
Por que não aparece o aviso [E] em uma máquina?
O jogador precisa estar dentro do raio de interação. Se o próprio prop não estiver visível, aumente a distância de renderização e confira o modelo do prop.

Continue explorando

Abasteça a sua cidade em minutos

O Rarx Vending Machines roda em QBCore, Qbox e ESX com nove inventários. Dúvidas? Pergunte no Discord.