vicexstudios_adventcalendar – Interactive Santa Advent Calendar

Bring pure Christmas magic to your FiveM server with the vicexstudios_adventcalendar – a fully interactive Advent Calendar system with Santa NPC, animated calendar doors, Christmas music, snow effects and persistent daily rewards.

Built for ESX with flexible inventory support (ESX inventory, ox_inventory, qs) and a modern NUI in full holiday style. 🎅✨

Advent Snapshot

✅ Santa NPC & blip
✅ 24 animated doors
✅ Daily 1x claim per player
✅ Money, items & car rewards
✅ Christmas music & snow FX

🎄 Core Christmas Features

Santa NPC Advent Point 🎅
A dedicated Santa Claus NPC with 3D text & markers waits at your configured coordinates to open the Advent Calendar. Press [E] near Santa to open the UI – with optional blip on the map so nobody misses Christmas.

24 Animated Calendar Doors 🎁
A beautiful fullscreen calendar with 24 round doors, hover effects, glowing borders, snow particles and opening animations. Each day unlocks its number – perfect daily login content for your Christmas season.

Daily Rewards with Cooldown 🕒
Each player can open one door per real day. The system checks the real date, remembers what was claimed and includes a short cooldown between claims to prevent spam clicking.

Server-Synced Midnight Timer ⏰
A stylish timer shows how long until the next day’s door unlocks, based on server time. Players can literally watch the countdown to midnight and the next present.

Configurable Rewards (Money, Items, Vehicles) 🎁
Define all 24 rewards in config.lua:
• Money (bank/cash)
• Items
• Christmas edition vehicles Each door has its own type, label and amount – from small snacks to big Xmas cars.

ESX Account & Vehicle Handling 🚗
When players win money, it’s paid into the configured ESX account (bank/cash). Vehicle rewards are inserted into owned_vehicles with a special plate and tuned props for Xmas edition cars.

Inventory Flex Support 💼
Works with:
• Native ESX inventory
• ox_inventory
• qs-inventory Select your inventory system in Config.Inventory and items are given correctly.

Christmas Music, HoHoHo & Snow FX ❄️
The UI plays looped Christmas background music, a hohoho sound on claim, snow particle animations and confetti when opening a door – full cozy Christmas feeling.

Clean NUI & Notification System 🧊
Vue.js/Vuetify-based interface, tooltip hints (locked/already claimed), Santa-style notifications when you open a door and a close button + ESC support – players always know what’s going on.

🌍 Localization & Texts

Configurable texts (header, tooltips, notifications) via Config.Locales.
Christmas-themed messages like “Santa’s Message”, “Already claimed”, “Locked until December X”.
Perfect to adapt for English, German or any other language your community uses.

🛠️ Requirements & Tech

Framework: ESX (uses es_extended export).
Database: MySQL via oxmysql (server-side reward & vehicle handling).
Data: Persistent JSON file (advent_data.json) to store player claims.
UI: HTML + CSS + Vue + Vuetify with NUI integration.
Inventory: ESX, ox_inventory or qs-inventory selectable in config.

🎁 Installation (Overview)

Drop the resource (e.g. vicexstudios_adventcalendar) into your resources folder.
Make sure oxmysql is installed and running on your server.
Configure config.lua:
• Santa coordinates & blip
• Inventory system (esx / ox_inventory / qs)
• Rewards (money, items, vehicles)
• Locale texts & UI wording
Add the resource to your server.cfg:
```
ensure vicexstudios_adventcalendar
```
Restart the server, find Santa on the map and start opening doors. 🎅

❄️ Why choose vicexstudios_adventcalendar?

Daily engagement: Players log in every day to open their next door.
Full Christmas vibe: Snow, music, Santa, confetti and glowing doors.
Configurable rewards: From fun meme amounts of money to exclusive Xmas cars.
Easy to run: No complex commands – just walk to Santa and press [E].
ViceX Studios quality: Polished UI, clean logic and smooth NUI integration.

🎅 Turn your city into a Christmas Wonderland

Add vicexstudios_adventcalendar to your Tebex basket, drop it on your ESX server and give your community 24 days full of surprises, snow and Santa magic. The perfect seasonal event for any serious roleplay server. 🎄