hCustomEnchantments adds a complete custom enchantment system with configurable enchant files, enchant books, anvil support, optional enchanting table generation, conflicts, requirements, actions and gameplay effects for tools, weapons, armor, bows, crossbows, tridents and utility items.
The plugin includes 24 ready-made enchantments and lets you adjust their levels, names, lore, costs, applicable items, conflicts, effects and action feedback through YAML configuration files.
Features
24 Custom Enchantments
The plugin includes a large set of custom enchantments for different item types.

• Tool enchantments
• Sword enchantments
• Bow and crossbow enchantments
• Trident enchantments
• Armor enchantments
• Boot enchantments
• Totem enchantment
• Curse-style enchantment

Each enchantment has its own configuration file inside the enchants folder.
Separate Enchant Configs
Every custom enchantment is configured separately.
You can edit:

• Display name
• Roman level text
• Book name
• Book lore
• Rarity
• Active slots
• Applicable items
• Anvil cost
• Enchanting table settings
• Conflicts
• Requirements
• Level-specific settings
• Effect chances
• Effect duration
• Damage values
• Utility behavior

This makes the system easy to balance without editing the plugin code.
Anvil Support
Custom enchant books can be applied through the anvil.
The plugin supports:

• Custom anvil costs
• Material-based cost bonuses
• Level combining
• Conflict checks
• Requirement checks
• Custom warning item names
• Preserving other custom enchantments

Each enchantment can be enabled or disabled for anvil usage per level.
Enchanting Table Support
Custom enchantments can also be added through the enchanting table if enabled in the enchant config.
Each level can have its own:

• Enable state
• Required enchanting table level range
• Random chance
• Conflict rules
• Requirement rules

By default, the included configs keep enchanting table generation disabled, so you can decide exactly which enchantments should be obtainable this way.
Conflict and Requirement System
Enchantments can conflict with other custom enchantments or vanilla enchantments.
Example formats:
Enchantments can also require another enchantment before they can be applied.
For example, the Return enchantment can require vanilla Loyalty on the trident.
Custom Enchant Books
Administrators can give custom enchant books to players with a command.
Each book uses the name and lore from the enchantment configuration.
The plugin can also give all registered enchantment books at once. When needed, the books are packed into shulker boxes to keep the delivery clean.
Action System
hCustomEnchantments includes a flexible action system.
Actions can be executed when:

• A custom enchantment is received through the enchanting table
• A specific enchantment effect is triggered

Supported action types include:
Available internal placeholders:
PlaceholderAPI values can be parsed inside supported action text if PlaceholderAPI is installed.
Optional Vault Support
Vault can be used inside actions for economy operations.
Supported economy actions include giving, removing, setting and clearing balance through the plugin action system.
Vault is optional and is only required if you use Vault-based actions.
Grindstone Handling
When custom enchantments are removed through the grindstone, the plugin cleans up custom enchantment lore from the resulting item.
Paper or Purpur is recommended for the best experience with this feature.
Enchantments
Mining and Tool Enchantments
Sword Enchantments
Bow and Crossbow Enchantments
Trident Enchantments
Armor and Utility Enchantments
Command Aliases for Enchants
Some enchantments also have command aliases:
Commands
Command description:
Permissions
Configuration
Main configuration file:
Enchant configuration folder:
Included enchant files:
Requirements

• Java 17 or newer
• Minecraft 1.16 or newer
• Paper or Purpur recommended

Optional dependencies:

• PlaceholderAPI
• Vault

PlaceholderAPI is used for parsing placeholders in supported action text.
Vault is used only for Vault economy actions.
Installation

1. Place hCustomEnchantments.jar into your server's plugins folder.
2. Restart the server.
3. Open plugins/hCustomEnchantments/config.yml.
4. Edit the main settings and action messages.
5. Open plugins/hCustomEnchantments/enchants/.
6. Configure the enchantments you want to use.
7. Give yourself hcustomenchants.admin.
8. Give a book with /hcustomenchants give <player> <enchant> <level>.

Notes

• All enchantments can be balanced through YAML files.
• Anvil availability can be configured per enchantment level.
• Enchanting table availability can be configured per enchantment level.
• Conflicts and requirements can be configured for custom and vanilla enchantments.
• Custom action feedback can be configured globally and per enchantment.