[Release] FourTwenty Advent Calendar | Interactive Holiday Gift System
Introduction
Hey FiveM Community!
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.
Key Features
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
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
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
Multilingual Support
- Currently supports:
- English (en)
- German (de)
- Easy to add new languages
Dependencies
- ESX or QB-Core Framework
- oxmysql
- FiveM Server Build 2802+
Installation
- Download or Clone the repository:
cd resources
git clone https://github.com/FourTwentyDev/advent
- Import the provided SQL schema:
CREATE TABLE IF NOT EXISTS fourtwenty_advent (
year INT NOT NULL,
opened_doors LONGTEXT,
PRIMARY KEY (year)
);
- Add
ensure fourtwenty_advent
to yourserver.cfg
- Configure your settings in
config.lua
- Start your server and spread some holiday cheer!
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
}
}
}
}
Performance
- 0.0ms idle
- 0.01ms - 0.02ms active
- Optimized through:
- Efficient spawn algorithms
- Smart distance checks
- Event batching
- Resource state management
Showcase Video
Watch the showcase video to see the Advent Calendar in action!
Support & Updates
Need help or want to report a bug? Weโre here for you:
- Discord: Join Our Server
- GitHub: Submit Issues
- Website: FourTwentyDev
License
This project is licensed under the MIT License. See the LICENSE.md file for details.
Made with holiday cheer by FourTwentyDev