A Fully Interactive Loop of Jobs, Purchases & Crime
The Dynamic Vending Machine System creates a gameplay loop that ties together restocking, buying drinks, and lockpicking into one immersive experience. Players can take up a city job to refill vending machines โ directly influencing drink availability across the map. Neglected machines run dry, while the bold may try to break in and earn black money instead.
๐ Core Features
1. ๐ผ Vending Machine Job System
A city-based delivery job where players restock vending machines, ensuring they're operational for public use.
Job Workflow:
Players begin at a designated job center.
Upon starting, they automatically receive a work uniform.
A job vehicle becomes available once the uniform is equipped.
Players collect supply boxes from the vehicle and deliver them to various vending machines.
Routes & Checkpoints:
Six default delivery routes included.
Fully expandable via the config file.
Each route includes multiple vending machine checkpoints that must be restocked.
Reward System:
Earn money for every machine successfully refilled.
Total payout per route is configurable (e.g., $150โ$200).
Partial completions provide proportional rewards, but no bonus items and donโt count toward machine stock refresh.
Bonus Items:
Completing the full route gives a chance to earn drink items (e.g., Cola, Sprunk).
Bonus drop chances are configurable via percentage values.
2. ๐ฅค Drink Purchasing System
Vending machine drink purchases are dynamically tied to how well players perform their restocking duties.
Buying Drinks:
Players can purchase drinks from machines (e.g., Cola: $5, Sprunk: $5).
All prices are fully customizable.
Stock Depletion Mechanism:
Machines become empty if not refilled regularly.
Availability check runs at configurable intervals.
Example:
Config.RequiredJobsPerTimer = 2โ Two completed jobs required.Config.Timer = 60โ Every 60 minutes, the system checks job completion.
If requirements arenโt met, machines are automatically emptied.
Once the minimum number of jobs is completed, vending machines return to active status.
3. ๐ Lockpicking & Black Money
Add some high-risk, high-reward criminal gameplay with vending machine break-ins.
Lockpicking Mini-Game:
Attempt to crack vending machines to obtain black money.
Includes a skill-based mini-game with adjustable difficulty.
Players must time key presses correctly to succeed.
Rewards:
Successful attempts yield 10โ30 black money (fully customizable).
Risks:
Lockpicks can break on failure.
Police alerts may be triggered on failed attempts.
Both are configurable (e.g., 45% chance to break pick, 25% chance for alert).
Cooldown System:
Each machine has an individual cooldown timer (default: 5 minutes).
Prevents repeated abuse, but other machines can still be targeted.
4. โ๏ธ Full Customization & Framework Compatibility
Framework Support:
Built for QBCore and ESX frameworks.
Interaction Compatibility:
Supports both ox_target and qb-target.
Notification Systems:
Choose from multiple options:
ox_lib
tnotify
okoknotify
Framework default (ESX/QBCore)
print (for testing)
Highly Configurable:
Add custom job locations.
Define custom work uniforms.
Enable Discord webhook integration for event logging.
๐ฆ Requirements
ESX or QBCore Framework
ox_lib
- OX Target or QB Target
๐ ๏ธ Configuration Guide:
All configuration options and setup instructions can be found here:
๐ย azakit-development.gitbook.io/docs
HELP:
You can find Discord: https://discord.gg/DmsF6DbCJ9