Agency-Vending
Vending machine script with 4 machine types (Soda, Coffee, Snacks, Water Cooler) and automatic detection of GTA V.
01Overview
Vending machine script with 4 machine types (Soda, Coffee, Snacks, Water Cooler) and automatic detection of GTA V vending props. Modern NUI with numpad selection (A1, B3), drag-and-resize capability, and a full player ownership system where players can buy machines, adjust prices, manage stock, and earn profits. Supports cash and AgencyPay card payments.
02Features
+Good to know
Agency-Vending adds interactive vending machines to your GTA V server, supporting soda, coffee, snacks, and water coolers. The script automatically detects compatible GTA V props and provides a modern user interface with numpad selection and drag-and-resize features. Players can own machines, manage stock, set prices, and receive profits. Both cash and AgencyPay card payments are supported, with optional card fee surcharges and an auto-payout system.
- Automatic Prop Detection
- Agency-Vending identifies and supports GTA V vending machine props without manual placement. This allows you to integrate vending machines into existing maps and interiors, making setup straightforward and reducing the need for custom mapping or object placement.
- Player-Owned Machines
- Players can purchase vending machines, set product prices within a specified range, manage inventory, and receive profits automatically. The ownership system enables players to become vendors, adding a business layer to your server’s economy.
- Customizable Admin Controls
- Admin permissions are managed by group (admin, superadmin, god) or via the ace right agency-vending.admin. The vending machine spawner command name is set in the config, allowing you to adjust access and command naming to fit your server’s needs.
?Frequently asked questions
What permissions are required for admin features?
Admin features can be restricted by group (admin, superadmin, god) or by assigning the ace right agency-vending.admin. This controls access to administrative actions such as spawning vending machines. Adjust these permissions according to your server’s staff structure.
What dependencies are needed to run Agency-Vending?
oxmysql is required for database operations. ESX or QBCore can be used, but are optional. ox_target or qb-target are optional for targeting interactions, and agency-phone is optional if you want to enable AgencyPay card payments.
How do I change the vending machine spawner command?
The spawner command name is set in the config under Config.SpawnerCommand. Edit this value to change the command players or admins use to spawn vending machines. Remember to restart Agency-Vending after making changes to the config.
What happens if a required dependency is missing?
If oxmysql is not installed, Agency-Vending will not function correctly because it relies on database operations. Optional dependencies like ox_target, qb-target, or agency-phone are only needed for their respective features and can be omitted if those features are not required.