🎁 Cosmic Redeem - Redeem Code & Referral System

Complete Reward & Referral Management for FiveM RP Servers

Cosmic Redeem is a professional redeem code and referral system designed for modern FiveM servers. Create unlimited codes with custom rewards, manage a built-in referral program with milestone rewards, and track everything through a stunning admin dashboard.

✨ Key Features

🎯 Advanced Redeem Code System

• Unlimited Code Creation: Create as many codes as you need with custom names
• Multiple Reward Types: Cash, bank money, items, and vehicles
• Random Reward Mode: Assign chances to rewards and draw a set number per redemption
• Flexible Expiry System: Set expiration dates or create permanent codes
• Usage Limits: Control how many times each code can be used
• Claim Modes: Per-account (license) or per-character redemptions

🤝 Built-In Referral System

• Unique Referral Codes: Every player gets their own shareable code
• Automatic Rewards: Both referrer and referee receive instant rewards
• Milestone System: Bonus rewards when players hit referral count goals
• Referral Tracking: Complete history of who referred whom
• Pending Rewards: Players claim their referral rewards when ready
• Customizable Settings: Configure all rewards and milestones in-game

🛡️ Powerful Admin Dashboard

• Full Code Management: Create, edit, delete, and toggle codes on/off
• Bulk Code Generator: Generate hundreds of codes at once with custom prefix
• Live Redemption Logs: Real-time tracking of all code uses
• Referral Settings Panel: Configure referee/referrer rewards and milestones
• Search & Filter: Quickly find codes and redemption records
• Permission System: Restrict admin access to specific job groups

📊 Complete Logging & Analytics

• Discord Webhooks: Separate webhooks for admin and player actions
• Redemption History: Full database of all code uses with timestamps
• Referral Analytics: Track referral performance and milestone achievements
• Admin Action Logs: Monitor all code creation, edits, and deletions
• Reward Breakdown: Detailed logs showing exactly what was given

🎨 Modern & Intuitive UI

• Sleek Design: Professional interface with smooth animations
• Responsive Layout: Works perfectly on all screen resolutions
• Easy Navigation: Tabbed interface for player and admin features
• Real-Time Updates: Instant feedback on all actions
• Mobile-Friendly: Clean design optimized for readability

⚡ Zero-Configuration Setup

• Auto Database Creation: Tables created automatically on first start
• Framework Auto-Detection: Automatically detects ESX, QBCore, or QBox
• Inventory Auto-Detection: Supports 12+ inventory systems out of the box
• Garage System Support: Compatible with popular garage scripts
• Plug & Play: Works immediately after installation

🎮 How It Works

For Players

Step 1: Open the UI

Type /redeemcode in chat to open the redeem interface.

Step 2: Redeem a Code

Enter any valid code and click Redeem to instantly receive rewards:

• Cash money
• Bank deposits
• Inventory items
• Vehicles in garage

Step 3: Use a Referral Code

Navigate to the Referral tab and enter a friend's code to receive welcome rewards.

Step 4: Share Your Code

Your unique referral code is displayed in the Referral tab. Share it with friends and earn rewards when they use it!

Step 5: Claim Referral Rewards

View your referral history and claim pending rewards whenever you're ready.

For Admins

Step 1: Access Admin Panel

Open the UI with /redeemcode — the Admin tab appears automatically if you have permission.

Step 2: Create Codes

Click Create Code and configure:

• Code name (e.g., WELCOME2025)
• Maximum uses (unlimited or specific number)
• Expiry date (optional)
• Claim mode (per-account or per-character)
• Rewards (cash, bank, items, vehicles)
• Random mode (assign chances and draw counts)

Step 3: Bulk Generate Codes

Use the Bulk Generator to create hundreds of codes at once:

• Set a prefix (e.g., EVENT-)
• Choose quantity (e.g., 500 codes)
• Configure rewards and settings
• Generate instantly

Step 4: Configure Referral System

Go to Referral Settings to set up:

• Referee rewards (what new players get)
• Referrer rewards (what code owners can claim)
• Milestone rewards (bonus at 5, 10, 25, 50+ referrals)
• Claim mode settings

Step 5: Monitor Activity

View redemption logs, manage active codes, and track referral performance in real-time.

🎁 Reward Types Supported

🎲 Random Reward Mode

Create mystery codes where players receive random rewards:

• Assign percentage chances to each reward (e.g., 50% for $10,000, 25% for rare item)
• Set how many rewards to draw per redemption
• Perfect for events, giveaways, and loot boxes
• Players never know what they'll get!

🏆 Referral System Features

How Referrals Work

1. Player A shares their unique referral code with Player B
2. Player B enters the code in the Referral tab
3. Player B receives referee rewards instantly
4. Player A gets a notification and can claim referrer rewards
5. When Player A hits milestones (5, 10, 25 referrals), they unlock bonus rewards

Milestone Rewards

Reward your most active community members with milestone bonuses:

• 5 Referrals: Starter bonus (e.g., $50,000 + rare item)
• 10 Referrals: Bronze tier (e.g., $100,000 + vehicle)
• 25 Referrals: Silver tier (e.g., $250,000 + exclusive items)
• 50 Referrals: Gold tier (e.g., $500,000 + premium vehicle)
• 100+ Referrals: Diamond tier (e.g., $1,000,000 + legendary rewards)

Referral Analytics

• Track total referrals per player
• View complete referral history
• Monitor pending reward claims
• See milestone progress
• Discord webhook notifications for all referral activity

🔧 Framework & Inventory Compatibility

✅ Supported Frameworks

• ESX Legacy (auto-detected)
• QBCore (auto-detected)
• QBox (auto-detected)

✅ Supported Inventory Systems

Automatically detects and works with:

• ox_inventory
• qb-inventory
• qs-inventory
• core_inventory
• mf-inventory
• origen_inventory
• codem-inventory
• ps-inventory
• lj-inventory
• tgiann-inventory
• aj-inventory
• Custom inventory (configurable)

✅ Supported Garage Systems

• Default framework garages (ESX/QB/QBox)
• cd_garage
• jg-advancedgarages
• qs-advancedgarages
• Custom garage systems (configurable)

📊 Discord Webhook Integration

Two Separate Webhooks for Clean Logging

🛡️ Admin Webhook Logs:

• Code created with full reward details
• Code updated/edited
• Code deleted
• Code toggled on/off
• Bulk code generation
• Referral settings changes

👥 Player Webhook Logs:

• Code redemptions with player info and rewards received
• Referral code usage (who referred whom)
• Referral reward claims
• Milestone achievements
• Failed redemption attempts

All webhooks include rich embeds with color coding, timestamps, and detailed information.

💡 Use Cases & Ideas

🎉 Server Events

• Create limited-time event codes with exclusive rewards
• Host giveaways with random reward codes
• Celebrate milestones with special codes

🎁 Welcome Packages

• Give new players starter codes with cash and items
• Create VIP welcome codes for donators
• Offer tutorial completion rewards

📱 Social Media Promotions

• Share codes on Discord, Twitter, TikTok
• Reward followers with exclusive codes
• Track redemptions to measure campaign success

🤝 Community Growth

• Use referral system to incentivize player recruitment
• Reward top referrers with milestone bonuses
• Build a self-sustaining growth engine

🏆 Competitions & Challenges

• Create codes as prizes for in-game competitions
• Reward achievement hunters
• Host treasure hunts with hidden codes

💰 Monetization Support

• Sell premium codes on your store
• Offer subscription perks with monthly codes
• Create VIP-only codes with exclusive vehicles

🌟 Why Choose Cosmic Redeem?

✨ Professional Quality

Built by experienced FiveM developers with clean code, optimized performance, and attention to detail.

🎯 Feature-Complete

Everything you need in one script — redeem codes, referrals, milestones, admin panel, and logging.

🔧 Zero Configuration

Auto-detection for frameworks, inventories, and garages means it works out of the box.

⚡ Optimized Performance

Minimal resource usage with efficient database queries and optimized UI rendering.

🎨 Beautiful UI

Modern, responsive interface that looks professional and is easy to use.

🔄 Regular Updates

Continuous improvements, bug fixes, and new features based on community feedback.

💬 Dedicated Support

Active support team available through Discord and Tebex messaging.

📚 Complete Documentation

Detailed guides for installation, configuration, and usage included.

📋 Requirements

• ✅ Framework: ESX Legacy, QBCore, or QBox
• ✅ Database: oxmysql (required)
• ✅ Inventory: Any supported inventory system (12+ supported)
• ✅ Server: FiveM server with latest artifacts

🎥 Preview

Watch the full showcase:

🤝 Support & Community

🛒 Store: https://cosmiccrafts.tebex.io/

💬 Discord: https://discord.gg/hCgwU4nUPz

📘 Documentation: https://sites.gitbook.com/preview/site_l4KWg/scripts/reedem-and-referral-system

Join our Discord community to:

• Get support from our team and other users
• Share feedback and feature suggestions
• Stay updated on new releases and updates
• Connect with other server owners
• Access exclusive previews and beta tests

📝 What's Included

• ✅ Complete script with all features
• ✅ Auto-setup database system (no SQL files needed)
• ✅ Fully configured config file
• ✅ Complete documentation
• ✅ Discord webhook integration
• ✅ Multi-language support
• ✅ Lifetime updates
• ✅ Discord support

❤️ Made with love by Cosmic Crafts Studio

© 2025 Cosmic Crafts Studio

🌟 Thank you for choosing Cosmic Redeem!