ADVENT CALENDAR + PROP
ADVENT CALENDAR + PROP is a free FiveM advent calendar script by Risk Scripts, compatible with ESX, QBCore and QBox, available free of charge. It idles at 0.00ms, ships with free lifetime updates and is supported 24/7 through the Risk Scripts Discord. Also known as FiveM Christmas calendar, xmas calendar script, daily reward calendar.
ADVENT CALENDAR + PROP - features, frameworks and installation
# Risk Advent — Free FiveM Advent Calendar Script with 3D House & Premium Calendar
**Free: a real 3D advent calendar house with 24 doors, cars on Christmas Eve, and a premium calendar that earns money for your server.**
Risk Advent is a FiveM advent calendar script for ESX, QBCore and QBox, also known as a Christmas calendar, xmas calendar or Adventskalender. The escrow version is free with every feature. Players walk to a snowy 3D calendar house, open the door of the day from December 1st to 24th and get items, money or a car straight into their garage. Works with ox_inventory, qb-inventory, qs-inventory and more.
---
## Why this one
- **Free, with every feature.** The escrow version costs nothing and is not a cut-down demo. The premium calendar, cars, 3D house and all 11 languages are included. Only the open source version is paid.
- **A real 3D advent calendar on your map.** Not just a menu at an NPC. A snowy house with 24 doors that swing open while the gift reveal plays.
- **It earns money for your server.** A second premium calendar with its own 24 doors, sold in your own Tebex store. Players redeem their Tebex ID right in the calendar.
- **Cars, not only items.** A door can park an owned car with an `XMAS` plate in the player's garage.
- **Every character has its own calendar.** Multicharacter ready, the date comes from the server, every door is checked on the server.
---
## The 3D Advent Calendar House
The calendar is a snowy house with 24 real doors, brass hinges and two Christmas trees next to it.
| What happens | Why it matters |
| --- | --- |
| **Every player sees their own doors** | Only the doors their character opened are open on the house |
| **The door opens live** | While the gift reveal plays, the matching door on the house swings open |
| **The camera shows the house** | When the calendar opens, the view turns to the whole house |
| **Saved in the database** | Opened doors stay open after a reconnect or a server restart |
You never type coordinates. `/adventplace` shows a see-through ghost of the house. Aim, turn it with the mouse wheel, press ENTER, and the config line is printed in F8.
---
## A Christmas Calendar That Feels Real
Players open the calendar with `E`, `ox_target` or `qb-target` and look for today's yellow door, like a real advent calendar. Prefer it faster? One switch turns on a green "open door" button.
- The door swings open, the gift flies to the middle of the screen and opens.
- Snow falls in the background, the decoration swings.
- Doors of the coming days are dark, opened doors show what was inside.
- Door 24 is the big Christmas Eve door.
Before December 1st the calendar shows how many days are left. From December 25th it shows the end screen.
---
## Rewards: Items, Money and Cars
Every door holds up to 5 rewards.
| Reward | What the player gets |
| --- | --- |
| **Item** | Any item of your server, straight into the inventory |
| **Money** | Cash, bank or black money |
| **Car** | An owned car with an `XMAS` plate, parked in the garage you set |
9 Christmas items with pictures ship in `_items/`: gingerbread cookie, chocolate box, mystery gift, reindeer food, snowball pack, golden tree star, Christmas apple, chocolate pretzels and roasted nuts. Optional, any item works.
A full inventory never eats a reward. The player gets a message and the door stays closed until they make space.
---
## Premium Calendar for Your Tebex Store
This is how a free script makes money for **your** server.
| Step | What happens |
| --- | --- |
| **1. You sell it** | Create a premium package in your own Tebex store |
| **2. Player buys** | Tebex sends a command to your server, even when the player is offline |
| **3. Player redeems** | They type the Tebex transaction ID (`tbx-...`) into the locked premium calendar |
| **4. Two doors a day** | From now on they open the normal door AND the premium door |
The money goes to your store. Risk Scripts takes nothing. Every purchase works once, two players cannot share one ID. Optional catch up lets late buyers open the premium doors of past days, so premium still sells on December 20th.
Want to give premium from your own coin shop or VIP script instead? There is an export for that.
---
## Fair for Every Player
- **Server date only.** Changing the PC clock does nothing.
- **Checked on the server.** Every door, reward and redeem is validated server side.
- **One door per character per day.** Double clicks and race conditions cannot pay out twice.
- **Missed days:** stay closed by default, or turn on catch up.
- **Next year:** doors and premium are saved per year, December 1st starts fresh.
---
## Built for Your Other Scripts
Server exports let your phone, coin shop or reminder scripts use the calendar.
```lua
-- Open the calendar from a phone app or an item
exports['risk-advent']:OpenCalendar(source)
-- Give premium from your own coin shop or VIP script
exports['risk-advent']:GivePremium(source)
-- Remind players whose door is still closed
if not exports['risk-advent']:HasOpenedToday(source) then
TriggerClientEvent('chat:addMessage', source, { args = { 'Advent', 'Your door is still closed!' } })
end
```
Also included: `GetOpenedDoors`, `HasPremium` and `ResetDoors`.
---
## What You Can Change
| File | What you change |
| --- | --- |
| `config/config.lua` | Every setting, all 48 doors, garage, blip, commands, admin groups |
| `locales/*.lua` | Rewrite any text or add your own language as a new file |
| `inventory/inventory.lua` | Open inventory bridge, add your own inventory |
| `database/database.lua` | Open database bridge, decides how cars are saved for your garage script |
| `config/logo.png` + `Config.UIName` | Your own logo and server name in the calendar |
| `Config.Functions` | Plug in your own notify, help text and HUD hiding |
---
## Compatibility
| | Supported |
| --- | --- |
| **Framework** | ESX · QBCore · QBox, auto-detected |
| **Inventory** | ox_inventory · qb-inventory · qs-inventory · codem-inventory · tgiann-inventory · core_inventory · origen_inventory · framework inventory |
| **Target** | ox_target · qb-target · built-in `E` key |
| **Database** | oxmysql · mysql-async · ghmattimysql, tables created automatically |
| **Multicharacter** | esx_multicharacter · qb-multicharacter · QBox |
| **Languages** | 11: EN, DE, ES, FR, IT, NL, PL, PT, RO, RU, TR |
---
## What You Get
- ✅ Free escrow version with every feature
- ✅ 3D advent calendar house with 24 real doors and two Christmas trees
- ✅ Doors on the house open live with the gift reveal
- ✅ `/adventplace` ingame placing, no coordinates by hand
- ✅ 24 doors from December 1st to 24th, server date
- ✅ Up to 5 rewards per door: items, cash, bank, black money, cars
- ✅ Car rewards parked in the player's garage with an `XMAS` plate
- ✅ Premium calendar with its own 24 doors, sold in your Tebex store
- ✅ Tebex ID redeem directly in the calendar UI
- ✅ Search for today's door or quick open button
- ✅ Optional catch up for missed days, separate for premium
- ✅ Multicharacter ready, one calendar per character
- ✅ 9 Christmas items with pictures
- ✅ Admin commands: test day, reset player, give premium
- ✅ Server exports for phone, shop and reminder scripts
- ✅ 11 languages, add your own in one file
- ✅ Responsive UI from 1080p to 4K and ultrawide
- ✅ Exploit-safe, server-authoritative, 0.00ms idle
---
## Installation
1. Drop `risk-advent` into your resources folder, do not rename it
2. Add `ensure risk-advent` to your `server.cfg`, below your framework, inventory and database
3. Restart. The database tables are created automatically, no SQL import
4. Type `/adventplace`, place the house and paste the printed line into `Config.Location`
Test any door before December with `/adventday 1`.
**Requirements:** ESX, QBCore or QBox · `oxmysql`, `mysql-async` or `ghmattimysql`
---
## FAQ
**What is Risk Advent?**
Risk Advent is a FiveM advent calendar script for ESX, QBCore and QBox. Players open one door per day from December 1st to 24th at a 3D calendar house and get items, money or a car, with an optional premium calendar sold in your own Tebex store.
**Is Risk Advent free?**
Yes. The escrow version is free on Tebex with every feature, including the premium calendar and car rewards. The open source version, where you can edit the code itself, is paid.
**How does the premium calendar make money for my server?**
You sell a premium package in your own Tebex store. Players redeem the Tebex transaction ID in the calendar. The money is yours, Risk Scripts takes nothing.
**Does it work with my inventory?**
Yes. ox_inventory, qb-inventory, Quasar (qs-inventory), codem-inventory, tgiann-inventory, core_inventory and origen_inventory are detected automatically. Otherwise the framework inventory is used.
**Can I add my own inventory?**
Yes. The inventory bridge `inventory/inventory.lua` is open.
**Can players get cars?**
Yes. A car is saved as an owned car and waits in the garage from `Config.Garage`. Works with most garage scripts, and the database bridge is open for your own table.
**Does it work with multicharacter?**
Yes. Every character has its own calendar and premium. Without multicharacter it works the same.
**Can I test it before December?**
Yes. `/adventday 5` pretends it is December 5th, `/adventday 0` goes back to the real date.
**Do I need ox_target or qb-target?**
No. Both are supported, without one players press `E`.
**How does it affect performance?**
0.00ms idle. The house only spawns near players and the UI only runs while it is open.
**Can I add my own language?**
Yes. 11 languages ship, copy `locales/en.lua`, translate it and set `Config.Locale`.
https://www.youtube.com/watch?v=GWePJ65ZrZE
| Resource | ADVENT CALENDAR + PROP |
|---|---|
| Frameworks | ESX, QBCore and QBox |
| Price | Free |
| Licensing | Open source and Escrow editions available |
| Idle performance | 0.00ms |
| Updates | Free lifetime updates |
| Support | 24/7 via the Risk Scripts Discord |
| Documentation | Risk Scripts GitBook |
- Does ADVENT CALENDAR + PROP work with ESX, QBCore and QBox?
- ADVENT CALENDAR + PROP is compatible with ESX, QBCore and QBox. The framework is detected at runtime, so the same download works on every supported server without a separate build.
- Is ADVENT CALENDAR + PROP open source or Escrow?
- Risk Scripts offers ADVENT CALENDAR + PROP as an open-source edition and as an Escrow edition. In both cases the config files, locale files and the HTML/CSS stay editable.
- How much does ADVENT CALENDAR + PROP cost?
- ADVENT CALENDAR + PROP costs free of charge. It is also included in the Risk Scripts VIP package, a one-time payment that covers the Escrow edition of every current and future release.
- Does ADVENT CALENDAR + PROP affect server performance?
- ADVENT CALENDAR + PROP idles at 0.00ms and is profiled under real server load, so it runs alongside a full resource stack without measurable frame cost.
- What support and updates are included with ADVENT CALENDAR + PROP?
- Every Risk Scripts purchase includes free lifetime updates and 24/7 support through the Risk Scripts Discord, answered directly by the developers who wrote the code.
- Is this the official Risk Scripts store?
- Yes. riskscripts.com, shop.riskscripts.com and risk-scripts.tebex.io are the same official store, operated by Risk Scripts, a German FiveM development studio. Payment runs through Tebex checkout, the official Cfx.re payment partner, and the purchase is delivered to your own Cfx.re account. Risk Scripts does not sell through resellers or any other website.