BenthPinata

<div align="center"> # ✨ BenthPinata ✨ ### An Advanced and Fully Customizable Minecraft Piñata Event Plugin !(https://img.shields.io/badge/Java-8-blue.svg) !(https://img.shields.io/badge/API-Spigot%201.13%2B-orange.svg) !(https://img.shields.io/badge/License-MIT-green.svg) !(https://img.shields.io/github/stars/bentahsin/BenthPinata?style=social) *Designed for Spigot, Paper, Purpur, and all compatible server forks.* </div> **BenthPinata** is a comprehensive Spigot plugin that adds fun, rewarding, and fully customizable Piñata events to your Minecraft server. Designed for server owners, this plugin allows you to bring your community together to attack a common goal, compete for the top spot, and win amazing rewards. Breathe new life into your server with easy configuration and powerful features! <br> --- ## 🤔 Why Choose BenthPinata? * **🏆 High Performance:** Built with modern coding practices and asynchronous operations to ensure the lowest possible impact on your server's performance. * **🧩 Smart Dependency Handling:** No rigid requirements! BenthPinata uses a smart hologram system. It prioritizes **ProtocolLib** for smooth, packet-based holograms. If not found, it falls back to **DecentHolograms**. If neither is available, the plugin runs perfectly without holograms, ensuring it never breaks your server. * **🔧 Ultimate Flexibility:** Create the event of your dreams by customizing nearly every setting across `config.yml`, `rewards.yml`, and `abilities.yml`. * **✅ Active Development:** A project that is consistently updated and values community feedback. --- ## 🚀 Core Features * **Unlimited Piñata Types:** Create as many Piñata types as you want, each with different health, locations, and abilities. * `Advanced Mob Support:` Make your Piñata not just a sheep, but a **Zombie, Horse, Llama**, or even a fully custom entity using **NBT tags**! * **Advanced Ability System:** Trigger special abilities as the Piñata's health drops, such as knocking back nearby players, blinding them, or applying negative potion effects. * **Comprehensive Reward Mechanics:** * **Per-Hit Rewards:** Players can win small, chance-based rewards with every hit. * **Damage Thresholds:** Give guaranteed rewards to players who reach specific damage milestones. * **Final Rewards:** Honor the top damage dealers with incredible prizes when the event ends. * **Dynamic Visual Feedback:** * **Smart Hologram System:** Displays the Piñata's health dynamically. It uses high-performance, packet-based holograms with **ProtocolLib (recommended)**, falls back to **DecentHolograms**, or works without any hologram dependency. * **Boss Bar:** A built-in Boss Bar provides real-time health tracking for all nearby players. * **Stunning Effects:** Engaging **particle and sound effects** make the event feel alive. * **Automatic Event System:** * Start events automatically at set intervals (e.g., every 2 hours). * Trigger an event when the server's player count reaches a certain threshold. * Schedule events for specific days and times (e.g., every Friday at 8:00 PM). * **Statistics & Leaderboards:** Track players' total damage and Piñata kills. Use the `/pinata stats top` command to list the best players. * **PlaceholderAPI Support:** Display plugin stats and leaderboards in other plugins like scoreboards, menus, and more. * **Easy Management:** Manage events effortlessly with simple, permission-based commands. --- ## ✅ Supported Versions This plugin is built on modern server APIs and has been tested for compatibility across a wide range of versions. | Minecraft Version | Support Status | Minecraft Version | Support Status | | :---------------- | :------------: | :---------------- | :------------: | | **1.21.X** | ✅ Compatible | **1.16.X** | ✅ Compatible | | **1.20.X** | ✅ Compatible | **1.15.X** | ✅ Compatible | | **1.19.X** | ✅ Compatible | **1.14.X** | ✅ Compatible | | **1.18.X** | ✅ Compatible | **1.13.X** | ✅ Compatible | | **1.17.X** | ✅ Compatible | **1.12.X & Older** | ❌ Incompatible | --- ## 🔧 Installation 1. **Download the Plugin:** Grab the latest `.jar` file from the (https://github.com/bentahsin/BenthPinata/releases). 2. **Install Dependencies (Optional but Recommended):** * **For the best experience (Packet Holograms):** Install (https://www.spigotmc.org/resources/protocollib.1997/). * **For an alternative (Block-based Holograms):** If you don't use ProtocolLib, you can install (https://www.spigotmc.org/resources/decentholograms.96927/). * **For placeholder support:** It is highly recommended to install (https://www.spigotmc.org/resources/placeholderapi.6245/). * _Reminder: The plugin works perfectly even if no hologram plugi