🎄 Xrisma Christmas Calendar

Bring the Magic of Christmas to Your FiveM Server!

Give your players a festive experience with Xrisma Christmas Calendar, a feature-rich 30-day Christmas gift system designed for ESX Legacy, QBCore and Qbox.

Players simply visit a beautifully decorated Christmas tree, press [E], and open their personal Christmas calendar. Every day brings a new surprise, with beautifully animated gift reveals, festive effects and exciting rewards.

Whether it's December 1st or the final day before Christmas, there's always something waiting under the tree!

---

🎁 Features

🎄 Interactive Christmas Calendar

• Beautiful 30-day calendar with animated gift boxes.
• Festive snowfall, Christmas lights and confetti effects.
• Two unlock modes:
  • Real Dates: December 1st unlocks Day 1.
  • Daily Progress: One new gift per day for each player.
• Clear gift states: Available, Claimed, Locked and Missed.
• Four rarity tiers: Common, Rare, Epic and Legendary.
• Live countdown to the next available gift.
• Gift details on hover, with optional previews of locked rewards.

💎 Reward System

• Multiple reward types: Items, Money, Weapons and Vehicles.
• Vehicles delivered directly to the player's garage.
• Custom rewards through an easy-to-use server hook.
• Multiple rewards per calendar day.
• Automatic item labels and images loaded from your inventory.

🎅 Christmas Tree Interaction

• Spawn Christmas tree props at any coordinates.
• Create as many Christmas tree locations as you need.
• 3D interaction text displayed above each tree.
• Customizable [E] interaction using:
  • Custom Text UI
  • ox_lib
  • qb-core
  • esx_textui
• Target support: ox_target, qb-target and qtarget.
• Optional map blips.

🌍 Languages & Currency

• 12 supported languages:
  • English
  • Ελληνικά
• Each player can select their preferred language directly from the menu.
• Multi-currency support using ISO currency codes.
• Automatic currency formatting based on the selected language.
• Custom money accounts with individual currencies, including crypto, coins and item-based currencies.

🔔 Notifications

• Built-in festive Christmas notification system.
• Optional integration with:
  • esx_notify
  • ESX Notifications
  • QBCore
  • Qbox
  • ox_lib

🔒 Advanced Security

• All date and reward logic is handled server-side.
• Rewards are never exposed to the client in advance.
• Server-side distance validation.
• Unique session tokens for every menu opening.
• Atomic database claims to prevent duplicate rewards.
• Cooldowns and rate limits.
• Automatic kick protection against exploit attempts.
• One claim per Rockstar license to prevent multi-character farming.
• Minimum playtime requirements before claiming rewards.
• Discord webhook logging.

⚡ Performance Optimized

• Adaptive client sleep with minimal idle resource usage.
• UI completely paused when closed.
• Cached database reads.
• Designed for smooth performance without unnecessary server load.

---

⚙️ Configuration & Administration

• Fully documented and easy-to-understand configuration files.
• Configure every gift individually:
  • Gift name
  • Rarity
  • Items
  • Amounts
• Seasonal system: reset all player progress annually with a single configuration value.
• Admin command to reset an individual player's gifts.
• Server export to retrieve player calendar progress.

---

📦 Requirements

• ESX Legacy, QBCore or Qbox.
• oxmysql.
• OneSync.

🎒 Supported Inventories

• ox_inventory
• qb-inventory
• Default ESX Inventory

---

🎄 Make This Christmas Special!

Give your players something to look forward to every day with Xrisma Christmas Calendar.

A festive, customizable and secure Christmas reward experience, built to bring the holiday spirit to your FiveM server!

One tree. 30 days. Endless Christmas surprises.

Made with ❤️ by Xrisma.