# Imperium Store A comprehensive FiveM script for managing in-game stores, VIP systems, and Tebex integration on your server. ### Overview **is-store** is a professional-grade store management system designed for FiveM servers. It provides a seamless experience for players to purchase vehicles, items, and VIP memberships through an intuitive web-based interface. The script supports multiple frameworks, inventory systems, and notification providers, making it highly adaptable to any server setup. ### Main Features #### 🏪 Store System * **Permanent Store**: Browse and purchase from a curated catalog of vehicles and items * **Daily Shop (Ephemeral)**: Rotating daily inventory with exclusive vehicles and special offers * **Smart Search & Filtering**: Find exactly what you're looking for with advanced search capabilities * **Vehicle Preview**: Full 3D preview with performance specifications before purchase * **Test Drive**: Experience vehicles before buying with time-limited test drives #### 💎 VIP System * **Three VIP Tiers**: Bronze, Silver, and Gold membership levels * **VIP Salary Bonus**: Automatic salary increases for VIP members (25%, 50%, or 100%) * **VIP Inventory Bonus**: Increased carrying capacity for premium members * **VIP Shop Access**: Exclusive products available only to VIP members * **VIP Perks**: Customizable benefits per tier (autopilot, AFK zones, etc.) * **Time-Based Membership**: Configurable VIP duration with automatic expiration #### 🎁 Loyalty & Rewards Program * **Point System**: Earn loyalty points for every coin spent * **Tier Progression**: Unlock rewards as you climb the loyalty ladder * **Exclusive Badges**: Display your loyalty status to other players * **Discount Rewards**: Get percentage-based discounts on purchases * **Priority Support**: Platinum and Diamond tiers receive exclusive perks #### 💰 Payment & Currency * **Coin System**: In-game currency for all purchases * **Tebex Integration**: Seamless PayPal, credit card, and cryptocurrency payments * **Multiple Package Types**: Coins, VIP passes, and special bundles * **Admin Currency Management**: Grant coins to players for promotions or events * **Secure Transactions**: Escrow-protected system prevents fraud #### 🛠️ Framework & System Support **Frameworks:** * ESX Legacy * QBCore **Inventory Systems:** * ox\_inventory (Recommended) * qb-inventory * qs-inventory * esx\_inventory **Notification Systems:** * ox\_lib (Recommended) * ESX Notifications * QBCore Notifications * Mythic Notifications * okokNotify * Custom **Target/Interaction Systems:** * ox\_target * qb-target * qtarget **Vehicle Key Systems:** * is-smartkeys * qb-vehiclekeys * qs-vehiclekeys * wasabi\_carlock * mk\_vehiclekeys * cd\_garage * okokGarage * And 5+ more supported #### 📊 Admin Features * **Admin Commands**: Easy management of store inventory and player coins * **Webhook Logging**: Discord integration for all transactions and actions * **Shop Refresh**: Manually rotate the daily shop inventory * **Player Analytics**: Track purchases, VIP activity, and sales trends * **Configuration Control**: Flexible settings for every aspect of the system #### 🎮 Player Features * **Autopilot Command**: VIP members can use `/autopilot` for quick travel * **AFK Zone**: Designated areas where players can AFK safely with VIP benefits * **Profile Page**: View purchase history, loyalty status, and VIP information * **Promo Codes**: Support for time-limited discount codes * **Wishlist**: Save vehicles for later purchase #### 🌐 Multi-Language Support * English (en) * French (fr) * Spanish (es) * Portuguese (pt) * German (de) * Italian (it) All interface text, notifications, and menus are fully localized. #### 📦 Database Integration * **oxmysql Support**: Reliable and efficient database handling * **Automatic SQL Setup**: Database tables created automatically on first run * **Player Data Persistence**: Coins, VIP status, and loyalty points saved securely ### Quick Start 1. **Install**: Place the `is-store` folder in your server resources 2. **Configure**: Edit `config/config.lua` and `config/vip_config.lua` 3. **Start**: Add `ensure is-store` to your `server.cfg` 4. **Integrate Tebex**: Set your Tebex secret key for payment processing For detailed installation instructions, see the Installation Guide. ### Configuration #### Essential Settings * **Server Name**: Displayed in the UI * **Discord Link**: Invite link for community * **Framework**: Automatic detection available * **VIP Salary Bonus**: Enable/disable automatic salary increases * **Tebex Integration**: Link your store to real-world payments #### Customization * **Categories**: Add or remove product categories * **Products**: Define permanent and ephemeral inventory * **VIP Tiers**: Configure bonus percentages and duration * **Webhooks**: Set up Discord logging for all transactions * **Locales**: Add or modify language strings ### Advanced Features #### VIP Salary Integration The salary bonus system integrates seamlessly with both ESX and QBCore frameworks without modifying core files. VIP members automatically receive salary increases that scale with their tier level. #### Daily Shop Rotation Configure how many items appear daily, which products can be promoted, and set custom refresh times. The system supports fully configurable ephemeral inventory with automatic rotation. #### Bundle Packs Create special packages combining vehicles, items, money, and VIP time. Perfect for seasonal promotions or welcome packages. #### Tebex Monetization Convert Tebex package purchases directly into in-game rewards. Support for coins, VIP passes, and complex bundles with a single configuration file. ### Technical Details * **Optimized Performance**: Efficient database queries and caching system * **Export Functions**: Clean API for server-to-server communication * **Error Handling**: Comprehensive error logging and safeguards * **Escrow Protected**: FiveM Escrow System ensures code integrity ### Support & Community * **GitBook Documentation**: Comprehensive guides and troubleshooting * **Discord Community**: Join our server for support and updates * **Regular Updates**: New features and improvements released regularly * **Configuration Help**: Detailed examples for every setting ### Version **Current Version**: 1.0.0\ **Last Updated**: May 2026 ### License This script uses the FiveM Escrow System. All code is protected and verified by Cfx.re. *** For more information and detailed guides, visit the [GitBook Documentation](https://imperiumscripts.gitbook.io/imperium-scripts/) or join the [Discord Community](https://discord.gg/u5TxHBjQdS). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://imperiumscripts.gitbook.io/imperium-scripts/scripts/imperium-store.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.