FoxEnchantCreator

🔮 FoxEnchantCreator

A lightweight, powerful Paper plugin that allows you to define your own enchantments via config file (enchantments.yml)

📦 How It Works

This plugin reads your enchantments.yml file and automatically creates custom enchantments with the values you used in the file (requires server restart)

This plugin only registers custom enchantments they do not have any built-in effects. To make enchantments actually do something, you can use:

• 🔧 Skript/Denizen
• 🧱 Datapacks
• 🧩 Plugins

💡 You can check if an item is enchanted with registered enchantment, using namespaced keys like: fec:lifesteal, fec:double_jump, fec:something, and so on

⚙️ Features

• ✅ Fully configurable enchantments
  • Name, max level, weight, enchanting table costs, anvil cost, and supported items.

• 🎨 Custom enchantment description colors
  • Optional Color option lets you set enchantment tooltip color. (e.g., "&#FF2424" for red)
  • Defaults to vanilla gray if no color is set

• 🔄 Support for grouped item tags
  • Use groups like %SWORDS%, %AXES%, %PICKAXES%, %HOES%, %SHOVELS%, %ARMORS%, %HELMETS%, %CHESTPLATES%, %LEGGINGS, %BOOTS%. To target many items easily. (These groups are in lists.yml)
  • You can also define your own custom groups in lists.yml, like %FOOD%, to organize and reuse item sets across multiple enchantments

• ❌ Enchantment Ignoring System
  • Add an Ignore: field to prevent your custom enchantment from being applied if the item has any listed enchantments.
  • Supports both vanilla and custom enchantment IDs.
  • If an Ignore option references an enchantment that doesn't exist, that enchantment is safely skipped with a warning in console instead of crashing the server.

• 🏹 Restore & customize vanilla enchantments (New in 2.0)
  • Register vanilla enchantments (e.g. minecraft:sharpness) in enchantments.yml, either restored as-is with vanilla: true, or with specific fields overridden (Name, Color, SupportedItems, costs, etc.) while keeping their original vanilla behavior otherwise.

• 🚫 Remove all vanilla enchantments (New in 2.0, experimental)
  • A config.yml option that strips every vanilla enchantment from the server except ones you've explicitly restored, for a fully custom enchanting experience.

• 📁 Split configuration (New in 2.0)
  • config.yml for global settings, enchantments.yml for registering/editing enchantments, and lists.yml for item groups.
  • Old single-file configs are automatically migrated into enchantments.yml on first startup - no manual steps needed.

📝 Example Config

leech:
  Name: "Lifesteal"
  Color: "&#FF2424"
  SupportedItems: "%SWORDS%,MACE"
  PrimaryItems: "%SWORDS%"
  Ignore: "MINECRAFT:SHARPNESS,MINECRAFT:LOOTING,FEC:aether"
  Weight: 5
  maxLevel: 3
  minCost:
    base: 3
    perLevel: 11
  maxCost:
    base: 16
    perLevel: 11
  anvilCost: 3
  tradeable: true

aether:
  Name: "Aether's Blessing"
  Color: "&#7FB3FF"
  SupportedItems: "%SWORDS%"
  Weight: 2
  maxLevel: 1
  minCost:
    base: 20
    perLevel: 0
  maxCost:
    base: 30
    perLevel: 0
  anvilCost: 2
  tooltip_order_value: 0
  in_enchanting_table: true
  tradeable: true
  double_trade_price: true
  on_random_loot: true

crimson:
  Name: "Crimson"
  SupportedItems: "%SWORDS%,mace"
  Ignore: "minecraft:sharpness,minecraft:smite"
  Weight: 4
  maxLevel: 3
  minCost:
    base: 3
    perLevel: 9
  maxCost:
    base: 16
    perLevel: 9
  anvilCost: 3
  tooltip_order_value: 1
  in_enchanting_table: true