VIP System V2

VIP System V2 - Automated Tebex Integration for FiveM Monetization

VIP System V2 is the ultimate automated monetization solution for FiveM servers, providing seamless Tebex integration that lets players purchase credits and instantly redeem them for vehicles, weapons, items, jobs, houses, bundles, and money - all through an in-game interface. This fully open-source system eliminates manual admin work by automating the entire purchase-to-delivery pipeline, working with both ESX and QBCore frameworks across all major phone systems.

What's Included

You'll receive a complete automated VIP shop system with Tebex integration, credit purchase automation, anti-cheat protection, and support for six different product categories (vehicles, weapons, items, jobs, houses, bundles, and money). The system includes everything you need to monetize your server: Tebex command integration, offline purchase handling, custom license plate assignment, phone number customization, and compatibility with all major MySQL wrappers. This is a fully open-source resource with no escrow restrictions, giving you complete control over customization.

Automated Monetization Pipeline

VIP System V2 transforms your Tebex store into a fully automated vending machine for in-game goods. Players visit your Tebex store, purchase credit packages, and the system automatically adds credits to their account - even if they're offline. When they log in, they can browse the VIP shop through any compatible phone system, select items they want, and instantly receive them in-game. No admin intervention required, no manual deliveries, no tickets - just pure automation that runs 24/7.

Comprehensive Product Categories

The system supports six distinct product types, each with specialized handling to ensure proper delivery and integration with your server's framework:

• Vehicles - Players can purchase cars, motorcycles, aircraft, and boats with custom license plates and automatic garage insertion. Vehicles are spawned directly into the player's owned vehicles database with customizable plates for personalization. Supports both ESX and QBCore vehicle systems with proper ownership assignment and persistent storage.
• Weapons - Sell any weapon from your server's weapon list with configurable ammunition counts. Weapons are added directly to player inventory with proper licensing checks and framework-specific item handling. Perfect for selling unique firearms, rare weapon skins, or starter weapon packages.
• Items - Grant any inventory item with configurable quantities, from rare crafting materials to consumables. Items integrate with your framework's inventory system (ESX or QBCore) and respect weight limits and inventory slots. Ideal for selling resource packs, rare items, or exclusive collectibles.
• Jobs - Instantly assign players to whitelisted jobs or factions without admin approval. The system updates their job rank and salary in the database, perfect for selling VIP jobs, exclusive careers, or faction memberships. Works with both ESX job systems and QBCore gang/job frameworks.
• Houses - Sell property ownership directly through the VIP system, granting players instant access to houses, apartments, or warehouses. Integrates with popular housing scripts to assign ownership and generate access keys automatically.
• Bundles - Create product bundles that combine multiple items, weapons, vehicles, and money into discounted packages. Perfect for starter packs, criminal bundles, or business owner packages that deliver multiple products in one purchase.
• Money - Sell in-game currency (cash, bank money, or black money) with configurable amounts. Money is added directly to the player's framework accounts with transaction logging for anti-cheat monitoring.

Tebex Integration and Offline Purchases

The heart of VIP System V2 is its seamless Tebex integration. When you configure a package in Tebex, you add a simple game server command that executes on purchase:

vipsystemv2_credit_purchase {transid: {transaction}, credit: 1000}

This command automatically credits the buyer's account with the specified amount, using the transaction ID to prevent duplicate credits and fraud. The critical feature is offline execution - even if the player isn't online when they make the purchase, the system queues the credit addition and processes it when they next connect. This means sales happen 24/7 without requiring players to be in-game or admins to manually process orders.

Custom License Plate and Phone Number Assignment

When players purchase vehicles through the VIP system, they can specify custom license plates during checkout, adding personalization to their high-value purchases. Similarly, phone number customization lets VIP members choose memorable numbers instead of random assignments. These customization options add perceived value to purchases and let players express their identity through their in-game possessions.

Anti-Cheat Protection

All VIP System V2 code includes built-in cheat protection to prevent exploits and fraud:

• Transaction Verification - Every credit purchase is verified against Tebex transaction IDs to prevent duplicate redemptions
• Credit Balance Checks - Players can't purchase items worth more credits than they have, with server-side validation
• Purchase Logging - All transactions are logged to the database with timestamps, transaction IDs, and item details for audit trails
• Item Validation - The system verifies items exist in your configuration before granting them, preventing invalid purchases
• Framework Integration - Money and item additions go through framework functions, respecting inventory limits and anti-duplication systems

Framework Compatibility

VIP System V2 works with both major FiveM frameworks, automatically detecting which one your server uses and adapting its behavior accordingly:

• ✅ ESX Legacy - Full support for ESX 1.9.x and Legacy versions, integrating with es_extended job systems, inventory, and economy functions
• ✅ QBCore - Native compatibility with QB-Core, using qb-core functions for inventory management, job assignment, and money handling

MySQL Wrapper Compatibility

The system works with all three popular MySQL wrappers used in FiveM, so you don't need to change your existing database setup:

• oxmysql - Modern async MySQL wrapper with optimal performance
• mysql-async - Legacy async wrapper still used on many servers
• ghmattimysql - Alternative MySQL solution with similar functionality

Phone System Integration

The VIP shop interface is accessible through any phone system that supports basic framework integration. Players open their phone, navigate to the VIP app, browse available products across all six categories, and make purchases with their credit balance. The interface shows credit balance, product prices, available items, and purchase history all in one convenient location.

Perfect For

• Server owners wanting to monetize without constant admin involvement
• Communities selling VIP perks, exclusive items, and starter packages
• Servers with Tebex stores needing automated product delivery
• Admins tired of manually processing purchase tickets and requests
• Servers wanting to offer vehicle customization (plates) and phone number selection
• Communities needing audit trails and transaction logging for accountability

Easy Configuration

The config file uses a simple, readable structure that makes adding new products straightforward. You define each product with its category, price in credits, and framework-specific data (spawn codes, item names, job identifiers, etc.). The system handles all the complexity of framework integration, inventory management, and database updates - you just configure what's available and at what price.

Installation Overview

1. Extract vip-system-v2 to your server's resources folder
2. Import the provided SQL file to create credit and transaction tables
3. Configure config.lua with your framework (ESX or QBCore) and MySQL wrapper
4. Add products to the configuration file across all six categories
5. Add ensure vip-system-v2 to your server.cfg
6. Configure Tebex packages with the credit purchase command
7. Enable offline execution for Tebex commands in package settings
8. Test with a small credit package purchase to verify automation

Tebex Setup Walkthrough

Setting up Tebex integration is straightforward with the included documentation. You create credit packages in your Tebex store (e.g., 1000 Credits - $10, 5000 Credits - $40), then add the game server command to each package. The command format includes the transaction ID variable (automatically filled by Tebex) and your chosen credit amount. You enable offline execution in the package settings so purchases process even when players aren't online. That's it - your store is now fully automated.

Revenue Opportunities

VIP System V2 opens up multiple monetization strategies for server owners:

• Credit Packages - Sell credits at various price points ($5, $10, $25, $50) with bulk discounts
• Starter Bundles - Combine vehicles, weapons, items, and money into beginner packages for new players
• VIP Jobs - Sell access to exclusive, high-paying jobs that regular players can't access
• Property Sales - Monetize premium housing locations and luxury properties
• Vehicle Collections - Sell rare cars, aircraft, or boat packages with custom plates
• Resource Packs - Bundle rare crafting materials and consumables for convenience

Open Source Advantages

Unlike escrow-locked VIP systems, VIP System V2 is completely open source, giving you full access to all code. This means you can customize the shop interface to match your server's branding, add new product categories beyond the default six, integrate with custom scripts (drugs, businesses, factions), modify the credit calculation or pricing logic, and fix bugs yourself without waiting for developer updates. Open source also means easier debugging, community contributions, and no licensing headaches.

What Makes It Stand Out

VIP System V2 stands out through complete automation and comprehensive product support. While other VIP systems might handle vehicles or items, VIP System V2 supports six distinct product categories with specialized handling for each. The Tebex integration with offline purchase support means your store operates 24/7 without admin intervention - players can buy credits at 3 AM and receive them automatically. The anti-cheat protection and transaction logging provide accountability and fraud prevention. The open-source nature gives you unlimited customization potential, and the dual framework support (ESX and QBCore) means you're not locked to one ecosystem. The custom license plate and phone number features add personalization that increases perceived value of purchases.

Requirements

• ESX Legacy (1.9.x or higher) OR QBCore Framework
• MySQL database with one of: oxmysql, mysql-async, or ghmattimysql
• Active Tebex store account for payment processing
• Phone system compatible with framework integration (most popular phones work)
• Basic understanding of Tebex command configuration

Technical Specifications

• Performance: Minimal overhead, credit checks only when shop is opened
• Database: Efficient tables for credits and transaction history with indexing
• Security: Server-side validation for all purchases and credit operations
• Compatibility: Works with ESX, QBCore, all MySQL wrappers, and standard phone systems
• Source Code: Fully open source, no escrow, complete customization freedom

Support and Documentation

VIP System V2 includes comprehensive setup documentation covering Tebex integration, product configuration, framework setup, and troubleshooting common issues. The support system provides assistance with configuration questions, Tebex command setup, and integration with custom scripts. Regular updates maintain compatibility with framework updates and new FiveM features.

Help for Setup

How to Add Credits with Tebex

1. Select the Package: In your Tebex dashboard, navigate to the specific package where you want to add credit functionality.
2. Add a Game Server Command: Choose the server on which you want this command to run.
3. Set the Purchase Command: Configure the command to execute whenever the package is purchased.
4. Enter the Command: Use the following format to specify the command:
   vipsystemv2_credit_purchase {transid: {transaction}, credit: credit amount}
   • Replace credit amount with the desired number of credits.
   Example:
   vipsystemv2_credit_purchase {transid: {transaction}, credit: 1000}
   This example will grant the user 1000 credits upon purchase.
5. Ensure Offline Execution: Click the settings icon (⚙️) next to the command and enable the option to execute the command even if the player is offline.
6. Save Changes: Press the Update button to save your settings.

Related vRP Scripts

• 0R IDCard
• FaxCAD
• AC Radio
• Izzy – Admin Menu