ByAnvilEnchantBlocker

Prevent Unwanted Enchantments on Anvils & Clean Inventories


ByAnvilEnchantBlocker is a lightweight yet powerful Spigot plugin designed to give server administrators granular control over enchantments on their Minecraft server. With this plugin, you can prevent specific enchantments from being applied to certain item types on an anvil, and automatically remove designated enchantments from players' inventories upon joining. This is ideal for balancing gameplay, preventing overpowered items, or maintaining a specific server theme.



Key Features:

• Customizable Anvil Blocking: Define specific enchantments that cannot be applied to designated item types (e.g., prevent Smite on Tridents, or Bane of Arthropods on Netherite Swords).
• Automatic Inventory Cleaning: Automatically remove unwanted enchantments from players' items when they join the server. Perfect for cleaning up items obtained through exploits, misconfigurations, or previous server states.
• Per-Item Type Control: Configure rules individually for each Minecraft material (e.g., DIAMOND_SWORD, TRIDENT, BOW, LEATHER_BOOTS).
• Easy Configuration: All settings are managed through a simple and well-commented config.yml file.
• Flexible Messaging: Customize all in-game messages to match your server's tone and language.
• Lightweight & Efficient: Designed to run with minimal impact on server performance.
• 1.13+ Compatibility (including 1.21+): Built with modern Spigot API practices to ensure broad version support and deprecation compliance.
  

Why Use This Plugin?

• Server Balance: Prevent players from creating overly powerful or unintended item combinations.
• Economy Control: Maintain the value of specific items or enchantment books by limiting their application.
• Theme Enforcement: Ensure items align with your server's custom rules or lore.
• Anti-Exploit: Cleanse inventories of items that may have gained forbidden enchantments through glitches or unpatched methods.
  

Commands:

• /byanvilenchantblocker reload - Reloads the plugin's configuration from config.yml.
  • Aliases: /baeb reload, /byanvil reload, /byar reload
    

Permissions:

• byanvilenchantblocker.reload - Allows a player to use the reload command.
  

Configuration (config.yml):


The config.yml is extensively commented to guide you through customization. Here's a brief overview of its structure:

YAML
# messages: Defines all configurable in-game messages.
# blocked_enchantments:
# <MATERIAL_NAME>: # e.g., TRIDENT, DIAMOND_SWORD
# block_on_anvil: # List of enchantments to prevent on anvil for this material
# - SMITE
# - IMPALING
# remove_from_inventory: # List of enchantments to remove from inventory on join for this material
# - SMITE
# - CHANNELING

Note: For enchantment names, use the Bukkit/Spigot internal names (e.g., SMITE, BANE_OF_ARTHROPODS). For material names, use the exact Bukkit Material enum names (e.g., DIAMOND_SWORD, TRIDENT).



Installation:

1. Download the ByAnvilEnchantBlocker.jar file.
2. Place the .jar file into your server's plugins folder.
3. Start or restart your server.
4. (Optional but Recommended) Edit the generated config.yml file in plugins/ByAnvilEnchantBlocker/ to configure your desired rules.
5. Use /byanvilenchantblocker reload (or its aliases) to apply changes without restarting the server.
   

Support & Feedback:


If you encounter any issues, have suggestions for new features, or just want to provide feedback, please use the discussion section or open an issue on the resource page. Your input is highly valued!