Wert Coin Shop – Premium In-Game Store System

# 💎 Wert Coin Shop – Premium In-Game Store System

Transform your FiveM server with **Wert Coin Shop**, a complete in-game store system featuring a modern Vue.js interface, virtual currency management, product catalogs, discount codes, vehicle test drives, rentals, and subscriptions.

Players can purchase available coin packages through your Tebex store and use their balance to access configured in-game products and services. Manage products, categories, coupons, coin packages, and player balances directly through the in-game admin panel — without manual SQL changes, server restarts, or file editing.

## 🌟 Why Choose Wert Scripts?

**Premium Interface:** Responsive Vue.js UI with customizable branding, coin icons, accent colors, and dark/light themes.
**Easy Installation:** Automatic database table creation and migrations.
**Server-Side Security:** Prices, stock, purchase limits, and coupons are validated server-side.
**Developer Friendly:** Editable configuration, bridge files, hooks, events, and a documented export API.

## 🚀 Features

### 🛒 Modern Storefront

- Featured banner slider and product backgrounds.

- Customizable categories and product cards.

- Search, sorting, and availability filters.

- Sale prices, stock counters, and purchase limits.

- Product detail modals with reward previews.

### 🧺 Cart & Checkout

- Purchase multiple products in one checkout.

- Server-side price verification.

- Individual handling of failed product deliveries.

### 🏷️ Coupon System

- Percentage and fixed-value discounts.

- Minimum spend and usage limits.

- Expiration dates and category restrictions.

- Random coupon code generation.

### ⏳ Rentals & Subscriptions

- Hourly, daily, weekly, and monthly plans.

- Optional lifetime purchase options.

- Configurable renewals using the supported in-game currency.

- Automatic expiration handling and reward revocation.

- Dedicated subscription page with remaining-time indicators.

### 🚗 Vehicle Test Drives

- Test-drive functionality for vehicle products.

- Configurable durations, attempt limits, and cooldowns.

- Private routing buckets for isolated sessions.

- Optional dealership NPCs, map blips, and spawn points.

- Automatic session termination.

### 💰 Tebex Integration

- Tebex transaction integration and coin delivery.

- Transaction ID redemption for eligible offline purchases.

- Chargeback event handling.

- Configurable coin package cards and checkout links.

### 🎁 Flexible Reward System

- Items, money, vehicles, and server commands.

- Multiple rewards per product.

- Extensible reward types through editable files.

### 🛠️ In-Game Admin Panel

- Sales statistics, wallet balances, activity charts, and transaction history.

- Live product and category management.

- Coin package and coupon management.

- Player wallet administration.

- Rental and subscription management.

- Access controls through ACE permissions, framework groups, or identifiers.

### 🎨 Player Personalization

- Dark and light themes.

- Custom accent colors.

- Adjustable interface scaling.

- Performance-friendly visual settings.

- Personal purchase history.

### 🔌 Developer Tools

- Exports for balances, products, purchases, subscriptions, and rental vehicles.

- Hooks and events for supported shop activities.

- Custom purchase and test-drive validation.

- Included developer documentation.

### 📢 Additional Features

- Discord webhooks for purchases and administrative actions.

- Centralized JSON localization.

- Lightweight NUI and cached catalog.

- Support for Qbox, QBCore, ESX, and standalone configurations.

- Inventory integration for ox_inventory, qb-inventory, and qs-inventory. And u can easily edit all system intergations from editable files.

## 📦 Requirements

- ox_lib

- oxmysql

- Qbox, QBCore, or ESX (optional for standalone configurations)

## 🔓 Editable Files

- `config/` — General settings and integrations.

- `editable/server/framework.lua` — Framework functions and permissions.

- `editable/server/inventory.lua` — Inventory operations.

- `editable/server/rewards.lua` — Reward handlers.

- `editable/server/hooks.lua` — Custom hooks.

- `editable/server/logs.lua` — Discord logging.

- `editable/client/client.lua` — Client-side interface behavior.

- `locales/*.json` — Language files.

## ▶️ Preview

Watch the video showcase to explore the interface and features:

https://www.youtube.com/watch?v=azJTxhQnrE8

## 🌐 Localization

English is included. Additional languages can be added by editing the locale files.

## 💬 Support

For assistance, updates, and other Wert Scripts, visit our Discord:

https://discord.com/invite/SyPunyjqPj