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

8 Likes

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

1 Like