FiveM Advent Calendar

FiveM Advent Calendar - Interactive Holiday Event System for Your Server

Transform your FiveM server into a winter wonderland with this fully functional Advent Calendar system. Perfect for the holiday season, this script brings the traditional countdown-to-Christmas experience into your roleplay environment, giving players daily rewards, surprises, and activities throughout December. Whether you're running a serious RP server or a casual community, this resource adds seasonal engagement that keeps players logging in every single day.

The Advent Calendar isn't just a decoration - it's a complete event management system that automatically handles daily rewards, tracks player participation, and creates anticipation throughout the holiday season. Server owners can configure everything from reward types to opening times, making it flexible enough for any server economy or gameplay style.

What's Included

This package includes a complete Advent Calendar system with 24 configurable reward slots (one for each day of December leading up to Christmas). Each calendar door can be customized with different rewards including in-game currency, items, vehicles, weapons, or custom events. The script handles all the backend logic for date tracking, player eligibility, and reward distribution.

You'll get a beautifully designed 3D calendar prop that players can interact with in-game, complete with visual feedback when doors are opened. The system includes administrator tools for managing rewards, resetting the calendar for new seasons, and monitoring player participation. Everything is optimized for performance with minimal resource usage.

Key Features

• 24 Configurable Reward Slots - Set unique rewards for each day of December, from cash and items to exclusive vehicles or custom events
• Automatic Date Tracking - System automatically unlocks calendar doors based on real-world dates, no manual intervention needed
• Player Participation Logging - Track which players have opened which doors, preventing exploits and managing rewards
• Visual 3D Calendar Prop - Gorgeous interactive calendar model that players can walk up to and engage with in-game
• Flexible Reward System - Support for money, items, vehicles, weapons, job items, and custom script triggers
• Multi-Framework Support - Works seamlessly with ESX, QBCore, and standalone configurations
• Admin Management Panel - Easy-to-use configuration system for setting up rewards and managing the event
• Anti-Exploit Protection - Built-in safeguards prevent players from claiming rewards multiple times or accessing future dates
• Customizable Opening Times - Set specific times when each door becomes available (midnight, noon, evening, etc.)
• Discord Webhook Integration - Get notifications when players open calendar doors and claim rewards
• Performance Optimized - Lightweight script with minimal impact on server resources (typically 0.00-0.01ms)
• Localization Support - Multi-language configuration for international communities

Perfect For

• Holiday Server Events - Create month-long engagement during the December holiday season
• Player Retention - Give players a reason to log in daily throughout the holidays
• Community Building - Foster excitement and anticipation with daily surprises
• Seasonal Promotions - Reward loyal players with exclusive holiday items and bonuses
• New Player Acquisition - Attract new players with generous holiday giveaways
• Server Economy Boost - Inject controlled amounts of currency or items into your economy
• Roleplay Events - Tie calendar rewards to holiday-themed RP scenarios

How It Works

Players approach the interactive Advent Calendar prop placed at a location of your choice (popular spots include city centers, shopping districts, or community gathering areas). Each day from December 1st through December 24th, a new door becomes available to open. When a player interacts with an unlocked door, they receive that day's configured reward automatically.

The system tracks which players have claimed which rewards using a database backend, ensuring no one can exploit the system by claiming the same reward multiple times. Server administrators can configure rewards in advance for the entire month, or adjust them on-the-fly as the event progresses.

Configuration Options

The config file gives you complete control over every aspect of the Advent Calendar. Set different reward types for each day - maybe December 1st gives a small cash bonus, December 10th unlocks a rare vehicle, and December 24th delivers a massive jackpot. You can configure opening times (all doors unlock at midnight, or stagger them throughout the day), set location coordinates for the calendar prop, and customize messages players see when claiming rewards.

Integration with your existing framework is seamless. The script automatically detects whether you're running ESX or QBCore and adjusts its behavior accordingly. For standalone servers, you can configure custom reward triggers that execute any server-side function you want.

Technical Details

• File Size: Approximately 2-3 MB (includes 3D props and UI assets)
• Performance Impact: 0.00-0.01ms resmon (negligible resource usage)
• Database: Uses framework's existing database (ESX/QBCore) or custom tables for standalone
• Dependencies: Framework-specific (ESX/QBCore resources) or none for standalone
• Client-Side: Interactive prop rendering and UI display
• Server-Side: Reward distribution, date validation, and player tracking

Installation

1. Extract the advent-calendar folder to your server's resources directory
2. Configure the config.lua file with your desired rewards for all 24 days
3. Set the calendar prop location coordinates where you want it to appear in-game
4. Add ensure advent-calendar to your server.cfg file
5. Restart your server and the calendar will be ready for the holiday season
6. Optional: Configure Discord webhooks for reward claim notifications

Framework Compatibility

• ✅ ESX Legacy - Full support for ESX 1.9.x and Legacy versions with automatic item/money distribution
• ✅ QBCore - Complete integration with QB inventory and cash systems
• ✅ QBOX - Compatible with QBOX framework features
• ✅ Standalone - Can be configured to work without any framework using custom reward triggers

What Makes It Stand Out

Unlike generic event scripts that require constant admin management, this Advent Calendar system is truly set it and forget it. Configure all 24 days of rewards once in early December, and the system handles everything automatically for the entire month. The built-in anti-exploit protection means you won't deal with players trying to claim rewards multiple times or access future dates.

The visual presentation is what really sets this apart from other holiday scripts. The 3D calendar prop is beautifully designed with opening animations and visual feedback that make the daily ritual feel special. Players genuinely look forward to their daily calendar check, creating a community tradition that brings your server together during the holidays.

Server owners appreciate the flexibility - you can run conservative rewards that gently boost player engagement, or go all-out with massive daily giveaways that make December the most exciting month on your server. The choice is entirely yours, and you can adjust the strategy each year based on what worked best.

Reward Ideas

• Early December (Days 1-10): Small cash bonuses, basic items, cosmetic rewards
• Mid-December (Days 11-20): Rare items, weapons, vehicle test drives, job-specific tools
• Christmas Week (Days 21-24): Exclusive vehicles, large cash prizes, special access items, custom player perks
• Christmas Eve (Day 24): Grand prize - could be a luxury vehicle, massive cash jackpot, or exclusive server access

Admin Management

The admin system lets you monitor calendar participation in real-time. See which players have claimed rewards, check how many people are engaging with the event daily, and identify the most popular reward days. This data helps you plan even better events for next year's holiday season.

Need to reset the calendar for testing or for next year? A simple admin command wipes all player participation data while preserving your reward configuration. You can also manually grant or revoke calendar rewards for specific players if needed for customer service situations.

Community Engagement Tips

Promote your Advent Calendar event on Discord and social media before December starts. Build anticipation by revealing what the Day 1 and Day 24 rewards will be, while keeping the middle days a surprise. Consider running a guess the reward contest where players predict what each day's prize will be.

Some servers create roleplay events around calendar openings, like having all players gather at the calendar location at a specific time each day for a community reveal. Others tie calendar rewards into holiday-themed RP scenarios, like Santa's helpers delivering extra surprises to players who opened their calendar that day.

Related ESX Scripts

• MilkMan Job (Milk Farmer)
• [ESX] Fruit Picker Job
• Darts Script
• OC HUD (ESX)