# PJ-premiums - Premium FiveM Store
gh-end, glassmorphism-inspired premium store for FiveM servers. This script provides a seamless and immersive shopping experience for players to purchase exclusive items, vehicles, and packs using a points-based currency system.
## 🌟 Features
💎 Modern UI**: Sleek, responsive, and high-quality glassmorphism design with premium animations.
🚀 3D Interaction**: Custom floating interaction UI that attaches to NPCs' heads in the game world.
📦 Reward Boxes**: premium packs function as "boxes" that grant multiple items and cash instantly upon purchase.
🎰 Gacha System**: Integrated gacha (loot box) mechanic with tiered rewards (Common to Legendary) and configurable probabilities.
🚗 Vehicle Persistence**: Automated vehicle insertion into player garages with unique license plate generation.
⚙️ Multi-Framework**: Native support for **QB-Core** and **ESX**.
🎒 Inventory Support**: Built-in support for **qb-inventory** and **ox_inventory**, including dynamic image loading.
📍 Configurable Locations**: Support for multiple NPC store locations with custom blips.
💰 Points System**: Fully managed points currency saved in the database.
## 🛠️ Installation
-
Upload Files: Copy the `pj-premiums` folder into your resources directory.
-
Database Setup: Run the provided `install.sql` file in your database to add the `points` column to your player data.
-
Configure: Open `config.lua` and set your preferred framework, inventory system, and product listings.
-
Images: Ensure your item images are in the designated inventory paths or providing direct URLs in the config.
-
Start: Add `ensure pj-premiums` to your `server.cfg`.
⚙️ Requirements
- `oxmysql`
- `qb-core` OR `es_extended`
- `qb-inventory` OR `ox_inventory`
*For support and updates, join our Discord community.*