EASTER EVENT [OPEN SOURCE]

🎁 Point Shop System

Exclusive reward shop with point currency, buy items/money/vehicles with earned points, rarity system (common/rare/epic/legendary), customizable prices, unique purchase limits per player, modern UI with images, unlimited shop items, database tracking

🥚 Auto Egg Hunt

Automatic egg spawning in customizable zones, define multiple spawn areas with radius, set egg count per drop, random placement within zones, prop customization, loading progress bar, debug mode for zone visualization, optimized performance

🎯 Scheduled Drops

Two drop modes: interval-based or specific times, set drops every X minutes OR at exact times (10:00, 15:30, etc.), 24h time format, server timezone support, automatic daily reset, flexible scheduling

🚗 Vehicle Rewards

Direct vehicle insertion into player garage, works with ESX owned_vehicles & QBCore player_vehicles, automatic database integration, configurable spawn location, supports all vehicle models, instant delivery

🎲 Random Loot System

Easter eggs contain random rewards, configurable min/max amounts per item, points awarded per item collected, weighted drop chances, multiple reward items, customizable labels

💰 Sell System

Built-in item selling, sell collected Easter items for money, cash/bank/black money support, item-to-item trading option, configurable prices, instant transactions, integrated shop button

🧹 Auto Cleanup

Automatic egg removal after time limit, countdown notifications, configurable cleanup timer (minutes), warns players before cleanup, resets zones, prevents server clutter

👮 Admin Commands

`/egghunt` - Manual egg drop, `/givepoints [ID] [amount]` - Give points to players, configurable admin list (license/steam/discord), permission system, everyone-can-use option

🎯 ox_target Integration

Optional ox_target support, custom icons for shop & eggs, configurable labels, distance-based interaction, fallback to markers if disabled

📍 Shop Configuration

Customizable shop location with coords, optional NPC with ped model, marker system with type/size/color, blip on map with sprite/color, F1 close key, modern UI design

🗺️ Spawn Zones

Multiple spawn zones support, set coordinates + radius per zone, unlimited zones, city/countryside/custom areas, visual radius in debug mode, optimized spawning algorithm

💎 Rarity System

4 rarity tiers with color coding, common (white), rare (blue), epic (purple), legendary (gold), affects UI appearance, visual feedback

📊 Player Stats

Database tracking for points, opened eggs counter, purchase history, unique purchase limits, persistent data, automatic table creation

🔔 Notification System

Customizable notifications, countdown warnings, cleanup alerts, reward notifications, point updates, purchase confirmations, works with all notify systems

🌐 Multi-Framework

Auto-detects ESX, QBCore, QBox, no manual configuration, universal item functions (addItem/removeItem/hasItem), works with any inventory system, framework-independent

🛡️ Exploit Protection

Server-side validation, client cannot modify prices, anti-cheat for point manipulation, database integrity checks, secure purchase system, admin-only commands

🎨 Full Customization

All text translatable, all colors changeable, all timings adjustable, unlimited items/rewards, flexible zone system, complete config control

📝 Developer-Friendly

Complete documentation, config.lua with English comments, example configurations, item setup guides, troubleshooting section, quick start checklist

https://youtu.be/tytelbTUt2o