# XMAS EVENT

## <mark style="color:yellow;">Highlights</mark>

* **Gift Hunt Zones:** Presents spawn in predefined zones and only open if inside valid event areas.
* **Points Economy:** Every box grants configurable points that unlock items, money or vehicles.
* **Christmas Shop:** Redeem points for rewards with images, rarity tiers and per-player purchase limits.
* **Auto Framework:** ESX or QBCore/Qbox detection; identifiers and names auto-mapped, manual override in config.
* **Secure Rewards:** Rewards processed server-side only; distance, zone and duplicate-open checks enforced.
* **Admin Control:** Protected commands for dropping boxes and gifting points using identifier whitelist.
* **Auto Drops:** Time-based or interval-based automatic drop system for passive server events.
* **Custom Props:** Swap the present prop model via `RISK.Box.propModel` and stream any custom crate.

{% content-ref url="/pages/VzGKBNuLzLWR1xwUTBR9" %}
[Prop Setup Guide](/risk-scripts/scripts/xmas-event/prop-setup-guide.md)
{% endcontent-ref %}

{% content-ref url="/pages/wba9ETeg2LBdU3WNPBUp" %}
[NPC Setup Guide](/risk-scripts/scripts/xmas-event/npc-setup-guide.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://risk-scripts.gitbook.io/risk-scripts/scripts/xmas-event.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.