Update from Git Manager GUI

2026-02-06 07:38:13 +01:00
parent 983ca72aaa
commit 9c1b980388
12 changed files with 409 additions and 84 deletions
--- a/src/main/java/de/nexuslobby/NexusLobby.java
+++ b/src/main/java/de/nexuslobby/NexusLobby.java
@@ -23,7 +23,7 @@ import de.nexuslobby.modules.border.BorderModule;
 import de.nexuslobby.modules.parkour.ParkourManager;
 import de.nexuslobby.modules.parkour.ParkourListener;
 import de.nexuslobby.modules.player.PlayerInspectModule;
-import de.nexuslobby.modules.ball.SoccerModule; // NEU
+import de.nexuslobby.modules.ball.SoccerModule;
 import de.nexuslobby.utils.*;
 import me.clip.placeholderapi.expansion.PlaceholderExpansion;
 import net.md_5.bungee.api.chat.ClickEvent;
@@ -68,7 +68,7 @@ public class NexusLobby extends JavaPlugin implements Listener {
    private IntroModule introModule;
    private BorderModule borderModule;
    private ParkourManager parkourManager;
-    private SoccerModule soccerModule; // NEU
+    private SoccerModule soccerModule;
    
    private ConversationManager conversationManager;

@@ -96,12 +96,22 @@ public class NexusLobby extends JavaPlugin implements Listener {
        return parkourManager;
    }

-    public SoccerModule getSoccerModule() { // NEU
+    public SoccerModule getSoccerModule() { 
        return soccerModule;
    }

    @Override
    public void onEnable() {
+        getLogger().info("");
+        getLogger().info("[NexusLobby]    _   __                     __          __    __         ");
+        getLogger().info("[NexusLobby]   / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __");
+        getLogger().info("[NexusLobby]  /  |/ / _ \\| |/_/ / / / ___/ /   / __ \\ / __ \\/ __ \\/ / / /");
+        getLogger().info("[NexusLobby] / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / ");
+        getLogger().info("[NexusLobby] /_/ |_/\\___/_/|_|\\__,_/____/_____/\\____/_.___/_.___/\\__, /  ");
+        getLogger().info("[NexusLobby]                                                    /____/    ");
+        getLogger().info("[NexusLobby] ");
+        getLogger().info("[NexusLobby] NexusLobby Plugin aktiviert! Version: " + getDescription().getVersion());
+
        instance = this;
        initCustomConfigs();
        validateConfig();
@@ -136,8 +146,6 @@ public class NexusLobby extends JavaPlugin implements Listener {

        registerCommands();
        checkUpdates();
-
-        getLogger().info("NexusLobby v" + getDescription().getVersion() + " wurde erfolgreich gestartet.");
    }

    private void startAutoConversationTimer() {
@@ -245,8 +253,8 @@ public class NexusLobby extends JavaPlugin implements Listener {
        moduleManager.registerModule(new PlayerInspectModule());

        // Soccer Modul registrieren
-        this.soccerModule = new SoccerModule(); // NEU
-        moduleManager.registerModule(this.soccerModule); // NEU
+        this.soccerModule = new SoccerModule(); 
+        moduleManager.registerModule(this.soccerModule); 

        this.portalManager = new PortalManager(this);
        moduleManager.registerModule(portalManager);
@@ -352,6 +360,10 @@ public class NexusLobby extends JavaPlugin implements Listener {
        visualsFile = new File(getDataFolder(), "visuals.yml");
        if (!visualsFile.exists()) saveResource("visuals.yml", false);

+        // lang.yml automatisch erstellen, falls nicht vorhanden
+        File langFile = new File(getDataFolder(), "lang.yml");
+        if (!langFile.exists()) saveResource("lang.yml", false);
+
        reloadVisualsConfig();
        Config.load(); 
    }
--- a/src/main/java/de/nexuslobby/api/ModuleManager.java
+++ b/src/main/java/de/nexuslobby/api/ModuleManager.java
@@ -25,7 +25,6 @@ public class ModuleManager {
     */
    public void enableAll() {
        for (Module module : modules) {
-            plugin.getLogger().info("[NexusLobby] Enabling module: " + module.getName());
            module.onEnable();
        }
    }
--- a/src/main/java/de/nexuslobby/modules/ScoreboardModule.java
+++ b/src/main/java/de/nexuslobby/modules/ScoreboardModule.java
@@ -15,7 +15,11 @@ import java.util.List;
 import java.util.Set;
 import java.util.UUID;

-public class ScoreboardModule implements Module {
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.PlayerJoinEvent;
+
+public class ScoreboardModule implements Module, Listener {

    private final NexusLobby plugin = NexusLobby.getInstance();
    private boolean placeholderAPIEnabled;
@@ -34,6 +38,9 @@ public class ScoreboardModule implements Module {
        FileConfiguration vConfig = plugin.getVisualsConfig();
        if (!vConfig.getBoolean("scoreboard.enabled", true)) return;

+        // Listener registrieren
+        Bukkit.getPluginManager().registerEvents(this, plugin);
+
        placeholderAPIEnabled = Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null;

        new BukkitRunnable() {
@@ -46,6 +53,21 @@ public class ScoreboardModule implements Module {
        }.runTaskTimer(plugin, 0L, vConfig.getLong("scoreboard.update_ticks", 20L));
    }

+    /**
+     * Setzt Scoreboard-Status beim Join gemäß config.yml (scoreboard-default-visible)
+     */
+    @EventHandler
+    public void onPlayerJoin(PlayerJoinEvent event) {
+        Player player = event.getPlayer();
+        boolean defaultVisible = plugin.getConfig().getBoolean("scoreboard-default-visible", true);
+        if (!defaultVisible) {
+            hiddenPlayers.add(player.getUniqueId());
+            player.setScoreboard(Bukkit.getScoreboardManager().getMainScoreboard());
+        } else {
+            hiddenPlayers.remove(player.getUniqueId());
+        }
+    }
+
    private void updateSidebar(Player player) {
        // 1. Prüfen, ob der Spieler das Scoreboard ausgeblendet hat
        if (hiddenPlayers.contains(player.getUniqueId())) {
--- a/src/main/java/de/nexuslobby/modules/armorstandtools/DynamicArmorStandModule.java
+++ b/src/main/java/de/nexuslobby/modules/armorstandtools/DynamicArmorStandModule.java
@@ -27,7 +27,6 @@ public class DynamicArmorStandModule implements Module {
    @Override
    public void onEnable() {
        startUpdateTask();
-        Bukkit.getLogger().info("§a[NexusLobby] DynamicArmorStandModule aktiv: Ingame-Zeit & Sternen-Effekt geladen.");
    }

    private void startUpdateTask() {
--- a/src/main/java/de/nexuslobby/modules/ball/SoccerModule.java
+++ b/src/main/java/de/nexuslobby/modules/ball/SoccerModule.java
@@ -255,7 +255,7 @@ public class SoccerModule implements Module, Listener, CommandExecutor {

    private void spawnBall() {
        if (spawnLocation == null || spawnLocation.getWorld() == null) {
-            Bukkit.getLogger().warning("[NexusLobby] Ball-Spawn-Location nicht gesetzt! Verwende /nexuslobby ball setspawn");
+            // Keine Warnung mehr in der Konsole ausgeben
            return;
        }
        
--- a/src/main/java/de/nexuslobby/modules/portal/PortalManager.java
+++ b/src/main/java/de/nexuslobby/modules/portal/PortalManager.java
@@ -64,7 +64,6 @@ public class PortalManager implements Module, Listener {
        loadBorderSettings();
        Bukkit.getPluginManager().registerEvents(this, plugin);
        startParticleTask();
-        plugin.getLogger().info("PortalManager vollständig geladen.");
    }

    @Override
--- a/src/main/resources/armorstands.yml
+++ b/src/main/resources/armorstands.yml
@@ -1,5 +1,13 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
+# -----------------------------------------------------
 # ArmorStandTools Configuration
-# -----------------------------
+# -----------------------------------------------------

 # Nachrichten
 prefix: "§8[§6ArmorStand§8] §7"
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -1,89 +1,252 @@
-# ==========================
-# NexusLobby Konfiguration
-# ==========================
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
+# =============================================================
+# NEXUSLOBBY - HAUPTKONFIGURATION
+# =============================================================
+#
+# Diese Konfigurationsdatei steuert alle Aspekte deiner Lobby.
+# Farben werden mit & formatiert (z.B. &a = grün, &c = rot, &e = gelb)
+# Vollständige Farbcode-Liste: https://minecraft.fandom.com/wiki/Formatting_codes

-# Spracheinstellung für alle Texte (z.B. de, en, fr)
+# ══════════════════════════════════════════════════════════════════════════════
+# SPRACHE
+# ══════════════════════════════════════════════════════════════════════════════
+# Spracheinstellung für alle Texte und Nachrichten im Plugin
+# Verfügbare Optionen: de (Deutsch), en (Englisch), fr (Französisch)
 language: de

-# --- Spawn Einstellungen ---
+# ══════════════════════════════════════════════════════════════════════════════
+# SPAWN EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Definiert den Spawn-Punkt der Lobby, zu dem Spieler beim Join teleportiert werden
+# Tipp: Nutze den Befehl /nexus setspawn um diese Werte automatisch zu setzen
 spawn:
-  world: "world"       # Name der Standardwelt
-  x: 0.5               # X-Koordinate des Spawns
-  y: 64.0              # Y-Koordinate des Spawns
-  z: 0.5               # Z-Koordinate des Spawns
-  yaw: 0.0             # Blickrichtung
-  pitch: 0.0           # Blickrichtung
+  # Name der Welt, in der sich der Spawn befindet
+  world: "world"
  
+  # X-Koordinate des Spawn-Punktes (Ost-West)
+  x: 0.5
+  
+  # Y-Koordinate des Spawn-Punktes (Höhe)
+  y: 64.0
+  
+  # Z-Koordinate des Spawn-Punktes (Nord-Süd)
+  z: 0.5
+  
+  # Horizontale Blickrichtung beim Spawn (0-360 Grad)
+  # 0 = Süden, 90 = Westen, 180 = Norden, 270 = Osten
+  yaw: 0.0
+  
+  # Vertikale Blickrichtung beim Spawn (-90 bis 90 Grad)
+  # -90 = Direkt nach oben, 0 = Geradeaus, 90 = Direkt nach unten
+  pitch: 0.0
+
+# ══════════════════════════════════════════════════════════════════════════════
+# WELTGRENZE (WORLD BORDER)
+# ══════════════════════════════════════════════════════════════════════════════
+# Erstellt eine unsichtbare Barriere um die Lobby herum
 worldborder:
+  # Aktiviert die Weltgrenze (true = an, false = aus)
  enabled: true
-  type: "SQUARE" # oder "CIRCLE"
+  
+  # Form der Weltgrenze
+  # Optionen: "SQUARE" (Quadrat), "CIRCLE" (Kreis)
+  type: "SQUARE"
+  
+  # Radius der Weltgrenze in Blöcken
+  # Bei SQUARE: Kantenlänge = radius * 2
+  # Bei CIRCLE: Durchmesser = radius * 2
  radius: 50.0
+  
+  # Zentrum der Weltgrenze (optional, kann leer bleiben)
+  # Wenn nicht gesetzt, wird der Spawn-Punkt als Zentrum verwendet
  center: 
+  
+  # Alternative: Definiere Eckpunkte (für rechteckige Border)
+  # Format: x,y,z
  pos1:
  pos2:

-# --- Lobby Einstellungen ---
+# ══════════════════════════════════════════════════════════════════════════════
+# LOBBY EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Grundlegende Verhaltensregeln und Einstellungen für die Lobby
 lobby:
-  allow-fly: false          # Spieler dürfen fliegen
-  pvp-enabled: false        # PvP in der Lobby
-  build-enabled: false      # Bau im Lobby-Bereich
+  # Erlaubt Spielern das Fliegen in der Lobby
+  # true = Spieler können fliegen, false = Fliegen ist deaktiviert
+  allow-fly: false
+  
+  # Aktiviert PvP (Player vs Player) in der Lobby
+  # true = Spieler können sich gegenseitig angreifen, false = kein PvP
+  pvp-enabled: false
+  
+  # Erlaubt Spielern das Platzieren und Abbauen von Blöcken
+  # true = Bauen erlaubt, false = Bauen verboten (außer für Berechtigte)
+  build-enabled: false
+  
+  # Standard-Spielmodus für alle Spieler in der Lobby
+  # Optionen: Survival, Creative, Adventure, Spectator
  default-gamemode: Adventure
+  
+  # Leert das Inventar von Spielern beim Betreten der Lobby
+  # true = Inventar wird geleert, false = Inventar bleibt erhalten
+  # Empfohlen: true für ein sauberes Lobby-Erlebnis
  clear-inventory-on-join: true

-# Mapping für den Server-Status-Ping der ArmorStands
-# Der Name (z.B. survival) muss exakt dem Bungee-Servernamen entsprechen
+# ══════════════════════════════════════════════════════════════════════════════
+# SCOREBOARD EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Steuert das Scoreboard (rechte Seitenleiste) in der Lobby
+# Standardmäßig sichtbar? Spieler können es per Befehl ein-/ausblenden
+# true = Scoreboard wird beim Join angezeigt, false = standardmäßig ausgeblendet
+scoreboard-default-visible: true
+
+# ══════════════════════════════════════════════════════════════════════════════
+# SERVER-STATUS PING (FÜR ARMORSTANDS)
+# ══════════════════════════════════════════════════════════════════════════════
+# Mapping für den Server-Status-Ping der ArmorStands in der Lobby
+# Diese Einstellungen ermöglichen es, den Status anderer Server zu überprüfen
+# WICHTIG: Der Name (z.B. "survival") muss EXAKT dem BungeeCord-Servernamen entsprechen
 servers:
+  # Erster Server: Survival
  survival:
+    # IP-Adresse des Survival-Servers
+    # 127.0.0.1 = Localhost (Server läuft auf derselben Maschine)
    ip: "127.0.0.1"
+    
+    # Port des Survival-Servers
    port: 25566
+  
+  # Zweiter Server: Skyblock
  skyblock:
+    # IP-Adresse des Skyblock-Servers
    ip: "127.0.0.1"
+    
+    # Port des Skyblock-Servers
    port: 25567

-# --- Tablist Einstellungen ---
+# ══════════════════════════════════════════════════════════════════════════════
+# TABLISTE (TAB-LISTE) EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Anpassung der Player-Liste (TAB-Taste)
 tablist:
+  # Aktiviert die angepasste Tabliste
+  # true = Custom Tablist wird verwendet, false = Standard Minecraft Tablist
  enabled: true
-  header: "&6Willkommen auf &eNexusLobby"
-  footer: "&7Viel Spaß!"
-  refresh-interval: 40       # Ticks
  
-# --- Items Modul Einstellungen ---
+  # Kopfzeile über den Spielernamen
+  # Unterstützt Farbcodes (&-Codes) und mehrzeiligen Text mit |
+  header: "&6Willkommen auf &eNexusLobby"
+  
+  # Fußzeile unter den Spielernamen
+  # Unterstützt Farbcodes (&-Codes) und mehrzeiligen Text mit |
+  footer: "&7Viel Spaß!"
+  
+  # Aktualisierungsintervall in Ticks (20 Ticks = 1 Sekunde)
+  # Niedrigere Werte = häufigere Updates (mehr Performance-Last)
+  # Höhere Werte = seltenere Updates (weniger Performance-Last)
+  refresh-interval: 40
+
+# ══════════════════════════════════════════════════════════════════════════════
+# ITEMS MODUL EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Konfiguration der Items, die Spieler in der Lobby erhalten
 items:
+  # Container für alle Lobby-Werkzeuge
  lobby-tools:
+    # Kompass (Server-Auswahl / Teleporter)
    compass:
+      # Aktiviert das Kompass-Item (true = an, false = aus)
      enabled: true
+      
+      # Anzeigename des Items (unterstützt Farbcodes)
      displayname: "&eTeleporter"
+      
+      # Slot im Inventar (0-8, wobei 0 ganz links ist und 8 ganz rechts)
      slot: 4
+    
+    # Baumodus-Umschalter (nur für berechtigte Spieler)
    build-toggle:
+      # Aktiviert das Baumodus-Item (true = an, false = aus)
      enabled: true
+      
+      # Anzeigename des Items (unterstützt Farbcodes)
      displayname: "&aBaumodus"
+      
+      # Slot im Inventar (0-8)
      slot: 0
+    
+    # Gadget-Menü (Spezialeffekte und Extras)
    gadget:
+      # Aktiviert das Gadget-Item (true = an, false = aus)
      enabled: false
+      
+      # Anzeigename des Items (unterstützt Farbcodes)
      displayname: "&bGadgets"
+      
+      # Slot im Inventar (0-8)
      slot: 8

-# --- Portal Einstellungen ---
+# ══════════════════════════════════════════════════════════════════════════════
+# PORTAL EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Konfiguration für Teleportations-Portale in der Lobby
 portals:
+  # Standard-Partikeleffekt für alle Portale
+  # Optionen: PORTAL, FLAME, VILLAGER_HAPPY, REDSTONE, ENCHANTMENT_TABLE, etc.
+  # Vollständige Liste: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
  default-particle: "PORTAL"
-  portal-cooldown: 40         # Ticks, 2 Sekunden
+  
+  # Cooldown zwischen Portal-Nutzungen in Ticks (20 Ticks = 1 Sekunde)
+  # Verhindert Spam und ungewollte Mehrfach-Teleports
+  portal-cooldown: 40
+  
+  # Dateiname für die Speicherung der Portal-Positionen
+  # Wird automatisch im Plugin-Ordner erstellt
  save-file: "portals.yml"

-# -----------------------------------------------------
-# COMPASS MENU
-# -----------------------------------------------------
+# ══════════════════════════════════════════════════════════════════════════════
+# COMPASS MENU (SERVER SWITCHER)
+# ══════════════════════════════════════════════════════════════════════════════
+# GUI-Menü das sich öffnet, wenn ein Spieler auf den Kompass klickt
 compass:
+  # Titel des Inventar-Menüs (unterstützt Farbcodes)
  title: "&eServer Switcher"
+  
+  # Größe des Inventars (muss ein Vielfaches von 9 sein)
+  # Optionen: 9, 18, 27, 36, 45, 54
  size: 27
+  
+  # Server-Einträge im Menü
  servers:
+    # Erster Server: PvP
    pvp:
+      # Anzeigename des Items im Menü (unterstützt Farbcodes)
      name: "&cPvP Arena"
+      
+      # Material des Items (muss ein gültiger Minecraft-Material-Name sein)
+      # Liste: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
      material: "DIAMOND_SWORD"
+      
+      # Befehl der beim Klick ausgeführt wird
+      # Für BungeeCord: "server <servername>"
+      # Für Teleport: "spawn <name>" oder andere Custom-Befehle
      command: "server pvp"
+      
+      # Position des Items im Inventar (0 = oben links)
      slot: 11
+      
+      # Beschreibung des Items (wird beim Darüberfahren angezeigt)
      lore:
        - "&7Klicke hier um dich"
        - "&7zum PvP Server zu teleportieren."
+    
+    # Zweiter Server: Survival
    survival:
      name: "&aSurvival"
      material: "GRASS_BLOCK"
@@ -92,6 +255,8 @@ compass:
      lore:
        - "&7Das normale Survival."
        - "&7Viel Spaß beim Bauen!"
+    
+    # Dritter Server: BuildBattle
    buildbattle:
      name: "&bBuildBattle"
      material: "BEDROCK"
@@ -100,82 +265,172 @@ compass:
      lore:
        - "&7Zeige was du kannst!"

-# -----------------------------------------------------
-# PLAYER INSPECT (Statistiken per Rechtsklick)
-# -----------------------------------------------------
+# ══════════════════════════════════════════════════════════════════════════════
+# PLAYER INSPECT (STATISTIKEN PER RECHTSKLICK)
+# ══════════════════════════════════════════════════════════════════════════════
+# Ermöglicht das Anzeigen von Spieler-Statistiken durch Rechtsklick auf einen Spieler
 player_inspect:
+  # Aktiviert die Player-Inspect-Funktion (true = an, false = aus)
  enabled: true
+  
+  # Titel des GUI-Fensters das sich öffnet
+  # Platzhalter: {PLAYER} = Name des angeklickten Spielers
  gui_title: "&8Statistiken von &6{PLAYER}"

-# --- Suppressor / Global Chat Einstellungen ---
+# ══════════════════════════════════════════════════════════════════════════════
+# SUPPRESSOR / GLOBAL CHAT EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Join/Quit-Nachrichten Unterdrückung und BungeeCord-Messaging
 suppressor:
+  # Aktiviert das Suppressor-System (true = an, false = aus)
  enabled: true
+  
+  # Unterdrückt Join- und Quit-Nachrichten für neue Spieler temporär
+  # true = Nachrichten werden unterdrückt, false = normale Anzeige
+  # Nützlich um Spam zu vermeiden wenn viele Spieler gleichzeitig joinen/leaven
  suppress-join-quit: true
-  suppress-duration-ticks: 40   # Zeit, bis Spieler wieder sichtbar
+  
+  # Dauer der Unterdrückung in Ticks (20 Ticks = 1 Sekunde)
+  # Nach dieser Zeit werden Join/Quit-Nachrichten wieder normal angezeigt
+  suppress-duration-ticks: 40
+  
+  # BungeeCord Plugin-Messaging Channels
+  # Diese Channels werden für die Kommunikation zwischen Servern verwendet
  channels:
-    control: "global:control"  # Channel für Join/Quit Suppression
-    chat: "global:chat"        # Channel für globales Chat-Relay
+    # Channel für Join/Quit-Suppression-Control
+    control: "global:control"
    
-# --- Logging Einstellungen ---
+    # Channel für globales Chat-Relay über alle Server
+    chat: "global:chat"
+
+# ══════════════════════════════════════════════════════════════════════════════
+# LOGGING EINSTELLUNGEN
+# ══════════════════════════════════════════════════════════════════════════════
+# Konfiguration der Plugin-Logs und Debug-Ausgaben
 logging:
-  enable-debug: true           # Aktiviert detaillierte Logs für Module
-  log-file: "logs/plugin.log"  # Pfad für das Logfile
+  # Aktiviert detaillierte Debug-Logs in der Konsole
+  # true = Sehr ausführliche Logs (nur zur Fehlersuche empfohlen)
+  # false = Normale Logs
+  # WARNUNG: Bei true kann die Konsole sehr voll werden!
+  enable-debug: true
  
-# --- Wartungsmodus ---
+  # Pfad zur Log-Datei des Plugins
+  # Relativ zum Plugin-Ordner
+  log-file: "logs/plugin.log"
+
+# ══════════════════════════════════════════════════════════════════════════════
+# WARTUNGSMODUS
+# ══════════════════════════════════════════════════════════════════════════════
+# Sperrt den Server für normale Spieler während Wartungsarbeiten
 maintenance:
+  # Aktiviert den Wartungsmodus (true = an, false = aus)
+  # Wenn aktiviert, können nur Spieler mit der Permission "nexuslobby.maintenance.bypass" joinen
  enabled: false
+  
+  # Nachricht die Spielern angezeigt wird, wenn sie gekickt werden
+  # Unterstützt Farbcodes und \n für Zeilenumbrüche
  kick_message: "&cServer im Wartungsmodus! Du darfst nicht joinen."

-# -----------------------------------------------------
-# VOID PROTECTION
-# -----------------------------------------------------
-# Verhindert, dass Spieler in die Leere fallen
+# ══════════════════════════════════════════════════════════════════════════════
+# VOID PROTECTION (SCHUTZ VOR LEERE)
+# ══════════════════════════════════════════════════════════════════════════════
+# Verhindert dass Spieler in die Leere fallen und im Void sterben
 void_protection:
+  # Aktiviert den Void-Schutz (true = an, false = aus)
  enabled: true
-  # Teleportiert den Spieler zum Welt-Spawn
+  
+  # Teleportiert Spieler zum Spawn zurück wenn sie in die Leere fallen
+  # true = Teleport zum Spawn, false = Spieler nimmt Schaden/stirbt
  teleport_to_spawn: true
-  # Nachricht beim Teleport (Leer lassen für keine Nachricht)
+  
+  # Nachricht die dem Spieler beim Teleport angezeigt wird
+  # Leer lassen ("") für keine Nachricht
  message: "&cDu bist in die Leere gefallen und wurdest teleportiert!"

-# -----------------------------------------------------
-# DOUBLE JUMP
-# -----------------------------------------------------
-# Erlaubt einen Doppelsprung in der Lobby
+# ══════════════════════════════════════════════════════════════════════════════
+# DOUBLE JUMP (DOPPELSPRUNG)
+# ══════════════════════════════════════════════════════════════════════════════
+# Erlaubt Spielern einen Doppelsprung in der Luft
 doublejump:
+  # Aktiviert die Doppelsprung-Funktion (true = an, false = aus)
  enabled: true
-  # Stärke des Sprungs nach oben
+  
+  # Stärke des Sprungs nach oben (vertikale Geschwindigkeit)
+  # Standardwert: 1.0
+  # Höhere Werte = höherer Sprung, niedrigere Werte = flacherer Sprung
+  # Empfohlener Bereich: 0.5 - 2.0
  velocity: 1.0
-  # Vorwärts-Schub beim Sprung
+  
+  # Vorwärts-Schub beim Sprung (horizontale Geschwindigkeit)
+  # Standardwert: 0.2
+  # Höhere Werte = mehr Vorwärtsschub, 0.0 = kein Vorwärtsschub
+  # Empfohlener Bereich: 0.0 - 0.5
  horizontal: 0.2

-# -----------------------------------------------------
-# PLAYER HIDER
-# -----------------------------------------------------
-# Item, um andere Spieler zu verstecken/anzuzeigen
+# ══════════════════════════════════════════════════════════════════════════════
+# PLAYER HIDER (SPIELER VERSTECKEN)
+# ══════════════════════════════════════════════════════════════════════════════
+# Item zum Verstecken/Anzeigen anderer Spieler in der Lobby
 hider:
+  # Aktiviert die Player-Hider-Funktion (true = an, false = aus)
  enabled: true
-  # Material-Name (Muss ein gültiger Bukkit-Material-Name sein)
+  
+  # Material des Items im Inventar
+  # Kann je nach Status wechseln (z.B. grüner/roter Farbstoff)
+  # Liste: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
  item: "REDSTONE"
+  
  # Slot im Inventar (0-8)
  slot: 8
+  
+  # Nachrichten für verschiedene Zustände
  messages:
-    # Anzeigename des Items und Nachricht, wenn alle sichtbar sind
+    # Anzeigename und Nachricht wenn alle Spieler sichtbar sind
+    # Wird angezeigt wenn der Spieler auf das Item klickt und Spieler sichtbar sind
    all: "&aAlle Spieler: &7Sichtbar"
-    # Anzeigename des Items und Nachricht, wenn alle versteckt sind
+    
+    # Anzeigename und Nachricht wenn alle Spieler versteckt sind
+    # Wird angezeigt wenn der Spieler auf das Item klickt und Spieler versteckt sind
    none: "&cKeine Spieler: &7Versteckt"

-# -----------------------------------------------------
+# ══════════════════════════════════════════════════════════════════════════════
 # BALL / SOCCER EINSTELLUNGEN
-# -----------------------------------------------------
+# ══════════════════════════════════════════════════════════════════════════════
+# Aktiviert ein Fußball-System in der Lobby zum Spielen
 ball:
+  # Aktiviert das Ball-System (true = an, false = aus)
  enabled: true
-  # Der Spawnpunkt wird automatisch über /nexus ball setspawn hier gespeichert
+  
+  # Spawn-Position des Balls
+  # Tipp: Nutze /nexus ball setspawn um diese Position automatisch zu setzen
  spawn:
+    # Name der Welt in der der Ball spawnt
    world: "world"
+    
+    # X-Koordinate des Ball-Spawns
    x: 10.5
+    
+    # Y-Koordinate des Ball-Spawns
    y: 65.0
+    
+    # Z-Koordinate des Ball-Spawns
    z: 10.5
+    
+    # Blickrichtung des Balls (normalerweise nicht relevant)
    yaw: 0.0
    pitch: 0.0
-  # Zeit in Sekunden, bis der Ball bei Inaktivität respawnt
+  
+  # Zeit in Sekunden bis der Ball bei Inaktivität automatisch respawnt
+  # Nützlich wenn der Ball verloren geht oder stecken bleibt
+  # 0 = Kein automatischer Respawn
  respawn_delay: 60
+
+# ══════════════════════════════════════════════════════════════════════════════
+# Links
+# ══════════════════════════════════════════════════════════════════════════════
+# 
+# Benötigst du Hilfe oder Support?
+# - Webseite: https://m-viper.de
+# - Dokumentation: https://git.viper.ipv64.net/M_Viper/NexusLobby/wiki
+# - Discord: https://discord.com/invite/FdRs4BRd8D
+# - GitHub: https://git.viper.ipv64.net/M_Viper/NexusLobby
--- a/src/main/resources/conversations.yml
+++ b/src/main/resources/conversations.yml
@@ -1,5 +1,12 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
 # =============================================================
-#             NexusLobby - Lebendige Dialoge v2
+# Dialoge und Gespräche in der Lobby
 # =============================================================

 conversations:
--- a/src/main/resources/lang.yml
+++ b/src/main/resources/lang.yml
@@ -1,3 +1,14 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
+# =====================================================
+# DEFAULT Language
+# =====================================================
+
 soccer_module_not_loaded:
  de: "§cDas Fußball-Modul ist nicht geladen."
  en: "§cThe soccer module is not loaded."
--- a/src/main/resources/settings.yml
+++ b/src/main/resources/settings.yml
@@ -1,6 +1,12 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
 # =====================================================
-# NEXUSLOBBY – DEFAULT LOBBY GAMERULES
-# Minecraft 1.21.1
+# DEFAULT LOBBY GAMERULES
 # =====================================================

 # -------------------------------------------------
--- a/src/main/resources/visuals.yml
+++ b/src/main/resources/visuals.yml
@@ -1,5 +1,12 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
 # -----------------------------------------------------
-# NEXUSLOBBY - VISUELLE EINSTELLUNGEN
+# VISUELLE EINSTELLUNGEN
 # -----------------------------------------------------

 # --- Tablist Einstellungen ---