Christmas Script: Find Gifts, Advent Calendar

minitaurkaKoncowa


:tada: 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!

:star2: 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.

:link: Preview: YOUTUBE


:shopping_cart: Get It Now on Tebex: ESX / QBCORE


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


:bulb: 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.

:shield: Quick Administrator Command Guide:

  1. ‘/showgift’:
  • Displays blips and IDs of presents on the map for admins.
  1. ‘/creategift’:
  • Allows admins to create a new present location.
  1. ‘/removegift’:
  • Used by admins to delete an existing present location.
  1. ‘/startfindgift’:
  • Start the gift search event.
  1. ‘/stopfindgift’:
  • Stop the gift search event.

:globe_with_meridians: 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! :santa::christmas_tree:


:gear: 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
Code is accessible Only configuration
Subscription-based No
Lines (approximately) 500+
Requirements Dependencies
Support Yes
5 Likes

:bell: Important Update for FiveM Christmas Script!

Hello everyone! :wave:

We’re thrilled to bring you a significant update for the FiveM Christmas Script. This update includes a series of improvements and fixes to enhance your server’s holiday experience.

:hammer_and_wrench: Update Highlights:

  • SQL File Fix: We’ve corrected an error in the SQL file to ensure better stability and performance.
  • Enhanced ‘CreateGift’/‘RemoveGift’ Functionality: Adding new gift locations with ‘/creategift’ now makes them immediately available for the next event, eliminating the need for a script restart.
  • Advent Calendar Improvement: The calendar has been updated to accurately display the current day, aligning with the real-world date.
  • FXManifest Optimization: We’ve made adjustments to the fxmanifest file to resolve warnings and improve overall script performance.
  • Ox Target Improvement: Target calling has been corrected so that it does not cause errors for other versions.

:file_folder: Files Updated:

  • fxmanifest.lua
  • event_manager.lua
  • app.js
  • main.lua only for ESX version
  • Note: The ‘audio’ folder within ‘html’ has been removed to streamline the script.

We highly recommend updating to this latest version to take full advantage of these enhancements. The updated files are available at the original download link.

Thank you for your ongoing support. We’re excited to see how these updates enhance your FiveM Christmas festivities!

2 Likes

Love me a good ole’ Advent scavenger hunt!

Hope it has some high customization features, such as changing the items for after the holiday, location drops, etc!

3 Likes

Looks very nice!

2 Likes

Script looks nice

2 Likes

:bell: Important Update for FiveM Christmas Script!

Hello everyone! :wave:

We’re thrilled to bring you a significant update for the FiveM Christmas Script. This update includes a series of improvements and fixes to enhance your server’s holiday experience.

:hammer_and_wrench: Update Highlights:

  • Location Duplication Fix: We’ve resolved the issue with duplicating gift locations, ensuring a smoother event experience.
  • Script Optimization: The entire script has been optimized for better performance and efficiency.
  • Instant Event Start with ‘/startfindgift’: The ‘/startfindgift’ command now immediately initiates the event, making the process faster and more convenient.
  • Trader UI Fix: Adjustments have been made to the Trader UI for a more intuitive and error-free user experience.

:file_folder: Files Updated:

  • client/main.lua
  • server/event_manager.lua
  • html/js/app.js

We highly recommend updating to this latest version to take full advantage of these enhancements. The updated files are available at the original download link.

Thank you for your ongoing support. We’re excited to see how these updates enhance your FiveM Christmas festivities!

1 Like

Can anyone recommend a good winter mod (snowfall on the ground)