Donor Shop

Donor Shop | Complete Donation Rewards System for ESX Servers

Monetize your FiveM server professionally with the Donor Shop, a comprehensive donation reward system designed specifically for ESX v1.2 and lower. This script transforms player donations into tangible in-game rewards through an elegant shop interface where donors can claim exclusive vehicles, items, weapons, and perks. Perfect for server owners looking to generate revenue while rewarding supporters with premium content that doesn't break game balance.

What Makes Donor Shop Stand Out

• Easy Integration - Seamless connection between donation platforms and in-game rewards
• Flexible Rewards - Offer vehicles, weapons, items, money, or custom perks
• Tiered System - Create multiple donation tiers with escalating rewards
• Automated Delivery - Donors automatically receive shop access upon payment
• Anti-Abuse - One-time claim system prevents reward duplication
• Professional UI - Clean shop interface with category organization

Perfect For

• Server owners seeking sustainable revenue to cover hosting costs
• Communities wanting to reward donors without creating pay-to-win scenarios
• Servers offering VIP perks, exclusive vehicles, or cosmetic items to supporters
• Growing servers that need funding for development and infrastructure

Reward Categories

• Exclusive Vehicles - Premium cars, motorcycles, or custom vehicles for donors
• Weapons & Attachments - Special weapons or rare weapon modifications
• Money Packages - In-game cash or bank deposits (configurable amounts)
• Items & Resources - Rare crafting materials, special items, consumables
• Cosmetics - Unique clothing, accessories, or character customization options
• Properties - Exclusive houses, apartments, or business locations
• Perks & Bonuses - Increased inventory space, faster crafting, salary boosts

Framework Compatibility

• ✅ ESX v1.2 and Lower - Designed for legacy ESX versions
• ⚠️ ESX Legacy - May require modifications for newer ESX versions
• ❌ QBCore - Not compatible (ESX-specific architecture)

Donation Tier System

• Bronze Tier - $5-10 donation with basic rewards (starter vehicle, cash package)
• Silver Tier - $15-25 donation with enhanced rewards (premium vehicle, weapons)
• Gold Tier - $30-50 donation with exclusive rewards (luxury vehicles, properties)
• Platinum Tier - $75+ donation with ultimate rewards (custom items, permanent perks)
• Custom Tiers - Create unlimited tiers with unique reward packages

Shop Interface Features

• Category Browsing - Organized rewards by type (vehicles, weapons, items)
• Preview System - View reward details before claiming
• Claim Tracking - See which rewards have been claimed
• Tier Display - Shows donor's current tier and available rewards
• Search Function - Find specific rewards quickly
• Expiration Dates - Optional time-limited rewards for seasonal donations

Automated Reward Delivery

• Instant Access - Donors gain shop access immediately after payment confirmation
• Vehicle Delivery - Cars spawn directly to donor's garage (esx_advancedgarage integration)
• Item Distribution - Items automatically added to player inventory
• Money Transfer - Cash/bank deposits processed instantly
• Perk Activation - Permanent perks automatically enabled on claim

Anti-Abuse & Security

• One-Time Claims - Each reward can only be claimed once per donor
• Claim Logging - Database records all reward claims with timestamps
• Identifier Verification - Links donations to specific player identifiers
• Admin Override - Manual reward grants for special cases
• Refund Protection - Track claims to handle chargebacks appropriately

Installation

1. Extract Donor Shop to your ESX v1.2 server resources folder
2. Import the SQL file to create donor shop database tables
3. Configure reward items in config.lua (vehicles, weapons, items, money)
4. Set up donation tier thresholds and reward packages
5. Integrate with your donation platform (Tebex, PayPal, Ko-fi)
6. Add start donor_shop to your server.cfg
7. Test donation flow and reward delivery with test donor account

Technical Details

• File Size: Lightweight script under 5MB
• Performance: 0.00-0.01ms resmon (minimal server impact)
• Dependencies: ESX v1.2 or lower, esx_advancedgarage (optional)
• Database: Tracks donor status, claimed rewards, tier levels

Donation Platform Integration

Donor Shop integrates with popular donation platforms:

• Tebex (BuyCraft) - Professional game server commerce platform
• PayPal - Direct PayPal donation buttons with webhook integration
• Ko-fi - Simple donation page for community supporters
• Patreon - Monthly subscription-based donor perks
• Custom Webhooks - Connect any payment system with webhook support

Configuration Options

• Reward Definitions - Define exactly what donors receive per tier
• Vehicle Spawn Points - Set where donor vehicles are delivered
• Money Amounts - Configure cash/bank amounts for each tier
• Item Quantities - Set how many of each item donors receive
• Perk Durations - Permanent or temporary perk activation
• Shop Access Levels - Control which tiers see which rewards

Revenue Generation Best Practices

• Fair Pricing - Price tiers based on reward value, not pay-to-win advantages
• Cosmetic Focus - Emphasize cosmetic/convenience rewards over gameplay advantages
• Transparency - Clearly display what donors receive for each tier
• Server Sustainability - Explain how donations fund server operations
• Thank You Rewards - Treat donations as appreciation, not purchases

Donor Perks Examples (Non-Pay-to-Win)

• Exclusive Vehicles - Cosmetically unique cars with same performance as in-game vehicles
• Custom Clothing - Unique outfits or accessories not available to free players
• Name Tags - Special donor tags in chat or above character heads
• Priority Queue - Join server faster during high population times
• Extra Character Slots - Additional character slots beyond standard limit
• Custom Spawn - Spawn at exclusive donor-only locations

Why Server Owners Choose Donor Shop

Running a FiveM server costs money - hosting, development, maintenance all add up. Donor Shop provides a professional way to generate revenue without creating pay-to-win scenarios that drive away players. The automated reward system eliminates manual donor perk management, the tier system encourages higher donations, and the clean UI makes the donor experience feel premium. It's the difference between send me $20 and I'll give you stuff manually and a professional shop experience.

Legal & Ethical Considerations

• Terms of Service - Clearly state donation refund policies
• Rockstar Compliance - Avoid direct real-money to in-game money exchanges
• Player Balance - Don't create unfair advantages for paying players
• Transparency - Be honest about where donation money goes

Donor Retention Features

• Monthly Rewards - Give returning donors exclusive monthly items
• Loyalty Tiers - Higher tiers for long-term monthly supporters
• Exclusive Events - Donor-only server events or roleplay scenarios
• Early Access - Let donors test new features before general release

Support & Sustainability

Donor Shop helps servers achieve financial sustainability without compromising roleplay integrity. The script pays for itself quickly - even a few monthly donors can cover server hosting costs. The professional presentation makes players feel good about supporting your community, and the fair reward system ensures free players don't feel disadvantaged.

Related ESX Scripts

• Squid Games Pack FiveM
• XenTablet
• Job Creator (UniJob)
• Woodcutter job