Gamzky Scripts
Home Browse Scripts Free Scripts Documentation Server Name Generator Hash Resolver Discord
Login with FiveM
Basket
ESX • QBCore • Qbox compatible
Instant download
Updates included
Discord support
Secure checkout

Christmas Event - Santa's Present Hunt

Resource folder: gs_presenthunt

View product

Installation Instructions for Christmas Event - Santa's Present Hunt

Follow these steps to install and configure gs_presenthunt on your FiveM server.

  1. Download the Resource
    • Go to portal.cfx.re
    • Navigate to Assets > Granted Assets > gs_presenthunt
    • Download the resource
  2. Extract the Files
    • Open the downloaded .zip file
    • Inside, you'll find a folder named gs_presenthunt
    • Move the entire gs_presenthunt folder into your desired server resources folder (e.g., /resources/[scripts])
  3. Add to Server Configuration
    • Open your server.cfg
    • Add the following line: 
      ensure gs_presenthunt
  4. Restart the Server
    • Restart your FiveM server (Important!)
  5. Configure the Script (Optional)
    • Navigate to gs_presenthunt/config.lua
    • Edit the configuration options to fit your server's needs

Does Present Hunt work with qb-target?

Not out of the box. The script supports ox_target first, with a text fallback when no target script is running. qb-target is not included in the bridge. qb-target-only servers need a bridge change or ox_target installed.

Does Present Hunt work with ox_target?

Yes. ox_target is the primary supported target system. Make sure ox_target starts before gs_presenthunt.

Does it work with QBCore?

Yes. QBCore framework support is separate from target integration. Confirm both your framework bridge and your chosen target system are set up correctly.

Presents stopped spawning and the script errors near the leaderboard

The script failed to resolve a player's first and last name from their identifier. This often happens when a character was deleted from the database but their entry still exists in the scoreboard data.

Check server logs, remove orphaned scoreboard entries for deleted characters, and update Functions.GetCharacterName in the bridge to return a fallback like 'Unknown' when no character is found.

How does the community goal and personal rewards work?

Players collect presents around the map to contribute to a server-wide community goal. Once the goal is reached and a player has collected enough presents personally, they can claim configured rewards from the Santa NPC.