ByCustomDeathDrops - Major Update: Unparalleled Customization Arrives!
We're incredibly excited to announce a massive update for ByCustomDeathDrops! This release consolidates the powerful features developed across versions, bringing you an unparalleled level of control over your server's death mechanics and item drops. Prepare to create truly unique and dynamic gameplay experiences like never before!



What's New? (Key Features & Improvements)

Here's a detailed look at all the exciting additions and enhancements included in this comprehensive update:


1. Advanced NBT Data Support for Custom Drops
Now, you can define highly specific custom items to be dropped with intricate details directly from your drops.yml file! This feature empowers you to create genuinely unique loot.

• Unique Item Customization: Craft items with custom names, lore, and enchantments. You can also define unbreaking status and integrate items with specific custom model data values, perfect for linking with your server's resource pack to display unique visuals.
  

How it works: Simply add an nbt-data section to any drop entry in your drops.yml.

• Examples:
  
  • Drop a sword named &cLegendary Blade that features a unique description.
  • Ensure a boss consistently drops a diamond sword pre-enchanted with Sharpness V and Looting III.
  • Offer special quest items that boast distinct custom models for visual flair.
    

2. Flexible Death Modes for Player Groups

This is a groundbreaking addition that transforms how player deaths are handled. You can now configure diverse death behaviors for players based on their permissions or direct names, giving you precise control over what happens to their inventory upon death. This moves far beyond simple "keep armor" to offer a fully customized death experience.

• DROP_ALL: Players will drop all items from their inventory, including equipped armor and held items. This mirrors default Minecraft behavior when keepInventory is false, but is integrated with the plugin's custom drops.
• KEEP_ARMOR_AND_HAND: Players will retain their equipped armor (helmet, chestplate, leggings, boots) and items in their main and off-hand. Only their regular inventory items will drop.
• CHANCE_ARMOR_AND_HAND: While regular inventory items drop, each piece of equipped armor and held items has a configurable percentage chance to drop independently (e.g., a 20% chance for each piece to drop).
• DEFAULT_MINECRAFT: For this group, the plugin will not interfere with player death drops at all. Minecraft's default keepInventory game rule will solely determine what happens.
  

How it works: Define death-mode and chance-to-drop-armor-hand (for CHANCE mode) within the players section of drops.yml. This can be applied to the default group, a specific PlayerName, or a permission-group-key (e.g., bycustomdeathdrops.group.vip).

3. Player/Group-Specific Mob Drop Overrides


Tailor mob drops specifically based on the player who kills them! This feature has been refined to offer even more robust control, allowing you to create intricate custom reward systems for special players, ranks, or even quest lines.

• Custom Reward Systems: Design unique progression paths, implement tiered mob hunting challenges, or offer exclusive loot to premium players.
• Override General Drops: These specific drops will take precedence and override any general mob drops you have configured.

How it works: The player-mob-drops section in drops.yml enables you to define different drops for mobs when killed by:

• Specific Players: For example, player-mob-drops.YourPlayerName.ZOMBIE.
• Permission Groups: For instance, player-mob-drops.Group_VIP.permission-group-key: "vip" (this requires the bycustomdeathdrops.group.vip permission).

4. Command Execution Support on Item Drop

Trigger custom commands directly from your drops.yml whenever an item is dropped. This feature has been significantly enhanced for greater reliability and flexibility, opening up a world of possibilities for dynamic server events and rewards.

• Dynamic Events: Automatically grant money or XP, broadcast server-wide messages, or even directly give items to inventories.
• Placeholders: Utilize %player% (referring to the player involved in the event) and %killer% (referring to the player who made the kill) within your commands for personalized actions.
  

How it works: Simply add a commands list to any drop entry in drops.yml.

• Types of commands:
  
  • console: [command] - Executed by the server console.
  • player: [command] - Executed by the player who died (for player drops).
  • killer: [command] - Executed by the player who performed the kill (for mob drops).
    

Installation & Usage:

1. Download the latest ByCustomDeathDrops.jar file.
   
   
2. Place the .jar file into your server's plugins folder (make sure to remove any older versions).
   
   
3. Start or restart your server.
   
   
4. Edit the newly generated drops.yml and messages.yml files located in plugins/ByCustomDeathDrops to customize your drops and settings. The drops.yml file contains detailed comments and examples for all new features to guide you.
   
   
5. Use /bycustomdeathdrops reload (or the aliases /bcdd reload, /cdrops reload) to apply your changes instantly without needing a server restart.