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

README.md aktualisiert

Browse Source
This commit is contained in:
M_Viper
2026-01-24 16:13:45 +00:00
parent 64a03b539e
commit 250bf2fea6
1 changed files with 59 additions and 139 deletions
Download Patch File Download Diff File Expand all files Collapse all files

198
README.md
View File

@@ -4,7 +4,7 @@
<img src="https://m-viper.de/img/NexusLobby.png" width="500" alt="NexusLobby">
</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)
![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**
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 Weitergabe, Verbreitung oder Veröffentlichung des Plugins ist **strengstens untersagt**
- Jegliche Anderung, Modifikation oder Dekompilierung des Codes ist **verboten**
- Das Plugin darf nicht verkauft, vermietet oder anderweitig kommerziell genutzt werden
- Eine Weitergabe an Dritte ist ohne ausdrückliche schriftliche Genehmigung nicht gestattet
- Die Nutzung ist ausschließlich für den persönlichen Gebrauch gestattet.
- Die Weitergabe, Verbreitung oder Veröffentlichung des Plugins ist **strengstens untersagt**.
- Jegliche Änderung, Modifikation oder Dekompilierung des Codes ist **verboten**.
- Das Plugin darf nicht verkauft, vermietet oder anderweitig kommerziell genutzt werden.
- 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
### Lobby-Management
- **Spawn-System** - Automatischer Teleport zum Spawn bei Join/Respawn
- **Void-Schutz** - Automatischer Teleport bei Fall ins Void
- **Doppelsprung** - Konfigurierbarer Double-Jump mit Cooldown
- **Build-Modus** - Schnelles Umschalten zwischen Bau- und Spielmodus
### 🤖 High-End NPC & ArmorStand System
- **Conversation Manager** - Komplexe Dialoge zwischen NPCs mit Sprechblasen und Sound-Effekten.
- **Dynamic KI** - NPCs reagieren auf Tageszeit (Fackel nachts) und ziehen bei Annäherung von Spielern das Schwert.
- **LookAt-Logik** - NPCs verfolgen flüssig die Kopfbewegungen von Spielern in der Nähe.
- **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
- **Scoreboard** - Anpassbares Sidebar-Scoreboard mit Animationen
- **Tablist** - Header und Footer mit PlaceholderAPI-Support
- **BossBar** - Animierte Boss-Bar mit wechselnden Nachrichten
- **ActionBar** - Permanente ActionBar-Nachrichten
### 🌍 Lobby-Management
- **Spawn-System** - Automatischer Teleport zum Spawn bei Join/Respawn.
- **Portal-System** - BungeeCord-Portale für nahtlose Server-Wechsel.
- **Build-Modus** - Schnelles Umschalten zwischen Bau- und Spielmodus.
- **Double-Jump** - Konfigurierbarer Doppelsprung mit Cooldown und Partikeln.
### Sicherheit
- **VPN-Blocker** - Blockiert VPN/Proxy-Verbindungen (proxycheck.io API)
- **Country-Blocker** - Erlaubt nur bestimmte Lander (Whitelist/Blacklist)
- **Wartungsmodus** - Sperrt den Server für nicht-berechtigte Spieler
- **Lobby-Schutz** - Verhindert Griefing und unerwünschte Aktionen
### 🛡️ Sicherheit & Protection
- **VPN-Blocker** - Blockiert VPN/Proxy-Verbindungen via proxycheck.io API.
- **Country-Blocker** - Geo-IP Filter (Whitelist/Blacklist für Länder).
- **Maintenance** - Vollständiger Wartungsmodus mit Whitelist-Funktion.
- **World-Protection** - Schutz vor Griefing, Hunger, Fallschaden und PvP.
### Zusatzliche Module
- **Portal-System** - Erstelle Portale fur Server-Wechsel (BungeeCord)
- **ArmorStand-Tools** - Bearbeite ArmorStands mit GUI und Command-Binding
- **Server-Switcher** - GUI-basierter Server-Wechsel
- **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/`
### 📊 Visuelle Elemente
- **Scoreboard & Tablist** - Vollständig animiert mit PlaceholderAPI-Support.
- **BossBar & ActionBar** - Rotierende Nachrichten und permanente Status-Anzeigen.
- **Hologramme** - Einfache Erstellung von Text-Displays in der Lobby.
---
@@ -79,73 +60,31 @@ Bei Verstoss gegen diese Bedingungen behalten wir uns rechtliche Schritte vor.
| Befehl | Beschreibung | Berechtigung |
|--------|--------------|--------------|
| `/nexuslobby` | Hauptbefehl mit Hilfe | `nexuslobby.use` |
| `/nexuslobby reload` | Konfiguration neu laden | `nexuslobby.reload` |
| `/nexuslobby setspawn` | Spawn-Punkt setzen | `nexuslobby.setspawn` |
| `/build` | Build-Modus umschalten | `nexuslobby.build` |
| `/maintenance` | Wartungsmodus verwalten | `nexuslobby.maintenance` |
| `/portal` | Portal-System verwalten | `nexuslobby.portal` |
| `/armorstand` | ArmorStand-Editor | `nexuslobby.armorstand` |
| `/lobbysettings` | Spieler-Einstellungen | `nexuslobby.settings` |
| `/nexuslobby` | Hauptbefehl (reload, setspawn, silentjoin) | `nexuslobby.admin` |
| `/nexuscmd` | NPC Command/Dialog Verwaltung (aliases: `ncmd`, `conv`) | `nexuslobby.armorstand.cmd` |
| `/nexustools` | NPC Editor GUI (Rotation, KI, Sichtbarkeit) | `nexuslobby.armorstand.use` |
| `/build` | Aktiviert/Deaktiviert den Baumodus | `nexuslobby.build` |
| `/maintenance` | Schaltet den Wartungsmodus (on/off) | `nexuslobby.maintenance` |
| `/portal` | Verwaltung der Server-Portale | `nexuslobby.portal` |
| `/holo` | Erstellt oder löscht Text-Hologramme | `nexuslobby.hologram` |
| `/mapart` | Erstellt Bilder aus URLs auf Karten-Rahmen | `nexuslobby.mapart` |
---
## Konfiguration
## Konfiguration (Auszug)
### config.yml
### conversations.yml
```yaml
prefix: "&8[&6NexusLobby&8] "
conversations:
willkommen:
dialogue:
- "&eWächter: &7Willkommen auf dem Server!"
- "&aBürger: &7Schön, dass du da bist!"
spawn:
teleport_on_join: true
teleport_on_respawn: true
world: "world"
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!"
links:
UUID-NPC1:
partner: UUID-NPC2
dialog: willkommen
```
---
@@ -154,47 +93,28 @@ bossbar:
| Berechtigung | Beschreibung |
|--------------|--------------|
| `nexuslobby.*` | Alle Berechtigungen |
| `nexuslobby.use` | Grundlegende Nutzung |
| `nexuslobby.reload` | Konfiguration neu laden |
| `nexuslobby.setspawn` | Spawn setzen |
| `nexuslobby.build` | Build-Modus nutzen |
| `nexuslobby.maintenance` | Wartungsmodus verwalten |
| `nexuslobby.portal` | Portale verwalten |
| `nexuslobby.armorstand` | ArmorStand-Editor nutzen |
| `nexuslobby.admin` | Voller Zugriff auf alle System-Einstellungen |
| `nexuslobby.armorstand.cmd` | NPCs konfigurieren und Dialoge verknüpfen |
| `nexuslobby.armorstand.use` | Zugriff auf die ArmorStand-Editor GUI |
| `nexuslobby.build` | Berechtigung für den Baumodus |
| `nexuslobby.portal` | Portale erstellen und löschen |
### Bypass-Berechtigungen
| Berechtigung | Beschreibung |
|--------------|--------------|
| `nexuslobby.bypass.protection` | Lobby-Schutz umgehen |
| `nexuslobby.bypass.maintenance` | Wartungsmodus umgehen |
| `nexuslobby.bypass.vpn` | VPN-Blocker umgehen |
| `nexuslobby.bypass.country` | Country-Blocker umgehen |
| `nexuslobby.bypass.maintenance` | Server trotz Wartungsmodus betreten |
| `nexuslobby.bypass.vpn` | VPN-Check überspringen |
---
## PlaceholderAPI
## Support & Kontakt
Das Plugin registriert eigene Platzhalter unter der Expansion `nexuslobby`:
| 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 |
- **Wiki:** Ausführliche Dokumentation der Module im [Wiki](../../../wiki).
- **Bug-Reports:** Erstelle ein [Issue](../../../issues) bei technischen Problemen.
---
## 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.