🐰 Easter Event System | Egg Hunt, Boss Rabbit, Egg Opening, Pity NPC, Admin Panel

🐰 Easter Event System | Egg Hunt, Boss Rabbit, Egg Opening, Pity NPC, Admin Panel

Bring the spirit of Easter to your FiveM server with the k0sseK Easter Event resource! This comprehensive, seasonal event is designed with a clean framework bridge, offering full support for ESX, QBCore, and Qbox. Engage your players with a multi-layered gameplay loop featuring egg hunts, egg incubation, animated case openings, a challenging Boss Rabbit, and a rewarding Pity NPC. Everything is synchronized server-side, ensuring fair play and preventing client-authority exploits. Enjoy full locale support for easy translation and customization.

Features

• Egg Hunt Zones: Configurable spawn zones across the map with a custom basket prop that auto-attaches when entering a zone. Collect scattered eggs by pressing E.
• Incubation System: Incubate collected eggs by driving above a minimum speed. Track progress in real time with a NUI progress bar.
• Animated Case Opening: Use incubated eggs to trigger an animated case opening NUI. Loot rarity (common, rare, epic, legendary) is pre-rolled server-side, with weighted loot tables.
• Boss Rabbit: A server-wide Boss Rabbit spawns on a configurable cron schedule, indicated by a flashing blip on the map. Players can tackle the boss, earning per-hit drops, with an exclusive reward for the last hit.
• Roaming Rabbits: Small rabbits that flee from nearby players. Catch them for a reward.
• Pity NPC: Exchange collected eggshells at a custom NPC to receive a guaranteed item.
• Discord Webhooks: Automatic webhook embeds for legendary pre-rolls, epic/legendary claims, and boss kills.
• Admin Commands: Includes commands such as /spawnrabbit [normal|boss] to spawn entities, and /easterspawns [egg|rabbit] to log active entities with coordinates to the server console.
• Multi-framework Bridge: Full support for ESX Legacy, QBCore, and Qbox via a clean bridge pattern.
• Full Locale Support: All strings are externalized to locale files for easy translation.

Installation

1. Ensure you have ox_lib and oxmysql installed and configured.
2. Install ESX, QBCore, or Qbox depending on your server framework.
3. Place the k0sseK Easter Event resource in your server's resources directory.
4. Configure the resource in your server.cfg.
5. Customize the locale files as needed.
6. Start the resource.

Compatibility

This resource requires ox_lib, oxmysql, and either ESX, QBCore, or Qbox.