XMAS EVENT SCRIPT [OPEN SOURCE]

↪ GitBook Documentation

https://youtu.be/EP6e7jSlT-8?si=HQft1WnLJsa85mwF

🎁 City-Wide Christmas Hunt

Transform your entire map into a Christmas event. Players search for gift boxes and open them for configurable rewards. Spawn settings, reward chances and rarities are fully controlled via config.

🎅 Live Santa Drops & Customizable Props

Use the included present crate or plug in your own prop. Spawns are dynamic and event-based. Works perfectly with a Santa shop NPC for a full seasonal vibe.

⭐ Points & Gifts Economy

Players earn items, money or Christmas Points, your seasonal event currency. These can be exchanged at the Santa shop for exclusive items. The entire reward system is editable.

🛍️ Santa NPC Shop

Configured directly in config.lua with ped options, custom coords and headings. Replace any ped model (e.g. ig_bankman) with a Santa Claus Add-On ped for a complete holiday presentation.

🧊 Flexible Prop & Ped Setup

You’re never locked to one model. Swap props and peds via simple config edits. GitBook includes full guides for:
🔹 Free Gift Crate Prop
🔹 Santa Claus Add-On Ped Setup

🔐 Exploit-Safe by Design

All rewards, points and payouts are validated server-side. Players cannot change rewards through devtools or UI modification. Safe for busy, grind-heavy servers.

🧩 Optimized for Seasonal Events

Lightweight, clean, no constant loops. Integrates smoothly into any economy style and can be removed after the season without any impact on your database.