https://github.com/matyydev/christmaspresenthunt

https://github.com/matyydev/christmaspresenthunt

christmas esx lua ox-core

Last synced: 11 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/matyydev/christmaspresenthunt
• Owner: MatyyDEV
• License: gpl-3.0
• Created: 2024-10-22T14:37:16.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-22T14:44:28.000Z (over 1 year ago)
• Last Synced: 2025-04-04T11:40:30.998Z (about 1 year ago)
• Topics: christmas, esx, lua, ox-core
• Language: Lua
• Homepage:
• Size: 21.5 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# **The script is not 100% yet, it is still being worked on.❌❌**

## 🎄 Christmas Present Hunt Script for FiveM (newESX)

### 🎁 About

This is a fun and interactive Christmas present hunt script for **FiveM**, built for the **newESX** framework. Players can collect presents scattered across the map, compete to collect the most, and view the top collectors on the leaderboard.

### ✨ Features

- 🎅 **Random Gift Spawning:** 1000 presents spawn randomly on the map for players to collect.

- 🏆 **Leaderboard:** Players can check the top 3 collectors using `/leaderboard`.

- 🎁 **Gift Collection:** Presents disappear once collected, rewarding the player.

- 🚀 **Teleport to Nearest Gift:** Players can teleport to the nearest present with `/teleportToGift`.

- 🕹️ **Fully integrated with newESX Framework**: Utilizes the latest newESX functions.

### 🛠️ Installation

1. **Download** the script and place it in your `resources` folder.

2. Add the following to your `server.cfg`:

    ```plaintext

    start ChristmasPresentHunt

    ```

3. Ensure you are using the **newESX framework**.

### 📝 Commands

- `/leaderboard` - Displays the top 3 players with the most collected presents.

- `/teleportToGift` - Teleports the player to the nearest uncollected present.

### 🚧 Future Enhancements

- More customizable features, including different gift models.

- Expanded leaderboard options.

- Additional rewards for top collectors!

### 🤝 Contributing

Feel free to submit any pull requests or issues to help improve this script!

### 📜 License

This project is licensed under the GPL 3.0 License.