# ⚔ EpicBeheading ### Turn Every Kill Into a Trophy **EpicBeheading** is a Minecraft PvP plugin that introduces player head drops, configurable drop chances, permission-based VIP bonuses, player statistics, and leaderboards. Make every PvP encounter more meaningful. Reward successful kills with collectible player heads, let players showcase their trophies, and give your community new reasons to compete. ## ✨ Features ### ⚔️ Player Head Drops - Players can obtain their opponents' heads after PvP kills. - Configurable head drop probability. - Default drop chance: **5%**. - Supports custom drop chances from 0% to 100%. - Player heads use the victim's Minecraft account identity. - If the killer's inventory is full, the head drops naturally at the death location. ### 👑 Custom VIP Drop Rates Create different head drop chances for different permission groups. - Configure custom permissions for VIP, MVP, MVP+, and other ranks. - Set individual drop rates for each group. - The highest applicable drop rate is used; rates do not stack. - Enable or disable the VIP drop rate system independently. - Integrate the system with your existing permission setup. Example: | Rank | Permission | Drop Chance | |---|---|---:| | Default | None | 5% | | VIP | `epicbeheading.vip` | 7% | | MVP | `epicbeheading.mvp` | 9% | | MVP+ | `epicbeheading.mvpplus` | 12% | These are example values and can be customized. ### 📊 Statistics & Leaderboards Track player performance with lifetime, weekly, and monthly statistics. - Total player kills - Total heads collected - Weekly kill rankings - Weekly head collection rankings - Monthly kill rankings - Monthly head collection rankings Weekly statistics follow the ISO week schedule, resetting on Monday. Monthly statistics reset at the beginning of each calendar month. Lifetime statistics remain available permanently. ### 💾 SQLite Data Storage Player statistics are stored in an SQLite database. - Persistent statistics across server restarts. - Asynchronous database saving to reduce main-thread disk I/O. - Batched database updates. - In-memory leaderboard caching. - Designed to handle large player datasets efficiently. Database location: `plugins/EpicBeheading/playerdata/data.db` ### 🔌 PlaceholderAPI Integration Integrate EpicBeheading statistics into compatible scoreboards, holograms, menus, and other plugins. PlaceholderAPI is required for PlaceholderAPI placeholders. EpicBeheading provides placeholders for player statistics, ranks, and leaderboard entries, including lifetime, weekly, and monthly data. ### 🌍 Multilingual Support Available languages include: - Simplified Chinese - Traditional Chinese - English - Japanese - Korean - German - French - Russian ### ⚙️ Easy Configuration Configure drop chances, VIP permissions, leaderboard settings, time zones, language, and statistics save intervals through YAML files. Reload supported configuration settings without restarting the server. ## 📦 Installation 1. Download EpicBeheading from SpigotMC. 2. Place the downloaded `.jar` file into your server's `plugins` folder. 3. Restart your Minecraft server. 4. Open `plugins/EpicBeheading/config.yml`. 5. Configure your preferred drop chance and other settings. 6. Configure VIP drop rates if desired. 7. Install PlaceholderAPI if you want to display statistics through placeholders. ## 🛠️ Configuration Examples ### Basic Drop Chance In `plugins/EpicBeheading/config.yml`: ```yaml drop-chance: 0.05 language: "en" ``` The default `0.05` represents a 5% chance. - `0.0` = 0% - `0.05` = 5% - `0.5` = 50% - `1.0` = 100% ### VIP Drop Rates Configure permission-based drop rates in the VIP configuration: ```yaml enabled: true default: 5.0 groups: vip: permission: epicbeheading.vip chance: 7.0 mvp: permission: epicbeheading.mvp chance: 9.0 mvpplus: permission: epicbeheading.mvpplus chance: 12.0 ``` The VIP configuration uses percentage values. For example, `7.0` means a 7% drop chance. Make sure the permissions are assigned to the appropriate groups in your permissions plugin. ## 🖥️ Compatibility - **Platforms:** Paper, Spigot, Purpur - **Minecraft versions:** 1.13–1.21.x and tested 26.x versions listed on the resource page - **Optional integration:** PlaceholderAPI Check the official resource page for the latest tested versions and compatibility information. ## 🔗 Links - **SpigotMC Resource:** https://www.spigotmc.org/resources/138148/ - **Author:** QuantifyingEpic - **GitHub:** https://github.com/kobayashi-007 ## ❤️ Support the Project If you enjoy EpicBeheading, please consider leaving a rating or review on SpigotMC. Feedback helps improve the plugin and guides future development. Found a bug or have a feature request? Visit the SpigotMC resource page to report it. --- *EpicBeheading — Every Kill Matters. Every Trophy Tells a Story.*

EpicBeheading

1.1.6