📥 Installation

1. Requirements

17mov_VendingMachines requires oxmysql.

Make sure oxmysql is installed and started before Vending Machines.

The resource automatically detects supported frameworks, inventories and interaction systems, so your framework, inventory and target resource should also start before Vending Machines.

2. Add the resource

Place the 17mov_VendingMachines folder inside your server's resources/ directory.

Then add this line to your server.cfg:

ensure 17mov_VendingMachines

We recommend keeping it at the end of server.cfg, after your framework, inventory and target resources.

Start order matters. If Vending Machines starts before your framework or inventory, automatic bridge detection may fall back to standalone mode.

3. Database setup

The database is installed automatically by default when:

Config.InstallDatabaseAutomatically = true

4. Add the required items

Vending Machines uses two items:

Item	Purpose
vending_machine	Used to place a new vending machine
vending_tablet	Used to open the management tablet when tablet access is configured to use an item

Choose your inventory below and copy the provided code into the indicated file or database table.

If you change Config.RequireItem.ItemName or Config.Tablet.ItemName, make sure the same item names are used in your inventory configuration.

QBCore

Add the following entries to:

qb-core/shared/items.lua

['vending_machine'] = {
    name = 'vending_machine',
    label = 'Vending Machine',
    weight = 15000,
    type = 'item',
    image = 'vending_machine.png',
    unique = true,
    useable = true,
    shouldClose = true,
},

['vending_tablet'] = {
    name = 'vending_tablet',
    label = 'Vending Tablet',
    weight = 700,
    type = 'item',
    image = 'vending_tablet.png',
    unique = true,
    useable = true,
    shouldClose = true,
},

ESX

If you use the default ESX database item system, run:

INSERT IGNORE INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
    ('vending_machine', 'Vending Machine', 15, 0, 1),
    ('vending_tablet', 'Vending Tablet', 1, 0, 1)
;

ox_inventory

Add the following entries to:

ox_inventory/data/items.lua

['vending_machine'] = {
    label = 'Vending Machine',
    weight = 15000,
    stack = false,
    close = true,
    consume = 0,
    server = {
        export = '17mov_VendingMachines.vending_machine'
    },
},

['vending_tablet'] = {
    label = 'Vending Tablet',
    weight = 700,
    stack = false,
    close = true,
    consume = 0,
    server = {
        export = '17mov_VendingMachines.vending_tablet'
    },
},

5. Add item images

Copy the included item images to the image folder used by your inventory:

installation/images/vending_machine.png
installation/images/vending_tablet.png

6. Restart and verify

Restart your server after completing the installation.

If the resource reports that no supported framework or inventory was detected, check your resource start order and make sure 17mov_VendingMachines starts after them.

If automatic detection does not match your setup, bridge selection can be configured manually in shared/bridge.lua using Config.Framework, Config.Inventory and Config.Interaction.

Next steps

Once Vending Machines is installed and running correctly, you can customize products, placement rules, the wholesaler, interactions and other behavior in the configuration.

⚙️ Continue to Configuration →