# Verzauberungs-Upgrades

Mit `/upgrade` hebst du eine Verzauberung auf dem Item in deiner Hand um eine Stufe an, auch über das Vanilla-Maximum hinaus: Schärfe V wird zu Schärfe VI. Jede Stufe hat ihren Preis aus Geld, Erfahrungsleveln und Items, den der Server festlegt. Ein sauberer Geldsink für die Endphase eines Servers.

## Commands

| Command | Syntax | Permission | Default | Beschreibung |
|---|---|---|---|---|
| `/upgrade` | `/upgrade` (Alias `/enchantupgrade`, `/upgradeenchant`) | `upgrade.use` | `true` | Öffnet das Upgrade-Menü für das Item in der Haupthand |

## So funktioniert es

1. Tippe `/upgrade` und lege das verzauberte Item (oder das verzauberte Buch) in den Slot in der zweiten Reihe.
2. Sobald das Item im Slot liegt, zeigt der Amboss unten in seiner Beschreibung, was du bekommst, etwa "Schärfe V » Schärfe VI", und in der fünften Reihe stehen die Anforderungen dieser Stufe: Geld, Level und Items, jeweils mit dem, was du gerade hast, grün wenn erfüllt, rot wenn nicht.
3. Hat das Item mehrere aufwertbare Verzauberungen, wechselt ein Rechtsklick auf den Amboss zur nächsten.
4. Sind alle Einträge grün, klicke mit links auf den Amboss. Geld, Level und Items werden abgezogen, die Verzauberung steigt um eine Stufe, und das Menü zeigt direkt die nächste Stufe.

Beim Schließen des Menüs oder bei einem Verbindungsabbruch wandert das Item aus dem Slot zurück ins Inventar (ist es voll, fällt es vor dir zu Boden). Anforderungsitems werden aus dem Inventar genommen, nie aus der Offhand oder den Rüstungsslots. Es geht immer nur ein Item auf einmal, kein Stapel.

Aufgewertete Stufen überleben den Amboss: Ein Buch mit Efficiency VII lässt sich wie gewohnt auf eine Spitzhacke legen, und beim Reparieren oder Zusammenlegen bleibt die höhere Stufe erhalten. Vanilla allein würde sie wieder auf das normale Maximum kürzen. Höher als die Eingabe wird es im Amboss nie, neue Stufen gibt es nur über `/upgrade`.

Ein Hinweis zur Anzeige: Das Spiel kennt Namen nur bis Stufe X. Stufen darüber zeigt der Tooltip als `enchantment.level.11`, deshalb liegt das Standardmaximum bei 10. Im Menü und in den Nachrichten stehen alle Stufen als römische Zahlen.

## Mitgelieferte Stufen

Die Datei kommt fertig befüllt: Jede Vanilla-Verzauberung, deren Wirkung mit der Stufe weiter wächst, ist mit thematischen Materialien und steigenden Preisen eingetragen. Gedeckelt ist dort, wo das Spiel nichts mehr draufrechnet oder es kaputtginge.

| Verzauberung | Vanilla | Hier bis | Beispiel-Materialien |
|---|---|---|---|
| Sharpness, Smite, Bane of Arthropods, Impaling | V | VIII | Diamanten und Disc Fragments; Knochen und Skelettschädel; Spinnenaugen; Prismarin |
| Looting | III | V | Wither-Schädel, Smaragde, Netherstern |
| Efficiency, Power, Density | V | VII | Redstone und Amethyst; Spektralpfeile und Drachenatem; Ambosse und Netherit |
| Protection, Fire, Blast, Projectile Protection, Feather Falling, Breach, Piercing | IV | VI | je nach Art Obsidian, Magmacreme, TNT, Pfeile, Federn, Breeze Rods |
| Unbreaking, Fortune, Thorns, Respiration, Soul Speed, Swift Sneak, Sweeping Edge, Wind Burst, Loyalty, Riptide, Luck of the Sea, Lunge | III | V | passend zur Verzauberung, etwa Seelensand, Echo-Scherben, Nautilusmuscheln, Kupfer und Hasenpfoten |
| Knockback, Fire Aspect, Punch, Frost Walker, Quick Charge, Lure | II bis III | IV | Kolben und Schleim, Lohenruten, Packeis, Redstone, tropische Fische |

Die Speer-Verzauberung Lunge ist dabei: Jede Stufe schiebt dich beim Stoß ein Stück weiter nach vorn und kostet einen Hungerpunkt mehr. Bewusst nicht dabei, weil eine höhere Stufe nichts bringt oder die Verzauberung nur Stufe I kennt: Mending, Infinity, Flame, Silk Touch, Channeling, Multishot, Aqua Affinity, Depth Strider (III hebt die Verlangsamung schon ganz auf) und die Flüche. Lure endet bei IV, weil ab V keine Fische mehr anbeißen, Quick Charge bei IV, weil V negativ laden würde.

## Konfiguration

Datei `plugins/CoreEngine/modules/upgrade.yml`:

```yaml
upgrade:
  # Höchste Stufe, die hier überhaupt erreichbar ist (Deckel 255).
  absolute-max-level: 10
  # Optionale Formel für Stufen OHNE eigenen Eintrag, mal der erreichten
  # Stufe. Standardmäßig aus: jede Verzauberung bepreist ihre Stufen selbst.
  default-step:
    enabled: false
    money-per-level: 2500
    xp-levels-per-level: 8
    # Items für jede Standardstufe, "MATERIAL:Anzahl" oder "nexo:<id>:Anzahl".
    items: []
  # Welche Verzauberungen aufgewertet werden dürfen, nach Registry-Schlüssel,
  # jede mit eigenen Preisen. max-level deckelt die Verzauberung, steps
  # bepreist einzelne Zielstufen mit Geld, Leveln und bis zu FÜNF
  # verschiedenen Items. Eine Stufe ohne Eintrag ist nicht kaufbar, eine
  # Verzauberung, die hier fehlt, lässt sich nie aufwerten.
  enchantments:
    sharpness:
      max-level: 8
      steps:
        6:
          money: 5000
          xp-levels: 15
          items: ["DIAMOND:10"]
        7:
          money: 12000
          xp-levels: 25
          items: ["DIAMOND:20", "DISC_FRAGMENT_5:3"]
        8:
          money: 30000
          xp-levels: 35
          items: ["NETHER_STAR:1"]
    protection:
      max-level: 6
      steps:
        5:
          money: 6000
          xp-levels: 20
          items: ["DIAMOND:12", "OBSIDIAN:32"]
        6:
          money: 15000
          xp-levels: 30
          items: ["NETHERITE_SCRAP:4", "TOTEM_OF_UNDYING:1"]

cooldown:
  # Sekunden zwischen zwei Menüöffnungen pro Spieler, 0 deaktiviert.
  commands:
    upgrade: 0
```

Items werden als `MATERIAL:Anzahl` angegeben, zum Beispiel `NETHER_STAR:3`, höchstens fünf verschiedene pro Stufe (mit Geld und Leveln ist die Menüreihe dann voll). Mit Nexo funktionieren auch Custom-Items als `nexo:<id>:Anzahl`. Eine Vanilla-Anforderung lässt sich nicht mit einem Nexo-Item desselben Materials bezahlen und umgekehrt. Bezahlt wird nur mit unveränderten Items: umbenannte, verzauberte oder beschädigte Exemplare bleiben im Inventar. Ein fehlerhafter Eintrag wird einmal in der Konsole gemeldet und im Menü als rote, unerfüllbare Zeile gezeigt; die Stufe ist dann gesperrt, bis der Eintrag stimmt, statt heimlich billiger zu werden.

Geld setzt das Economy-Modul voraus. Ist es aus, gelten Stufen mit Geldanforderung als nicht erfüllbar.

## Permissions

| Permission | Default | Beschreibung |
|---|---|---|
| `upgrade.use` | `true` | `/upgrade` öffnen und Verzauberungen gegen den konfigurierten Preis aufwerten |
| `upgrade.free` | op | Aufwerten ohne Geld, Level und Items; die Anforderungen bleiben sichtbar, gelten aber als erfüllt |