README.md aktualisiert

This commit is contained in:
2026-01-24 16:13:45 +00:00
parent 64a03b539e
commit 250bf2fea6

196
README.md
View File

@@ -4,7 +4,7 @@
<img src="https://m-viper.de/img/NexusLobby.png" width="500" alt="NexusLobby"> <img src="https://m-viper.de/img/NexusLobby.png" width="500" alt="NexusLobby">
</p> </p>
Ein umfassendes Lobby-Plugin fur Minecraft Server (Paper/Spigot 1.21+) mit modularem Aufbau, umfangreichen Sicherheitsfunktionen und voller Konfigurierbarkeit. Ein umfassendes Lobby-Plugin für Minecraft Server (Paper/Spigot 1.21+) mit modularem Aufbau, High-End NPC-System, umfangreichen Sicherheitsfunktionen und voller Konfigurierbarkeit.
![Minecraft](https://img.shields.io/badge/Minecraft-1.21+-green) ![Minecraft](https://img.shields.io/badge/Minecraft-1.21+-green)
![Java](https://img.shields.io/badge/Java-21+-orange) ![Java](https://img.shields.io/badge/Java-21+-orange)
@@ -16,62 +16,43 @@ Ein umfassendes Lobby-Plugin fur Minecraft Server (Paper/Spigot 1.21+) mit modul
**ALLE RECHTE VORBEHALTEN** **ALLE RECHTE VORBEHALTEN**
Dieses Plugin ist urheberrechtlich geschutzt. Es gelten folgende Bedingungen: Dieses Plugin ist urheberrechtlich geschützt. Es gelten folgende Bedingungen:
- Die Nutzung ist ausschliesslich fur den persönlichen Gebrauch gestattet - Die Nutzung ist ausschließlich für den persönlichen Gebrauch gestattet.
- Die Weitergabe, Verbreitung oder Veröffentlichung des Plugins ist **strengstens untersagt** - Die Weitergabe, Verbreitung oder Veröffentlichung des Plugins ist **strengstens untersagt**.
- Jegliche Anderung, Modifikation oder Dekompilierung des Codes ist **verboten** - Jegliche Änderung, Modifikation oder Dekompilierung des Codes ist **verboten**.
- Das Plugin darf nicht verkauft, vermietet oder anderweitig kommerziell genutzt werden - Das Plugin darf nicht verkauft, vermietet oder anderweitig kommerziell genutzt werden.
- Eine Weitergabe an Dritte ist ohne ausdrückliche schriftliche Genehmigung nicht gestattet - Eine Weitergabe an Dritte ist ohne ausdrückliche schriftliche Genehmigung nicht gestattet.
Bei Verstoss gegen diese Bedingungen behalten wir uns rechtliche Schritte vor. Bei Verstoß gegen diese Bedingungen behalten wir uns rechtliche Schritte vor.
--- ---
## Features ## Features
### Lobby-Management ### 🤖 High-End NPC & ArmorStand System
- **Spawn-System** - Automatischer Teleport zum Spawn bei Join/Respawn - **Conversation Manager** - Komplexe Dialoge zwischen NPCs mit Sprechblasen und Sound-Effekten.
- **Void-Schutz** - Automatischer Teleport bei Fall ins Void - **Dynamic KI** - NPCs reagieren auf Tageszeit (Fackel nachts) und ziehen bei Annäherung von Spielern das Schwert.
- **Doppelsprung** - Konfigurierbarer Double-Jump mit Cooldown - **LookAt-Logik** - NPCs verfolgen flüssig die Kopfbewegungen von Spielern in der Nähe.
- **Build-Modus** - Schnelles Umschalten zwischen Bau- und Spielmodus - **Command Binding** - Binde Spieler-, Konsolen- oder Bungee-Befehle an NPC-Slots (0-9).
- **Status-Backup** - Automatisches Speichern von NPC-Namen via PersistentDataContainer & Tags.
### Visuelle Elemente ### 🌍 Lobby-Management
- **Scoreboard** - Anpassbares Sidebar-Scoreboard mit Animationen - **Spawn-System** - Automatischer Teleport zum Spawn bei Join/Respawn.
- **Tablist** - Header und Footer mit PlaceholderAPI-Support - **Portal-System** - BungeeCord-Portale für nahtlose Server-Wechsel.
- **BossBar** - Animierte Boss-Bar mit wechselnden Nachrichten - **Build-Modus** - Schnelles Umschalten zwischen Bau- und Spielmodus.
- **ActionBar** - Permanente ActionBar-Nachrichten - **Double-Jump** - Konfigurierbarer Doppelsprung mit Cooldown und Partikeln.
### Sicherheit ### 🛡️ Sicherheit & Protection
- **VPN-Blocker** - Blockiert VPN/Proxy-Verbindungen (proxycheck.io API) - **VPN-Blocker** - Blockiert VPN/Proxy-Verbindungen via proxycheck.io API.
- **Country-Blocker** - Erlaubt nur bestimmte Lander (Whitelist/Blacklist) - **Country-Blocker** - Geo-IP Filter (Whitelist/Blacklist für Länder).
- **Wartungsmodus** - Sperrt den Server für nicht-berechtigte Spieler - **Maintenance** - Vollständiger Wartungsmodus mit Whitelist-Funktion.
- **Lobby-Schutz** - Verhindert Griefing und unerwünschte Aktionen - **World-Protection** - Schutz vor Griefing, Hunger, Fallschaden und PvP.
### Zusatzliche Module ### 📊 Visuelle Elemente
- **Portal-System** - Erstelle Portale fur Server-Wechsel (BungeeCord) - **Scoreboard & Tablist** - Vollständig animiert mit PlaceholderAPI-Support.
- **ArmorStand-Tools** - Bearbeite ArmorStands mit GUI und Command-Binding - **BossBar & ActionBar** - Rotierende Nachrichten und permanente Status-Anzeigen.
- **Server-Switcher** - GUI-basierter Server-Wechsel - **Hologramme** - Einfache Erstellung von Text-Displays in der Lobby.
- **Spieler verstecken** - Toggle fur Spieler-Sichtbarkeit
- **Chat-Suppressor** - Unterdrückung fur globalen Chat
---
## Installation
### Voraussetzungen
- Paper/Spigot Server 1.21 oder höher
- Java 21 oder hoher
### Optionale Abhangigkeiten
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) - Für Platzhalter-Support
- [LuckPerms](https://luckperms.net/) - Für Berechtigungsverwaltung
### Schritte
1. Lade `NexusLobby.jar` herunter
2. Kopiere die JAR in den `plugins/` Ordner deines Servers
3. Starte den Server neu
4. Konfiguriere das Plugin in `plugins/NexusLobby/`
--- ---
@@ -79,73 +60,31 @@ Bei Verstoss gegen diese Bedingungen behalten wir uns rechtliche Schritte vor.
| Befehl | Beschreibung | Berechtigung | | Befehl | Beschreibung | Berechtigung |
|--------|--------------|--------------| |--------|--------------|--------------|
| `/nexuslobby` | Hauptbefehl mit Hilfe | `nexuslobby.use` | | `/nexuslobby` | Hauptbefehl (reload, setspawn, silentjoin) | `nexuslobby.admin` |
| `/nexuslobby reload` | Konfiguration neu laden | `nexuslobby.reload` | | `/nexuscmd` | NPC Command/Dialog Verwaltung (aliases: `ncmd`, `conv`) | `nexuslobby.armorstand.cmd` |
| `/nexuslobby setspawn` | Spawn-Punkt setzen | `nexuslobby.setspawn` | | `/nexustools` | NPC Editor GUI (Rotation, KI, Sichtbarkeit) | `nexuslobby.armorstand.use` |
| `/build` | Build-Modus umschalten | `nexuslobby.build` | | `/build` | Aktiviert/Deaktiviert den Baumodus | `nexuslobby.build` |
| `/maintenance` | Wartungsmodus verwalten | `nexuslobby.maintenance` | | `/maintenance` | Schaltet den Wartungsmodus (on/off) | `nexuslobby.maintenance` |
| `/portal` | Portal-System verwalten | `nexuslobby.portal` | | `/portal` | Verwaltung der Server-Portale | `nexuslobby.portal` |
| `/armorstand` | ArmorStand-Editor | `nexuslobby.armorstand` | | `/holo` | Erstellt oder löscht Text-Hologramme | `nexuslobby.hologram` |
| `/lobbysettings` | Spieler-Einstellungen | `nexuslobby.settings` | | `/mapart` | Erstellt Bilder aus URLs auf Karten-Rahmen | `nexuslobby.mapart` |
--- ---
## Konfiguration ## Konfiguration (Auszug)
### config.yml ### conversations.yml
```yaml ```yaml
prefix: "&8[&6NexusLobby&8] " conversations:
willkommen:
dialogue:
- "&eWächter: &7Willkommen auf dem Server!"
- "&aBürger: &7Schön, dass du da bist!"
spawn: links:
teleport_on_join: true UUID-NPC1:
teleport_on_respawn: true partner: UUID-NPC2
world: "world" dialog: willkommen
x: 0.5
y: 100.0
z: 0.5
double_jump:
enabled: true
cooldown: 3
velocity_y: 1.0
velocity_multiplier: 1.5
```
### settings.yml
```yaml
player_visibility: true
double_jump: true
flight: false
gamerules:
block_break: false
block_place: false
pvp: false
hunger: false
fall_damage: false
```
### visuals.yml
```yaml
scoreboard:
enabled: true
title: "&6&lNEXUS LOBBY"
lines:
- "&7"
- "&fSpieler: &a%online%"
- "&fRang: &e%luckperms_primary_group_name%"
tablist:
enabled: true
header:
- "&6&lNEXUS NETWORK"
footer:
- "&7Spieler online: &a%online%"
bossbar:
enabled: true
messages:
- "&6Willkommen auf NexusNetwork!"
``` ```
--- ---
@@ -154,47 +93,28 @@ bossbar:
| Berechtigung | Beschreibung | | Berechtigung | Beschreibung |
|--------------|--------------| |--------------|--------------|
| `nexuslobby.*` | Alle Berechtigungen | | `nexuslobby.admin` | Voller Zugriff auf alle System-Einstellungen |
| `nexuslobby.use` | Grundlegende Nutzung | | `nexuslobby.armorstand.cmd` | NPCs konfigurieren und Dialoge verknüpfen |
| `nexuslobby.reload` | Konfiguration neu laden | | `nexuslobby.armorstand.use` | Zugriff auf die ArmorStand-Editor GUI |
| `nexuslobby.setspawn` | Spawn setzen | | `nexuslobby.build` | Berechtigung für den Baumodus |
| `nexuslobby.build` | Build-Modus nutzen | | `nexuslobby.portal` | Portale erstellen und löschen |
| `nexuslobby.maintenance` | Wartungsmodus verwalten |
| `nexuslobby.portal` | Portale verwalten |
| `nexuslobby.armorstand` | ArmorStand-Editor nutzen |
### Bypass-Berechtigungen ### Bypass-Berechtigungen
| Berechtigung | Beschreibung | | Berechtigung | Beschreibung |
|--------------|--------------| |--------------|--------------|
| `nexuslobby.bypass.protection` | Lobby-Schutz umgehen | | `nexuslobby.bypass.maintenance` | Server trotz Wartungsmodus betreten |
| `nexuslobby.bypass.maintenance` | Wartungsmodus umgehen | | `nexuslobby.bypass.vpn` | VPN-Check überspringen |
| `nexuslobby.bypass.vpn` | VPN-Blocker umgehen |
| `nexuslobby.bypass.country` | Country-Blocker umgehen |
--- ---
## PlaceholderAPI ## Support & Kontakt
Das Plugin registriert eigene Platzhalter unter der Expansion `nexuslobby`: - **Wiki:** Ausführliche Dokumentation der Module im [Wiki](../../../wiki).
- **Bug-Reports:** Erstelle ein [Issue](../../../issues) bei technischen Problemen.
| Platzhalter | Beschreibung |
|-------------|--------------|
| `%nexuslobby_online%` | Spieler online |
| `%nexuslobby_max_players%` | Maximale Spieler |
| `%nexuslobby_maintenance%` | Wartungsmodus Status |
| `%nexuslobby_build_mode%` | Build-Modus Status |
| `%nexuslobby_double_jump%` | Double-Jump Status |
--- ---
## Support **Copyright (c) 2026 - M_Viper - Alle Rechte vorbehalten**
- [Wiki](../../../wiki) - Ausführliche Dokumentation
- [Issues](../../../issues) - Bug-Reports und Feature-Requests
---
**Copyright (c) 2025 - Alle Rechte vorbehalten**
Die unbefugte Vervielfältigung, Verbreitung oder Weitergabe dieses Plugins ist strafbar und wird rechtlich verfolgt. Die unbefugte Vervielfältigung, Verbreitung oder Weitergabe dieses Plugins ist strafbar und wird rechtlich verfolgt.