Christmas Event - Santa's Present Hunt
Celebrate the holidays with a festive FiveM present hunt! Players collect gifts across the map to contribute to a server...
Key Features
Works with ESX • QBCore • Qbox
What's included:
- Full script files
- Configuration files
- Installation documentation
- Lifetime updates
- Discord support
Overview
Bring the magic of Christmas to your server with the Santa's Present Hunt event script! This fun and festive script lets players go on a scavenger hunt to gather presents scattered around the map. As they collect presents, they contribute to the community goal, unlocking rewards for everyone once the target is met!
Key Features
🎁 Gift Collection: Presents will randomly appear in the world around the player, with adjustable spawn distances from the player, roads, and other presents.
🎯 Community Goal: Everyone works together to reach the community-wide goal (Configurable). Players need to collect a set minimum number of gifts to be eligible for the prize.
🛡️ Anti-Abuse System: Built-in server-side checks detect and block any invalid collection attempts. If abuse is detected, the player is temporarily prevented from contributing to the community goal.
⚙️ Customizable Settings: Tweak spawn rates, distances, pickup effects, and more to suit your server.
🎅 Santa & Blip: Santa Claus is by default located at Legion Square where players can claim their rewards, marked by a blip on the map.
💾 Save System: Progress is saved in JSON format, so no progress gets lost during the event.
How it works
- Presents spawn at random spots in a configurable area around the player. (Presents automatically despawn when out of range.)
- Players can pickup presents. As they collect the presents they contribute to the community goal.
- Once the goal is reached and a player has collected the minimum required number of presents, they can visit Santa to claim their reward!
Installation
- Download the resource from portal.cfx.re (Assets > Granted Assets)
- Extract the files and move the resource folder to your server's resources directory
- Add to server.cfg by adding:
ensure gs_presenthunt - Restart your server to load the resource
- Configure (optional) by editing the config.lua file in the resource folder
Configuration
All scripts include easy-to-edit configuration files. Common settings include:
- Language/localization options
- Feature toggles
- Price and economy settings
- Notification preferences
Dependencies
This script requires the following dependencies to function properly:
Make sure to install and start all dependencies before installing this script.
Escrow vs Source: Which Should You Choose?
Escrow (Encrypted)
Best for server owners who want plug-and-play functionality.
- Protected code files
- Easy configuration via config files
- Same features as source version
Source (Unencrypted)
Best for developers who need full customization.
- 100% editable code
- Full customization freedom
- Same features as escrow version
Same features; editability differs.
