From ef102bcdd506347c0de2b3d2ded31f1e4300b00f Mon Sep 17 00:00:00 2001 From: M_Viper Date: Fri, 23 Jan 2026 16:05:29 +0000 Subject: [PATCH] Spawn & WorldBorder aktualisiert --- Spawn-%26-WorldBorder.md | 105 +++++++++++++++++++++++---------------- 1 file changed, 61 insertions(+), 44 deletions(-) diff --git a/Spawn-%26-WorldBorder.md b/Spawn-%26-WorldBorder.md index c604af6..2aabb45 100644 --- a/Spawn-%26-WorldBorder.md +++ b/Spawn-%26-WorldBorder.md @@ -1,72 +1,89 @@ -# Spawn & WorldBorder +# 🛡️ Setup: WorldBorder & Grenzen -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. +In **NexusLobby v1.0.4** gibt es zwei Arten, die Lobby-Begrenzung festzulegen. Entweder als dynamischen Radius um einen Punkt oder als fest definiertes Viereck über eine Markierung. --- -## 🏠 1. Den Lobby-Spawn setzen +## 🔵 1. Kreis-Grenze setzen (CIRCLE) -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`. +Die Kreis-Grenze berechnet den Abstand von einem festen Mittelpunkt. Dies ist die schnellste Methode, um eine Begrenzung einzurichten. -### 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: +### Vorgehensweise: +1. Stelle dich genau in die **Mitte** des Bereichs, den du begrenzen möchtest. +2. Nutze den Befehl: ```bash - /nexus setspawn + /border circle ``` -4. Das Plugin speichert die Welt, die Koordinaten (X, Y, Z) sowie die Blickrichtung (Yaw, Pitch) sofort in der `config.yml`. +3. Beispiel: `/border circle 50` erstellt eine Grenze mit 50 Blöcken Radius um dich herum. + +### Technische Details: +- Das Plugin speichert deinen aktuellen Standort als `worldborder.center` in der `config.yml`. +- Der Typ wird automatisch auf `CIRCLE` gesetzt. +- Spieler, die die Distanz überschreiten, werden zum Haupt-Spawn teleportiert. --- -## 🛡️ 2. Die WorldBorder (Lobby-Begrenzung) +## 🟧 2. Viereck-Grenze setzen (SQUARE) -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 viereckige Grenze nutzt das Selektions-System der Portalwand. Dies ist ideal, wenn deine Lobby exakte Mauern oder eine rechteckige Form hat. -### 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): +### Vorgehensweise: +1. Nimm die Portalwand (standardmäßig ein Stock mit speziellem Key) in die Hand (Befehl: `/giveportalwand`). +2. Markiere **Punkt 1** (Linksklick auf einen Block) an einer Ecke der Lobby. +3. Markiere **Punkt 2** (Rechtsklick auf einen Block) an der gegenüberliegenden Ecke. +4. Wenn der Bereich im Chat als "Großer Bereich" (WorldBorder-Größe) erkannt wird, nutze: ```bash - /border circle 50 + /border square ``` -* Quadratische Border erstellen (z.B. 100 Blöcke Kantenlänge): -```bash - /border square 100 -``` - -* Border deaktivieren: -```bash - /border disable -``` +### Technische Details: +- Das Plugin speichert die zwei Punkte als `worldborder.pos1` und `worldborder.pos2`. +- Es wird ein unsichtbarer Kasten zwischen diesen Koordinaten berechnet. +- Der Typ in der Config ändert sich auf `SQUARE`. --- -## ⚙️ 3. Manuelle Anpassung (config.yml) +## 🚫 3. Grenze deaktivieren -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. +Falls du Wartungsarbeiten durchführst oder die Begrenzung temporär entfernen möchtest: +```bash +/border disable +``` + +Dies setzt `worldborder.enabled` auf `false` in der Konfiguration. Das Modul bleibt geladen, prüft aber keine Bewegungen mehr. + +--- + +## 📝 Konfiguration in der config.yml + +Deine Einstellungen werden in der Hauptkonfiguration im Abschnitt `worldborder` gespeichert. So sieht eine fertige Konfiguration aus: ```yaml worldborder: enabled: true - type: "SQUARE" # SQUARE oder CIRCLE - radius: 50.0 # Radius in Blöcken + type: "SQUARE" # Oder "CIRCLE" + radius: 50.0 # Nur für CIRCLE relevant + center: # Standort des Admins beim Befehl + world: world + x: 10.5 + y: 64.0 + z: 10.5 + pos1: # Markierung via Portalwand (Linksklick) + world: world + x: -100.0 + y: 0.0 + z: -100.0 + pos2: # Markierung via Portalwand (Rechtsklick) + world: world + x: 100.0 + y: 255.0 + z: 100.0 ``` --- -## 💡 Profi-Tipps +## 💡 Wichtige Hinweise für Admins -* **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. \ No newline at end of file +- **Teleportation**: Wenn ein Spieler die Grenze überschreitet, wird er zum Spawn teleportiert, der unter `spawn:` in der Config definiert ist. +- **Sound-Effekt**: Beim Zurücksetzen ertönt der `ENTITY_ENDERMAN_TELEPORT` Sound. +- **Bypass**: Spieler mit der Permission `nexuslobby.admin` oder im Spectator-Modus können die Grenze ignorieren. +- **Echtzeit-Update**: Nach der Nutzung des `/border` Befehls speichert das Plugin die Config automatisch und aktualisiert das Modul im Arbeitsspeicher – ein manueller Reload ist nicht nötig. \ No newline at end of file