Spawn & WorldBorder hinzugefügt

Spawn-%26-WorldBorder.md

@@ -0,0 +1,72 @@
+# Spawn & WorldBorder
+
+In dieser Anleitung erfährst du, wie du den zentralen Einstiegspunkt deines Servers festlegst und eine Sicherheitsbegrenzung (WorldBorder) einrichtest, damit Spieler die Lobby-Map nicht verlassen können.
+
+---
+
+## 🏠 1. Den Lobby-Spawn setzen
+
+Der Spawnpunkt ist die wichtigste Koordinate des Plugins. Er wird für folgende Funktionen genutzt:
+* **Join-Punkt:** Hier landen Spieler, wenn sie den Server betreten.
+* **Void-Protection:** Spieler werden hierher teleportiert, wenn sie aus der Map fallen.
+* **Border-Zentrum:** Der Mittelpunkt für kreisförmige Begrenzungen.
+* **Befehl:** Zielort für `/spawn`.
+
+### So setzt du den Spawn:
+1. Gehe im Spiel an die gewünschte Position.
+2. Schaue in die Richtung, in die die Spieler blicken sollen.
+3. Nutze den Befehl:
+```bash
+   /nexus setspawn
+```
+4. Das Plugin speichert die Welt, die Koordinaten (X, Y, Z) sowie die Blickrichtung (Yaw, Pitch) sofort in der `config.yml`.
+
+---
+
+## 🛡️ 2. Die WorldBorder (Lobby-Begrenzung)
+
+Die WorldBorder verhindert, dass Spieler zu weit von der Map weglaufen oder wegfliegen. Wenn ein Spieler die Grenze überschreitet, wird er sanft zum Spawn zurückteleportiert.
+
+### Die zwei Modi:
+
+| Modus | Beschreibung |
+|-------|--------------|
+| CIRCLE | Eine kreisförmige Grenze mit einem festen Radius um den Spawn. |
+| SQUARE | Eine quadratische Grenze (Box) um den Spawn. |
+
+### Befehle zur Einrichtung:
+
+* Kreis-Border erstellen (z.B. 50 Blöcke Radius):
+```bash
+  /border circle 50
+```
+
+* Quadratische Border erstellen (z.B. 100 Blöcke Kantenlänge):
+```bash
+  /border square 100
+```
+
+* Border deaktivieren:
+```bash
+  /border disable
+```
+
+---
+
+## ⚙️ 3. Manuelle Anpassung (config.yml)
+
+Falls du die Werte direkt in der Konfiguration ändern möchtest, findest du sie in der `config.yml`. Nach einer manuellen Änderung musst du `/nexus reload` ausführen.
+```yaml
+worldborder:
+  enabled: true
+  type: "SQUARE"     # SQUARE oder CIRCLE
+  radius: 50.0       # Radius in Blöcken
+```
+
+---
+
+## 💡 Profi-Tipps
+
+* **Admin-Bypass:** Administratoren mit dem Recht `nexuslobby.admin` oder Spieler im Baumodus (`/build`) können die Border ignorieren, um außerhalb der Grenzen zu bauen.
+* **Zusammenspiel mit Void-Protection:** Wir empfehlen, den Spawn nicht zu nah an einem Abgrund zu setzen, damit Spieler nach einem Border-Teleport sicher stehen.
+* **Performance:** Die Border-Prüfung ist hochgradig optimiert und prüft nur Bewegungen, die ganze Blöcke überschreiten, um die Server-CPU zu schonen.