EnchantmentsX

EnchantmentsX

EnchantmentsX adds Anvil to your server while keeping everything Anvil. Players don’t need to learn complicated commands — simply combine a special Anvil with your tool in an Anvil.

---

English Description

✨ Features

Anvil 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.

3×3 area of blocks Break a 3×3 area of blocks at once with your pickaxe.

Auto Replant Automatically replants crops (Wheat, Potatoes, Carrots, etc.) right after harvesting.

instantly 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 Enchantment Paper 2. Place your Enchantment Paper 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: [EnchantmentsX] ```

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> [amount]` Gives a player an enchantment paper

`/ex reload` Reloads the plugin configuration

---

Deutsche Beschreibung

EnchantmentsX fügt deinem Server Amboss hinzu und bleibt dabei Amboss. Spieler benötigen keine komplizierten Befehle – kombiniere einfach ein spezielles Amboss mit deinem Tool in einem Amboss.

---

✨ Features

Amboss 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.

3×3 Feld 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 Level 10 Ermöglicht extrem schnelles Abbauen mit Efficiency Level 10.

Unbreaking Level 10 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 Enchantment-Paper 2. Lege dein Enchantment-Paper 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: [EnchantmentsX] ```

Beispiel

```java 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