NexusLobby/readme.md

🌐 Mehrsprachigkeit & Texte

Alle Nachrichten, Hilfetexte und Fehler werden zentral über die Datei lang.yml im Ordner src/main/resources verwaltet. Dort kannst du für jede Sprache (z.B. Deutsch und Englisch) die Texte pflegen und beliebig erweitern.

Beispiel für lang.yml:

welcome:
  de: "Willkommen auf dem Server!"
  en: "Welcome to the server!"
no_permission:
  de: "§cKeine Berechtigung."
  en: "§cNo permission."

Sprache umstellen: Im Code kann die Sprache mit LangManager.setLanguage("en") gewechselt werden. Standard ist Deutsch (de).

Texte ingame nutzen: Alle Texte werden im Plugin mit LangManager.get("key") abgerufen und sind direkt ingame sichtbar. Änderungen in der lang.yml wirken nach einem Reload sofort.

Chat-Prefix anpassen: Der Prefix vor Plugin-Nachrichten wird in der Server-config.yml über prefix festgelegt. Farben können mit &-Codes angegeben werden:

prefix: "&8[&6Nexus&8] "

Ändere den Text und die Farben nach Wunsch und lade das Plugin anschließend neu.

---

NexusLobby

Ein umfassendes, modulares Lobby-Plugin für Minecraft Server (Paper/Spigot 1.21+) mit High-End NPC-System, umfangreichen Sicherheitsfunktionen, Soccer-Modul, Parkour-System und voller Konfigurierbarkeit.

---

🎯 Lizenz und Nutzungsbedingungen

ALLE RECHTE VORBEHALTEN

Dieses Plugin ist urheberrechtlich geschützt. Es gelten folgende Bedingungen:

Scoreboard ausblenden (Opt-out)

Spieler können das Scoreboard per Befehl ein-/ausblenden. Standardmäßig wird das Scoreboard beim Join angezeigt. Über die Option

scoreboard-default-visible: true

in der config.yml kann festgelegt werden, ob das Scoreboard für neue Spieler standardmäßig sichtbar ist. Bei false ist es für alle Spieler nach dem Join ausgeblendet, bis sie es selbst aktivieren.

• 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 Verstoß gegen diese Bedingungen behalten wir uns rechtliche Schritte vor.

---

✨ Features

🤖 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

⚽ Soccer/Fußball-System

• Interaktiver Soccer-Ball - Physics-basierter Ball mit realistischer Physik
• Dribbling - Ball folgt Spielern automatisch in der Nähe
• Kick-Mechanik - Schieße den Ball durch Schlagen oder Angriff
• Wall-Bounce - Realistische Wand-Abpraller mit Sound-Effekten
• Partikel-System - Geschwindigkeits-abhängige Partikel (SONIC_BOOM, CRIT, SMOKE)
• Auto-Respawn - Automatischer Respawn bei Inaktivität oder Void-Fall
• Anti-Duplikat-System - Verhindert mehrfache Ball-Instanzen

🏃 Parkour-System

• Unsichtbare Checkpoints - Partikel-basierte Checkpoint-Markierungen
• Timer-System - Präzise Zeitmessung mit ActionBar-Anzeige
• Bestenliste - Persistente Top-10 Bestzeiten-Speicherung
• NPC-Trainer - Interaktive NPCs zum Starten des Parkours
• Fail-Safe - Teleport zum letzten Checkpoint bei Fehler

🌍 Lobby-Management

• Spawn-System - Automatischer Teleport zum Spawn bei Join/Respawn
• Portal-System - BungeeCord-Portale für nahtlose Server-Wechsel mit Partikel-Effekten
• Build-Modus - Schnelles Umschalten zwischen Bau- und Spielmodus
• Double-Jump - Konfigurierbarer Doppelsprung mit Cooldown und Partikeln
• Worldborder - Unsichtbare Lobby-Begrenzung (Circle/Square)
• Intro-Tour - Cinematic Kamera-Tour für neue Spieler

🛡️ Sicherheit & Protection

• VPN-Blocker - Blockiert VPN/Proxy-Verbindungen via proxycheck.io API
• Country-Blocker - Geo-IP Filter (Whitelist/Blacklist für Länder)
• Maintenance-Modus - Vollständiger Wartungsmodus mit Whitelist-Funktion
• World-Protection - Schutz vor Griefing, Hunger, Fallschaden und PvP
• Anti-Grief - Verhindert Block-Break, Item-Drop und Explosionen
• Security-Module - Umfassende Sicherheitsprüfungen beim Join

📊 Visuelle Elemente

• Scoreboard - Vollständig animiert mit PlaceholderAPI-Support
• Tablist - Dynamische Header/Footer mit Permissions-Anzeige
• BossBar - Rotierende Nachrichten mit Farb-Effekten
• ActionBar - Typewriter-Effekt für permanente Status-Anzeigen
• Hologramme - Text-Displays mit flexibler Positionierung
• MapArt - Bild-Generator für Item-Frames aus URLs

🎮 Item-System

• Compass - Server-Switcher GUI
• Player-Hider - Sichtbarkeits-Toggle für andere Spieler
• Gadgets - Konfigurierbares Item-System mit Custom-Slots
• Player-Inspector - Detaillierte Spieler-Informationen per Click

---

📋 Befehle

Haupt-Commands

Befehl	Beschreibung	Berechtigung
/nexuslobby reload	Lädt das Plugin neu	nexuslobby.admin
/nexuslobby setspawn	Setzt den Lobby-Spawn	nexuslobby.admin
/nexuslobby silentjoin <on|off>	Versteckter Join/Quit	nexuslobby.admin
/nexuslobby sb <on|off|admin|spieler>	Scoreboard-Kontrolle	nexuslobby.admin
/spawn	Teleport zum Spawn	nexuslobby.spawn

NPC & ArmorStand

Befehl	Beschreibung	Berechtigung
/nexustools	NPC Editor GUI (Rotation, KI)	nexuslobby.armorstand.use
/nexuscmd add <slot> <prio> <type> [cmd]	Bindet Command an NPC	nexuslobby.armorstand.cmd
/nexuscmd remove <slot|all>	Entfernt Commands	nexuslobby.armorstand.cmd
/nexuscmd conv select1-4	Wählt NPCs für Dialog	nexuslobby.armorstand.cmd
/nexuscmd conv link <id>	Verknüpft Dialog	nexuslobby.armorstand.cmd
/nexuscmd say <text>	NPC-Sprechblase	nexuslobby.armorstand.cmd

Parkour

Befehl	Beschreibung	Berechtigung
/nexuslobby parkour setstart	Markiert Start-NPC	nexuslobby.admin
/nexuslobby parkour setcheckpoint <n>	Setzt Checkpoint	nexuslobby.admin
/nexuslobby parkour setfinish	Setzt Ziel	nexuslobby.admin
/nexuslobby parkour reset	Löscht eigene Zeit	nexuslobby.admin
/nexuslobby parkour clear	Löscht alle Zeiten	nexuslobby.admin
/setstart	Alias für setstart	nexuslobby.admin
/setcheckpoint	Alias für setcheckpoint	nexuslobby.admin
/setfinish	Alias für setfinish	nexuslobby.admin

Soccer/Fußball

Befehl	Beschreibung	Berechtigung
/nexuslobby ball setspawn	Setzt Ball-Spawn	nexuslobby.admin
/nexuslobby ball respawn	Spawnt Ball neu	nexuslobby.admin
/nexuslobby ball remove	Entfernt Ball	nexuslobby.admin

Portal & Server

Befehl	Beschreibung	Berechtigung
/portal create <name> <type>	Erstellt Portal	nexuslobby.portal
/portal delete <name>	Löscht Portal	nexuslobby.portal
/portal list	Zeigt alle Portale	nexuslobby.portal
/giveportalwand	Portal-Werkzeug	nexuslobby.portal.give
/serverswitcher	Öffnet Server-GUI	nexuslobby.serverswitcher

Sonstiges

Befehl	Beschreibung	Berechtigung
/build	Build-Modus toggle	nexuslobby.build
/maintenance <on|off>	Wartungsmodus	nexuslobby.maintenance
/settings	Lobby-Einstellungen (Gamerules)	nexuslobby.admin
/holo create <id> [text]	Erstellt Hologramm	nexuslobby.hologram
/holo delete <id>	Löscht Hologramm	nexuslobby.hologram
/mapart <URL> <BxH>	Erstellt MapArt	nexuslobby.mapart
/intro <add|clear|start>	Intro-Tour-Verwaltung	nexuslobby.admin
/border <circle|square|disable>	Worldborder-Setup	nexuslobby.admin

---

⚙️ Konfiguration

config.yml (Auszug)

# Spawn-Einstellungen
spawn:
  world: "world"
  x: 0.5
  y: 64.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0

# Lobby-Einstellungen
lobby:
  allow-fly: false
  pvp-enabled: false
  build-enabled: false
  default-gamemode: Adventure
  clear-inventory-on-join: true

# Server-Mapping (für Status-Check)
servers:
  survival:
    ip: "127.0.0.1"
    port: 25566
  skyblock:
    ip: "127.0.0.1"
    port: 25567

# Ball/Soccer-Einstellungen
ball:
  respawn_delay: 60  # Sekunden bis Auto-Respawn

# Worldborder
worldborder:
  enabled: true
  type: "SQUARE"  # SQUARE oder CIRCLE
  radius: 50.0

conversations.yml

conversations:
  willkommen:
    dialogue:
      - "&eWächter: &7Willkommen auf dem Server!"
      - "&aBürger: &7Schön, dass du da bist!"
      - "&eWächter: &7Viel Spaß beim Erkunden!"
    
  quest_dialog:
    dialogue:
      - "&6Quest-Geber: &7Hast du meine Quest erledigt?"
      - "&aHeld: &7Ja, ich habe alle Monster besiegt!"

links:
  # UUID des ersten NPCs
  "550e8400-e29b-41d4-a716-446655440000":
    partner: "550e8400-e29b-41d4-a716-446655440001"  # UUID des zweiten NPCs
    dialog: willkommen
    automated: true  # Startet automatisch

visuals.yml (Auszug)

# ActionBar-Nachrichten
actionbar:
  enabled: true
  speed: 3
  messages:
    - "&6&lWillkommen &8» &eauf unserem Server!"
    - "&b&lViel Spaß &8» &7in der Lobby!"

# BossBar
bossbar:
  enabled: true
  interval: 40
  messages:
    - text: "&6&lNexusLobby &8» &eVersion 1.1.0"
      color: "YELLOW"

---

🔐 Berechtigungen

Admin-Berechtigungen

Berechtigung	Beschreibung
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
nexuslobby.portal.give	Portal-Werkzeug erhalten
nexuslobby.hologram	Hologramme verwalten
nexuslobby.mapart	MapArt erstellen
nexuslobby.maintenance	Wartungsmodus togglen

Spieler-Berechtigungen

Berechtigung	Beschreibung
nexuslobby.spawn	Spawn-Command nutzen
nexuslobby.serverswitcher	Server-Switcher GUI öffnen
nexuslobby.scoreboard.admin	Admin-Scoreboard sehen

Bypass-Berechtigungen

Berechtigung	Beschreibung
nexuslobby.bypass.maintenance	Server trotz Wartungsmodus betreten
nexuslobby.bypass.vpn	VPN-Check überspringen
nexuslobby.bypass.country	Country-Check überspringen

---

🔧 Technische Details

Systemanforderungen

• Minecraft: Paper/Spigot 1.21+ (Spigot-kompatibel, Paper empfohlen)
• Java: Java 21 oder höher
• Dependencies: LuckPerms, PlaceholderAPI (optional)

Verwendete Technologien

• Build-Tool: Maven 3.9+
• JSON-Library: Gson 2.10.1 (gegenüber json-simple 1.1.1 aktualisiert)
• BungeeCord API: Für Server-Wechsel und Messaging
• PlaceholderAPI: Für dynamische Platzhalter

Code-Qualität

• ✅ Moderne Java 21 Features (Switch-Expressions, Pattern Matching)
• ✅ Proper Error-Handling (Logger statt printStackTrace)
• ✅ Memory-Management (Tasks & Listeners werden sauber disposed)
• ✅ Config-Validierung mit Default-Werten
• ✅ Optimiertes JSON-Parsing mit Gson
• ✅ Spigot-kompatible BungeeCord Chat API

Performance-Optimierungen

• Async-Processing für API-Calls (Update-Check, VPN-Check)
• Caching für Spieler-Daten und Config-Werte
• Optimierte Entity-Queries (nur relevante Welten)
• Effiziente Scheduler-Nutzung (Tasks werden gecancelt)

---

📦 Installation

1. Download der neuesten NexusLobby-1.1.0.jar aus den Releases
2. Upload der JAR-Datei in den /plugins/ Ordner
3. Server-Neustart durchführen
4. Konfiguration anpassen (config.yml, visuals.yml, etc.)
5. Permissions mit LuckPerms oder einem anderen Permissions-Plugin setzen
6. (Optional) PlaceholderAPI installieren für erweiterte Platzhalter

---

🐛 Bekannte Issues & Lösungen

Ball spawnt mehrfach

• Lösung: Nutze /nexuslobby ball remove gefolgt von /nexuslobby ball setspawn
• Das Anti-Duplikat-System sollte dies automatisch verhindern

NPCs schauen nicht zu Spielern

• Lösung: Stelle sicher, dass der NPC mit /nexustools das LookAt-Feature aktiviert hat
• Prüfe, ob ArmorStandLookAtModule in den Logs geladen wird

Server-Checker zeigt falsche Status

• Lösung: Überprüfe die IP/Port-Einstellungen in config.yml unter servers:
• Stelle sicher, dass die Server erreichbar sind (Firewall, Ports)

---

📚 Support & Dokumentation

• Wiki: Ausführliche Dokumentation im Wiki
• Bug-Reports: Erstelle ein Issue bei technischen Problemen
• Feature-Requests: Vorschläge über Issues mit Label "enhancement"

---

📝 Changelog

Version 1.1.0 (Februar 2026)

• ✨ Soccer/Fußball-System mit realistischer Physik
• ✨ Parkour-System mit Bestenliste und Checkpoints
• ✨ Player-Inspector Modul
• ✨ Config-Validierung mit Auto-Defaults
• 🔧 JSON-Library auf Gson 2.10.1 aktualisiert
• 🔧 Alle printStackTrace() durch Logger ersetzt
• 🔧 Memory-Management verbessert (Tasks & Listeners)
• 🔧 UpdateChecker mit proper JSON-Parsing
• 🐛 Diverse Bug-Fixes und Performance-Optimierungen

---

Copyright © 2026 - M_Viper - Alle Rechte vorbehalten

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