Admin Commands

Admin commands and tools for managing Oxide Vending businesses and machines.

All commands require admin permissions. In QBCore, this is the admin permission level. In ESX, the admin or superadmin group. In standalone, the oxide.vending.admin ace permission.


Business Commands

/vendingbusiness [citizenid]

View a player's vending business information.

/vendingbusiness ABC12345

Output:

  • Business ID
  • Business name
  • Owner citizen ID
  • Level
  • Machine count / max
  • Total revenue
  • Uncollected balance
  • Items sold

/vendingcreatebusiness [citizenid] [name]

Create a vending business for a player (bypasses registration fee).

/vendingcreatebusiness ABC12345 "Joe's Snacks"

/vendingdeletebusiness [businessId]

Delete a business and all associated data.

/vendingdeletebusiness vend-abc123

Warning: This permanently deletes:

  • All machines owned by the business
  • All stock in those machines
  • All revenue records
  • All employee records
  • All transaction history
  • Progression data

Machine Commands

/vendinglist [type]

List all placed vending machines with detailed information.

/vendinglist
/vendinglist drinks

Output per machine:

  • Machine ID
  • Machine type
  • Business ID and name
  • World coordinates (x, y, z)
  • Cash balance
  • Status (active/inactive/broken)

Machines are sorted by business ID. An optional type filter restricts results to a single machine type. Works from both in-game and server console.

/vendingdelete [machineId]

Force delete a vending machine (no refund, no return to inventory).

/vendingdelete mach-abc123

/vendingsetstock [machineId] [item] [quantity]

Set stock for a machine (bypasses inventory requirements).

/vendingsetstock mach-abc123 water_bottle 50

/vendinggivemachine [playerId] [type]

Give a player an unplaced machine.

/vendinggivemachine 1 drinks

/vendingteleport [machineId]

Teleport to a machine's location.

/vendingteleport mach-abc123

/vendingnear [radius]

Find nearby vending machines sorted by distance. In-game only (requires player position).

/vendingnear
/vendingnear 200

Parameters:

  • radius - Search radius in meters (default: 100, min: 10, max: 1000)

Output per machine:

  • Machine ID
  • Machine type
  • Business name
  • Distance from player
  • Durability percentage
  • Status

Progression Commands

/vendingsetlevel [businessId] [level]

Set a business's progression level (1-10).

/vendingsetlevel vend-abc123 5

Note: This also sets the XP and revenue to the threshold values for that level.


NPC Sales Commands

/vendingnpc <toggle|stats|force>

Consolidated NPC sales management command.

/vendingnpc toggle
/vendingnpc stats
/vendingnpc force
SubcommandDescription
toggleEnable or disable NPC sales simulation
statsView total NPC sales count, revenue, and active status
forceForce a simulation tick with boosted sale chance (for testing)

All subcommands work from both in-game and server console.


Debug Commands

/vendingdebug <subsystem> [args]

Consolidated debug and migration tools.

/vendingdebug bank [businessId]
/vendingdebug daily [businessId]
/vendingdebug boxes [count]
/vendingdebug clearboxes
/vendingdebug progression <status|init|create <id>>

Subsystems

bank [businessId]

Debug banking integration for a business. If no business ID is provided, uses the calling player's business.

Output:

  • Config.UseBanking status
  • Config.BusinessAccountPrefix
  • oxide-banking resource state
  • Expected account name
  • Account existence check
  • Account balance
  • Account type and owner

daily [businessId]

Debug daily bonus state for a business. Output goes to server console.

Output:

  • Cache data (last_daily_bonus, streak)
  • Database data (raw and normalized)
  • Today/yesterday comparison

boxes [count]

Spawn test boxes on the pickup pallet for visual debugging. In-game only.

/vendingdebug boxes 6

clearboxes

Clear all pickup boxes from the pallet and database.

/vendingdebug clearboxes

progression <status|init|create <id>>

Progression management tools for migration and debugging.

ActionDescription
statusView which businesses have/don't have progression records
initCreate progression records for all existing businesses
create <id>Create a progression record for a specific business
/vendingdebug progression status
/vendingdebug progression init
/vendingdebug progression create vend-abc123

Command Reference Table

CommandArgumentsDescription
/vendingbusiness<citizenid>View player's business
/vendingcreatebusiness<citizenid> <name>Create business for player
/vendingdeletebusiness<businessId>Delete a business
/vendinglist[type]List all machines with details
/vendingnear[radius]Find nearby machines by distance
/vendingdelete<machineId>Force delete machine
/vendingsetstock<machineId> <item> <qty>Set machine stock
/vendinggivemachine<playerId> <type>Give player a machine
/vendingteleport<machineId>Teleport to machine
/vendingsetlevel<businessId> <level>Set business level
/vendingnpc<toggle|stats|force>NPC sales management
/vendingdebug<subsystem> [args]Debug and migration tools

Server Console Commands

All admin commands can also be run from the server console (source = 0), except /vendingnear which requires a player position:

vendinglist
vendinglist drinks
vendingnpc toggle
vendingnpc stats
vendingdebug progression status
vendingdebug progression init

Admin Exports

For programmatic admin access, see Exports & API:

  • AdminDeleteBusiness(businessId, adminIdentifier)
  • AdminDeleteMachine(machineId, adminIdentifier)

Transaction Logging

Admin deletions are logged in the transaction table with:

  • transaction_type = 'admin_delete'
  • player_citizenid = adminIdentifier

This provides an audit trail for administrative actions.