README.md aktualisiert

2026-01-24 16:13:45 +00:00
parent 64a03b539e
commit 250bf2fea6
1 changed files with 59 additions and 139 deletions
--- a/README.md
+++ b/README.md
@@ -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
-
- [Wiki](../../../wiki) - Ausführliche Dokumentation
- [Issues](../../../issues) - Bug-Reports und Feature-Requests
-
---
-
-**Copyright (c) 2025 - Alle Rechte vorbehalten**
+**Copyright (c) 2026 - M_Viper - Alle Rechte vorbehalten**

 Die unbefugte Vervielfältigung, Verbreitung oder Weitergabe dieses Plugins ist strafbar und wird rechtlich verfolgt.