M_Viper/NexusLobby
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 8 Wiki Activity

Spawn & WorldBorder aktualisiert

M_Viper
2026-01-23 16:05:29 +00:00
parent 5bba426087
commit ef102bcdd5
1 changed files with 61 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

97
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: Die Kreis-Grenze berechnet den Abstand von einem festen Mittelpunkt. Dies ist die schnellste Methode, um eine Begrenzung einzurichten.
* **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: ### Vorgehensweise:
1. Gehe im Spiel an die gewünschte Position. 1. Stelle dich genau in die **Mitte** des Bereichs, den du begrenzen möchtest.
2. Schaue in die Richtung, in die die Spieler blicken sollen. 2. Nutze den Befehl:
3. Nutze den Befehl:
```bash ```bash
/nexus setspawn /border circle <Radius>
``` ```
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: ### Vorgehensweise:
1. Nimm die Portalwand (standardmäßig ein Stock mit speziellem Key) in die Hand (Befehl: `/giveportalwand`).
| Modus | Beschreibung | 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.
| CIRCLE | Eine kreisförmige Grenze mit einem festen Radius um den Spawn. | 4. Wenn der Bereich im Chat als "Großer Bereich" (WorldBorder-Größe) erkannt wird, nutze:
| SQUARE | Eine quadratische Grenze (Box) um den Spawn. |
### Befehle zur Einrichtung:
* Kreis-Border erstellen (z.B. 50 Blöcke Radius):
```bash ```bash
/border circle 50 /border square
``` ```
* Quadratische Border erstellen (z.B. 100 Blöcke Kantenlänge): ### Technische Details:
```bash - Das Plugin speichert die zwei Punkte als `worldborder.pos1` und `worldborder.pos2`.
/border square 100 - Es wird ein unsichtbarer Kasten zwischen diesen Koordinaten berechnet.
``` - Der Typ in der Config ändert sich auf `SQUARE`.
* Border deaktivieren: ---
## 🚫 3. Grenze deaktivieren
Falls du Wartungsarbeiten durchführst oder die Begrenzung temporär entfernen möchtest:
```bash ```bash
/border disable /border disable
``` ```
Dies setzt `worldborder.enabled` auf `false` in der Konfiguration. Das Modul bleibt geladen, prüft aber keine Bewegungen mehr.
--- ---
## ⚙️ 3. Manuelle Anpassung (config.yml) ## 📝 Konfiguration in der 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. Deine Einstellungen werden in der Hauptkonfiguration im Abschnitt `worldborder` gespeichert. So sieht eine fertige Konfiguration aus:
```yaml ```yaml
worldborder: worldborder:
enabled: true enabled: true
type: "SQUARE" # SQUARE oder CIRCLE type: "SQUARE" # Oder "CIRCLE"
radius: 50.0 # Radius in Blöcken 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. - **Teleportation**: Wenn ein Spieler die Grenze überschreitet, wird er zum Spawn teleportiert, der unter `spawn:` in der Config definiert ist.
* **Zusammenspiel mit Void-Protection:** Wir empfehlen, den Spawn nicht zu nah an einem Abgrund zu setzen, damit Spieler nach einem Border-Teleport sicher stehen. - **Sound-Effekt**: Beim Zurücksetzen ertönt der `ENTITY_ENDERMAN_TELEPORT` Sound.
* **Performance:** Die Border-Prüfung ist hochgradig optimiert und prüft nur Bewegungen, die ganze Blöcke überschreiten, um die Server-CPU zu schonen. - **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.