Expendedoras · Guía de FiveM

Script de máquinas expendedoras para FiveM: QBCore, Qbox y ESX

Las máquinas expendedoras son pequeñas, pero los jugadores las usan constantemente: una bebida después del turno, algo de picar en el hospital, un café en la sala de descanso de la oficina. Cuando las máquinas de tu mapa son props fijos en el código con productos fijos, cada cambio supone editar la configuración y reiniciar.

Esta guía cubre qué esperar de un script de máquinas expendedoras para FiveM en QBCore, Qbox y ESX, cómo resuelve Rarx Vending Machines cada punto, qué necesita instalado y las preguntas que se hacen los dueños antes de añadirlo.

Qué revisar antes de comprar

Qué debe hacer un buen script de máquinas expendedoras para FiveM

Usa estos puntos para comparar recursos de máquinas expendedoras, incluido el nuestro.

  1. Máquinas que coloca el staff, en el juego

    Los admins deberían crear y colocar las máquinas donde están. Rarx Vending Machines tiene un panel de administración y un editor de colocación con una leyenda en pantalla para mover, rotar y confirmar cada prop.

  2. Catálogos por tipo de máquina

    Las de bebidas, aperitivos, café y tabaco rellenan sus props automáticamente, y una categoría personalizada te permite montar una máquina con cualquier prop interactivo del catálogo.

  3. Precios y stock opcional

    Cada producto tiene su propio precio y, si quieres escasez, su propio stock. Los grupos, los productos y las ubicaciones se guardan en la base de datos, así que no se pierde nada al reiniciar.

  4. Productos entregados a través de tu inventario

    El inventario que ya usas debería ser el que entrega y comprueba los productos. Hay nueve inventarios compatibles, que se detectan automáticamente o se fijan en la configuración.

  5. Acceso y registros

    La gestión debería estar limitada al staff. Aquí el acceso se controla con grupos ACE, y los registros por webhook guardan cada grupo, producto y máquina que se crea, actualiza o elimina.

  6. Ligero en el cliente

    Una distancia de renderizado y un radio de interacción configurables mantienen el streaming de props eficiente, y el aviso [E] solo aparece cuando el jugador está a su alcance.

Recursos de RARX

El script de máquinas expendedoras de RARX

Un solo recurso para todas las máquinas expendedoras de tu mapa.

Rarx Vending Machines — recurso de FiveM (Scripts)
Nuevo

Scripts

Rarx Vending Machines

Máquinas expendedoras colocadas en el juego con sus propios productos, precios y stock para QBCore, Qbox y ESX.

  • QBCore
  • ESX
  • QBox
Gratis

Rarx Vending Machines

Rarx Vending Machines sustituye los props de máquinas fijos en el código por máquinas que tu staff coloca y abastece desde un panel en el juego. Las máquinas se organizan en grupos que comparten catálogo y lista de productos, y todo se guarda en la base de datos, así que no hay que editar archivos de configuración ni reiniciar nada. Las tablas de la base de datos se crean automáticamente en el primer arranque.

Funciones principales

  • Gestión en el juego. Crea, edita y elimina grupos de máquinas y artículos desde un panel de administración sin reinicios.
  • Editor de colocación. Coloca props en el mapa y muévelos, gíralos y confírmalos con una leyenda en pantalla.
  • Precios y stock. Precio por artículo y stock opcional, guardados en la base de datos.
  • Nueve inventarios. Detecta automáticamente tu inventario o te deja fijar uno de los sistemas compatibles.

Compatibilidad

Frameworks, inventarios y dependencias

Sacado de los datos del producto y de su documentación. El framework se define en la configuración; el inventario se puede detectar.

FunciónRarx Vending Machines
Nombre del recursorarx_vmachines
FrameworksQBCore, Qbox, ESX
Configuración del frameworkPon Config.Core en config.lua a 'qb-core', 'qbx_core' o 'esx'.
Recursos necesariosoxmysql, ox_lib, rarx_lib, A supported inventory
Recursos opcionalesNinguno
Inventariosrarx_inventory, ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory, core_inventory
Base de datosTodas las tablas rarx_vmachines_* se crean automáticamente en el primer arranque. No hace falta importar SQL.
IdiomasInglés, Español
DocumentaciónEn esta web

Planificación

Cómo planificar las máquinas expendedoras de tu servidor

Agrupa las máquinas por lugar, no solo por tipo. Un hospital, una comisaría y una oficina pueden tener cada uno su propio grupo de café con productos y precios distintos, y al cambiar un grupo se actualizan todas sus máquinas. Mantén los nombres de los productos que vendes idénticos a los de tu inventario, ya que es ese inventario el que los entrega y comprueba.

Usa el stock donde la escasez aporte rol y desactívalo donde solo frustraría a los jugadores. Las máquinas en lugares apartados o zonas de eventos son buenas candidatas para un stock limitado; las bebidas y aperitivos de diario en zonas concurridas suelen funcionar mejor sin límite. Los registros por webhook de grupos, productos y máquinas te ayudan a ver quién cambió un precio o movió una máquina.

Instalación

Cómo instalar un script de máquinas expendedoras en FiveM

Un resumen de la instalación. La documentación explica las categorías, los permisos y los registros.

Documentación completa
  1. 01

    Descárgalo desde el Cfx.re Portal

    Descarga el recurso y extrae rarx_vmachines en tu carpeta de recursos.

  2. 02

    Arráncalo después de sus dependencias

    oxmysql, ox_lib y rarx_lib deben arrancar antes que rarx_vmachines. Las tablas se crean en el primer arranque.

  3. 03

    Define framework, inventario e idioma

    Pon el core en qb-core, qbx_core o esx, deja el inventario en auto o fija el tuyo, y elige el idioma con la convar rarx-lang.

  4. 04

    Da acceso y coloca las máquinas

    Añade tu cuenta a uno de los grupos de admin o concede el ace personalizado, y abre el panel con /vmadmin.

Si los productos no llegan a los jugadores, comprueba que los nombres de los productos que vendes existen en tu inventario. Documentación completa: Rarx Vending Machines

Conviene saber

Preguntas frecuentes sobre scripts de máquinas expendedoras

¿Qué frameworks admite Rarx Vending Machines?
QBCore, Qbox y ESX. Define el core en config.lua según tu servidor.
¿Qué inventarios son compatibles?
rarx_inventory, ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory y core_inventory.
¿Tengo que importar el SQL?
No. Todas las tablas se crean automáticamente en el primer arranque.
¿Puedo limitar cuántos productos tiene una máquina?
Sí. El stock es opcional por producto. Desactívalo para ventas ilimitadas o actívalo para crear escasez.
¿Puedo montar una máquina con mis propios props?
Sí. La categoría personalizada empieza vacía y permite a un admin elegir cualquier prop interactivo del catálogo.
¿Por qué no aparece el aviso [E] en una máquina?
El jugador debe estar dentro del radio de interacción. Si no se ve ni el prop, aumenta la distancia de renderizado y revisa el modelo del prop.

Sigue explorando

Abastece tu ciudad en minutos

Rarx Vending Machines funciona en QBCore, Qbox y ESX con nueve inventarios. ¿Dudas? Pregúntanos en Discord.