# 🎫 BZK COUPON SYSTEM - Professional Coupon System for RedM
## 🌟 Description
**BZK Coupon System** is the most complete and professional coupon system for RedM servers. Compatible with **VORP** and **RSG** frameworks, it offers a complete solution to create promotions, reward players, and increase server engagement through custom coupons with money and item rewards.
### 💎 Why choose BZK Coupon System?
- ✅ **Modern Interface**: Professional design with Western theme adapted for RedM
- ✅ **Easy to Use**: Intuitive interface for both admins and players
- ✅ **Complete System**: Management, statistics, and total control
- ✅ **Multi-Framework**: Compatible with VORP and RSG Core
- ✅ **Multi-Language**: English and Portuguese included
- ✅ **Secure**: Validation system to prevent exploits
- ✅ **Optimized**: Clean and performant code (0.00ms idle)
- ✅ **Complete Support**: Support in Portuguese and English
---
## ✨ MAIN FEATURES
### 🎛️ Complete Admin Panel
**Coupon Management**
- Create coupons with custom codes
- Configure money rewards ($$$)
- Add multiple items as rewards
- Set usage limit (1 person or multiple players)
- Activate, deactivate, or delete coupons with one click
- View real-time status
**Statistics System**
- Total coupons created
- Fully used coupons
- Total redemptions performed
- Last 50 redemptions history
- Information on who redeemed and when
- Interface with charts and info cards
**Permission Control**
- Configure by groups (admin, moderator, etc)
- Configure by specific identifiers
- Flexible and adaptable system
### 🎁 Player Interface
**User Experience**
- Modern and responsive interface
- Reward preview before redeeming
- Elegant notification system
- Automatic validations
- Instant visual feedback
- Intuitive and easy-to-use design
**Security and Validation**
- Verifies if coupon exists and is active
- Prevents duplicate redemption by same character
- Automatically controls usage limit
- Uses charidentifier (permanent identification)
- Protection against exploit attempts
---
## 🎮 HOW IT WORKS?
### For Administrators
1. **Open Panel**: Type `/coupon` in chat
2. **Create Coupons**:
- Define the code (e.g., XMAS2024, PROMO500)
- Configure money reward
- Add items (name and quantity)
- Define how many times it can be used
3. **Manage**: Activate, deactivate, or delete coupons as needed
4. **Monitor**: Track statistics and redemption history
### For Players
1. **Access System**: Type `/coupon` in chat
2. **Enter Code**: Type the promotional coupon code
3. **View Rewards**: See what you'll receive
4. **Redeem**: Click the button and receive instantly!
---
## 📦 WHAT'S INCLUDED?
```
✅ Complete script (client + server + NUI)
✅ Modern administrative interface
✅ Redemption interface for players
✅ Statistics system
✅ Custom notification system
✅ Automatic database (MySQL)
✅ Multi-language (EN/PT-BR)
✅ Complete documentation in Portuguese
✅ Detailed configuration file
✅ Lifetime technical support
✅ Free updates
```
---
## 🛠️ REQUIREMENTS
```
✅ RedM Server (Updated)
✅ VORP Core OR RSG Core
✅ oxmysql
✅ VORP Inventory OR RSG Inventory
```
---
## 🚀 INSTALLATION
### Simple and Quick!
1. Extract the `bzk_coupon` folder to `resources/[standalone]/`
2. Add to your `server.cfg`: `ensure bzk_coupon`
3. Configure the `config.lua` file:
- Choose framework (VORP or RSG)
- Set language
- Configure admin groups
4. Restart the server
5. Use `/coupon` in-game!
**Database tables are created automatically!**
---
## ⚙️ CONFIGURATION
### Config.lua - Easy and Intuitive
```lua
-- Choose your framework
Config.Framework = 'VORP' -- or 'RSG'
-- Choose language
Config.Language = 'en-us' -- or 'pt-br'
-- Configure admin groups
Config.AdminGroups = {
['admin'] = true,
['superadmin'] = true,
['moderator'] = true,
}
-- Or use specific IDs
Config.AdminIdentifiers = {
['steam:110000xxxxx'] = true,
}
-- Command to open
Config.OpenCommand = 'coupon'
```
---
## 🎨 INTERFACE
### Premium Design
- 🎨 Western theme adapted for RedM
- ⚡ Smooth animations and transitions
- 🖼️ Integrated Font Awesome icons
- 📱 Responsive and modern layout
- 🎯 Harmonious and professional colors
- ✨ Premium visual experience
### Included Screens
1. **Redemption Screen** (Players)
- Code input
- Reward preview
- Redeem button with feedback
2. **Management** (Admin)
- List of all coupons
- Status and information
- Quick action buttons
3. **Coupon Creation** (Admin)
- Complete form
- Add multiple items
- Real-time validation
4. **Statistics** (Admin)
- Cards with general data
- Recent redemptions table
- Refresh button
---
## 🌐 MULTI-LANGUAGE
### Available Languages
- 🇺🇸 **English (en-us)** - Complete
- 🇧🇷 **Portuguese (pt-br)** - Complete
### Easy to Add New Languages
All strings are in the `locales/locale.lua` file, making it simple to add new languages or customize messages!
---
## 🎯 USE CASES
### Practical Examples
📢 **Discord Promotions**: Distribute exclusive coupons for Discord members
🎉 **In-Game Events**: Reward event winners
🎁 **Welcome**: Give welcome coupons to new players
💰 **Temporary Campaigns**: Create weekend promotions
🏆 **Loyalty Rewards**: Reward active and loyal players
📱 **Social Media**: Run giveaways on Instagram, Twitter, or TikTok
🎮 **Partnerships**: Offer coupons for partner servers
💎 **VIP Rewards**: Exclusive benefits for VIP members
---
## 🔐 SECURITY
### Robust Validation System
- ✅ Server-side validation of all actions
- ✅ Duplicate use prevention (by charidentifier)
- ✅ Automatic usage limit control
- ✅ Administrative permission verification
- ✅ SQL injection protection (via oxmysql)
- ✅ Logs of all important actions
- ✅ Clean and audited code
---
## 📊 DATABASE
### Professional Structure
**Table: bzk_coupons**
- Stores all created coupons
- Creator and date information
- Usage and limit control
- Active/inactive status
**Table: bzk_coupon_redemptions**
- Complete redemption history
- Identification by charidentifier
- Precise date and time
- Link to original coupon
**Automatic Creation**: Tables are created automatically when starting the resource!
---
## 🔧 COMPATIBILITY
### VORP Framework
✅ Fully compatible
✅ Uses character's charIdentifier
✅ Integrated with vorp_inventory
✅ VORP group system support
✅ Adds money via Character.addCurrency
### RSG Framework
✅ Fully compatible
✅ Uses character's citizenid
✅ Integrated with rsg-inventory
✅ RSG jobs and permissions support
✅ Adds money via Player.Functions.AddMoney
---
## 📞 SUPPORT
### Complete Support Included!
🎯 **What we offer:**
- 💬 Discord support (tickets)
- 🔧 Installation help
- 🐛 Bug fixes
- 💡 Question clarification
- 🆕 Free updates
- 📚 Complete documentation
🕐 **Service Hours:**
- Responses within 24 hours (business days)
- Support in Portuguese and English
📱 **Support Channels:**
- Discord: https://discord.gg/zHpuu3ENTR
- Tickets within Discord
- Active and helpful community
---
## 🎁 WHAT YOU GET
### Complete Package
```
📦 Complete and functional script
📖 Detailed documentation (README.md)
⚙️ Configuration file (config.lua)
🌐 Multi-language (en-us and pt-br)
🎨 Modern NUI interface
🔔 Notification system
📊 Statistics system
🔐 Permission system
💾 Automatic database
🆘 Lifetime technical support
🔄 Future updates FREE
```
---
## 📜 LICENSE AND TERMS
### When Purchasing You Receive:
✅ **License for ONE server**
✅ **Unlimited use** on your server
✅ **Open source** (can edit)
✅ **Free updates** (lifetime)
✅ **Technical support** included
### Restrictions:
❌ **Reselling or redistributing prohibited**
❌ **Sharing on forums/Discord prohibited**
❌ **Removing credits prohibited**
❌ **One license = One server**
---
## ⚡ PERFORMANCE
### Optimized for Performance
- 🚀 **0.00ms** when panel is closed
- 💚 **Clean code** and optimized
- 📦 **Lightweight** (doesn't impact performance)
- ⚙️ **Efficient** (minimal resource usage)
- 🔄 **Asynchronous** (non-blocking callbacks)
---
## 🆕 FUTURE UPDATES
### Roadmap (Included Free)
- [ ] Date/time expiration system
- [ ] Unique coupons (1 total use)
- [ ] Gold rewards
- [ ] Discord webhooks for logs
- [ ] Automatic code generator
- [ ] Saved coupon templates
- [ ] Report export (CSV)
- [ ] API for integrations
- [ ] Category system
- [ ] Discord notifications when redeemed
**All future updates are 100% FREE!**
---
## 🌟 DIFFERENTIALS
### Why BZK is different?
```diff
+ Professional and documented code
+ Modern and responsive interface
+ Support in Portuguese
+ Constant updates
+ Active community
+ Fair price
+ Guaranteed quality
+ Scripts tested on real servers
```
---
## 🎥 MEDIA
*Screenshots and videos in gallery!*
- 📸 Redemption Interface
- 📸 Admin Panel
- 📸 Coupon Creation
- 📸 Statistics System
- 📸 Notifications
- 🎥 Demo Video
---
## 💰 GUARANTEE
### Satisfaction Guaranteed!
```
✅ Functional script guaranteed
✅ Installation guaranteed with support
✅ Clean code and virus-free
✅ Premium quality guaranteed
✅ We solve any technical problem
```
⚠️ **Note**: This is a digital product. We do not offer refunds, but we guarantee that we will solve any technical problem related to the script.
---
## 📞 CONTACT
**Bzk Dev Scripts**
*Professional Scripts for RedM*
🌐 **Store**: https://bzk-dev-scripts.tebex.io/
💬 **Discord**: https://discord.gg/zHpuu3ENTR
📧 **Support**: Via Discord (Tickets)
---
## 🏆 ABOUT BZK DEV SCRIPTS
We are a team dedicated to developing high-quality scripts for RedM. Our focus is to provide professional solutions, exceptional support, and constant updates.
### Our Values:
- ✅ Quality above all
- ✅ Responsive support
- ✅ Clean and documented code
- ✅ Fair prices
- ✅ Active community
---
### 💎 PROFESSIONAL SCRIPTS | COMPLETE SUPPORT | GUARANTEED QUALITY
**Developing the best scripts for your RedM experience!**
🛒 **[ADD TO CART](#)** 🛒
---
*© 2024 BZK Dev Scripts. All rights reserved.*
*This product is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Rockstar Games or Take-Two Interactive.*