Rarx Vending Machines — capa do recurso (Scripts)

1 / 9

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

Um script de máquinas de venda automática FiveM gerenciado por painel admin

O Rarx Vending Machines (nome do recurso: rarx_vmachines) substitui os props de máquinas de venda fixos no código por máquinas que a sua staff posiciona e abastece por um painel no jogo. Os grupos, os itens e as posições das máquinas ficam salvos no banco de dados, então não é preciso editar arquivos de configuração nem reiniciar nada.

Os jogadores se aproximam de uma máquina e veem um aviso [E] limpo apenas quando estão ao alcance, e os produtos comprados são entregues e verificados pelo inventário que o seu servidor já usa.

Rarx Vending Machines: Um script de máquinas de venda automática FiveM gerenciado por painel admin

Máquinas de venda de bebidas, snacks, café e cigarros

As máquinas são organizadas em grupos que compartilham catálogo e lista de produtos. As categorias fixas preenchem seus props automaticamente, enquanto a categoria personalizada começa vazia para você montar a sua própria máquina.

  • Bebidas: máquinas de refrigerante, geladeiras de bebidas e bebedouros.
  • Snacks: máquinas de snacks compactas e variantes de textura.
  • Café: máquinas de café e dispensers de café portáteis para cafeterias, escritórios e salas de descanso.
  • Cigarros: máquinas de venda de tabaco e prateleiras de cigarros de loja.
  • Personalizada: escolha qualquer prop interativo do catálogo e abasteça como quiser.
Rarx Vending Machines: Máquinas de venda de bebidas, snacks, café e cigarros

Painel de administração no jogo e editor de posicionamento

Os administradores abrem o painel com /vmadmin, criam um grupo, escolhem a categoria, adicionam os produtos com preço e estoque opcional e depois posicionam as máquinas no mapa. O editor de posicionamento mostra uma legenda de controles na tela para mover, girar e confirmar cada prop exatamente onde você está.

As mudanças são confirmadas com notificações dentro do painel, e cada grupo, item e máquina é salvo no banco de dados pelo oxmysql.

Rarx Vending Machines: Painel de administração no jogo e editor de posicionamento

Acesso por ACE, logs de webhook e ajustes de desempenho

A gestão fica restrita a grupos ACE configuráveis. Você pode usar os grupos integrados god, admin e superadmin ou conceder o seu próprio ace personalizado.

Os logs de webhook registram cada grupo e item criado, atualizado ou removido e cada máquina posicionada, atualizada ou excluída, com um canal separado para cada evento. Uma distância de renderização e um raio de interação configuráveis mantêm o streaming de props eficiente.

Tudo incluído

Funções

Gestão

  • Painel de administração no jogo com /vmadmin
  • Grupos de máquinas por categoria
  • Categorias de bebidas, snacks, café, cigarros e personalizada
  • Editor de posicionamento para mover, girar e confirmar
  • Preço por item e estoque opcional
  • Grupos, itens e máquinas salvos no banco de dados

Servidor

  • Detecção automática do inventário ou inventário fixo
  • Acesso de gestão restrito por ACE
  • Logs de webhook para nove eventos de grupos, itens e máquinas
  • Distância de renderização e raio de interação configuráveis
  • Tabelas do banco de dados criadas automaticamente
  • Traduções em inglês e espanhol incluídas

Comandos

ComandoO que fazAcesso
/vmadminAbre o painel de administração das máquinas de vendaConfig.AdminGroups ou o ace personalizado

Antes de instalar

Compatibilidade

Frameworks

QBCore
qb-core
Qbox
qbx_core
ESX
es_extended

Defina Config.Core no config.lua como 'qb-core', 'qbx_core' ou 'esx'.

Recursos e banco de dados

Obrigatórios: oxmysql, ox_lib, rarx_lib, A supported inventory

Banco de dados: Todas as tabelas rarx_vmachines_* são criadas automaticamente na primeira inicialização. Não é preciso importar SQL.

Inventários

rarx_inventory
rarx_inventory
ox_inventory
ox_inventory
qb-inventory
qb-inventory
qs-inventory
qs-inventory
ps-inventory
ps-inventory
origen_inventory
origen_inventory
codem-inventory
codem-inventory
tgiann-inventory
tgiann-inventory
core_inventory
core_inventory

Config.InventorySystem = 'auto' detecta o inventário, ou fixe um inventário específico.

Integrações e idiomas

  • Os logs são configurados em config_server.lua com uma URL de webhook compatível com o Discord por evento.
  • O idioma é definido pela convar rarx-lang.
  • Inglês
  • Espanhol

Primeiros passos

Instalação

Documentação completa
  1. 01

    Baixe e extraia

    Baixe o recurso no seu Cfx.re Portal e extraia-o na sua pasta de recursos.

  2. 02

    Inicie depois das dependências

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

    ensure oxmysql
ensure ox_lib
ensure rarx_lib
ensure rarx_vmachines
  3. 03

    Defina o framework e o idioma

    Defina Config.Core no config.lua de acordo com o seu framework e escolha o idioma com a convar rarx-lang.

    setr rarx-lang "en"
  4. 04

    Libere o acesso e abra o painel

    Adicione a sua conta a um dos grupos de Config.AdminGroups ou conceda o ace personalizado e, depois, use /vmadmin no jogo.

Este é um resumo. A configuração, os exports, os events e a solução de problemas estão na documentação completa (em inglês).

Bom saber

Perguntas sobre Rarx Vending Machines

Não encontrou o que procura? Abra um ticket no nosso Discord com seu framework e o erro que aparece.

Pedir suporteMais sobre scripts de máquinas de venda para FiveM →
Quais frameworks o Rarx Vending Machines suporta?

QBCore, Qbox e ESX. Defina Config.Core como 'qb-core', 'qbx_core' ou 'esx' de acordo com o seu servidor.

O que preciso ter instalado?

oxmysql, ox_lib, rarx_lib e um dos inventários compatíveis. As tabelas do banco de dados são criadas automaticamente.

/vmadmin não faz nada. O que devo verificar?

A sua conta precisa estar em um dos grupos de Config.AdminGroups, ou você precisa do ace personalizado, por exemplo add_ace identifier.xxx vendings.admin allow.

Por que os itens não são entregues aos jogadores?

Defina Config.InventorySystem com o seu inventário ou 'auto', e verifique se os nomes dos itens que você vende existem nesse inventário.

Por que o prop de uma máquina não aparece, ou por que não há aviso [E]?

Aumente Config.RenderDistance e verifique se o modelo do prop é válido. Para o aviso, fique dentro de Config.InteractRadius da máquina.

Posso montar uma máquina com os meus próprios props?

Sim. A categoria personalizada começa vazia e permite que um administrador escolha qualquer prop interativo do catálogo.

Continue explorando

Ver tudo