From 9c1b980388472c3daa60be5ffd1e8b257bab0bd7 Mon Sep 17 00:00:00 2001
From: M_Viper <admin@m-viper.de>
Date: Fri, 6 Feb 2026 07:38:13 +0100
Subject: [PATCH] Update from Git Manager GUI

---
 src/main/java/de/nexuslobby/NexusLobby.java   |  30 +-
 .../java/de/nexuslobby/api/ModuleManager.java |   1 -
 .../nexuslobby/modules/ScoreboardModule.java  |  24 +-
 .../DynamicArmorStandModule.java              |   1 -
 .../nexuslobby/modules/ball/SoccerModule.java |   2 +-
 .../modules/portal/PortalManager.java         |   1 -
 src/main/resources/armorstands.yml            |  10 +-
 src/main/resources/config.yml                 | 385 +++++++++++++++---
 src/main/resources/conversations.yml          |   9 +-
 src/main/resources/lang.yml                   |  11 +
 src/main/resources/settings.yml               |  10 +-
 src/main/resources/visuals.yml                |   9 +-
 12 files changed, 409 insertions(+), 84 deletions(-)

diff --git a/src/main/java/de/nexuslobby/NexusLobby.java b/src/main/java/de/nexuslobby/NexusLobby.java
index 31d6c3b..9bfc815 100644
--- 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);
@@ -343,7 +351,7 @@ public class NexusLobby extends JavaPlugin implements Listener {
 
         File configFile = new File(getDataFolder(), "config.yml");
         if (!configFile.exists()) saveResource("config.yml", false);
-        
+
         reloadConfig();
 
         File settingsFile = new File(getDataFolder(), "settings.yml");
@@ -351,7 +359,11 @@ 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(); 
     }
diff --git a/src/main/java/de/nexuslobby/api/ModuleManager.java b/src/main/java/de/nexuslobby/api/ModuleManager.java
index 665750a..67137c5 100644
--- 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();
         }
     }
diff --git a/src/main/java/de/nexuslobby/modules/ScoreboardModule.java b/src/main/java/de/nexuslobby/modules/ScoreboardModule.java
index f4ad44f..511dbd0 100644
--- 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())) {
diff --git a/src/main/java/de/nexuslobby/modules/armorstandtools/DynamicArmorStandModule.java b/src/main/java/de/nexuslobby/modules/armorstandtools/DynamicArmorStandModule.java
index 3428ea9..21ba714 100644
--- 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() {
diff --git a/src/main/java/de/nexuslobby/modules/ball/SoccerModule.java b/src/main/java/de/nexuslobby/modules/ball/SoccerModule.java
index b0d5541..1fe51a1 100644
--- 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;
         }
         
diff --git a/src/main/java/de/nexuslobby/modules/portal/PortalManager.java b/src/main/java/de/nexuslobby/modules/portal/PortalManager.java
index 59ba165..76355d8 100644
--- 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
diff --git a/src/main/resources/armorstands.yml b/src/main/resources/armorstands.yml
index 3ea02aa..2eb3e9a 100644
--- a/src/main/resources/armorstands.yml
+++ b/src/main/resources/armorstands.yml
@@ -1,5 +1,13 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
+# -----------------------------------------------------
 # ArmorStandTools Configuration
-# -----------------------------
+# -----------------------------------------------------
 
 # Nachrichten
 prefix: "§8[§6ArmorStand§8] §7"
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index d80c2f7..b0a79ea 100644
--- 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: 25567  
+    
+    # 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
+  
+  # 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ß!"
-  refresh-interval: 40       # Ticks
+  
+  # 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 ---
+# ══════════════════════════════════════════════════════════════════════════════
+# 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
-  save-file: "portals.yml"    
+  
+  # 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
-  gui_title: "&8Statistiken von &6{PLAYER}"        
+  
+  # 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"
+    
+    # Channel für globales Chat-Relay über alle Server
+    chat: "global:chat"
 
-# --- Logging Einstellungen ---
+# ══════════════════════════════════════════════════════════════════════════════
+# 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
+  
+  # Pfad zur Log-Datei des Plugins
+  # Relativ zum Plugin-Ordner
+  log-file: "logs/plugin.log"
 
-# --- Wartungsmodus ---
+# ══════════════════════════════════════════════════════════════════════════════
+# 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
-    none: "&cKeine Spieler: &7Versteckt"  
+    
+    # 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
-  respawn_delay: 60
\ No newline at end of file
+  
+  # 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
\ No newline at end of file
diff --git a/src/main/resources/conversations.yml b/src/main/resources/conversations.yml
index f001515..40dafc6 100644
--- 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:
diff --git a/src/main/resources/lang.yml b/src/main/resources/lang.yml
index d94b1f8..04adf4a 100644
--- 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."
diff --git a/src/main/resources/settings.yml b/src/main/resources/settings.yml
index 55426af..00cccd4 100644
--- 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
 # =====================================================
 
 # -------------------------------------------------
diff --git a/src/main/resources/visuals.yml b/src/main/resources/visuals.yml
index 7a6827b..46fa389 100644
--- a/src/main/resources/visuals.yml
+++ b/src/main/resources/visuals.yml
@@ -1,5 +1,12 @@
+#     _   __                     __          __    __         
+#    / | / /__  _  ____  _______/ /   ____  / /_  / /_  __  __
+#   /  |/ / _ \| |/_/ / / / ___/ /   / __ \/ __ \/ __ \/ / / /
+#  / /|  /  __/>  </ /_/ (__  ) /___/ /_/ / /_/ / /_/ / /_/ / 
+# /_/ |_/\___/_/|_|\__,_/____/_____/\____/_.___/_.___/\__, /  
+#                                                    /____/   
+#
 # -----------------------------------------------------
-# NEXUSLOBBY - VISUELLE EINSTELLUNGEN
+# VISUELLE EINSTELLUNGEN
 # -----------------------------------------------------
 
 # --- Tablist Einstellungen ---