EnchantmentsX

# EnchantmentsX EnchantmentsX adds **unique and powerful custom enchantments** to your server while keeping everything **vanilla-friendly**. Players don’t need to learn complicated commands — simply combine a special **Enchantment Paper** with your tool in an **Anvil**. --- # English Description ## ✨ Features **Vanilla-Friendly Mechanics** Custom enchantments are applied using an **Anvil** with special paper items (Custom Model Data). **Highly Configurable** Change enchantment names, lore, allowed items, and anvil costs inside `config.yml`. **Fully Translatable** All plugin messages can be customized in `messages.yml`. **Developer API** Includes a simple API for other plugins to interact with EnchantmentsX. --- ## 🔮 Available Enchantments The plugin currently includes the following custom enchantments: **Magnetizing** Automatically pulls drops from mined blocks or killed mobs directly into your inventory. **3x3 Mining** Break a **3×3 area of blocks** at once with your pickaxe. **Auto Replant** Automatically replants crops (Wheat, Potatoes, Carrots, etc.) right after harvesting. **Efficiency X** Allows tools to mine blocks **instantly** with level 10 Efficiency. **Unbreaking X** Greatly increases durability with level 10 Unbreaking. --- ## 🛠️ How To Use ### For Admins Give enchantment paper using the command: ``` /ex givepaper <player> <enchantment> ``` Example: ``` /ex givepaper Steve mining_3x3 1 ``` ### For Players 1. Open an **Anvil** 2. Place your **Tool or Weapon** in the left slot 3. Place the **Enchantment Paper** in the right slot 4. Take your newly enchanted item --- ## ⚙️ Configuration Every enchantment can be configured inside `config.yml`. Example: ```yaml enchantments: mining_3x3: enabled: true display-name: "&e3x3 Mining" anvil: cost-levels: 10 allowed-items: - DIAMOND_PICKAXE - NETHERITE_PICKAXE ``` You can configure: * display names * lore * allowed items * anvil level costs * enabling or disabling enchantments --- ## 💻 API for Developers EnchantmentsX provides a simple API for plugin developers. ### Dependency (plugin.yml) ```yaml depend: ``` ### Example Usage ```java import net.klyroth.enchantmentsX.EnchantmentsX; import net.klyroth.enchantmentsX.api.EnchantmentsXAPI; import net.klyroth.enchantmentsX.enchant.CustomEnchantType; EnchantmentsXAPI api = EnchantmentsX.getAPI(); if (api.hasEnchant(itemStack, CustomEnchantType.MAGNETIZING)) { // Do something special } ``` --- ## 📥 Installation 1. Download the plugin `.jar` 2. Place it in your server's **plugins** folder 3. Restart your server 4. Enjoy your custom enchantments --- ## 📜 Commands `/ex givepaper <player> <enchant> ` Gives a player an enchantment paper `/ex reload` Reloads the plugin configuration --- # Deutsche Beschreibung EnchantmentsX fügt deinem Server **einzigartige und mächtige Custom-Enchantments** hinzu und bleibt dabei **vanilla-freundlich**. Spieler benötigen keine komplizierten Befehle – kombiniere einfach ein spezielles **Enchantment-Paper** mit deinem Tool in einem **Amboss**. --- ## ✨ Features **Vanilla-Freundliches System** Custom-Enchantments werden über einen **Amboss** mit speziellen Papier-Items (Custom Model Data) angewendet. **Sehr Konfigurierbar** Namen, Lore, erlaubte Items und Amboss-Kosten können in der `config.yml` angepasst werden. **Vollständig Übersetzbar** Alle Plugin-Nachrichten lassen sich in der `messages.yml` anpassen. **Developer API** Eine einfache API ermöglicht es anderen Plugins mit EnchantmentsX zu interagieren. --- ## 🔮 Verfügbare Enchantments Aktuell enthält das Plugin folgende Custom-Enchantments: **Magnetizing** Zieht Drops von abgebauten Blöcken oder getöteten Mobs automatisch in dein Inventar. **3x3 Mining** Baut ein **3×3 Feld** von Blöcken gleichzeitig mit deiner Spitzhacke ab. **Auto Replant** Pflanzt automatisch Feldfrüchte (Weizen, Kartoffeln, Karotten usw.) nach der Ernte wieder an. **Efficiency X** Ermöglicht extrem schnelles Abbauen mit **Efficiency Level 10**. **Unbreaking X** Erhöht die Haltbarkeit von Werkzeugen stark mit **Unbreaking Level 10**. --- ## 🛠️ Verwendung ### Für Admins Gib Enchantment-Paper mit folgendem Befehl: ``` /ex givepaper <player> <enchantment> ``` Beispiel: ``` /ex givepaper Steve mining_3x3 1 ``` ### Für Spieler 1. Öffne einen **Amboss** 2. Lege dein **Werkzeug oder deine Waffe** in den linken Slot 3. Lege das **Enchantment-Paper** in den rechten Slot 4. Nimm dein neu verzaubertes Item --- ## ⚙️ Konfiguration Alle Enchantments können in der `config.yml` angepasst werden. Beispiel: ```yaml enchantments: mining_3x3: enabled: true display-name: "&e3x3 Mining" anvil: cost-levels: 10 allowed-items: - DIAMOND_PICKAXE - NETHERITE_PICKAXE ``` --- ## 💻 API für Entwickler ### Dependency (plugin.yml) ```yaml depend: ``` ### Beispie