Rarx Vending Machines

Overview#

RARX Vending Machines lets admins place fully configurable vending machines anywhere in the world from a clean in-game panel — no config editing or restarts. Each machine belongs to a categorized group (drinks, snacks, coffee, cigarettes or a custom prop set) with its own product list, per-item pricing and optional stock. Products are handed out and verified through whichever inventory you run, and every change is logged to Discord.

Features#

Requirements#

Installation#

1. Download & Extract

   Extract the resource into your resources folder.

2. Add to server.cfg

   server.cfgCopy

   ensure ox_lib
   ensure rarx_lib
   ensure rarx_vmachines

3. Set Core & Language

   server.cfgCopy

   setr rarx-lang "en"

   Then set Config.Core in config.lua to match your framework.

4. Grant Admin Access

   Make sure your account is in one of Config.AdminGroups (e.g. god, admin, superadmin) or grant the custom ace.

5. Open the Panel

   Use /vmadmin in-game to start creating groups and placing machines.

Configuration#

Core & Integration#

Config.Core = 'qb-core'            -- 'qb-core' | 'qbx_core' | 'esx'
Config.InventorySystem = 'auto'    -- 'auto' or a specific inventory (see below)
Config.AdminGroups = { 'god', 'admin', 'superadmin' } -- checked with IsPlayerAceAllowed

Behaviour#

Config.DebugMode      = false
Config.RenderDistance = 60.0       -- metres a machine prop streams in/out
Config.InteractRadius = 2.5        -- metres to show the [E] hint and open it
Config.ToastAnchor    = 'top-right'

Prop Catalogue#

The catalogue lists the props an admin can attach to a group. The fixed categories (drinks, snacks, coffee, cigarettes) auto-fill their props; the custom category starts empty and lets an admin cherry-pick any interactive prop.

Config.Catalog = {
    { category = 'drinks', label = 'Bebidas', props = {
        { model = 'prop_vend_soda_01',  label = 'Expendedora eCola',   interactive = true },
        { model = 'prop_vend_fridge01', label = 'Nevera de bebidas',   interactive = true },
        -- ...
    }},
    -- snacks, coffee, cigarettes ...
}

Supported Systems#

Using the Admin Panel#

1. Open

   Run /vmadmin (you must be in an admin ACE group).

2. Create a Group

   Add a group and pick a category. Fixed categories auto-load their props; custom lets you pick your own.

3. Add Items

   Add the products sold by that group, each with a price and optional stock.

4. Place Machines

   Pick a prop and place it in the world with the placement editor (move / rotate / confirm using the on-screen legend).

Discord Logging#

Audit logging is configured in config_server.lua. Set a webhook URL per event to relay changes to Discord:

return {
    active = true,
    channels = {
        groupCreated   = 'YOUR_WEBHOOK_URL',
        groupUpdated   = 'YOUR_WEBHOOK_URL',
        groupDeleted   = 'YOUR_WEBHOOK_URL',
        itemAdded      = 'YOUR_WEBHOOK_URL',
        itemUpdated    = 'YOUR_WEBHOOK_URL',
        itemRemoved    = 'YOUR_WEBHOOK_URL',
        machineCreated = 'YOUR_WEBHOOK_URL',
        machineUpdated = 'YOUR_WEBHOOK_URL',
        machineDeleted = 'YOUR_WEBHOOK_URL',
    },
}

Localization#

Set the language with the rarx-lang convar (shared by all RARX scripts):

setr rarx-lang "es"   # default: "en"

Translations live in translates/ (en.lua, es.lua) and use the RARX Lang (Locale) system.

Troubleshooting#

Support#

Need help? Reach out:

• Discord: discord.gg/rarxnetwork
• Store: rarxnetwork.com