⚙️Configuration

Check the instructions below.

The script is fully customizable via the config.lua file.

Core Settings

Field	Description	Example Value
Framework	Server framework used. Options: esx, qb, newesx, newqb.	"newqb"
Admins	Steam identifiers of admins who can control the truck.	["steam:11000010c8b3b9e"]
TruckSpawnCoords	Coordinates where the truck spawns.	{vector3(1531.963, 913.5385, 77.023)}

Gift Spawn Settings

Field	Description	Example Value
GiftSpawnInterval	Time range (in seconds) for gifts to spawn.	{min = 30, max = 60}
GiftCount	Number of gifts spawned per session.	10

Rewards

The Rewards table defines the reward categories (common, uncommon, rare, epic, legendary) and their associated money and item rewards.

Reward Example:

["common"] = {
    ["money"] = {min = 100, max = 500},
    ["items"] = {
        {name = "weapon_pistol", min = 1, max = 2},
        {name = "weapon_combatpistol", min = 1, max = 2},
    },
},

Category	Money Range	Item Examples	Probability (%)
common	100 - 500	weapon_pistol, combatpistol	50
uncommon	500 - 1000	whiskey	30
rare	1000 - 2000	goldbar, 10kgoldchain	15
epic	2000 - 5000	rolex, goldbar	4
legendary	5000 - 10000	weapon_carbinerifle, smg	1

Localization

The Locales table allows you to customize in-game messages. Default example:

["picked_reward"] = "You picked up a gift and got %s %s",

---

How to Use

1. Truck Spawn The Christmas truck spawns automatically at the predefined coordinates in TruckSpawnCoords.

2. Gift Drops Gifts are dropped at regular intervals, as configured in GiftSpawnInterval.

3. Collect Gifts Players interact with gifts to claim rewards. The system automatically calculates the reward category and item/money.

4. Notifications Players receive a message after collecting a gift, e.g., "You picked up a gift and got $100 goldbar".

---

Tips and Notes

• Admin Control: Add admin identifiers in the Admins section to give specific players control over the Christmas truck.

• Reward Balance: Adjust CategoryChances to balance reward probabilities.

• Framework Compatibility: Ensure the Framework value matches your server's framework.