REX ADVENT CALENDAR

A full Christmas event for your FiveM server

Rex Advent Calendar turns December into a real server event: a 3D calendar with 24 doors, streaks and catch-up, a gift hunt around the map, Santa showing up in the city, a community goal and a live admin panel to edit every reward without a restart.

Important: Rex Advent Calendar requires ox_lib and oxmysql. ESX, QBCore and QBox are detected automatically.

THE CALENDAR

• 24 doors (or anything from 1 to 31) that swing open in 3D, with snow, a reveal screen and confetti
• Shuffled door layout like a real calendar, with a bigger door for the grand prize
• Four rarities: common, rare, epic, legendary. Locked doors can show a rarity glow as a teaser, nothing, or the full reward
• Countdown to the next door, streak counter with milestones, wallet with tokens and balance
• Optional built-in music box (off by default, players toggle it)

STREAKS & CATCH-UP

• Open doors on consecutive days to unlock streak bonuses (3, 7, 12, 18, 24 days by default)
• Missed a day? Catch the door up with money, a token item, either one, or for free. The price can go up with the delay, and you decide if a caught-up door repairs the streak
• Grace days after the last door so late players can still finish
• "Perfect calendar" bonus for players who opened every door

REWARDS

• Cash, bank, dirty money, items, weapons, vehicles (added to the garage with a generated plate), catch-up tokens, XP, jobs, your own hooks or any export
• Fixed rewards, weighted loot tables, or both on the same door
• Pity system: after X rolls without an epic, the next one is guaranteed epic or better

THINGS TO DO IN THE CITY

• Christmas trees, calendar props or an NPC around the map to open the calendar (ox_target, qb-target or [E])
• Gift hunt: on the days you choose, presents spawn around the map. First come first served, or everyone can pick each one
• Santa shows up at random places during the day. Find him and talk to him for a bonus
• Community goal: every door opened on the server fills a bar. Each tier reached gives a gift to everyone who took part, even players who were offline
• Streak leaderboard with a podium
• Optional Christmas decorations (vanilla props) and a snow toggle, with a hook for weather sync scripts

ADMIN PANEL

An admin tab right inside the calendar (ACE permission):

• Edit any door live: title, rarity, loot table, rewards. Saved to the database, no restart
• Exact drop rates for each loot table
• Stats: doors opened per day, catch-ups, unique players, rarity split, top streaks
• Force open a door to test it, simulate a date (test December in the middle of November), reset a player
• Spawn Santa or start a gift hunt on demand
• Discord logs for claims, events, admin actions and suspicious requests

SECURITY

• The current door comes from the server clock and your timezone. Changing the PC date does nothing
• One claim per door, per character or per license. Rate limits, a lock per player and a unique database key: double clicks or spam never give anything twice
• Rewards live in a server-only file, so nobody can dig through client files to see what's coming
• Inventory space is checked before anything is charged or saved
• Gift hunt and Santa pickups are distance-checked server side, impossible requests are logged with an optional kick

FRAMEWORKS & REQUIREMENTS

Frameworks

• ESX (new export)
• QBCore
• QBox

Requirements

• ox_lib (required)
• oxmysql (required)
• ox_inventory or your framework's inventory
• ox_target or qb-target (optional), or the [E] prompt with ox_lib text UI