Christmas Script: Find Gifts, Advent Calendar

Introducing Our Exclusive FiveM Christmas Script!

Celebrate the festive season in your FiveM server with our unique Christmas script. Designed to bring holiday joy and excitement, this script is a must-have for your community this winter!

Features:

• Citywide Gift Hunt: Players can explore the city to find hidden presents, each filled with surprises.
• Collectible Toys: Discover bronze, silver, and gold toys and unlock special rewards.
• Christmas Trees and Trader Zones: Trade collected toys for exclusive items at designated Christmas trees around the city.
• Advent Calendar Rewards: An in-game calendar that offers daily surprises including cash, rare items, and exclusive vehicles.

Preview: YOUTUBE

Get It Now on Tebex: ESX / QBCORE

Dependencies: Our Christmas script is designed for easy integration, but it does require the following dependencies to function optimally:

• QBCore Framework
• ESX Framework (ox_lib, ox_target)

Why Choose Our Script?

• Enhance Player Experience: Add a festive twist to your server, keeping your community engaged and excited.
• Easy Integration: Our script is designed for easy installation and compatibility with most FiveM servers.
• Continuous Support: We provide regular updates and support to ensure the best experience for you and your players.

Quick Administrator Command Guide:

1. ‘/showgift’:

• Displays blips and IDs of presents on the map for admins.

2. ‘/creategift’:

• Allows admins to create a new present location.

3. ‘/removegift’:

• Used by admins to delete an existing present location.

4. ‘/startfindgift’:

• Start the gift search event.

5. ‘/stopfindgift’:

• Stop the gift search event.

Feedback & Support: We value your feedback and are here to assist with any questions or support requests. Feel free to reach out to us on this forum or through our support channels on discord.

Let’s make this holiday season unforgettable on your FiveM server!

Configuration file:

cfg = {}

cfg.Prefix             = ESX
cfg.TriggerPrefix      = "esx"
cfg.TimeZone           = "GMT+1"
cfg.Colors             = {r = 16, g = 205, b = 172}
cfg.Show_Gifts_Blip    = true -- (true - Displays map blips for administrators, false - Doesn't display map blips for administrators.)
cfg.discordWebhook     = "URL"
cfg.Blip = {
    ["Present"] = {
        Sprite = 675, Scale = 0.7, Color = 1, Short_Range = false, Text = "Gift"
    },
    ["Christmas_Tree"] = {
        Sprite = 58, Scale = 0.8, Color = 2, Short_Range = false, Text = "Christmas Tree"
    }
}

cfg.ChristmasTree = {
    coords = {
        vector3(163.88, -982.35, 30.09),
        vector3(-1161.32, -725.88, 20.61),
        vector3(1388.58, 3596.03, 34.89),
        vector3(-119.0, 6461.4, 31.47)
    },
    model = "prop_xmas_tree_int"
}

cfg.Translation = {
    ["lua"] = {
        notifyGiftWarning = "To open the gift, you need to exit the vehicle.",
        presentDistance50 = "You are quite a distance away.",
        presentDistance35 = "You are getting closer.",
        presentDistance20 = "You are very close now.",
        presentDistance5 = "Congratulations! You found a gift.",
        targetPresent = "Collect the gift",
        targetTree = "Interaction",
        giftIdText = "Gift ID:",
        notifyEventStart = "Christmas event has started!",
        notifyEventEnd = "Christmas event has ended!",
        notifyEventWarning = "Christmas event is currently active!",
        notifyFoundToy = "You found a gift with a {type} toy",
        toyBronze = "bronze",
        toySilver = "silver",
        toyGold = "gold"
    },
    ["js"] = {
        buttonCollect = "COLLECT",
        buttonUnavailable = "UNAVAILABLE",
        buttonReceived = "RECEIVED",
        titleBronze = "BRONZE",
        titleSilver = "SILVER",
        titleGold = "GOLD",
        navTrader = "TRADER",
        navCalendar = "ADVENT CALENDAR",
        foundToy = "You've found the {type} toy!",
        bottomText = "Find Gifts Event is active!"
    }
}

cfg.Rewards = {
    ['bronze'] = {
        {
            mainImg = 'img/rewards/coffee-cup.png', requiredItems = 2, description = 'Coffee', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "coffee", 1 }
        },
		{
            mainImg = 'img/rewards/money.png', requiredItems = 5, description = '$10.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 10000 }
        },
        {
            mainImg = 'img/rewards/lockpick.png', requiredItems = 5, description = 'Lockpick', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "lockpick", 1 }
        },
        {
            mainImg = 'img/rewards/watch.png', requiredItems = 10, description = '2 Rolex', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "rolex", 2 }
        },
	},
    ['silver'] = {
        {
            mainImg = 'img/rewards/whiskey.png', requiredItems = 2, description = 'Whiskey', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "whiskey", 1 }
        },
        {
            mainImg = 'img/rewards/money.png', requiredItems = 10, description = '$25.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 25000 }
        },
        {
            mainImg = 'img/rewards/weapon.png', requiredItems = 15, description = 'Walther P99', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "weapon_pistol", 1 }
        },
    },
    ['gold'] = {
        {
            mainImg = 'img/rewards/diamond.png', requiredItems = 10, description = 'Diamond', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "diamond", 1 }
        },
        {
            mainImg = 'img/rewards/money.png', requiredItems = 15, description = '$35.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 35000 }
        },
        {
            mainImg = 'img/rewards/seven70.png', requiredItems = 20, description = 'Seven-70', serverEvent = 'christmasEvent:rewardVehicle', serverEventData = { "seven70" }
        },
    }
}

cfg.Calendar = {
    ["2023-10-27"] = {
        mainImg = 'img/rewards/money.png', description = '$2.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 2000 }
    },
    ["2023-10-28"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    },
    ["2023-10-29"] = {
        mainImg = 'img/rewards/money.png', description = '$5.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 5000 }
    }, 
    ["2023-10-30"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    }, 
    ["2023-10-31"] = {
        mainImg = 'img/rewards/money.png', description = '$2.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 2000 }
    }, 
    ["2023-11-01"] = {
        mainImg = 'img/rewards/money.png', description = '$5.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 5000 }
    }, 
    ["2023-11-02"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    }, 
    ["2023-11-03"] = {
        mainImg = 'img/rewards/money.png', description = '$4.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 4000 }
    }, 
    ["2023-11-04"] = {
        mainImg = 'img/rewards/money.png', description = '$8.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 8000 }
    }, 
    ["2023-11-05"] = {
        mainImg = 'img/rewards/watch.png', description = '2 Rolex', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "rolex", 2 }
    }, 
    ["2023-11-06"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    }, 
    ["2023-11-07"] = {
        mainImg = 'img/rewards/money.png', description = '$4.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 4000 }
    }, 
    ["2023-11-08"] = {
        mainImg = 'img/rewards/money.png', description = '$6.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 6000 }
    }, 
    ["2023-11-09"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    }, 
    ["2023-11-10"] = {
        mainImg = 'img/rewards/weapon.png', description = 'Walther P99', serverEvent = 'christmasEvent:rewardItem', serverEventData = { "weapon_pistol", 1 }
    }, 
    ["2023-11-11"] = {
        mainImg = 'img/rewards/money.png', description = '$5.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 5000 }
    }, 
    ["2023-11-12"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    }, 
    ["2023-11-13"] = {
        mainImg = 'img/rewards/money.png', description = '$4.500', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 4500 }
    }, 
    ["2023-11-14"] = {
        mainImg = 'img/rewards/money.png', description = '$3.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 3000 }
    }, 
    ["2023-11-25"] = {
        mainImg = 'img/rewards/money.png', description = '$5.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 5000 }
    }, 
    ["2023-11-26"] = {
        mainImg = 'img/rewards/money.png', description = '$2.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 2000 }
    }, 
    ["2023-11-27"] = {
        mainImg = 'img/rewards/money.png', description = '$4.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 4000 }
    }, 
    ["2023-11-28"] = {
        mainImg = 'img/rewards/money.png', description = '$10.000', serverEvent = 'christmasEvent:rewardMoney', serverEventData = { 10000 }
    }, 
    ["2023-11-29"] = {
        mainImg = 'img/rewards/vacca.png', description = 'Vacca', serverEvent = 'christmasEvent:rewardVehicle', serverEventData = { "vacca" }
    },  
}

function notify(txt, type, duration)
    cfg.Prefix.ShowNotification(txt, type, duration)
end

function serverNotify(source, txt, type, duration)
    local xPlayer = cfg.Prefix.GetPlayerFromId(source)
	xPlayer.showNotification(txt)
end