Portal-System hinzugefügt

Portal-System.-.md

@@ -0,0 +1,163 @@
+# Portal-System
+
+Das Portal-System ermoglicht das Erstellen von Teleport-Zonen mit Partikeleffekten.
+
+## Ubersicht
+
+- Erstelle rechteckige Portal-Regionen
+- Automatische Partikeleffekte
+- Teleportation zu beliebigen Koordinaten oder Servern
+- Cooldown-System gegen Spam
+
+## Portal erstellen
+
+### Schritt 1: Portal-Werkzeug erhalten
+
+```
+/giveportalwand
+```
+
+Du erhaltst einen speziellen Stock.
+
+### Schritt 2: Region markieren
+
+1. **Linksklick** auf Block 1 (erste Ecke)
+2. **Rechtsklick** auf Block 2 (zweite Ecke)
+
+Die beiden Punkte definieren die diagonal gegenuber liegenden Ecken des Portals.
+
+### Schritt 3: Portal erstellen
+
+```
+/portal create <name>
+```
+
+**Beispiel:**
+```
+/portal create spawn_portal
+```
+
+### Schritt 4: Ziel setzen
+
+Gehe zum Zielort und fuhre aus:
+
+```
+/portal setdest <name>
+```
+
+**Beispiel:**
+```
+/portal setdest spawn_portal
+```
+
+---
+
+## Befehle
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/portal create <name>` | Erstellt Portal mit markierter Region |
+| `/portal delete <name>` | Loscht ein Portal |
+| `/portal list` | Listet alle Portale auf |
+| `/portal setdest <name>` | Setzt Ziel auf aktuelle Position |
+| `/portal info <name>` | Zeigt Portal-Informationen |
+| `/giveportalwand` | Gibt das Markierungs-Werkzeug |
+
+---
+
+## Konfiguration
+
+In `config.yml`:
+
+```yaml
+portals:
+  default-particle: "PORTAL"    # Partikeltyp
+  portal-cooldown: 40           # Cooldown in Ticks (40 = 2 Sekunden)
+  save-file: "portals.yml"      # Speicherdatei
+```
+
+### Partikeltypen
+
+| Partikel | Beschreibung |
+|----------|-------------|
+| `PORTAL` | Standard Nether-Portal Partikel |
+| `END_ROD` | End-Stab Partikel |
+| `ENCHANT` | Verzauberungspartikel |
+| `FLAME` | Flammenpartikel |
+| `SOUL_FIRE_FLAME` | Seelenfeuer-Partikel |
+| `SMOKE` | Rauchpartikel |
+| `CLOUD` | Wolkenpartikel |
+
+---
+
+## Beispiel-Workflow
+
+### Spawn-Portal erstellen
+
+1. Erhalte das Werkzeug:
+   ```
+   /giveportalwand
+   ```
+
+2. Markiere die erste Ecke (Linksklick auf einen Block)
+
+3. Markiere die zweite Ecke (Rechtsklick auf einen Block)
+
+4. Erstelle das Portal:
+   ```
+   /portal create main_spawn
+   ```
+
+5. Gehe zum Spawn und setze das Ziel:
+   ```
+   /portal setdest main_spawn
+   ```
+
+### Server-Wechsel-Portal
+
+Fur Portale, die zu anderen BungeeCord/Velocity-Servern fuhren, konfiguriere das Ziel als Server-Befehl in der `portals.yml`.
+
+---
+
+## portals.yml
+
+Nach dem Erstellen werden Portale in `portals.yml` gespeichert:
+
+```yaml
+portals:
+  main_spawn:
+    world: "world"
+    pos1:
+      x: 100
+      y: 64
+      z: 200
+    pos2:
+      x: 102
+      y: 67
+      z: 202
+    destination:
+      world: "world"
+      x: 0.5
+      y: 65.0
+      z: 0.5
+      yaw: 90.0
+      pitch: 0.0
+    particle: "PORTAL"
+```
+
+---
+
+## Tipps
+
+1. **Portale sollten mindestens 1x2x1 gross sein** fur eine gute Spieler-Erkennung
+
+2. **Cooldown beachten:** Spieler konnen nicht sofort wieder teleportiert werden
+
+3. **Partikel-Performance:** Bei vielen Portalen kann es zu Lag kommen. Reduziere die Partikelintensitat bei Bedarf
+
+4. **Backup:** Die `portals.yml` wird automatisch gespeichert. Erstelle regelmasige Backups
+
+5. **Reload:** Nach manuellen Anderungen an `portals.yml`:
+   ```
+   /nexuslobby reload
+   ```