EpicBeheading

⚔ 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:

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:

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:

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.