Oxide Studios

Complete vending machine business system for FiveM servers with multi-framework support, business management, NPC sales simulation, and progression system.

Oxide Vending is a comprehensive vending machine business system designed for FiveM servers. It supports QBCore, QBx (Qbox), ESX, and Standalone frameworks through an auto-detecting bridge system. Players can own and operate vending machine businesses, featuring a modern NUI dashboard, passive income through NPC sales, and a 10-level progression system.

Key Features

Multi-Framework Support - Auto-detects QBCore, QBx, ESX, or Standalone via bridge system
Business System - Register businesses, hire employees, and manage permissions
Machine Types - Four machine types: drinks, snacks, general, and electronics
Interactive Placement - Ghost preview placement system with collision detection
NPC Sales Simulation - Server-side passive income with time, location, and competition factors
Progression System - 10-level progression with XP, milestones, and unlockable rewards
NUI Dashboard - Full-featured management interface with analytics and transaction history
Warehouse System - Physical warehouse for bulk storage and wholesale ordering
Banking Integration - Optional oxide-banking support for separate business accounts
Rate Limiting - Configurable anti-abuse system for all player actions

Quick Start

-- Open the vending dashboard
exports['oxide-vending']:OpenDashboard()

-- Get business stats
local stats = exports['oxide-vending']:GetBusinessStats(businessId)

-- Check business level
local level = exports['oxide-vending']:GetBusinessLevel(businessId)

Requirements

Always Required

Requirement	Purpose
oxmysql	Database operations
ox_lib	Shared library

Framework-Specific

Framework	Dependencies
QBCore	qb-core, qb-target, qb-inventory, qb-radialmenu, qb-input
QBx (Qbox)	qbx_core, ox_target, ox_inventory
ESX	es_extended, ox_target, ox_inventory (auto-detected)
Standalone	ox_inventory, ox_target

Optional Dependencies

Resource	Purpose	Fallback
oxide-banking	Separate business accounts	Revenue goes to owner's bank
qb-weathersync	In-game time for NPC sales	Falls back to real time
oxide-menu	Primary menu system	Falls back to framework-appropriate menu

Documentation

Installation Guide - Get started with Oxide Vending
Configuration - Configure all settings and options
Features - Explore business, machine, and revenue systems
NPC Sales - Understand passive income simulation
Progression - Level system and rewards
Exports & API - Complete API reference
Admin Commands - Administration tools
Troubleshooting - Common issues and solutions

Oxide Vending