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> [amount]

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:

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)

depend: [EnchantmentsX]

Example Usage

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> [amount] 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> [amount]

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:

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)

depend: [EnchantmentsX]

Beispiel

EnchantmentsXAPI api = EnchantmentsX.getAPI();

if (api.hasEnchant(itemStack, CustomEnchantType.MAGNETIZING)) {
    // Eigene Logik
}

---

📥 Installation

1. Lade die .jar Datei herunter
2. Lege sie in den plugins Ordner deines Servers
3. Starte den Server neu
4. Viel Spaß mit den Custom-Enchantments

---

📜 Befehle

/ex givepaper <player> <enchant> [amount] Gibt einem Spieler ein Enchantment-Paper

/ex reload Lädt die Plugin-Konfiguration neu