VIP System

Overview

The VIP System allows server administrators to manage, automate, and synchronize VIP memberships across multiple server systems.

Core Features

• Staff VIP Management – Assign, edit, and remove VIP memberships through the in-game admin menu.
• Redeemable VIP Codes – Generate codes that players can redeem for VIP access.
• Player Redeem Command – Players can redeem codes using /code (configurable).
• Tebex Integration – Optional console command (gcmtebex) for automated purchases.
• Discord Role Sync – Automatically assign or remove Discord roles when VIP status changes.
• VIP Paycheck Bonuses – Optional salary bonuses based on VIP tier.
• Queue Priority Sync – Automatically updates queue priority using Queue:LoadVips.

Runtime Architecture

The system is designed to be framework-agnostic while maintaining compatibility with the most common FiveM ecosystems.

Framework Detection

The resource automatically detects and supports:

• qb-core
• es_extended

Core Dependencies

Required libraries used by the system:

• ox_lib
• oxmysql

Database Persistence

VIP data is stored in the following database tables:

• gcm_vips
• gcm_vips_codes

These tables handle VIP assignments, expiration times, and redeemable codes.

API Surface

The resource exposes server and client exports that allow other scripts to:

• Check if a player has VIP
• Grant or remove VIP status
• Retrieve VIP tier information

System Flow

The VIP lifecycle follows this process:

1. The resource starts and loads all active VIPs from the database.
2. An automatic cleanup scheduler checks for expired VIP memberships.
3. Staff members manage VIPs or generate codes using the VIP admin menu.
4. Players redeem VIP codes using the configured command (default: /code).
5. The internal VIP cache (listaVip) updates and queue priority is synchronized.
6. Optional integrations run automatically:
   • Discord role updates
   • Discord logging
   • VIP paycheck bonuses

The VIP System centralizes all VIP management in a single automated workflow.