FourTwenty Advent Calendar 🎄 | Interactive Holiday Gift System

[Release] FourTwenty Advent Calendar :christmas_tree: | Interactive Holiday Gift System

:loudspeaker: Introduction

Hey FiveM Community! :wave:
We’re FourTwentyDev, and we’re excited to bring some holiday cheer with the FourTwenty Advent Calendar, a feature-rich calendar system that combines daily rewards, interactive gift hunting, and a stunning UI. Perfect for servers looking to engage their community during the festive season while maintaining seamless integration with ESX or QB-Core.


:fire: Key Features

:gift: Interactive Gift Hunt System

  • Dynamic gift placement with multiple spawn locations per day
  • Intelligent ground detection system
  • Safe location verification
  • Anti-exploitation measures
  • Engaging search mechanics with visual indicators

:date: Advanced Calendar System

  • Daily rewards system with multiple reward types:
    • Items
    • Cash rewards
    • Bank transfers
    • Special multi-rewards (Day 24)
  • Progress tracking
  • Anti-abuse mechanisms

:desktop_computer: Modern NUI Interface

  • 24 animated calendar doors
  • Beautiful Christmas theme
  • Custom animations and transitions
  • Particle effects and seasonal decorations
  • Sound effects for enhanced immersion
  • Fully mobile-friendly design

:earth_africa: Multilingual Support

  • Currently supports:
    • English (en)
    • German (de)
  • Easy to add new languages

:package: Dependencies

  • ESX or QB-Core Framework
  • oxmysql
  • FiveM Server Build 2802+

:cd: Installation

  1. Download or Clone the repository:
cd resources
git clone https://github.com/FourTwentyDev/advent
  1. Import the provided SQL schema:
CREATE TABLE IF NOT EXISTS fourtwenty_advent (
    year INT NOT NULL,
    opened_doors LONGTEXT,
    PRIMARY KEY (year)
);
  1. Add ensure fourtwenty_advent to your server.cfg
  2. Configure your settings in config.lua
  3. Start your server and spread some holiday cheer! :christmas_tree:

:wrench: Configuration

Gift Properties

Config.GiftProps = {
    models = {
        'prop_box_tea01a',
        'prop_cs_box_clothes',
        'prop_cs_box_step',
        'prop_box_ammo04a',
        'prop_paper_bag_01'
    },
    searchRadius = 100.0,
    timeToSearch = 5000,
    markerType = 1
}

Sound Effects

Config.Sounds = {
    doorOpen = {
        name = "NAV_UP_DOWN",
        dict = "HUD_FRONTEND_DEFAULT_SOUNDSET"
    },
    giftFound = {
        name = "CHALLENGE_UNLOCKED",
        dict = "HUD_AWARDS"
    }
}

Reward System

Config.Rewards = {
    [24] = {
        type = "multi",
        rewards = {
            {
                type = "bank",
                amount = 25000
            },
            {
                type = "item",
                item = "heist_necklace_2",
                amount = 1
            }
        }
    }
}

:chart_with_upwards_trend: Performance

  • 0.0ms idle
  • 0.01ms - 0.02ms active
  • Optimized through:
    • Efficient spawn algorithms
    • Smart distance checks
    • Event batching
    • Resource state management

:movie_camera: Showcase Video

Showcase
:eyes: Watch the showcase video to see the Advent Calendar in action!


:satellite: Support & Updates

Need help or want to report a bug? We’re here for you:

  1. Discord: Join Our Server
  2. GitHub: Submit Issues
  3. Website: FourTwentyDev

:page_facing_up: License

This project is licensed under the MIT License. See the LICENSE.md file for details.


:christmas_tree: Made with holiday cheer by FourTwentyDev

9 Likes

This Script looks great! Keep it up :+1:

1 Like

i can’t figure out how to use it with ox.lib/ progress… can you help please?

I have a script error on my F8 console which says the following:

script error: @fourtwenty_advent/client/client.lua:15: attempt to index a nil value (field 'Commands')

And YES I have installed everything as instructed. My server is QBcore framework with oxmysql included. My FXServer build is 7290.

:rotating_light: IMPORTANT UPDATE: fourtwenty_advent Hotfix :rotating_light:

Hey @everyone!

We’ve just released a critical hotfix for fourtwenty_advent. To ensure everything works smoothly, please follow these steps:

:one: Execute these SQL commands:

DROP TABLE fourtwenty_advent;

CREATE TABLE IF NOT EXISTS fourtwenty_advent (
  identifier VARCHAR(50) NOT NULL,
  year INT NOT NULL,
  opened_doors JSON,
  PRIMARY KEY (identifier, year)
);

:two: Then run these commands:
/refresh
/restart fourtwenty_advent

:warning: Please update ASAP to avoid any issues!

If you have any questions or run into problems, feel free to reach out in the support channel. :video_game::sparkles:

I want to start by acknowledging the effort you put into creating this advent calendar script for the community. Free resources like this can be incredibly helpful. However, I reached out to you about an error that I’ve been having in my FiveM server. I noticed my message was seen but ignored, which is disappointing.

I understand this is a free script, and you don’t owe anyone ongoing support. That said, ignoring a simple request for help reflects poorly, especially when users are dedicating their time to using and supporting your work. I also tried your hotfix, but unfortunately, it didn’t resolve my issue.

Since I haven’t received any acknowledgment or resolution on my issue, I’ve decided to remove your script from my server. It’s not worth the headache, and I’ll be looking for alternatives that are better supported.

I hope you’ll consider improving communication in the future to avoid similar frustrations for others in the community.

Good morning,

I would like to address the situation and clarify a few things.

I did reply to your original message - however, it unfortunately wasn’t approved by the moderation team. In my response, I asked if you could join our voice chat app (the one with the blue icon/symbol), as this would help us provide better support. I have to refer to it this way since mentioning its actual name requires moderator approval to post

I completely understand that joining a new server just for a quick help request may be inconvenient. However, I hope you can appreciate that we have limited resources to constantly monitor three different channels (GitHub, CFX, and the blue voice app). This is precisely why we’ve implemented a ticketing bot system, which allows us to handle all requests systematically and fairly.

If you’d still like to get this bug resolved, please feel free to message me. While I understand your concerns about the process, I hope this helps explain why things happened this way. I sincerely apologize for any frustration this may have caused.

Happy holidays

:rotating_light: IMPORTANT UPDATE: fourtwenty_advent Hotfix :rotating_light:

Hey @everyone!

We’ve just released another critical hotfix for fourtwenty_advent. To ensure everything works smoothly, please follow these steps:

:one: Run these commands:
/refresh
/restart fourtwenty_advent

:warning: Please update ASAP to avoid any issues!

If you have any questions or run into problems, feel free to reach out in the support channel. :video_game::sparkles:

To compensate for outages, we created a new Tebex Discount Code for 25% off

CODE

E4EV-RTNZ-K3BA