Mythicverse

# MythicVerse Progression System (Minecraft 1.21.11)

Das vollständige **MythicVerse**-System für deinen Minecraft Paper/Purpur Server auf der Version **1.21.11** ("Mounts of Mayhem") inklusive fertig kompiliertem Plugin und maßgeschneidertem Resourcepack / Texturepack.

---

## ⚡ 1.21.11 Spezifische Anpassungen

1. **Neues Resourcepack-Format (Format 75):**
- In Minecraft 1.21.11 ist das Resourcepack-Format auf **Format 75** aktualisiert worden.
- `pack.mcmeta` verwendet `pack_format: 75` mit `supported_formats: {"min_inclusive": 34, "max_inclusive": 75}` für universelle Kompatibilität ohne rote Warnhinweise.
2. **Modernes Item-Definition System (`assets/minecraft/items/`):**
- Ab 1.21.4+ und in 1.21.11 wurde das alte `overrides`-Modell durch `items/*.json` mit `"type": "minecraft:range_dispatch"` abgelöst.
- Das Pack enthält nun sowohl die modernen `assets/minecraft/items/*.json`-Definitionen als auch die klassischen Model-Dateien – dadurch funktioniert das Pack nahtlos auf 1.21.11 sowie älteren 1.21-Versionen.
3. **Cross-Version Attribut-Sicherheit:**
- Ein dynamischer `AttributeHelper` stellt sicher, dass Attributänderungen (`MAX_HEALTH`) unabhängig von Mapping-Änderungen in 1.21.11 fehlerfrei und ohne `NoSuchFieldError` funktionieren.

---

## Schnellstart & Installation

1. **Plugin installieren:**
- Kopiere die Datei [`plugins/MythicVerse.jar`](file:///C:/Users/Startklar/OneDrive/Desktop/Lennart/plugins/MythicVerse.jar) in den `plugins/`-Ordner deines 1.21.11 Paper/Purpur Servers.
- Starte den Server neu.

2. **Resourcepack aktivieren:**
- **Für Spieler:** Kopiere [`MythicVerse-Resourcepack.zip`](file:///C:/Users/Startklar/OneDrive/Desktop/Lennart/MythicVerse-Resourcepack.zip) in deinen `.minecraft/resourcepacks/`-Ordner und aktiviere es unter *Optionen > Ressourcenpakete*.
- **Für den Server:** Trage den Download-Link der ZIP in der `server.properties` unter `resource-pack=` ein.

---

## ️ Projektübersicht

```text
Lennart/
├── MythicVerse-Resourcepack.zip # Fertiges, gepacktes Texturepack (Format 75 / 1.21.11)
├── README.md # Diese Dokumentation
├── plugins/
│ ├── MythicVerse.jar # ⚡ FERTIG KOMPILIERTES PLUGIN (1.21.11 kompatibel)
│ └── MythicVerse/ # Vollständiger Java 21 Quellcode & Maven-Projekt
└── resourcepack/ # Ungepackte Rohdaten (Texturen & Model-JSONs)
├── pack.mcmeta # Format 75 (Minecraft 1.21.11)
├── pack.png # Custom Pack-Icon
└── assets/minecraft/
├── items/ # Modernes 1.21.11 range_dispatch System
├── models/item/ # Fallback Overrides für Schwerter, Relikte, Amboss etc.
└── textures/item/mythicverse/ # Echte 16x16 Pixelart-Texturen für alle Items
```

---

## ⚡ Teil 1 bis 8: System-Architektur

### 1. Progression & Balance
- **Keine Entwertung von Netherite:** Mythic-Ausrüstung baut auf Netherite auf und bietet passive Zusatzeffekte, ohne Vanilla-Stats zu zerstören oder One-Hits zu ermöglichen.
- **PDC-Integrität:** Alle Items nutzen Bukkit `PersistentDataContainer` (PDC) – kein Schmiede-/Amboss-Rename kann ein Fake-Item erzeugen.

### 2. Die 5 Mythic Bosses
Jeder Boss verfügt über ein eigenes BossBar, dynamische Skalierung (Gesundheit skaliert mit der Spielerzahl in der Nähe), Anti-Cheese-Mechaniken (Leash-Distanz, Schutz vor Ersticken/Bedrock-Traps, Projektil-Resistenz in Phase 2) und 2 Phasen (Phase 2 Enraged ab < 50% HP):

1. **⚡ Stormcaller** (Wither Skeleton mit Blitzrüstung)
- *Fähigkeiten:* Blitzschlag-Sperrfeuer (alle 10s), Gale Wave (Schockwelle & Wegschleudern), Phase 2 Overload.
- *Drop:* **Storm Core**
2. ** Void Reaper** (Warden/Schattenfürst)
- *Fähigkeiten:* Shadow Step (teleportiert hinter Angreifer), Void Siphon (saugt Spieler an, Dunkelheit/Wither, Boss-Heilung), homing Wither-Schädel.
- *Drop:* **Void Heart**
3. ** Infernal Titan** (Magma-/Netherit-Golem)
- *Fähigkeiten:* Ground Slam (Katapultiert Spieler hoch), Magma Eruption (Feuersturm), Phase 2 Inferno Burn Aura.
- *Drop:* **Infernal Core**
4. **❄️ Frostbound King** (Eisritter)
- *Fähigkeiten:* Glacial Spike (Eissäulen), Blizzard Aura (verlangsamt & nutzt echte 1.21 Freezing-Ticks), Absolute Zero.
- *Drop:* **Frozen Crown**
5. ** Ancient Wyrm** (Drachenfürst)
- *Fähigkeiten:* Drachenodem-Wolken, Wing Buffet (Schockwellen-Rückstoß), Zielsuchende Drachenfeuerbälle.
- *Drop:* **Wyrm Scale**

### 3. Boss Drops & Schadenstracking (Anti-Ninja-Looting)
- **Damage Leaderboard:** Nach dem Boss-Tod wird das Top-3 Schadens-Ranking im Chat gepostet.
- **Top-Damager:** Erhält das garantierte Boss-Relikt direkt in sein Inventar (oder an die Füße bei vollem Inventar).
- **Beitrags-Belohnung:** Jeder Spieler mit mindestens 5% Schadensanteil erhält garantierte **Mythic Shards** und eine 25%-Chance auf einen Relic-Drop.

### 4. Fähigkeiten (Abilities)
- **⚡ Storm Step** (20s Cooldown): 8-Block Blitz-Dash mit Speed II & Schockwellen-Schaden am Ziel.
- ** Void Blink** (25s Cooldown): 12-Block Schatten-Teleport mit Wandkollisionsschutz (verhindert Ersticken in Blöcken) und Erblindung von Gegnern.
- ** Flameborn** (45s Cooldown): 8s Feuer-Immunität + Nahkampfangriffe entzünden Gegner mit Zusatzschaden.
- **❄️ Frost Nova** (30s Cooldown): 6-Block Eisexplosion (Slowness IV, Mining Fatigue & Freeze-Ticks).
- ** Wyrm's Fury** (60s Cooldown): 10s Drachen-Ermächtigung (Strength I, Resistance I).
- **Aktivierung:** `Sneak + F` (Handwechsel) oder `Sneak + Rechtsklick` mit Mythic-Waffe.
- **Slot-System:** Startet mit 1 Slot; Slot 2 (16 Shards) und Slot 3 (32 Shards) im GUI schaltbar.

### 5. Mythic Netherite Ausrüstung
- **Waffen:**
- ⚡ *Stormforged Netherite Sword:* 15% Chance auf Kettenblitz (+3.0 Magieschaden).
- *Voidforged Netherite Sword:* 15% Chance auf Wither + Lebensraub (1.5 Herzen).
- *Infernal Netherite Sword:* Verbrennt Gegner + 2.0 echter Feuerschaden.
- ❄️ *Frostbound Netherite Sword:* Verlangsamt Gegner mit Frost-Ticks.
- *Wyrmforged Netherite Sword:* 10% Chance auf Drachen-Schockwelle mit Knockback.
- ✨ *Celestial Netherite Sword (Endgame):* Aus 4 Relikten geschmiedet! 20% Chance auf Kosmik-Burst (+4 AoE-Schaden, Blendung, 2 HP Lifesteal).
- **Rüstung (Stormforged Set):**
- +5% Laufgeschwindigkeit pro Teil.
- Volles Set (4/4): *Electric Thorns* (Chance Angreifer mit Blitzschaden zu kontern).

### 6. Die Mythic Forge (`/mythic forge`)
- Interaktives GUI mit Dupe-Schutz:
- Slot 1: Netherite-Basis (z. B. Netherite Sword)
- Slot 2: Mythic Relic (z. B. Storm Core)
- Slot 3: Katalysatoren (8x Mythic Shards)
- Output-Vorschau & Forge-Button.
- Beim Schließen des Inventars werden alle eingelegten Items sicher an den Spieler zurückgegeben.

### 7. Mythic Events
- Vollautomatischer Timer alle 2 Stunden (in `config.yml` anpassbar).
- Serverweite Ankündigung mit Countdown (30:00, 15:00, 5:00, 1:00).
- Sichere automatische Ortsbestimmung in der Wildnis.
- Wenn der Boss nicht innerhalb von 30 Minuten besiegt wird, zieht er sich zurück.

---

## ️ Befehle & Berechtigungen

| Befehl | Beschreibung | Berechtigung |
| :--- | :--- | :--- |
| `/mythic abilities` | Öffnet das Fähigkeiten- & Slot-Menü | `mythicverse.use` |
| `/mythic forge` | Öffnet die Mythic Forge Schmiede | `mythicverse.use` |
| `/mythic cast <id>` | Löst eine freigeschaltete Fähigkeit aus | `mythicverse.use` |
| `/mythic boss spawn <typ>` | Spawnt einen Mythic Boss an deiner Position | `mythicverse.admin` |
| `/mythic boss list` | Zeigt alle aktuell aktiven Bosse und deren HP an | `mythicverse.admin` |
| `/mythic boss killall` | Entfernt alle aktiven Bosse sicher | `mythicverse.admin` |
| `/mythic event start [typ]`| Startet manuell ein serverweites Mythic Event | `mythicverse.admin` |
| `/mythic event stop` | Beendet das laufende Mythic Event | `mythicverse.admin` |
| `/mythic give <spieler> <item> [anzahl]` | Gibt Mythic Relikte, Shards oder Ausrüstung | `mythicverse.admin` |
| `/mythic reload` | Lädt die `config.yml` neu | `mythicverse.admin` |