XMAS EVENT
XMAS EVENT is a FiveM Christmas event script by Risk Scripts, compatible with ESX, QBCore and QBox, available for 12.99 EUR as a one-time purchase. 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 event, Christmas script, holiday event.
XMAS EVENT - features, frameworks and installation
# Risk Xmas Event — Christmas Event Script for FiveM
**Santa drops gifts across your map. Players hunt them, open them in 3D and trade their points for a gift-wrapped car that lands straight in their garage.**
Risk Xmas Event is a FiveM christmas event script for ESX, QBCore and QBox, also known as an xmas script, gift hunt or present drop. Admins or a daily schedule drop gift boxes into your zones, players open them for items and event points, and spend the points in Santa's Gift Shop on items, money or the Xmas Clique. Works with ox_inventory, qb-inventory, qs-inventory, codem-inventory, tgiann-inventory, core_inventory and origen_inventory, with ox_target, qb-target or the E key.
---
## Why this one
Most christmas scripts give you a few props and a command. This one runs your whole holiday event.
- **The car goes into the garage.** The reward car is saved as an owned car with its Christmas livery, parked in the garage you choose. esx_garage, qb-garages, qbx_garages, okokGarage, jg-advancedgarages and cd_garage are handled out of the box.
- **Our own gift prop is included.** A self-made 3D gift box, streamed with the script. Nothing to download, no map pack needed.
- **It runs by itself.** Drops at fixed daily times or every X minutes, with a "Santa is on his way" banner before every drop.
- **Every gift opens once.** Gifts and purchases are checked on the server, so fast clicking, fake requests or a cheat menu get nothing.
- **Late joiners are not left out.** Who joins during or after a drop still sees the banner and every gift that is left.
---
## Gift Drops Across the Map
| Step | What happens |
| --- | --- |
| **Santa is coming** | A banner with a sleigh shows the countdown on every screen |
| **Gifts land** | Gift boxes fall at random spots inside your zones, each with a map blip |
| **The hunt** | The box appears when a player gets close and sits on the ground |
| **First come** | The first player who opens a gift gets it, it disappears for everyone else |
| **Clean up** | Leftover gifts vanish after the time you set, with a warning before |
Start a drop with `/xmasdrop`, let it run at `18:00` and `21:00` every day, or every 60 minutes. Zones are simple circles, from one big city zone to a small hunt in Paleto Bay.
---
## The Gift Opening
The gift appears in the middle of the screen and the player clicks it. The lid lifts off, the reward rises out of the open box, and light rays in the rarity color fill the screen. Then the item name, the amount and the points show up.
- Four rarities: **common**, **rare**, **epic** and **legendary**, colors set in the config
- Every reward has its own chance, amount and points per piece
- Full inventory? The gift stays on the map, nothing is lost
---
## Santa's Gift Shop
An NPC or a marker where players spend their points. Every entry is a card with its picture, rarity and price.
| Reward type | Example | What the player gets |
| --- | --- | --- |
| **Item** | Christmas Cookie, 50 points | Any item of your server |
| **Money** | $50,000 cash, 220 points | Cash, bank or black money |
| **Vehicle** | Xmas Clique, 450 points | An owned car, parked in the garage |
Set a limit per character, for example one car per player. Prices, rewards and the shop position are all yours to change.
---
## The Xmas Car
The default reward is the GTA **Vapid Clique** with the **Merry Cliquemas** livery, a real christmas car without any extra download. It is never spawned in the world: the script saves it with plate, livery and the full vehicle data of your framework, already parked. The player walks to the garage and takes it out.
Want another car? Put any model into the shop and find its livery with `/xmaslivery`: the car spawns in front of you, the arrow keys switch liveries, `ENTER` shows the number.
---
## Usable Christmas Items
Eight items with pictures ship with the script, five of them usable:
| Item | When used |
| --- | --- |
| Christmas Cookie, Chocolate Box, Christmas Wrap | Eat animation, fills hunger on ESX, QBCore and QBox |
| Snowball Pack | Gives real snowballs, no pickup glitches |
| Mystery Gift | Opens with the same box animation and a surprise reward |
Any item of your server can be made usable the same way, as food, drink, snowball pack or gift.
---
## Built for Your Other Scripts
```lua
-- give points for a job, a quest or an event of your own
exports['risk-xmasevent']:AddPoints(source, 25)
-- start a drop from your own event or command
exports['risk-xmasevent']:StartDrop()
-- open Santa's shop from a phone app
exports['risk-xmasevent']:OpenShop(source)
```
`GetPoints`, `ClearGifts` and `IsDropActive` are there too.
---
## Change Everything Yourself
| What | Where |
| --- | --- |
| Shop, drops, rewards, prices, commands | `config/config.lua`, one comment per line |
| All texts and the whole UI | `locales/` — rewrite them or add your own language |
| Your own inventory or needs script | `inventory/inventory.lua`, an open bridge |
| A garage with its own table | `database/database.lua`, an open bridge |
| Notify, help text and HUD | `Config.Functions` |
| Pictures for your own rewards | `html/img/items/` |
Every config value is checked on start. A typo never breaks the script, it falls back to a safe value and tells you in the console.
---
## Compatibility
| | Supported |
| --- | --- |
| **Frameworks** | ESX, QBCore, QBox (auto-detected) |
| **Inventories** | ox_inventory, qb-inventory, qs-inventory, codem-inventory, tgiann-inventory, core_inventory, origen_inventory |
| **Garages** | esx_garage, qb-garages, qbx_garages, okokGarage, jg-advancedgarages, cd_garage, risk-garage |
| **Database** | oxmysql, mysql-async, ghmattimysql |
| **Interaction** | ox_target, qb-target or the E key |
| **Languages** | 11: EN, DE, ES, FR, IT, NL, PL, PT, RO, RU, TR |
---
## What You Get
✅ Gift drops by command, daily times or interval
✅ "Santa is on his way" banner before every drop
✅ Own custom 3D gift prop, streamed with the script
✅ 3D gift opening, reward rises out of the box
✅ Four rarities with colors in the config
✅ Event points with chance and points per reward
✅ Santa's Gift Shop with items, money and vehicles
✅ Xmas Clique with Merry Cliquemas livery
✅ Car saved straight into 7 garage systems
✅ `/xmaslivery` livery finder for any car
✅ 8 Christmas items with pictures, 5 usable
✅ Late joiners see running drops
✅ Server-side checks, every gift opens once
✅ Responsive UI from 720p to 4K and ultrawide
✅ 11 languages, open locales
✅ Open inventory, database and notify bridges
✅ Database tables created automatically
✅ 0.00ms Idle
✅ 0.00ms Performance
---
## Installation
1. Put `risk-xmasevent` into your resources and `ensure` it after your framework, inventory and target
2. Add the items from `_items/` to your inventory
3. Add the four `add_ace` lines for the admin commands to your `server.cfg`
4. Set the shop position, the garage name and your zones, restart and type `/xmasdrop`
**Requirements:** ESX, QBCore or QBox · oxmysql, mysql-async or ghmattimysql · optional ox_target or qb-target
---
## FAQ
**What is Risk Xmas Event?**
Risk Xmas Event is a FiveM christmas event script for ESX, QBCore and QBox. It drops gift boxes across the map, players open them for items and points and spend the points in Santa's Gift Shop on items, money or a christmas car that lands in their garage.
**Does it work with ox_inventory, qs-inventory and my other inventory?**
Yes. ox_inventory, qb-inventory, qs-inventory, codem-inventory, tgiann-inventory, core_inventory and origen_inventory are detected automatically. Anything else can be added in the open `inventory/inventory.lua`.
**Do I need ox_target, or does qb-target or the E key work?**
All three work. With `ox_target` or `qb-target` running it uses the target eye, otherwise a help text and the `E` key.
**Is the gift prop included?**
Yes. Our own gift box streams with the script. There is nothing extra to install.
**Where does the reward car go?**
Into the garage you set in the config, already parked with its livery. The script fills the columns of esx_garage, qb-garages, qbx_garages, okokGarage, jg-advancedgarages and cd_garage by itself.
**Can a gift be opened twice or exploited with a cheat menu?**
No. The server picks the reward, checks the distance and lets every gift be opened exactly once. Shop purchases are locked against double clicks.
**How is the performance?**
0.00ms idle. Gift boxes only exist near the player who is close to them, and while nobody is near a gift or the shop only one light check per second runs.
**Can I change the items and drop zones after the holidays?**
Yes. Rewards, shop entries, prices and zones are plain config tables. Use any item of your server.
**Can I add my own language?**
Yes. All 11 languages are open files in `locales/`. Copy one, translate it and set `Config.Locale`.
**Do the snowballs work with ox_inventory?**
Yes. The snowball pack gives `weapon_snowball` through your own inventory, so the snowballs arrive like any other weapon item and are equipped the normal way.
| Resource | XMAS EVENT |
|---|---|
| Frameworks | ESX, QBCore and QBox |
| Price | 12.99 EUR, one-time |
| 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 XMAS EVENT work with ESX, QBCore and QBox?
- XMAS EVENT 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 XMAS EVENT open source or Escrow?
- Risk Scripts offers XMAS EVENT 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 XMAS EVENT cost?
- XMAS EVENT costs 12.99 EUR as a one-time purchase. 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 XMAS EVENT affect server performance?
- XMAS EVENT 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 XMAS EVENT?
- 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.